Sintegra Produtor Rural – Consulta CPF Produtor Rural

A API oferece uma forma direta e eficiente de consultar informações de Produtores Rurais registrados no Sintegra Produtor Rural. Com ela, é possível verificar a situação cadastral do CPF, identificar enquadramentos específicos e obter dados oficiais vinculados ao cadastro.

Cache: Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O cache é compartilhado entre os clientes da plataforma para melhorar performance e disponibilidade.

Cache Strategy: Define o comportamento da consulta, determinando a prioridade entre utilizar dados em cache e realizar uma nova consulta online no Sintegra Produtor Rural.

Error Fallback: Define se a API poderá utilizar dados em cache como resposta alternativa quando ocorrer erro na consulta online, independentemente da estratégia definida em cache_strategy.

Endereço: Define se a API também deve buscar o endereço da inscrição estadual. Aceita true ou false. Ao informar endereco=true, é contabilizada 1 consulta extra por requisição.

UF: Aceita o código de uma UF brasileira (ex: SP, MG, MT) ou o valor especial BR para consultar todas as UFs de uma vez. Se nenhuma UF for informada, a consulta retornará um erro.

Os valores aceitos para uf são: BR, AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, RJ, RN, RO, RR, RS, SC, SE, SP e TO.

Informações de entrada

Para realizar a consulta, são necessários apenas dois atributos obrigatórios:

Name
cpf
Type
string
Description
Informe o CPF do Produtor Rural - pode ser informado em qualquer padrão de formatação contanto que esteja completo e seja válido. Exemplo: 41012345678

Name
uf
Type
string
Description
Informa a API em quais UFs ela deve realizar a consulta. Aceita o código de uma UF brasileira (ex: SP, MG) ou o valor especial BR para consultar todas as UFs disponíveis de uma vez.
Valores aceitos: BR, AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, RJ, RN, RO, RR, RS, SC, SE, SP e TO.

Parâmetros Opcionais

Name
cache
Type
number
Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor padrão é 7 dias.
O cache é compartilhado entre os clientes da plataforma para melhorar performance e disponibilidade. O reaproveitamento do cache ocorre de forma segura: a API não informa qual cliente originou a consulta e não compartilha dados comerciais entre usuários.
Por compatibilidade, o parâmetro cache ainda é aceito no header da requisição. Porém, o formato recomendado é informá-lo pela query string.

Name
cache_strategy
Type
string
Description
Estratégia utilizada pela API para decidir entre utilizar dados em cache ou realizar uma nova consulta online no Sintegra Produtor Rural. O valor padrão é ONLINE_PREFERENCIAL.
Valores aceitos: CACHE_SE_EXISTIR, CACHE_PREFERENCIAL, SO_ONLINE, ONLINE_PREFERENCIAL.

Name
error_fallback
Type
boolean
Description
Define se a API poderá retornar dados em cache como resposta alternativa quando ocorrer erro na consulta online, independentemente da estratégia definida em cache_strategy. O valor padrão é false.
Quando true, caso o Sintegra Produtor Rural esteja indisponível ou retorne erro, a API poderá utilizar um resultado previamente armazenado em cache para o mesmo CPF/UF, quando disponível.

Name
endereco
Type
boolean
Description
Define se a API também deve buscar o endereço por inscrição estadual. Aceita true ou false. O valor padrão é false.
Quando true, a consulta inclui o campo endereco em cada inscrição estadual que possuir essa informação.
A busca de endereço contabiliza 1 consulta extra por requisição.

Estratégias de Cache

A API oferece diferentes estratégias para balancear entre performance, custo e atualização dos dados:

Estratégia	Prioridade	Fallback	Descrição
`CACHE_SE_EXISTIR`	Cache	Online	Utiliza o cache caso exista qualquer resultado armazenado para o CPF. Em caso de cache miss, tenta consulta online no Sintegra Produtor Rural.
`CACHE_PREFERENCIAL`	Cache válido	Online	Utiliza o cache quando estiver dentro da validade definida pelo parâmetro `cache`. Caso contrário, tenta consulta online.
`SO_ONLINE`	Online	Nenhum	Sempre tenta consulta online no Sintegra Produtor Rural. Não utiliza cache como fallback caso a consulta falhe.
`ONLINE_PREFERENCIAL`	Online	Cache válido	Prioriza a consulta online. Caso a consulta online falhe, poderá utilizar o cache como fallback. Recomendado para a maioria dos cenários.

GET/consultas/v2/produtor-rural/{cpf}?uf={uf}

Produtor Rural

Esta consulta retorna as Inscrições Estaduais (IEs) do Produtor Rural de forma focada e estável.

Você deve usar esta consulta se:

Precisa de maior estabilidade operacional
Quer um layout praticamente idêntico ao da consulta Sintegra, facilitando a integração
Dados completamente normalizados

Atributos obrigatórios

Name
cpf
Type
string
Description
CPF do Produtor Rural a ser consultado. Pode ser informado com ou sem formatação, desde que esteja completo e válido.

Name
uf
Type
string
Description
Obrigatório. Define em qual UF a consulta será realizada. Aceita uma UF específica (ex: SP, MG) ou BR para consultar todas as UFs.

Atributos opcionais

Name
cache
Type
number
Description
Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O valor default é 7 dias.
Por compatibilidade, o parâmetro cache ainda é aceito no header da requisição. Porém, o formato recomendado é informá-lo pela query string.

Name
cache_strategy
Type
string
Description
Estratégia de cache a ser utilizada. O valor default é ONLINE_PREFERENCIAL.
Valores aceitos: CACHE_SE_EXISTIR, CACHE_PREFERENCIAL, SO_ONLINE, ONLINE_PREFERENCIAL.

Name
error_fallback
Type
boolean
Description
Define se a API pode utilizar cache como fallback em caso de erro na consulta online. O valor default é false.

Name
endereco
Type
boolean
Description
Define se a API deve buscar endereço por inscrição estadual. Aceita true ou false. O valor default é false.
Quando true, a busca de endereço contabiliza 1 consulta extra por requisição.

Requisição

GET

/consultas/v2/produtor-rural/{cpf}?uf={uf}

curl -G https://api.sintegrapi.com.br/consultas/v2/produtor-rural/41012345678 \
  -H "x-api-key: {apiKey}" \
  -d "uf=MG" \
  -d "cache_strategy=ONLINE_PREFERENCIAL" \
  -d "endereco=true"

Resposta

{
    "cpf": "12345678901",
    "nome": "JOAO DA SILVA",
    "uf": "MG",
    "inscricoes_estaduais": [
        {
            "inscricao_estadual": "14237680002",
            "uf": "MG",
            "ativa": false,
            "data_status": "2015-10-28",
            "tipo_ie": "IE de Produtor Rural",
            "situacao_pj": "Sem restrição",
            "updated_at": "2026-07-23 07:41:14",
            "endereco": {
                "logradouro": "FAZENDA ATAQUE LUGAR GARIMPO",
                "numero": "NAO INFORMADO",
                "bairro": "ZONA RURAL",
                "municipio": "COROMANDEL",
                "codigo_municipio_ibge": "3119302",
                "uf": "MG",
                "cep": "38550000"
            }
        },
        {
            "inscricao_estadual": "14237680185",
            "uf": "MG",
            "ativa": true,
            "data_status": "2022-02-24",
            "tipo_ie": "IE de Produtor Rural",
            "situacao_pj": "Sem restrição",
            "updated_at": "2026-07-23 07:41:14",
            "endereco": {
                "logradouro": "FAZENDA MUTUCA",
                "numero": "NAO INFORMADO",
                "bairro": "ZONA RURAL",
                "municipio": "URUCUIA",
                "codigo_municipio_ibge": "3170529",
                "uf": "MG",
                "cep": "38649000"
            }
        }
    ],
    "request_id": "d2b49a35-a0e4-488a-ba5b-d4bbdd434f26",
    "success": true,
    "error": false,
    "is_cache": false
}

Exemplos de Uso

Consulta em uma UF específica (valores padrão)

GET /consultas/v2/produtor-rural/21345218800?uf=MG

Equivalente a:

GET /consultas/v2/produtor-rural/21345218800?uf=MG&cache_strategy=ONLINE_PREFERENCIAL&cache=7&error_fallback=false

Consulta em todas as UFs

GET /consultas/v2/produtor-rural/21345218800?uf=BR

A API executa buscas em todas as UFs disponíveis e retorna as inscrições estaduais encontradas para o CPF informado.

Consulta com endereço por inscrição estadual

GET /consultas/v2/produtor-rural/21345218800?uf=MG&endereco=true

Quando endereco=true, a API retorna o campo endereco por inscrição estadual e contabiliza 1 consulta extra na requisição.

Consulta priorizando cache por 30 dias

GET /consultas/v2/produtor-rural/21345218800?uf=MG&cache_strategy=CACHE_PREFERENCIAL&cache=30

A API utilizará o cache se ele tiver até 30 dias de idade. Caso contrário, tentará uma nova consulta online.

Consulta sempre online

GET /consultas/v2/produtor-rural/21345218800?uf=MG&cache_strategy=SO_ONLINE

A API consultará diretamente o Sintegra Produtor Rural, sem utilizar cache como fallback.

Consulta online com fallback habilitado em caso de erro

GET /consultas/v2/produtor-rural/21345218800?uf=MG&error_fallback=true

Se a consulta online falhar por instabilidade do Sintegra Produtor Rural, a API retornará dados em cache quando disponíveis.

Integração com CRMs e ERPs

Este endpoint é especialmente relevante para empresas do agronegócio que precisam validar Produtores Rurais em seus processos de cadastro e compras. Os campos inscricao_estadual, ativa, tipo_ie e situacao_pj podem ser mapeados diretamente em módulos de fornecedores em sistemas como SAP S/4HANA (módulos MM e FI), TOTVS Protheus, Oracle Fusion Cloud, Siagri e Agrosystems.

Para equipes de integração, o JSON Schema abaixo pode ser importado em ferramentas iPaaS como MuleSoft Anypoint, Dell Boomi, Workato e Azure Logic Apps, permitindo criar automaticamente conectores e transformações de dados para fluxos de onboarding de Produtores Rurais.

Use o JSON Schema abaixo para:

Validar respostas automaticamente antes de processar no ERP ou CRM
Gerar classes e modelos de dados com ferramentas como Quicktype
Configurar mapeamentos em conectores de integração e workflows fiscais
Automatizar a qualificação cadastral de Produtores Rurais em processos de compra

JSON Schema da Resposta

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Produtor Rural — Resposta",
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "Identificador único da requisição."
    },
    "success": {
      "type": "boolean",
      "description": "Indica se a consulta foi processada com sucesso."
    },
    "error": {
      "type": "boolean",
      "description": "Indica se ocorreu um erro na consulta."
    },
    "is_cache": {
      "type": "boolean",
      "description": "Indica se a resposta foi obtida a partir do cache."
    },
    "cpf": {
      "type": "string",
      "description": "CPF do Produtor Rural consultado, sem formatação."
    },
    "nome": {
      "type": ["string", "null"],
      "description": "Nome do Produtor Rural, quando disponível."
    },
    "uf": {
      "type": "string",
      "description": "UF consultada."
    },
    "inscricoes_estaduais": {
      "type": "array",
      "description": "Lista de inscrições estaduais encontradas para o CPF nas UFs consultadas.",
      "items": {
        "type": "object",
        "properties": {
          "inscricao_estadual": {
            "type": "string",
            "description": "Número da inscrição estadual do Produtor Rural."
          },
          "uf": {
            "type": "string",
            "description": "UF da inscrição estadual."
          },
          "ativa": {
            "type": "boolean",
            "description": "Indica se a inscrição estadual está ativa."
          },
          "data_status": {
            "type": "string",
            "format": "date",
            "description": "Data da última alteração de status no formato YYYY-MM-DD."
          },
          "tipo_ie": {
            "type": "string",
            "description": "Tipo da inscrição estadual (ex: IE de Produtor Rural)."
          },
          "situacao_pj": {
            "type": "string",
            "description": "Situação da pessoa na UF (ex: Sem restrição, Bloqueado como destinatário na UF)."
          },
          "updated_at": {
            "type": "string",
            "description": "Data e hora da última atualização do registro no formato YYYY-MM-DD HH:mm:ss."
          },
          "endereco": {
            "type": "object",
            "description": "Endereço da inscrição estadual. Presente apenas quando endereco=true é solicitado e a informação está disponível.",
            "properties": {
              "logradouro": { "type": "string" },
              "numero": { "type": "string" },
              "bairro": { "type": "string" },
              "municipio": { "type": "string" },
              "codigo_municipio_ibge": {
                "type": "string",
                "description": "Código IBGE do município."
              },
              "uf": { "type": "string" },
              "cep": {
                "type": "string",
                "description": "CEP sem formatação."
              }
            }
          }
        },
        "required": ["inscricao_estadual", "uf", "ativa"]
      }
    }
  },
  "required": ["request_id", "success", "error", "cpf", "inscricoes_estaduais"]
}