Padrón — Descripción general
Consultá la condición fiscal de CUITs en los servicios de padrón de ARCA
Los endpoints de padrón te permiten consultar la condición fiscal de personas físicas y jurídicas inscriptas en ARCA, sin montar la integración SOAP por tu cuenta.
Entornos
Cada consulta se ejecuta contra uno de los dos entornos de ARCA:
| Valor | Descripción |
|---|---|
homologacion | Ambiente de pruebas. Los datos de padrón pueden ser limitados o de prueba. |
produccion | Ambiente productivo. Requiere certificado de producción emitido por ARCA. |
Representada
Toda consulta de padrón requiere indicar una representada: uno de tus CUITs con certificado válido en el entorno elegido. La representada firma el ticket WSAA con su certificado; el resultado de la consulta es independiente de qué representada lo firmó (el dato de padrón es el mismo para todos).
Cache compartido
Las respuestas se cachean en base de datos por (cuit_consultado, servicio, entorno), compartido entre todas las cuentas. Esto reduce las llamadas a ARCA y mejora la latencia.
- Resultado exitoso: TTL configurable, máximo 10 días (
PADRON_CACHE_TTL_OKen segundos). - No encontrado: TTL más corto por defecto 1 día (
PADRON_CACHE_TTL_MISSen segundos).
La respuesta incluye el campo "cached": true/false para indicar si el dato proviene del cache o de una llamada fresca.
Formato de respuesta
Todas las operaciones devuelven la misma estructura base:
{
"cached": false,
"found": true,
"data": { ... }
}Cuando el CUIT o documento no existe en el padrón:
{
"cached": false,
"found": false,
"reason": "CUIT no encontrado en el padrón"
}Autenticación
Todos los endpoints requieren una API key válida en el header Authorization: Bearer <key>. Ver API keys.