Documentación / Primeros pasos

Empezá con Coco Padrones

Usá la consulta web o integrá Coco Padrones a tus sistemas. Esta documentación describe el contrato inicial disponible en el proyecto.

Consulta web

Ingresá el CUIT, la jurisdicción, el régimen y la fecha en la pantalla de consulta. El modo de demostración muestra un ejemplo ilustrativo. Para consultar la API local se requiere un token de prueba.

Consulta por API

Enviá una solicitud GET a /v1/alicuotas con un token Bearer y una clave UUID de idempotencia. Indicá padrón o jurisdicción y régimen; si enviás ambos, se utiliza el padrón. La dirección de la API depende del entorno.

GET /v1/alicuotas?cuit=20123456786&jurisdiccion=ba&regimen=percepcion&fecha=2026-10-03
Authorization: Bearer <token>
Idempotency-Key: 8d6e6625-8801-4014-8e7a-940620753928

El CUIT y los valores del ejemplo son ficticios. No compartas tus credenciales.

Respuestas

200

Consulta resuelta: resultado encontrado o ausencia confirmada. Una alícuota de 0 % es válida.

400

Parámetros inválidos o cobertura no soportada.

401 / 403

Credencial inválida, cuenta suspendida o sin acceso al padrón.

409

La clave de idempotencia ya está asociada a otros parámetros.

429

Cuota mensual agotada.

503

Período no publicado o dependencia no disponible.

Una ausencia confirmada, un período sin publicar y un error de lectura tienen significados distintos. Usá solamente los campos de vigencia o versión cuando la respuesta los incluya.

Consumo y reintentos

Cada resultado resuelto, incluida una ausencia confirmada, consume una consulta. Los errores de lectura no consumen cuota. Para reintentar la misma consulta, reutilizá su clave y parámetros: no se vuelve a descontar durante al menos 24 horas y posiblemente más, hasta que se elimine el registro. Una clave existente con parámetros diferentes produce un conflicto.