Restrição de CNPJ direto na sua planilha

Da chave à primeira resposta

1. Receba sua chave

   A chave tem 40 caracteres e começa em mk_live_. Ela é emitida por nós e mostrada uma única vez: guardamos apenas o hash, o que significa que não existe reenviar uma chave perdida. Se sumir, emitimos outra e revogamos a anterior.

2. Chame a API com o header x-api-key

   Toda rota é GET e devolve JSON.

   # ficha cadastral + quadro societário
   curl -H "x-api-key: $CHAVE" \
     https://api.monitore.ai/api/v1/empresas/33000167000101
   
   # as nove categorias de restrição numa chamada só
   curl -H "x-api-key: $CHAVE" \
     https://api.monitore.ai/api/v1/empresas/33000167000101/restricoes

3. Ou puxe direto no Excel

   Dados → Obter Dados → De Outras Fontes → Consulta em Branco → Editor Avançado. Cole o código abaixo e troque só a chave. Quando o Excel pedir credencial, escolha Anônima — a chave já vai no header.

   let
       Chave = "mk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
       Cnpj  = "33000167000101",
       Resposta = Json.Document(
           Web.Contents(
               "https://api.monitore.ai",
               [
                   RelativePath = "api/v1/empresas/" & Cnpj,
                   Headers = [#"x-api-key" = Chave]
               ]
           )
       ),
       Socios = try Resposta[socios] otherwise {},
       Tabela = Table.FromList(Socios, Splitter.SplitByNothing(), null, null, ExtraValues.Error),
       Expandida = Table.ExpandRecordColumn(
           Tabela, "Column1",
           {"nome_socio", "cnpj_cpf_socio", "qualificacao_socio"},
           {"Sócio", "CPF mascarado", "Qualificação"}
       )
   in
       Expandida

   Use RelativePath, não uma URL montada

   Concatenar o CNPJ na URL faz o Excel tratar cada consulta como uma fonte de dados nova e quebrar a atualização automática com o erro de dynamic data source.

Uma chamada, nove categorias

GET /api/v1/empresas/{cnpj}/restricoes responde "tem pendência?" de uma vez. Pedir categoria a categoria custaria nove requisições pelo mesmo resultado.

{
  "cnpj": "33000167000101",
  "resumo": {
    "severidade": "ambar",      // pior severidade entre as categorias
    "parcial": false,           // true = alguma categoria falhou
    "total": 3,
    "categorias": [
      { "categoria": "financeiro", "natureza": "multa",
        "sujeitos": ["empresa", "socio"],
        "n": 0, "nEmpresa": 0, "nSocios": 0, "severidade": null,
        "historico": false, "ambiguo": false, "indisponivel": false },
      { "categoria": "mercadoCapitais", "natureza": "processo",
        "sujeitos": ["empresa", "socio"],
        "n": 3, "nEmpresa": 1, "nSocios": 2, "severidade": "ambar",
        "historico": false, "ambiguo": false, "indisponivel": false }
    ]
  },
  "consultas": { /* detalhe de cada categoria, ou null */ }
}

Como ler a severidade