O endpoint /api/CAF-PJ permite consultar os dados cadastrais de uma pessoa jurídica vinculada ao CAF a partir do CNPJ, retornando informações sobre registro, enquadramento, representante legal, composição societária e distribuição geográfica dos associados.
CAF - Cadastro Nacional de Agricultura Familiar - PJ
Sistema oficial do governo federal para registro e consulta de agricultores familiares, cooperativas e associações rurais. Centraliza informações cadastrais e emite extratos que comprovam regularidade para acesso a políticas públicas, crédito rural e programas do setor.
Casos de Uso
- Onboarding de cooperativas e associações rurais
- Validação de elegibilidade para crédito rural PJ
- Verificação de regularidade para programas governamentais
- Análise cadastral de entidades do agronegócio familiar
- Processos de compliance e validação documental.
Aplicações
- Onboarding de Clientes e Fornecedores
Benefícios
- Acesso à base oficial do governo federal (CAF)
- Validação confiável de cooperativas e associações
- Redução de riscos em concessão de crédito rural
- Visão estruturada da composição societária
- Integração simples com sistemas de cadastro e análise.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/CAFCadastroNacionalAgriculturaPJEndpoint
GET https://apiv3.directd.com.br/api/CAFCadastroNacionalAgriculturaPJ?CNPJ={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas CAF - Cadastro Nacional de Agricultura Familiar - PJ.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Cadastrador: Informa o nome da entidade cadastradora.
- Categoria: Nome da Categoria
- CNPJ: CNPJ da empresa
- CNPJ Entidade: Informa o documento CNPJ da entidade.
- CPF: CPF do indivíduo
- CPF do Representante: Informa o documento CPF do representante.
- Data da Constituição: Informa a data da constituição do registro.
- Data de Emissão: Data da emissão do certificado
- Data de Inscrição: Data de inscrição
- Data de Validade: Data de validade da certidão
- Data do Último Extrato: Informa a data do último extrato do documento.
- Data do Último Upload de Associados: Informa a última data de upload dos associados.
- Emissor: Descreve o emissor da certidão
- Entidade Principal: Entidade responsável pela dívida
- Lista da Composição Societária: Lista a composição societária.
- Lista de Sócios Por Município: Retorna uma lista informando a quantidade de sócios da entidade separados por municípios.
- Município: Município/cidade referente ao registro
- Nome: Nome do indivíduo/registro
- Número CAF: Informa o número CAF da entidade.
- Participação Relativa: Informa a participação do sócio na sociedade.
- Quantidade: Quantidade de registros
- Razão Social: Razão social da empresa
- Representante Legal: Retorna as informações do representante legal do registro.
- Situação: Situação do registro em questão
- Tipo de Pessoa Jurídica: Informa o tipo de pessoa jurídica.
- UF: Unidade Federativa (estado) referente ao registro
- Última Atualização: Informa a data da última atualização.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"cnpj": "string",
"razaoSocial": "string",
"numeroCaf": "string",
"situacao": "string",
"dataInscricao": "string",
"ultimaAtualizacao": "string",
"dataEmissao": "string",
"dataValidade": "string",
"dataUltimoExtrato": "string",
"dataUltimoUploadAssociados": "string",
"tipoPessoaJuridica": "string",
"dataConstituicao": "string",
"municipio": "string",
"uf": "string",
"representanteLegal": "string",
"cpfRepresentante": "string",
"entidadeResponsavel": "string",
"cnpjEntidade": "string",
"cadastrador": "string",
"emissor": {
"nome": "string",
"cpf": "string"
},
"composicaoSocietaria": [
{
"categoria": "string",
"quantidade": 0,
"participacaoRelativa": "string"
}
],
"sociosPorMunicipio": [
{
"municipio": "string",
"uf": "string",
"quantidade": 0
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Para obter o comprovante desta consulta, utiliza-se: '&GerarComprovante=habilitar' na URL
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228