💡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
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CNPJ | string | Sim | CNPJ da empresa a ser consultada. |
TOKEN | string | Sim | Token de autenticação para acessar a API. |
GERARCOMPROVANTE | string | Não | Gera 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ódigo | Descrição |
---|---|
400 | Requisição inválida: parâmetros incorretos. |
401 | Não autenticado: token inválido ou ausente. |
403 | Não autorizado: saldo insuficiente para realizar a consulta. |
404 | Não encontrado: registro não localizado. |
408 | Tempo esgotado: consulta não foi concluída no prazo. |
500 | Erro interno: falha no processamento da consulta. |
503 | Serviço em manutenção: indisponível temporariamente. |
Notas Importantes
- Certidões Consolidadas: A consulta retorna dados consolidados de diversas fontes oficiais.
- Atualização Frequente: As informações são atualizadas conforme os bancos de dados oficiais.
- Consulta Individual: Apenas um CNPJ pode ser consultado por vez.
- PDF Opcional: Adicione o parâmetro
GERARCOMPROVANTE
para obter um PDF oficial da consulta.