> ## 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.

# CNR

> Busque as inscrições de sociedades que o Registro de Comercio de El Salvador publica, de matrículas, transferências e cancelamentos a balanços e atos societários, e consulte as inscrições de uma sociedade pelo seu número de expediente.

O Registro de Comercio do Centro Nacional de Registros de El Salvador publica, em seu boletim bimestral (o Boletín del Órgano Oficial del Registro de Comercio), cada inscrição que realiza: matrículas de empresas e de seus estabelecimentos, suas transferências e cancelamentos, balanços depositados e atos societários como constituições, alterações, liquidações, dissoluções, transformações e fusões. Um boletim reúne vários milhares de inscrições, e cada uma traz seu extrato, o aviso que o Registro publica com os livros e assentos em que foi inscrita, o endereço da sociedade, suas atividades, o ativo declarado ou o capital e o valor do balanço. São guardadas as inscrições desde janeiro de 2024, cada extrato idêntico byte a byte; o boletim em curso é lido de novo todos os dias à medida que o Registro o completa.

Busque por razão social (comparada pela grafia, então um erro de digitação ou um acento faltando ainda a encontram), tipo de inscrição, departamento ou data, e depois consulte tudo o que uma sociedade inscreveu pelo seu número de expediente, inclusive se a matrícula foi cancelada.

> [!NOTE]
>
> A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](https://docs.usecroma.com/pt/datasets.md).

## Buscar inscrições

`POST /sv/cnr-sv/filings-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

Uma única busca sobre todas as inscrições de sociedades, por nome, tipo, departamento ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Razão social opcional, p. ex. `Zonte` ou `Viajes y Mudanzas Cubias`, comparada pela grafia com a razão social, a abreviatura e o nome comercial. |
| `filing_type` | enum | Tipo opcional: `matricula_registration`, `matricula_transfer`, `matricula_cancellation`, `opening_balance`, `balance`, `liquidation_balance`, `incorporation`, `amendment`, `liquidation`, `dissolution`, `transformation` ou `merger`. |
| `department` | enum | Departamento de El Salvador opcional, p. ex. `San Salvador`, `La Libertad`, `Cabañas`. |
| `from_date` | string | Opcional: só inscrições desta data ou posteriores, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só inscrições desta data ou anteriores, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/sv/cnr-sv/filings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Zonte", "filing_type": "matricula_registration" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`: primeiro a grafia mais próxima quando há `query`, senão as mais recentes. Cada inscrição traz `id` (seu id permanente, p. ex. `matricula-517-382-1`), `filing_type`, `service` (o serviço com que o Registro a lista), `company_name`, `company_abbreviation`, `file_number` (o N° de expediente da sociedade, quando o boletim o lista), `registered_on`, `bulletin_period` (`aaaa-n`, n de 1 para janeiro-fevereiro a 6 para novembro-dezembro), `entry_book` e `entry_number` (onde foi inscrita) e o que diz o extrato: para uma matrícula `incorporation_book`, `incorporation_number`, `trade_name`, `activities`, `address`, `municipality`, `declared_assets`; para um ato societário `purpose`, `term`, `capital`; para um balanço `balance_date`, `balance_kind`, `balance_amount`, `deposit_number`, `presentation_number`; e `nationality`, `domicile`, `department`. `document_url` é a cópia da Croma do extrato que o boletim publica, idêntica byte a byte, que continua disponível aconteça o que acontecer na fonte; `source_document_url` é o próprio boletim.

> [!NOTE]
>
> Só sociedades. O boletim também publica inscrições de comerciantes individuais; essas não são guardadas.

## Uma sociedade

`POST /sv/cnr-sv/company/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

| Campo | Tipo | Notas |
| - | - | - |
| `file_number` | string | **Obrigatório.** O número de expediente da sociedade, p. ex. `2026136080`, como `file_number` em um resultado de busca. |

```bash theme={"dark"}
curl https://api.croma.run/sv/cnr-sv/company/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "file_number": "2026136080" }'
```

Retorna `as_of`, `found`, `file_number`, `company_name`, `company_abbreviation`, `cancelled` (se o boletim publicou o cancelamento da matrícula), `count` e `filings[]`, da mais recente à mais antiga: as inscrições sob o seu número de expediente e os balanços e atos societários que o boletim publica sob a sua razão social. Cada inscrição traz `id` (seu id permanente, p. ex. `matricula-517-382-1`), `filing_type`, `service` (o serviço com que o Registro a lista), `company_name`, `company_abbreviation`, `file_number` (o N° de expediente da sociedade, quando o boletim o lista), `registered_on`, `bulletin_period` (`aaaa-n`, n de 1 para janeiro-fevereiro a 6 para novembro-dezembro), `entry_book` e `entry_number` (onde foi inscrita) e o que diz o extrato: para uma matrícula `incorporation_book`, `incorporation_number`, `trade_name`, `activities`, `address`, `municipality`, `declared_assets`; para um ato societário `purpose`, `term`, `capital`; para um balanço `balance_date`, `balance_kind`, `balance_amount`, `deposit_number`, `presentation_number`; e `nationality`, `domicile`, `department`. `document_url` é a cópia da Croma do extrato que o boletim publica, idêntica byte a byte, que continua disponível aconteça o que acontecer na fonte; `source_document_url` é o próprio boletim.

> [!NOTE]
>
> Um número de expediente que a cópia não tem retorna `found: false` com HTTP 200, não um erro.

> **[Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)**
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.