Descargar Mis Comprobantes de ARCA via API
Con pocas líneas de código
Podemos usar Afip SDK para descargar los comprobantes emitidos o recibidos desde el servicio Mis Comprobantes de manera automática. Esto evita navegar manualmente por el sitio de ARCA y nos ayuda a reducir errores.
Requisitos previos
Para poder usar las automatizaciones, primero necesitarás:
1. Crear la automatización
Vamos a ejecutar la automatización para descargar los comprobantes. Lo primero es enviar una solicitud POST al endpoint:
https://app.afipsdk.com/api/v1/automations
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
cuit | string | CUIT del que queremos descargar los comprobantes. |
username | string | Usuario para ingresar a ARCA. Para la mayoría es el mismo CUIT, pero si administrás una sociedad es el CUIT del administrador. |
password | string | Contraseña para ingresar a ARCA. |
filters | object | Configuración para limitar los comprobantes obtenidos. |
Dentro de filters podés usar las siguientes claves:
| Campo | Tipo | Descripción |
|---|---|---|
t | string | Comprobantes a obtener (E = Emitidos, R = Recibidos). |
fechaEmision | string | Rango de fechas en formato dd/mm/yyyy - dd/mm/yyyy. |
puntosVenta | integer[] | Puntos de venta a incluir. (opcional) |
tiposComprobantes | integer[] | Tipos de comprobante. (opcional) |
comprobanteDesde | integer | Número inicial del comprobante. (opcional, usar junto con comprobanteHasta) |
comprobanteHasta | integer | Número final del comprobante. (opcional, usar junto con comprobanteDesde) |
tipoDoc | integer | Tipo de documento del receptor. (opcional) |
nroDoc | string | Número de documento del receptor. (opcional) |
codigoAutorizacion | string | Código de autorización (CAE/CAI). (opcional) |
Incluí el header con tu token:
Authorization: Bearer TU_ACCESS_TOKEN_AQUI
Ejemplo
{
"automation": "mis-comprobantes",
"params": {
"cuit": "20111111112",
"username": "20111111112",
"password": "contraseña#segura?",
"filters": {
"t": "R",
"fechaEmision": "01/01/2023 - 31/12/2023"
}
}
}
Al crear la automatización recibirás un id y su status inicial.
Response
{
"status": "in_process",
"id": "0d1e71e0-8882-4b14-b7f8-c5d716261760"
}
2. Obtener el resultado
Una vez creada la automatización, esta va a comenzar a ejecutarse. Para obtener el resultado final debés realizar una llamada GET al endpoint:
https://app.afipsdk.com/api/v1/automations/:id
id es el identificador de la automatización previamente creada.
Incluí nuevamente el header con tu token:
Authorization: Bearer TU_ACCESS_TOKEN_AQUI
La automatización va a devolver { "status": "in_process" } hasta que se complete. Te recomendamos chequear el resultado cada 5 segundos hasta que deje de estar in_process.
STATUS 200
{
"status": "complete",
"data": [
{
"Fecha de Emisión": "2023-08-02",
"Tipo de Comprobante": "11",
"Punto de Venta": "1",
"Número Desde": "36",
"Número Hasta": "36",
"Cód. Autorización": "73312575323360",
"Tipo Doc. Receptor": "80",
"Nro. Doc. Receptor": "30632580082",
"Denominación Receptor": "EMPRESA SA",
"Tipo Cambio": "1,00",
"Moneda": "PES",
"Imp. Neto Gravado": "0,00",
"Imp. Neto No Gravado": "0,00",
"Imp. Op. Exentas": "0,00",
"Otros Tributos": "0,00",
"IVA": "0,00",
"Imp. Total": "4687,20"
}
]
}
STATUS 400
{
"status": "error",
"data": {
"message": "Número de CUIL/CUIT incorrecto"
}
}
La automatización devuelve un arreglo con los comprobantes que cumplen los filtros indicados. Ajustá los campos opcionales para afinar la búsqueda según tus necesidades.
Ante cualquier duda o pregunta al respecto, pueden resolverla rápidamente dentro de la Comunidad Afip SDK. Además, puedes unirte para estar al tanto de las novedades y problemas técnicos al usar los servicios de ARCA.
