Pular para o conteúdo

Conta e empresa

As rotas de conta e empresa usam a raiz de CNPJ vinculada à chave. Elas não representam a conta pessoal de quem criou a credencial e não listam outras empresas às quais essa pessoa tenha acesso.

Todas exigem conta:ler.

GET/v1/contaconta:lerReferência

ID não secreto da credencial, raiz de CNPJ, escopos e expiração.

200 OK
{ "credencial_id": "196086a4-821c-4a7b-b4e4-0dd696046a4b", "cnpj_raiz": "12345678", "escopos": ["conta:ler", "catalogo:ler"], "expira_em": "2027-01-11T16:26:02.032Z" }
GET/v1/empresaconta:lerReferência

CNPJ principal, raiz, razão social e estado da empresa.

200 OK
{ "cnpj": "12345678000195", "cnpj_raiz": "12345678", "razao_social": "MEDEX BRASIL COMERCIO DE PRODUTOS MEDICOS LTDA", "estado": "ativa" }
GET/v1/empresa/capacidadesconta:lerReferência

Plano informado, capacidade e cobertura da vigilância, além da disponibilidade de análise.

Produtos canônicos compartilhados entre filiais contam uma vez. O objeto vigilancia informa:

  • cadastrados, selecionados e elegiveis;
  • capacidade e vagas;
  • modo, versao, direito_ativo, cobertura e exige_selecao.

O objeto analise informa situacao, que pode ser liberada ou limite, e disponivel_em quando houver uma janela vigente de espera.

Consultar capacidade não contrata plano, não muda a seleção, não consome análise e não comprova que uma vigilância foi executada. A operação que solicitar a análise revalida a disponibilidade.

Essas respostas não expõem CPF, e-mail pessoal, membros, endereço, cobrança, segredo da chave ou conteúdo do Catálogo de Produtos. Use os fluxos humanos autorizados para administrar pessoas, credenciais, titularidade e cobrança.