💡Esta API reúne informações consolidadas de várias fontes sobre a situação cadastral de uma pessoa jurídica. A consulta abrange cadastros como Licitantes Inidôneos (TCU), Cadastro Nacional de Condenações Cíveis por Ato de Improbidade Administrativa e Inelegibilidade (CNJ), Cadastro Nacional de Empresas Inidôneas e Suspensas (CEIS) e Cadastro Nacional de Empresas Punidas (CNEP). Ideal para análises de conformidade ESG e risco de crédito.


Introdução

A API TCU - Consulta Consolidada de Pessoa Jurídica - APF consolida os dados de diferentes fontes oficiais para verificar a situação de empresas. É uma ferramenta indispensável para auditorias, processos de compliance, análises de risco e verificação de elegibilidade em contratos públicos.


URL Base

https://api.directd.com.br

Endpoint

GET /api/TCUConsultaConsolidadaPessoaJuridica

Descrição: Retorna informações consolidadas de múltiplos cadastros relacionados à situação de uma pessoa jurídica.


Autenticação

  • Um token válido é obrigatório e deve ser enviado como parâmetro na URL.
  • Para suporte sobre o token, entre em contato com suporte@directd.com.br.

Campos da API

Informações Gerais

  • Razão Social
  • Nome Fantasia
  • CNPJ
  • UF: Unidade federativa da empresa.

Certidões

Cada item da lista de certidões contém:

  • Emissor: Origem da certidão (Ex.: TCU, CNJ).
  • Tipo: Tipo da certidão.
  • Data de Emissão: Data em que a certidão foi emitida.
  • Descrição: Detalhamento do registro.
  • Flag Sanção: Indica se há sanções associadas.
  • Status: Situação da certidão.

Parâmetros

NomeTipoObrigatórioDescrição
CNPJstringSimCNPJ da empresa a ser consultada.
TOKENstringSimToken de autenticação para acessar a API.
GERARCOMPROVANTEstringNãoGera comprovante PDF da consulta.

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/TCUConsultaConsolidadaPessoaJuridica?CNPJ=12345678000195&TOKEN=seu_token_aqui'

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "TCU - Consulta Consolidada de Pessoa Jurídica - APF",
    "consultaUid": "directd-123456",
    "usuario": "Cliente",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 1500
  },
  "retorno": {
    "razaoSocial": "Empresa Exemplo LTDA",
    "nomeFantasia": "Exemplo Comércio",
    "cnpj": "12.345.678/0001-95",
    "uf": "SP",
    "certidoes": [
      {
        "emissor": "TCU",
        "tipo": "Licitantes Inidôneos",
        "dataEmissao": "2024-01-10",
        "descricao": "Apto para licitações",
        "possuiSancao": false,
        "status": "Regular"
      },
      {
        "emissor": "CNJ",
        "tipo": "Cadastro de Condenações Cíveis",
        "dataEmissao": "2024-01-10",
        "descricao": "Sem registros de improbidade administrativa",
        "possuiSancao": false,
        "status": "Regular"
      }
    ]
  }
}

Erros Comuns

CódigoDescrição
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
403Não autorizado: saldo insuficiente para realizar a consulta.
404Não encontrado: registro não localizado.
408Tempo esgotado: consulta não foi concluída no prazo.
500Erro interno: falha no processamento da consulta.
503Serviço em manutenção: indisponível temporariamente.

Notas Importantes

  1. Certidões Consolidadas: A consulta retorna dados consolidados de diversas fontes oficiais.
  2. Atualização Frequente: As informações são atualizadas conforme os bancos de dados oficiais.
  3. Consulta Individual: Apenas um CNPJ pode ser consultado por vez.
  4. PDF Opcional: Adicione o parâmetro GERARCOMPROVANTE para obter um PDF oficial da consulta.