CADIN - Cadastro de Entidades Credoras
Procuradoria-Geral da Fazenda Nacional (PGFN)
Versão 2.0 - 08/08/2025
Base / Sistema: Novo Cadin
A API CADIN – Cadastro de Entidades Credoras foi desenvolvida para disponibilizar, de forma padronizada e interoperável, os serviços de gestão dos registros de devedores mantidos no Novo CADIN. A solução permite que entidades credoras autorizadas realizem, diretamente a partir de seus sistemas corporativos, operações de inclusão, consulta, atualização, baixa, suspensão e reativação de registros, além do processamento de remessas de dados em lote, assegurando maior eficiência na administração das informações cadastrais. A integração automatiza os processos de manutenção do cadastro, reduz a necessidade de intervenções manuais, fortalece a rastreabilidade das operações e contribui para a integridade e confiabilidade das informações mantidas no sistema.
Principais Operações
Número do CPF a ser consultado
Nome que está cadastrado no sistema como associado ao CPF solicitado
cpfNúmero do CPF consultado
situaçãoSituação do CPF consultado
codeCódigo HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno
Número do CNPJ a ser consultado
Razão social que está cadastrada no sistema como associado ao CNPJ solicitado
cnpjNúmero do CNPJ consultado
situacaoIndica se o CNPJ solicitado possui alguma pendência no sistema Cadin. Retorna “regular” ou “irregular”
codeCódigo HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno
Número da transação a ser consultada
Número de identificação do contribuinte no Cadin
tipoCpfCnpjSe o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)
nomeNome referente ao registro
numeroTransacaoNúmero da transação como registrado no Cadin
numeroReferenciaNúmero de referência da dívida na entidade credora
complementoReferenciaComplemento da referência
dataComunicacaoData da comunicação do débito
dataInadimplenciaData que deu origem ao débito
origemCódigo de origem da entidade credora
dataAtualizacaoData da última atualização
motivoMotivo da atualização, se houver
tipoAtualizacaoTipo da última atualização realizada no registro
situacaoSituação atual do registro (Ativo, Baixado, Suspenso)
nomeInstituicaoNome da instituição
instrucoesInstruções de regularização, conforme cadastro pela instituição
codeCódigo HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 404: Nenhum registro encontrado 500: Erro interno
Código de origem da entidade credora
niNúmero de identificação do contribuinte no Cadin
referenciaNúmero de referência da dívida na entidade credora
cpf_cnpjDefine se a busca será por 'cpf' ou 'cnpj'
Número de identificação do contribuinte no Cadin
tipoCpfCnpjSe o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)
nomeNome referente ao registro
numeroTransacaoNúmero da transação como registrado no Cadin
numeroReferenciaNúmero de referência da dívida na entidade credora
complementoReferenciaComplemento da referência
dataComunicacaoData da comunicação do débito
dataInadimplenciaData que deu origem ao débito
origemCódigo de origem da entidade credora
dataAtualizacaoData da última atualização
motivoMotivo da atualização, se houver
tipoAtualizacaoTipo da última atualização realizada no registro
situacaoSituação atual do registro (Ativo, Baixado, Suspenso)
nomeInstituicaoNome da instituição
instrucoesInstruções de regularização, conforme cadastro pela instituição
codeCódigo HTTP de retorno: 200: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 404: Nenhum registro encontrado 500: Erro interno
Número da transação a ser afetada
acaoAção a ser realizada no registro: baixar, reativar, suspender
motivoMotivo causador da ação
Código HTTP de retorno: 202: Sucesso; 400: Erro de cadastro; 403: Usuário sem autorização no Conecta.Gov; 500: Erro interno
Número da transação a ser afetada
motivoMotivo da alteração no registro
nomeNome do devedor
Código HTTP de retorno: 202: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno
Código de origem da entidade credora
tipoCpfCnpjSe o Número de identificação do contribuinte no Cadin é um CPF (1) ou CNPJ (2)
cpf_cnpjNúmero de identificação do contribuinte no Cadin
nomeNome
numeroReferenciaNúmero de referência da dívida na entidade credora
complementoReferenciaComplemento da referência
dataComunicacaoData da comunicação do débito
dataInadimplenciaData que deu origem ao débito
isnNúmero de controle da credora
Código HTTP de retorno: 201: Sucesso 400: Erro de cadastro 403: Usuário sem autorização no Conecta.Gov 500: Erro interno
Endpoints
Para utilizar esta API, os Órgãos Públicos Federais, Estaduais e Municipais devem seguir os passos abaixo:
1. Indique seu interesse.
Indique seu interesse enviando um e-mail para o endereço cadin.pgdau@pgfn.gov.br e cda.pgfn@pgfn.gov.br.
2. Preencha, assine e encaminhe a adesão
Você receberá a minuta do ofício de adesão ao Conecta, que deverá ser preenchida, assinada e devolvida para o endereço do e-mail recebido. Ressaltamos os seguintes pontos relativos ao ofício de adesão:
- é preciso a definição clara da finalidade do uso dos dados, de acordo com a Lei Geral de Proteção de Dados Pessoais (LGPD);
- não é necessária a análise jurídica;
- deve ser assinado pelo Dirigente de TI e Responsável Técnico;
- deve haver definição da volumetria anual desejada (de 01/01 a 31/12);
- o ofício de adesão pode incluir outras APIs disponibilizadas pelo Conecta.
3. Esclareça eventuais dúvidas
O Conecta enviará sua solicitação de autorização de acesso para o órgão cedente dos dados, que poderá entrar em contato direto com o órgão solicitante para esclarecer eventuais dúvidas pertinentes à autorização.
4. Receba o resultado da solicitação
Após análise do órgão cedente, o Conecta enviará e-mail com ofício indicando se a solicitação de autorização de acesso à API foi deferida ou não. Em caso de deferimento, serão enviadas também orientações técnicas para acesso à plataforma e geração da chave de acesso para consumo da API. Em caso de indeferimento, o órgão receberá a justificativa.
FAQ - Acesse o link abaixo se está com problema para acessar a API
Para órgão Público Federal, Estadual e Municipal, siga as instruções de adesão ao Conecta gov.br
Quero acessarPGFN/PGDAU (Autorizações e Dúvidas) (Área de Negócio)
cadin.pgdau@pgfn.gov.br
(61) 2025-5100
Horário comercial
PGFN/CDA (Autorizações) (Área de Negócio)
cda.pgfn@pgfn.gov.br
(61) 2025-5100
Horário comercial
PGFN/CGTI (Área Técnica)
cgti.pgfn@pgfn.gov.br cgti.sistemas@pgfn.gov.br
(61) 2025-4804
Horário comercial
