Saltar al contenido principal

Consultas a ARCA

Consultar el padrón​

GET /:id-empresa/arca/padron/:docNumber

Devuelve los datos de un contribuyente a partir de su CUIT o CUIL, ya mapeados a los códigos que usa la emisión.

Consultá con una API key de producción

La base de homologación tiene datos de prueba y responde distinto, así que una consulta que falla ahí no dice nada sobre cómo va a andar en producción. Esta consulta sólo lee y no emite nada, así que usar la clave de producción mientras integrás no tiene contraindicación.

Trae todo lo que necesita customer: nombre o razón social, domicilio fiscal, provincia y condición frente al IVA, para personas físicas y jurídicas por igual.

No hace falta delegar nada

No requiere ninguna delegación adicional en ARCA. Alcanza con que tu empresa tenga la facturación electrónica configurada.

Las respuestas se guardan un tiempo, así que consultar la misma clave dos veces seguidas es inmediato. result.cache cuenta de dónde salió el dato.

curl https://nanofactura.com/api/<id-empresa:cambiar>/arca/padron/30703088534 \
-H "Authorization: Bearer PROD_tu_api_key"
{
"ok": true,
"result": {
"name": "JUAN PEREZ",
"address": "CALLE FALSA 123 CABA",
"stateId": 0,
"stateName": "CABA",
"taxCondition": 6,
"taxConditionName": "Responsable Monotributo",
"docType": 80,
"docNumber": 30703088534,
"details": { },
"cache": { "hit": false, "stale": false, "fetchedAt": "2026-09-24T14:03:11.000Z" }
}
}
CampoSe usa como
namecustomer.name
addresscustomer.address — calle, número y localidad, sin la provincia, que viene aparte
stateIdcustomer.stateId — puede venir null si no tiene domicilio cargado
stateNameEl nombre de la provincia, para mostrarla. El comprobante la imprime con el domicilio a partir de stateId
taxConditioncustomer.taxType — tal cual, sin traducir. Si ARCA no le informa IVA ni monotributo, viene 5, Consumidor Final: es una CUIT sin inscripción en impuestos. Viene null si ARCA no da la constancia: ver Sin constancia
warningSólo cuando ARCA no da la constancia: su motivo, tal como lo dice ARCA
docTypecustomer.docType
docNumbercustomer.docNumber — el padrón lo devuelve numérico y la emisión lo espera string: convertilo
detailsLa respuesta cruda de ARCA, por si necesitás algo que el mapeo no expone
cacheDe dónde salió el dato —ver abajo—

cache​

CampoQué dice
hittrue si respondimos con un dato guardado, sin consultar a ARCA en el momento
staletrue si ese dato estaba vencido y se usó igual porque ARCA no respondió. El dato sirve, pero es viejo
fetchedAtCuándo se le preguntó a ARCA por última vez

Sin constancia​

Mientras una CUIT tenga requerimientos pendientes, ARCA no da su constancia. La respuesta trae igual el nombre y el domicilio, pero no la condición frente al IVA: taxCondition viene null y warning dice por qué. La condición la tiene que informar el cliente, como en Comprobantes en línea.

{
"ok": true,
"result": {
"name": "EMPRESA SA",
"address": "BV OROÑO 100 ROSARIO",
"stateId": 12,
"stateName": "Santa Fe",
"taxCondition": null,
"taxConditionName": null,
"warning": "La CUIT registra requerimientos de ARCA pendientes de respuesta. La CUIT registra requerimientos pendientes de verificaciones.",
"docType": 80,
"docNumber": 30709234796,
"details": { },
"cache": { "hit": false, "stale": false, "fetchedAt": "2026-10-29T14:03:11.000Z" }
}
}

Tres respuestas de error que conviene distinguir:

404 NOT_FOUNDARCA no tiene esa clave.
422 ARCA_ERRORARCA respondió sobre esa clave y no da sus datos. error trae su motivo: ver la tabla de abajo. Reintentar da lo mismo.
502 ARCA_CONNECTION_ERROREl padrón de ARCA no pudo responder y no teníamos un dato guardado con el que contestar. No es de tu configuración: reintentá en unos minutos.

Errores conocidos​

{
"ok": false,
"code": "ARCA_ERROR",
"error": "Padrón de ARCA: La CUIT registra requerimientos de ARCA pendientes de respuesta. La CUIT registra requerimientos pendientes de verificaciones.",
"details": { "reason": "CONSTANCIA_WITHHELD" }
}
Lo que dice ARCAQué pasaQué hacer
«La CUIT registra requerimientos de ARCA pendientes de respuesta.» o «La CUIT registra requerimientos pendientes de verificaciones.» Viene con details.reason: "CONSTANCIA_WITHHELD": usá eso y no el texto, que es de ARCA y puede cambiar.ARCA no da la constancia de esa CUIT y esta vez tampoco su nombre y domicilio (ver Sin constancia).Cargá a mano el nombre, el domicilio y la condición frente al IVA, como los informe el cliente.
Que la clave «se encuentra INACTIVA» o «fue cancelada»La clave no está activa en ARCA.Confirmá el número con el cliente.

Estas respuestas se guardan un día: consultar la misma clave de nuevo antes devuelve lo mismo sin preguntarle a ARCA.

Es la forma correcta de armar el customer

Si tenés el CUIT, consultá el padrón y usá lo que devuelve. Te asegura que la condición frente al IVA sea la real —que es lo que determina qué comprobante corresponde emitir— y te trae la provincia ya codificada, sin que nadie la tipee mal.

Guardá el resultado en tu base: no hace falta consultarlo en cada venta al mismo cliente.

Cotización de una moneda​

GET /:id-empresa/arca/cotizacion/:monId?date=AAAAMMDD

Devuelve la cotización que ARCA toma como referencia para un comprobante en esa moneda: el tipo vendedor del Banco Nación al cierre del día hábil anterior a la fecha del comprobante. date es la fecha del comprobante; sin ella, hoy. Una fecha posterior a hoy se consulta como hoy, que es lo que hace ARCA en ese caso.

curl "https://nanofactura.com/api/<id-empresa:cambiar>/arca/cotizacion/DOL?date=20261026" -H "Authorization: Bearer PROD_tu_api_key"
{
"ok": true,
"result": {
"currencyId": "DOL",
"referenceDate": "20261026",
"rate": 1350.5,
"quoteDate": "20261023",
"skippedDates": [],
"cache": { "hit": true, "stale": false, "fetchedAt": "2026-10-26T12:10:41.000Z" }
}
}
CampoQué es
rateLa cotización contra el peso. Es la que conviene mandar en currency.quotation
referenceDateLa fecha para la que se consultó
quoteDateLa fecha de la cotización que informó ARCA
skippedDatesLos días hábiles anteriores sin cotización en ARCA, como un feriado, que se saltearon hasta quoteDate. Vacío si se usó la del día hábil anterior
cacheDe dónde salió el dato, igual que en el padrón

Sirve para dos reglas de la emisión:

  • Con currency.quotation lejos de la de ARCA, el comprobante se rechaza (código 10119).
  • Con cancelsInSameForeignCurrency: "S", la cotización tiene que ser exactamente ésta (código 10038).

PES responde siempre 1. Un código que no es de ARCA responde 400; los códigos están en Monedas.

Condiciones de IVA admitidas​

GET /:id-empresa/arca/condicion-iva-receptor?claseCmp=A|B|C

Devuelve el catálogo de condiciones de IVA que ARCA acepta, opcionalmente filtrado por clase de comprobante. Sirve para poblar un desplegable en tu interfaz sin hardcodear la lista, y para verificar qué combinaciones son válidas.

La tabla completa, con los códigos: Condiciones de IVA.

Diagnóstico de la conexión​

GET /:id-empresa/arca/status

Prueba en paralelo, contra el entorno de tu clave, la disponibilidad de los servidores de ARCA y la autenticación con tu certificado:

{
"ok": true,
"environment": "PRODUCTION",
"certificateAlias": "nanofactura-prod",
"dummy": { "AppServer": "OK", "DbServer": "OK", "AuthServer": "OK", "duration": 412 },
"wsfe": { "ok": true, "error": null, "helpText": null, "reusedTicket": true, "duration": 890 }
}

Cuando algo falla, error trae el mensaje de ARCA y helpText una explicación en castellano de qué suele causarlo. Es la primera llamada a hacer cuando la emisión empieza a fallar y no sabés de qué lado está el problema.

BloqueQué prueba
dummyLos servidores de ARCA están arriba
wsfeTu certificado autentica contra facturación electrónica

reusedTicket indica que la prueba usó el Ticket de Acceso que ya estaba vigente en lugar de pedir uno nuevo. ARCA entrega un solo ticket por certificado, servicio y entorno, dura 12 horas y no se puede revocar: pedir otro mientras vive devuelve El CEE ya posee un TA valido. Que haya un ticket vigente ya demuestra que ese certificado autentica contra ese servicio.

Si wsfe falla pero dummy está OK, el problema es tuyo: casi siempre falta habilitarle la facturación al certificado.

Estado de los servidores​

GET /:id-empresa/arca/dummy

La versión liviana: sólo el estado de los servidores de ARCA, sin usar el certificado.

{ "AppServer": "OK", "DbServer": "OK", "AuthServer": "OK" }

Útil para distinguir "ARCA se cayó" de "mi configuración está mal" cuando aparecen errores 502 ARCA_CONNECTION_ERROR. Si acá algo no dice OK, el problema no es tuyo: esperá y reintentá.

Estos endpoints tienen más tiempo

Las rutas /arca/* tienen un techo de 25 segundos en vez de los 15 habituales, porque dependen de la respuesta de los servidores de ARCA. Ver Límites.