API

Aprendé cómo usar Afip SDK via API

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

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

Nombre	Tipo	Descripción
environment	string	Usar dev para ambiente de desarrollo o prod para producción.
tax_id	string	CUIT para el cual queremos obtener el TA.
wsid	string	ID 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_create	boolean	default: false Se debe setear en true si queremos forzar la creación de un nuevo TA. Mas información
cert	string	Certificado digital.
key	string	Key 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:

API | Blog

---

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

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..."
}