En esta documentación

Aprendé cómo usar Afip SDK via API


Requisitos previos

Para poder seguir esta guía, primero necesitarás:

Básicos

La URL base de la API es:

https://app.afipsdk.com/api/

El body de las peticiones es de tipo JSON. Se debe agregar el header correspondiente:

Content-Type: application/json

Además, debes agregar el header de autorización con tu access_token

Authorization: Bearer TU_ACCESS_TOKEN_AQUI

1. Obtener el Ticket de Acceso (TA)

Antes de llamar a los Web Services de ARCA, necesitás un ticket de acceso (TA), también llamado Token Authorization.

Este TA expira tras un tiempo, pero no tenés que preocuparte por renovarlo: Afip SDK lo cachea y solicita uno nuevo automáticamente si es necesario. Solo llamá a la API y Afip SDK te devuelve el TA correspondiente.

Para obtener el TA se necesita un certificado digital, pero con Afip SDK podés empezar en modo desarrollo usando el CUIT 20-40937847-2 sin necesidad de uno.

Si preferís usar tu propio certificado, al final te mostramos cómo.

Endpoint

POST https://app.afipsdk.com/api/v1/afip/auth

Body

NombreTipoDescripción
environmentstringUsar dev para ambiente de desarrollo o prod para producción.
tax_idstringCUIT para el cual queremos obtener el TA.
wsidstringID del Web Service a utilizar. Lo encontrás al inicio de la documentación de Afip SDK de cada Web Service o en el manual PDF de ARCA.
force_createbooleandefault: false

Se debe setear en true si queremos forzar la creación de un nuevo TA.

Mas información
certstringCertificado digital.
keystringKey del certificado.

Ejemplo

{
    "environment": "dev",
    "tax_id": "20409378472",
    "wsid": "wsfe"
}

Response

STATUS 200

{
    "expiration": "2024-03-13T00:42:59.845Z",
    "token": "PD94bWwgd...",
    "sign": "kEaCwSs36hpe..."
}

token y sign corresponden el TA que nos da ARCA. Debemos enviar estos datos en el body de cada solicitud a los Web Services. En el manual de cada Web Service verás dónde colocarlos.

2. Llamar al método del Web Service que necesites

Con el TA ya podés realizar las llamadas a los Web Services que necesites.

Web services

Si el Web Service que necesitás no se encuentra en la lista de la documentación, podés llamarlo siguiendo esta guía:

Otro web service

También podés usar las guías del blog de Afip SDK para API:


Usar tu propio certificado (Opcional)

Primero, obtenemos el certificado siguiendo esta guía.

Obtener el certificado para conectar tu sistema con los web services de ARCA

Obtener el certificado para conectar tu sistema con los web services de ARCA

Guía paso a paso

Al pedir la autorización agregamos cert y key en el body

API Request

POST https://app.afipsdk.com/api/v1/afip/auth

{
    "environment": "dev",
    "tax_id": "20111111112",
    "wsid": "wsfe",
    "cert": "-----BEGIN CERTIFICATE-----MIIDRzC...",
    "key": "-----BEGIN RSA PRIVATE KEY-----MIIEowIBAAKCA..."
}