> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# PGFN
> Lo que las empresas brasileñas deben a la Unión: busca toda deuda activa tributaria federal, de seguridad social y del FGTS en la dívida ativa por CNPJ, nombre, estado, situación y monto, y suma las deudas de una empresa.
La Procuradoria-Geral da Fazenda Nacional inscribe en la dívida ativa toda
deuda federal que una empresa no ha pagado: tributos como IRPJ, COFINS, PIS y
el Simples Nacional, contribuciones a la seguridad social y el FGTS. Cada
deuda viene con su situación (en cobro, negociada, garantizada, suspendida por
un juez), si está en ejecución judicial y su monto consolidado. Estas
inscripciones son públicas por ley (CTN art. 198 §3 II).
Solo empresas: unos 33 millones de deudas, actualizadas cada vez que la PGFN
publica su corte trimestral. Busca sobre todas, o consulta una empresa por
CNPJ, o por su raíz de 8 caracteres para todos sus establecimientos, y obtén
lo que debe en total.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar deudas
`POST /br/pgfn/debts-search/v1` Dataset
Busca en todas las deudas de empresas por cualquier combinación de nombre, CNPJ o
raíz, tipo de deuda, estado, situación, papel, ejecución judicial y monto.
| Campo | Tipo | Notas |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre de la empresa; sin lematización. |
| `document_number` | string | Opcional. Un CNPJ, con o sin puntuación, o su raíz de 8 caracteres para todos sus establecimientos. |
| `regime` | enum | Opcional. `nao_previdenciario`, `previdenciario` o `fgts`. |
| `state` | string | Opcional. El estado de la empresa, p. ej. `SP`. |
| `status_type` | enum | Opcional. `in_collection`, `tax_benefit`, `guaranteed`, `suspended_by_court` o `in_negotiation`. |
| `debtor_type` | enum | Opcional. `principal`, `co_responsible` o `joint`. |
| `in_court` | enum | Opcional. `yes`, `no` o `any`. Por defecto `any`. |
| `amount_min` | number | Opcional. Monto mínimo en reales. Por defecto `0`. |
| `amount_max` | number | Opcional. Monto máximo en reales; `0` sin límite. Por defecto `0`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/br/pgfn/debts-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "construtora", "in_court": "yes", "per_page": 10 }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `debts[]`, de mayor a menor monto.
Cada deuda incluye `regime` (`nao_previdenciario`, `previdenciario` o `fgts`), `inscription_number`, `document_number` (el CNPJ, 14 caracteres), `document` (`12.345.678/0001-90`), `cnpj_root`, `debtor_name`, `debtor_type` (`principal`, `co_responsible` o `joint`), `state`, `responsible_unit`, `registering_unit` (FGTS), `collecting_entity` (`pgfn` o `caixa`), `status_type` (`in_collection`, `tax_benefit`, `guaranteed`, `suspended_by_court` o `in_negotiation`), `status` (la redacción detallada de la PGFN), `revenue_type`, `registered_on` (`yyyy-mm-dd`), `in_court`, `amount` (reales, consolidado con los cargos legales) y `reference_month` (`yyyy-mm` de la publicación).
Una inscripción con varios deudores tiene una fila por cada uno, y cada fila
lleva el `amount` de toda la inscripción. Suma solo las filas `principal`; la
consulta de deudor de abajo lo hace por ti.
## Las deudas de una empresa
`POST /br/pgfn/debtor/v1` Dataset
Suma lo que una empresa debe a la Unión, por CNPJ o por raíz.
| Campo | Tipo | Notas |
| ----------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** Un CNPJ, p. ej. `33.000.167/0001-01`, o su raíz de 8 caracteres, p. ej. `33000167`, para sumar todos los establecimientos. |
```bash theme={"dark"}
curl https://api.croma.run/br/pgfn/debtor/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document_number": "33.000.167/0001-01" }'
```
Devuelve `found`, `document_number`, `as_of`, `reference_month`, `debtor_name`, `totals` y `debts[]` (las 50 mayores).
`totals` incluye `debts` (toda deuda en la que aparece la empresa), `principal_debts`, `principal_amount` (lo que la empresa debe como deudora principal, en reales), `in_court_amount`, `by_regime` (`{ debts, amount }` por tipo de deuda) y `complete` (false cuando la empresa tiene más de 10.000 deudas y solo se sumaron las mayores). Las deudas corresponsables y solidarias cuentan en `debts` pero no en los montos, porque repiten el monto de otro deudor.
Una empresa que no debe a la Unión nada inscrito por la PGFN devuelve
`found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.