Empresas
Pessoas jurídicas atendidas pela organização.
Listar empresas
Lista as empresas ativas da organização dentro do escopo de empresas de quem chama, com as etiquetas de cada uma. Requer a permissão `identity.companies.read`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Criar empresa
Cadastra uma empresa pelo `cnpj` (validado; inválido retorna `400` `cnpj_invalid`) e `legal_name`, gerando o código da empresa. A primeira empresa da organização vira a principal, e `group_name` cria ou reaproveita o grupo de empresas. Requer a permissão `identity.companies.create`. CNPJ já cadastrado retorna `409`.
Consultar CNPJ no cadastro público
Busca os dados públicos de um CNPJ (razão social, situação, endereço, CNAEs, sócios) para preencher o cadastro, com cache. Requer a permissão `identity.companies.create` ou `identity.companies.update`. CNPJ inválido retorna `400`, não encontrado `404`, fontes indisponíveis `503`; limite de consultas por organização (`429`).
Consultar empresa
Retorna a empresa com grupo e etiquetas. Requer a permissão `identity.companies.read`. O `company_id` é o código público de 4 caracteres da empresa; empresa inexistente, removida ou fora do escopo de empresas da pessoa retorna `404`.
Atualizar empresa
Altera apenas os campos enviados, incluindo o grupo (`group_id` ou `group_name`). `cnpj` e `code` não podem ser alterados (`400`). Requer a permissão `identity.companies.update`. O `company_id` é o código público de 4 caracteres da empresa; empresa inexistente, removida ou fora do escopo de empresas da pessoa retorna `404`.
Remover empresa
Marca a empresa como removida, retira-a do escopo das pessoas e remove suas etiquetas; responde `204`. Requer a permissão `identity.companies.delete`. O `company_id` é o código público de 4 caracteres da empresa; empresa inexistente, removida ou fora do escopo de empresas da pessoa retorna `404`.