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

# SIEM

> O diretório de estabelecimentos comerciais do México: busque por nome e obtenha o perfil comercial declarado de cada estabelecimento.

O Sistema de Información Empresarial Mexicano: o diretório empresarial
nacional do México, operado por meio das câmaras empresariais. Busque
estabelecimentos por nome comercial ou razão social, filtre por estado e
atividade SCIAN, e obtenha o perfil declarado: RFC, atividade, endereço e
contato, pessoal, comércio exterior, e produtos e serviços declarados.

## Buscar estabelecimentos

`POST /mx/siem/establishments/v1`

| Campo           | Tipo    | Notas                                                                                                   |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `name`          | string  | **Obrigatório.** Nome comercial ou razão social, 2-200 caracteres. Substring sem distinguir maiúsculas. |
| `state_code`    | integer | Código de entidade INEGI (1-32). Omita ou `0` para buscar em todos os estados.                          |
| `activity_code` | integer | Código de atividade SCIAN (correspondência exata). Omita ou `0` para todas as atividades.               |
| `page`          | integer | Número da página (base 1). 10 por página.                                                               |

```bash theme={"dark"}
curl https://api.croma.run/mx/siem/establishments/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "OXXO", "state_code": 21 }'
```

Retorna `query` (o nome buscado, em maiúsculas), `establishments` e
`pagination` (`total`, `page`, `page_size`, `total_pages`).

| Campo                 | Notas                                            |
| --------------------- | ------------------------------------------------ |
| `establishment_id`    | Id opaco; passe-o ao endpoint de detalhe abaixo. |
| `commercial_name`     | Nome comercial declarado.                        |
| `chamber`             | Câmara empresarial pela qual foi registrado.     |
| `state`, `state_code` | Nome do estado e código INEGI (1-32).            |

## Detalhe do estabelecimento

`POST /mx/siem/establishment/v1`

| Campo              | Tipo   | Notas                                                    |
| ------------------ | ------ | -------------------------------------------------------- |
| `establishment_id` | string | **Obrigatório.** O `establishment_id` da busca anterior. |

```bash theme={"dark"}
curl https://api.croma.run/mx/siem/establishment/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "establishment_id": "3417757" }'
```

Retorna `found`, `establishment_id` e `establishment` (null quando o id é
desconhecido).

| Campo                                                  | Notas                                                                                                                                            |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `rfc`                                                  | RFC, quando declarado.                                                                                                                           |
| `legal_name`, `person_name`                            | Razão social (pessoas jurídicas) ou nome completo (pessoas físicas).                                                                             |
| `commercial_name`                                      | Nome comercial declarado.                                                                                                                        |
| `main_activity`, `activity_code`                       | Atividade principal em texto livre e código SCIAN.                                                                                               |
| `state`, `state_code`, `municipality_code`             | Nome do estado mais códigos INEGI de entidade e município.                                                                                       |
| `status`                                               | Estado do registro (p. ex. `Actualizado`, `Vencido`).                                                                                            |
| `public_listing`                                       | Se o estabelecimento aceitou aparecer na listagem pública.                                                                                       |
| `registration_date`, `updated_date`, `expiration_date` | Datas do registro (`yyyy-mm-dd`).                                                                                                                |
| `location`                                             | Rua, bairro, código postal, município, ruas de referência, telefone, email, site.                                                                |
| `profile`                                              | Data de início, pessoal (total e mulheres), indicadores de exportação/importação, fornecedor do governo, atividades, câmara e grupo empresarial. |
| `products`, `services`                                 | Produtos e serviços declarados.                                                                                                                  |
| `export_countries`, `import_countries`                 | Destinos de exportação e origens de importação declarados.                                                                                       |

<Note>
  O SIEM é um diretório voluntário e autodeclarado: cada estabelecimento
  decide se vai se registrar e quais campos publica. Trate os resultados como
  um perfil comercial declarado, não como prova de existência ou legitimidade,
  e a ausência de resultados como nenhum sinal.
</Note>

<Note>
  Estas consultas podem demorar mais que uma requisição típica. São
  [trabalhos assíncronos](/pt/async-jobs). Por padrão a requisição espera em
  linha e retorna `{ data }`, ou você pode fazer polling ou usar um
  `callback_url`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>