Entidades
Entidades
A ficha completa, com expansão sob demanda. É onde mora o produto.
GET
Entidades
string
required
CNPJ em qualquer formato —
12.345.678/0001-95, 12345678000195 ou
12345678 — ou um id de pessoa devolvido por outra chamada.Você nunca precisa saber como chaveamos internamente: mandar a raiz ou o
estabelecimento chega na mesma empresa. Quando você manda o CNPJ completo, a
gente entende que a filial importa e usa ela nas expansões.string
Lista separada por vírgula:
socios, endereco, doacoes, sancoes.
Expansão desconhecida é ignorada, não quebra a chamada.Expansões e custo
sancoes varre outra base e conta no teto de 60/min em vez de 600/min. A
resposta traz X-Latencia-Estimada-Ms para você dimensionar lotes.
Como ler endereco
Como ler socios
Constar no quadro societário é o que o registro afirma — não é titularidade, não
é controle. O casamento é por nome, com CPF mascarado na origem, então homônimo
é possível.
Como ler sancoes
Cada linha traz evidencia, e a forma carrega a diferença antes da palavra:
decisãouma autoridade decidiu e publicou. É fato, e é publicável.
acusaçãoa empresa é ré num processo. Não é prova de nada.
Ficha de pessoa
GET /api/v1/entidades/***000000**::NOME devolve sociedades, candidaturas e
mandato.
Uma pessoa sem vínculo devolve 200 com listas vazias. Nunca 404: “não achei
nada sobre ela” é resposta, “não existe essa pessoa” seria conclusão.