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

> El directorio de establecimientos comerciales de México: busca por nombre y obtén el perfil comercial declarado de cada establecimiento.

El Sistema de Información Empresarial Mexicano: el directorio empresarial
nacional de México, operado a través de las cámaras empresariales. Busca
establecimientos por nombre comercial o razón social, filtra por estado y
actividad SCIAN, y obtén el perfil declarado: RFC, actividad, dirección y
contacto, personal, comercio exterior, y productos y servicios declarados.

## Buscar establecimientos

`POST /mx/siem/establishments/v1`

| Campo           | Tipo    | Notas                                                                                                    |
| --------------- | ------- | -------------------------------------------------------------------------------------------------------- |
| `name`          | string  | **Obligatorio.** Nombre comercial o razón social, 2-200 caracteres. Subcadena sin distinguir mayúsculas. |
| `state_code`    | integer | Código de entidad INEGI (1-32). Omite o `0` para buscar en todos los estados.                            |
| `activity_code` | integer | Código de actividad SCIAN (coincidencia exacta). Omite o `0` para todas las actividades.                 |
| `page`          | integer | Número de 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 }'
```

Devuelve `query` (el nombre buscado, en mayúsculas), `establishments` y
`pagination` (`total`, `page`, `page_size`, `total_pages`).

| Campo                 | Notas                                               |
| --------------------- | --------------------------------------------------- |
| `establishment_id`    | Id opaco; pásalo al endpoint de detalle de abajo.   |
| `commercial_name`     | Nombre comercial declarado.                         |
| `chamber`             | Cámara empresarial a través de la cual se registró. |
| `state`, `state_code` | Nombre del estado y código INEGI (1-32).            |

## Detalle del establecimiento

`POST /mx/siem/establishment/v1`

| Campo              | Tipo   | Notas                                                           |
| ------------------ | ------ | --------------------------------------------------------------- |
| `establishment_id` | string | **Obligatorio.** El `establishment_id` de la búsqueda 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" }'
```

Devuelve `found`, `establishment_id` y `establishment` (null cuando el id es
desconocido).

| Campo                                                  | Notas                                                                                                                                             |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rfc`                                                  | RFC, cuando fue declarado.                                                                                                                        |
| `legal_name`, `person_name`                            | Razón social (personas morales) o nombre completo (personas físicas).                                                                             |
| `commercial_name`                                      | Nombre comercial declarado.                                                                                                                       |
| `main_activity`, `activity_code`                       | Actividad principal en texto libre y código SCIAN.                                                                                                |
| `state`, `state_code`, `municipality_code`             | Nombre del estado más códigos INEGI de entidad y municipio.                                                                                       |
| `status`                                               | Estado del registro (p. ej. `Actualizado`, `Vencido`).                                                                                            |
| `public_listing`                                       | Si el establecimiento aceptó aparecer en el listado público.                                                                                      |
| `registration_date`, `updated_date`, `expiration_date` | Fechas del registro (`yyyy-mm-dd`).                                                                                                               |
| `location`                                             | Calle, colonia, código postal, municipio, entre calles, teléfono, email, sitio web.                                                               |
| `profile`                                              | Fecha de inicio, personal (total y mujeres), banderas de exportación/importación, proveedor de gobierno, actividades, cámara y grupo empresarial. |
| `products`, `services`                                 | Productos y servicios declarados.                                                                                                                 |
| `export_countries`, `import_countries`                 | Destinos de exportación y orígenes de importación declarados.                                                                                     |

<Note>
  El SIEM es un directorio voluntario y autodeclarado: cada establecimiento
  decide si se registra y qué campos publica. Trata los resultados como un
  perfil comercial declarado, no como prueba de existencia o legitimidad, y la
  ausencia de resultados como ninguna señal.
</Note>

<Note>
  Estas consultas pueden tardar más que una petición típica. Son
  [trabajos asíncronos](/es/async-jobs). Por defecto la petición espera en
  línea y devuelve `{ data }`, o puedes hacer polling o usar un `callback_url`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>