Perfil do Produtor

Consolida dados de múltiplas fontes (Receita Federal, SEFAZs, CNDs) em uma visão unificada do produtor rural.

GET /api/perfil-produtor

Retorna o perfil completo de um produtor rural, consolidando dados de múltiplas fontes em uma única chamada. Retorna o perfil completo de um produtor rural, consolidando dados de múltiplas fontes em uma única chamada.

Este endpoint pode demorar mais para responder, pois consulta múltiplas fontes simultaneamente. Considere usar um timeout adequado na sua aplicação.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de consulta

Você deve informar pelo menos um dos parâmetros cpf ou cnpj.

Name	Type	Required	Description
`cpf`	string	Não	CPF do produtor (somente números, 11 dígitos).
`cnpj`	string	Não	CNPJ do produtor (somente números, 14 dígitos).

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/perfil-produtor?cnpj=12345678000199" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/perfil-produtor?cnpj=12345678000199",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.receita_federal);
console.log(data.inscricoes_estaduais);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/perfil-produtor",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
)
data = response.json()
print(data["receita_federal"])
print(data["inscricoes_estaduais"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/perfil-produtor', [
    'cnpj' => '12345678000199',
]);
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/perfil-produtor?cnpj=12345678000199"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

A resposta consolida dados de três fontes independentes. Cada seção pode ser null caso a fonte correspondente não retorne dados ou falhe.

Campos de nível superior

Campo	Tipo	Descrição
`request_id`	string	Identificador único da requisição (UUID).
`document`	string	Documento enviado na consulta.
`receita_federal`	object \| null	Dados cadastrais da Receita Federal (CNPJ).
`inscricoes_estaduais`	object \| null	Inscrições estaduais encontradas em todos os estados.
`cnd_estaduais`	object \| null	Certidões negativas de débitos estaduais.

Campos de `receita_federal`

Campo	Tipo	Descrição
`request_id`	string	ID da sub-requisição.
`cnpj`	string	CNPJ consultado.
`cached`	boolean	Indica se o resultado veio do cache.
`source_status`	object	Status da consulta (`status`: `success` ou `error`).
`result`	object	Dados cadastrais do CNPJ.

Campos de `inscricoes_estaduais`

Campo	Tipo	Descrição
`request_id`	string	ID da sub-requisição.
`document`	string	Documento consultado.
`document_type`	string	Tipo do documento: `cpf` ou `cnpj`.
`results`	array	Lista de resultados por UF, cada um contendo `uf`, `source_status` e `results`.

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "document": "12345678000199",
  "receita_federal": {
    "request_id": "uuid",
    "cnpj": "12345678000199",
    "cached": false,
    "source_status": { "status": "success" },
    "result": {
      "razao_social": "AGROPECUARIA BOA VISTA LTDA",
      "nome_fantasia": "FAZENDA BOA VISTA",
      "situacao_cadastral": "ATIVA",
      "cnae_principal_codigo": "0151-2/01",
      "cnae_principal_descricao": "CRIACAO DE BOVINOS PARA CORTE"
    }
  },
  "inscricoes_estaduais": {
    "request_id": "uuid",
    "document": "12345678000199",
    "document_type": "cnpj",
    "results": [
      {
        "uf": "MT",
        "source_status": { "status": "success" },
        "results": [
          {
            "inscricao_estadual": "13.123.456-7",
            "razao_social": "AGROPECUARIA BOA VISTA LTDA",
            "situacao_ie": "ATIVA",
            "uf_ie": "MT"
          }
        ]
      }
    ]
  },
  "cnd_estaduais": null
}

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	Nenhum documento (cpf ou cnpj) foi informado.
`TODAS_FONTES_FALHARAM`	502	Todas as fontes de dados falharam ao processar a consulta.

Esta pagina foi util?

Perfil do Produtor

On this page