Orientações e respostas da equipe da Direct Data

/api/DAPPessoaFisica

💡 A API DAP - Declaração de Aptidão ao Pronaf fornece informações detalhadas sobre agricultores familiares, suas propriedades rurais e rendas familiares. Este documento é fundamental para o acesso a benefícios do Programa Nacional de Fortalecimento da Agricultura Familiar (Pronaf), incluindo crédito rural e assistência técnica.

Introdução

A API DAP - Declaração de Aptidão ao Pronaf - Pessoa Física facilita a verificação de dados de agricultores familiares e suas propriedades, possibilitando acesso a programas governamentais, análise de risco e conformidade fiscal.

URL Base

A API está hospedada no seguinte endereço:

https://api.directd.com.br

Endpoint

GET /api/DAPPessoaFisica

Descrição: Endpoint para realizar consultas de Declaração de Aptidão ao Pronaf para pessoas físicas.

Nota: É possível gerar comprovantes em PDF utilizando o parâmetro GERARCOMPROVANTE.

Autenticação

Para acessar esta API, é necessário fornecer um token de autenticação.

Regras de Autenticação:

1. O token deve ser enviado como parâmetro na URL da requisição.
2. O token é obrigatório para realizar consultas.

Campos da API

Informações Gerais

• Número DAP: Número da Declaração de Aptidão ao Pronaf.
• Data de Emissão: Data de emissão da DAP.
• Data de Validade: Data de validade da DAP.
• Tipo do DAP: Classificação do tipo de DAP (individual, grupo, etc.).
• Município: Localidade vinculada ao agricultor.
• UF: Unidade Federativa correspondente.

Detalhes do Titular

• CPF: Cadastro de Pessoa Física do titular.
• Nome: Nome completo do titular.
• RG: Registro Geral do titular.
• NIS: Número de Identificação Social.
• Data de Nascimento: Data de nascimento do titular.
• Sexo: Sexo do titular.
• Estado Civil: Estado civil do titular.
• Escolaridade: Nível educacional do titular.
• Regime de Casamento: Regime matrimonial declarado.

Detalhes da Propriedade

• Nome do Imóvel: Nome registrado da propriedade.
• Área Total: Dimensão total da propriedade.
• Área do Estabelecimento: Dimensão da área utilizada para atividades agropecuárias.
• Empregados: Número de empregados na propriedade.
• Imóveis Explorados: Quantidade de imóveis agrícolas sob exploração.

Renda e Produtos

• Renda Agroindustrial: Valor relacionado à atividade agroindustrial.
• Valor Total: Soma total da renda familiar.
• Lista de Produtos: Produtos cultivados e comercializados, incluindo valores auferidos e estimados.

Parâmetros

Exemplo de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/DAPPessoaFisica?CPF=12345678909&DATANASCIMENTO=15/03/1980&TOKEN=seu_token_aqui&GERARCOMPROVANTE=true'

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "DAP - Declaração de Aptidão ao Pronaf - Pessoa Física",
    "consultaUid": "dap-123456",
    "usuario": "Ana",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 1300,
    "gerarComprovante": true,
    "urlComprovante": "https://api.directd.com.br/comprovantes/dap123.pdf"
  },
  "retorno": {
    "numeroDAP": "DAP123456789",
    "dataEmissao": "01/12/2024",
    "dataValidade": "01/12/2025",
    "municipio": "Cidade Exemplo",
    "uf": "SP",
    "titulares": [
      {
        "cpf": "123.456.789-09",
        "nome": "João da Silva",
        "dataNascimento": "15/03/1980",
        "estadoCivil": "Casado",
        "escolaridade": "Ensino Médio Completo",
        "endereco": {
          "logradouro": "Rua das Flores",
          "numero": "123",
          "bairro": "Centro",
          "cep": "12345-678",
          "municipio": "Cidade Exemplo",
          "tipo": "Rural"
        }
      }
    ],
    "imovel": {
      "nome": "Sítio Exemplo",
      "area": "50 hectares",
      "empregados": 2,
      "membrosFamilia": 4
    },
    "renda": {
      "valorTotal": "R$ 30.000,00",
      "produtos": [
        {
          "nome": "Milho",
          "valorAuferido": "R$ 10.000,00",
          "valorEstimada": "R$ 12.000,00"
        }
      ]
    }
  }
}

Erros Comuns

Notas Importantes

• O parâmetro DATANASCIMENTO deve ser fornecido para garantir a precisão da consulta.
• É possível gerar comprovantes em PDF, adicionando um custo de 50% ao valor da consulta.
• Em caso de dúvidas ou suporte, entre em contato pelo e-mail suporte@directd.com.br.