# ConsultaCUIT

> Consulta pública y gratuita de datos fiscales por CUIT en Argentina, a partir del padrón
> oficial de AFIP/ARCA. Diseñada API-first: los agentes de IA pueden obtener datos
> estructurados (JSON) por CUIT o buscar por nombre / razón social. Sin registro ni token.

Base de la API: `https://consultacuit.fluxorhub.com`
Toda respuesta incluye `fuente` ("AFIP") y `padron_snapshot_date` (fecha del padrón).

## Cómo trabajar con el servicio (agentes)

- Para validar o describir un CUIT, usá `GET /v1/cuit/{cuit}` (11 dígitos, sin guiones).
- Para encontrar el CUIT de una persona o empresa por su nombre, usá `GET /v1/search?q=...`.
- Antes de confiar en el dato, mirá `padron_snapshot_date`: es un padrón que se actualiza
  cada pocos días, no tiempo real.
- Distinguí los estados: `400` = CUIT con dígito verificador inválido; `404` = CUIT válido
  pero sin actividad tributaria en el padrón; `200` = encontrado.
- Respetá el rate limit de `/v1/search` (30 req/min por IP).

## Endpoints

- [GET /v1/cuit/{cuit}](https://consultacuit.fluxorhub.com/v1/cuit/30546689979): ficha fiscal
  (denominación, tipo de persona, situación IVA/Ganancias/Monotributo, empleador). Devuelve
  etiquetas humanas y también los códigos crudos del padrón.
- [GET /v1/search?q=](https://consultacuit.fluxorhub.com/v1/search?q=ypf): búsqueda por
  nombre / razón social (reverse: nombre → CUIT).
- [GET /v1/health](https://consultacuit.fluxorhub.com/v1/health): estado + cantidad de registros.

## Especificación

- [OpenAPI](https://consultacuit.fluxorhub.com/openapi.json): esquema completo para
  auto-descubrimiento y generación de clientes.

## Documentación

- [Referencia de la API](https://consultacuit.fluxorhub.com/api)
- [Qué es el CUIT](https://consultacuit.fluxorhub.com/que-es-el-cuit)
- [Condiciones fiscales (glosario)](https://consultacuit.fluxorhub.com/condiciones-fiscales)

## Alcance y límites

- Fuente: padrón público de AFIP/ARCA (acceso público e irrestricto). Cubre ~6,2M de CUITs
  con condición tributaria; no incluye personas sin actividad tributaria.
- No expone datos protegidos (RENAPER, ANSES individual). No es un informe crediticio.