# Perfil do Produtor

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

URL: https://docs.fiscalapi.com.br/docs/enriquecimento/perfil-produtor


`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.

<Callout type="warn">
  Este endpoint pode demorar mais para responder, pois consulta múltiplas fontes simultaneamente. Considere usar um timeout adequado na sua aplicação.
</Callout>

## ## Autenticação

Envie sua chave no header `X-API-Key`. Veja [Autenticação](/docs/getting-started/authentication) 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

<Tabs items="[&#x22;curl&#x22;, &#x22;JavaScript&#x22;, &#x22;Python&#x22;, &#x22;PHP&#x22;, &#x22;C#&#x22;]">
  <Tab value="curl">
    ```bash
    curl -X GET "https://api.fiscalapi.com.br/api/perfil-produtor?cnpj=12345678000195" \
      -H "X-API-Key: fapi_sua_chave_aqui"
    ```
  </Tab>

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

  <Tab value="Python">
    ```python
    import requests

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

  <Tab value="PHP">
    ```php
    $response = Http::withHeaders([
        'X-API-Key' => 'fapi_sua_chave_aqui',
    ])->get('https://api.fiscalapi.com.br/api/perfil-produtor', [
        'cnpj' => '12345678000195',
    ]);
    $data = $response->json();
    ```
  </Tab>

  <Tab value="C#">
    ```csharp
    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=12345678000195"
    );
    var data = await response.Content.ReadAsStringAsync();
    ```
  </Tab>
</Tabs>

## ## 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, com os mesmos campos de [Consultar CNPJ](/docs/enriquecimento/consultar-cnpj#campos-do-resultado-result) (inclusive Simples Nacional, MEI e contato). |

### ### 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

```json
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "document": "12345678000195",
  "receita_federal": {
    "request_id": "uuid",
    "cnpj": "12345678000195",
    "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": "12345678000195",
    "document_type": "cnpj",
    "results": [
      {
        "uf": "MT",
        "source_status": { "status": "success" },
        "results": [
          {
            "inscricao_estadual": "13.123.456-0",
            "razao_social": "AGROPECUARIA BOA VISTA LTDA",
            "situacao_ie": "Habilitado",
            "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. |