SIEM

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.

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.

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.

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.

Estas consultas podem demorar mais que uma requisição típica. São trabalhos assíncronos. Por padrão a requisição espera em linha e retorna { data }, ou você pode fazer polling ou usar um callback_url.

Referência completa

Esquemas, campos de resposta e um playground interativo.

Primeiros passos

Países

Buscar estabelecimentos

Detalhe do estabelecimento

Referência completa

​Buscar estabelecimentos

​Detalhe do estabelecimento

Referência completa

Buscar estabelecimentos

Detalhe do estabelecimento