O endpoint /api/CAF permite consultar os dados cadastrais de um agricultor familiar a partir do CPF, retornando informações sobre inscrição, enquadramento, atividade rural, estrutura produtiva e composição familiar.
CAF - Cadastro Nacional de Agricultura Familiar - PF
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 produtores rurais
- Validação de elegibilidade para crédito rural
- Acesso a políticas públicas e programas governamentais
- Análise de perfil socioeconômico de agricultores familiares
- Processos de compliance e verificação cadastral.
Aplicações
- Onboarding de Clientes e Fornecedores
Benefícios
- Acesso direto à base oficial do governo federal
- Dados atualizados sobre agricultores familiares
- Redução de fraudes em concessão de crédito rural
- Facilidade na validação de enquadramento no PRONAF
- 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/ CAFCadastroNacionalAgriculturaPFEndpoint
GET https://apiv3.directd.com.br/api/ CAFCadastroNacionalAgriculturaPF?CPF={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas CAF - Cadastro Nacional de Agricultura Familiar - PF.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Atividade Principal: Informa a atividade principal exercida pela entidade.
- Cadastrador: Informa o nome da entidade cadastradora.
- Caracterização UFPA: Informa a caracterização da UFPA.
- CNPJ Entidade: Informa o documento CNPJ da entidade.
- Condição de Posse e Uso: Informa a condição da posse e uso.
- CPF: CPF do indivíduo
- 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
- Enquadramento PRONAF: Informa o enquadramento no PRONAF da entidade.
- Entidade Principal: Entidade responsável pela dívida
- Flag Mão de Obra Familiar: Informa se há a presença de mão de obra familiar. True(verdadeiro) ou false(falso).
- Lista de Composição Familiar: Retorna uma lista com a composição de todos os membros da família.
- Município: Município/cidade referente ao registro
- Nome: Nome do indivíduo/registro
- Número CAF: Informa o número CAF da entidade.
- Número de Imóveis Explorados: Informa o número de imóveis explorados.
- Relação de Parentesco: Informa a relação de parentesco do indivíduo.
- Situação: Situação do registro em questão
- Tamanho do Imóvel Principal: Informa o tamanho do imóvel principal.
- Total Estabelecimento Hectares: Informa o total de tamanho em hectares do imóvel.
- Total Estabelecimento Metros Quadrados: Informa o total de tamanho em metros quadrados do imóvel.
- 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 |
|---|---|---|---|
CPF | string | Sim | O parâmetro CPF 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": {
"cpf": "string",
"numeroCaf": "string",
"situacao": "string",
"dataInscricao": "string",
"ultimaAtualizacao": "string",
"dataValidade": "string",
"dataEmissao": "string",
"enquadramentoPRONAF": "string",
"atividadePrincipal": "string",
"caracterizacaoUFPA": "string",
"municipio": "string",
"uf": "string",
"numImoveisExplorados": 0,
"condicaoPosseUso": "string",
"tamanhoImovelPrincipal": "string",
"totalEstabelecimentoHA": 0,
"totalEstabelecimentoM2": 0,
"entidadeResponsavel": "string",
"cnpjEntidade": "string",
"cadastrador": "string",
"composicaoFamiliar": [
{
"nome": "string",
"cpf": "string",
"relacaoParentesco": "string",
"maoDeObraFamiliar": true
}
]
}
}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