Appearance
ARCA · Padrón fiscal
Padrón de contribuyentes: quién está inscripto, con qué denominación y en qué impuestos. Sirve tanto para personas físicas como jurídicas.
| Slug | arca |
| Modo | LOCAL (réplica propia versionada) |
| Clase de sujeto | Derivada del CUIT (NATURAL_PERSON / LEGAL_ENTITY) |
| Claves aceptadas | cuit, name (denominación) |
| Claves obligatorias | — |
| Payload | arca.padron.v1 |
| Scopes | sources:read + provider:arca |
| Endpoint | POST /api/v1/sources/arca/query |
Consulta
bash
curl -X POST https://tu-host/api/v1/sources/arca/query \
-H "Authorization: Bearer ilk_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "keys": { "cuit": "20111111112" } }'Payload arca.padron.v1
json
{
"cuit": "20111111112",
"denominacion": "JUAN EJEMPLO",
"dniDerivado": "11111111",
"fiscal": {
"impGanancias": "ACTIVO",
"impIva": "ACTIVO",
"monotributo": null,
"integranteSoc": null,
"empleador": "N",
"actividadMonotributo": null
}
}| Campo | Descripción |
|---|---|
cuit | Identificador fiscal (clave de la fuente). |
denominacion | Nombre o razón social tal como figura en el padrón. |
dniDerivado | DNI derivado del CUIT en personas físicas; null en jurídicas. |
fiscal | Situación por impuesto: ganancias, IVA, monotributo, condición de empleador e integrante de sociedad. |
Los valores del bloque fiscal son los códigos del padrón, sin reinterpretar: la API no traduce ni infiere una "condición fiscal" propia.
Cobertura y frescura
- Alcance: padrón de contribuyentes; incluye personas físicas y jurídicas.
- Frescura: réplica local, actualizada por ciclos de ingesta.
- Identidad: el CUIT es la clave; la búsqueda por denominación resuelve por similitud y puede devolver varios sujetos.
En Person Search
Aparece como dimensión fiscal en PERSON_STANDARD y PERSON_ADVANCED. Ahí el scope provider:arca funciona distinto: si falta, la fuente se excluye en silencio del resultado (no es un error). En la consulta directa, sin ese scope la respuesta es 403.
Ver también: Catálogo de fuentes · Payloads por dominio.