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.
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 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" }
}
}
| Campo | Se usa como |
|---|---|
name | customer.name |
address | customer.address — calle, número y localidad, sin la provincia, que viene aparte |
stateId | customer.stateId — puede venir null si no tiene domicilio cargado |
stateName | El nombre de la provincia, para mostrarla. El comprobante la imprime con el domicilio a partir de stateId |
taxCondition | customer.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 |
warning | Sólo cuando ARCA no da la constancia: su motivo, tal como lo dice ARCA |
docType | customer.docType |
docNumber | customer.docNumber — el padrón lo devuelve numérico y la emisión lo espera string: convertilo |
details | La respuesta cruda de ARCA, por si necesitás algo que el mapeo no expone |
cache | De dónde salió el dato —ver abajo— |
cache
| Campo | Qué dice |
|---|---|
hit | true si respondimos con un dato guardado, sin consultar a ARCA en el momento |
stale | true si ese dato estaba vencido y se usó igual porque ARCA no respondió. El dato sirve, pero es viejo |
fetchedAt | Cuá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_FOUND | ARCA no tiene esa clave. |
422 ARCA_ERROR | ARCA 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_ERROR | El 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 ARCA | Qué pasa | Qué 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.
customerSi 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" }
}
}
| Campo | Qué es |
|---|---|
rate | La cotización contra el peso. Es la que conviene mandar en currency.quotation |
referenceDate | La fecha para la que se consultó |
quoteDate | La fecha de la cotización que informó ARCA |
skippedDates | Los 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 |
cache | De dónde salió el dato, igual que en el padrón |
Sirve para dos reglas de la emisión:
- Con
currency.quotationlejos de la de ARCA, el comprobante se rechaza (código10119). - Con
cancelsInSameForeignCurrency: "S", la cotización tiene que ser exactamente ésta (código10038).
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.
| Bloque | Qué prueba |
|---|---|
dummy | Los servidores de ARCA están arriba |
wsfe | Tu 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á.
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.