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. Neste endpoint, endereco=true não acrescenta créditos ao custo da consulta.

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.

Custos

Consulta de um CPF	Créditos consumidos
Produtor Rural em uma UF, em cache ou online	1 crédito
Produtor Rural com `uf=BR`	1 crédito
Inclusão de endereço com `endereco=true`	Sem acréscimo

O custo é o total por requisição concluída sem erro ao endpoint /consultas/v2/produtor-rural/{cpf}. A quantidade de inscrições retornadas não altera o valor. Retornos com erro não consomem créditos.

Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.

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 não acrescenta créditos ao custo deste endpoint.

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 não acrescenta créditos ao custo deste endpoint.

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, quando disponível, sem acréscimo de créditos neste endpoint.

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

Use a API de Produtor Rural para integrar a consulta de inscrições estaduais por CPF ao cadastro e à homologação de fornecedores do agronegócio. Informe a UF desejada ou BR conforme a abrangência necessária.

Produtor Rural no TOTVS Protheus, SAP e Siagri

Em um projeto com TOTVS Protheus, TOTVS RM, SAP S/4HANA, SAP Business One, Oracle Fusion Cloud, Sankhya ou Siagri, organize as inscrições por CPF, UF e número da IE. Esse relacionamento permite manter várias inscrições do mesmo produtor sem substituir indevidamente o cadastro de outra unidade.

Campo da resposta	Uso na integração
`cpf` e `nome`	Identificar o produtor e conferir seu cadastro.
`inscricoes_estaduais[].inscricao_estadual` e `inscricoes_estaduais[].uf`	Associar cada inscrição à unidade federativa correta.
`inscricoes_estaduais[].ativa` e `inscricoes_estaduais[].data_status`	Encaminhar situações cadastrais para revisão.
`inscricoes_estaduais[].tipo_ie` e `inscricoes_estaduais[].situacao_pj`	Complementar a classificação da inscrição.
`inscricoes_estaduais[].endereco`	Complementar o endereço quando solicitado e disponível.

Cadastro de fornecedores rurais no Salesforce e Dynamics 365

No Salesforce, Microsoft Dynamics 365 ou HubSpot, vincule o produtor às inscrições encontradas para apoiar homologações e acompanhamento comercial. Um CPF pode ter inscrições em mais de uma UF; preserve a lista retornada e considere a situação de cada inscrição no seu processo.

A conexão utiliza chamadas HTTPS e mapeamentos desenvolvidos para os recursos do sistema contratado. Proteja o CPF e a API key, registre request_id e valide o retorno pelo JSON Schema da resposta antes de atualizar o ERP ou CRM.

JSON Schema da Resposta

O schema usa JSON Schema Draft 2020-12. Os campos de negócio podem ser omitidos ou nulos quando não há informação disponível ou quando ocorre um erro. Valide também success e error antes de atualizar o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível. O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Produtor Rural — Resposta",
  "type": "object",
  "properties": {
    "request_id": { "type": "string", "format": "uuid" },
    "success": {
      "type": "boolean",
      "description": "Resultado funcional da consulta; avalie junto com error."
    },
    "error": {
      "type": "boolean",
      "description": "Indica falha técnica ou de validação."
    },
    "is_cache": { "type": ["boolean", "null"] },
    "cpf": {
      "type": ["string", "null"],
      "description": "CPF do Produtor Rural consultado, sem formatação."
    },
    "nome": {
      "type": ["string", "null"],
      "description": "Nome do Produtor Rural, quando disponível."
    },
    "uf": { "type": ["string", "null"], "description": "UF consultada." },
    "inscricoes_estaduais": {
      "type": ["array", "null"],
      "description": "Lista de inscrições estaduais encontradas para o CPF nas UFs consultadas.",
      "items": {
        "type": ["object", "null"],
        "properties": {
          "inscricao_estadual": {
            "type": ["string", "null"],
            "description": "Número da inscrição estadual do Produtor Rural."
          },
          "uf": {
            "type": ["string", "null"],
            "description": "UF da inscrição estadual."
          },
          "ativa": {
            "type": "boolean",
            "description": "Indica se a inscrição estadual está ativa."
          },
          "data_status": {
            "type": ["string", "null"],
            "description": "Data civil no formato YYYY-MM-DD.",
            "format": "date"
          },
          "tipo_ie": {
            "type": ["string", "null"],
            "description": "Tipo da inscrição estadual (ex: IE de Produtor Rural)."
          },
          "situacao_pj": {
            "type": ["string", "null"],
            "description": "Situação da pessoa na UF (ex: Sem restrição, Bloqueado como destinatário na UF)."
          },
          "updated_at": {
            "type": ["string", "null"],
            "description": "Data e hora no formato YYYY-MM-DD HH:mm:ss.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
          },
          "endereco": {
            "type": ["object", "null"],
            "properties": {
              "tipo": { "type": ["string", "null"] },
              "logradouro": { "type": ["string", "null"] },
              "numero": { "type": ["string", "null"] },
              "complemento": { "type": ["string", "null"] },
              "bairro": { "type": ["string", "null"] },
              "municipio": { "type": ["string", "null"] },
              "codigo_municipio_ibge": { "type": ["string", "null"] },
              "uf": { "type": ["string", "null"] },
              "cep": { "type": ["string", "null"] }
            }
          }
        }
      }
    },
    "error_message": {
      "type": ["object", "null"],
      "properties": {
        "message": {
          "type": ["string", "null"],
          "description": "Mensagem pública da consulta."
        },
        "code": {
          "type": ["string", "null"],
          "description": "Código público, quando informado."
        }
      }
    },
    "regime_tributacao": { "type": ["string", "null"] },
    "endereco": {
      "type": ["object", "null"],
      "properties": {
        "tipo": { "type": ["string", "null"] },
        "logradouro": { "type": ["string", "null"] },
        "numero": { "type": ["string", "null"] },
        "complemento": { "type": ["string", "null"] },
        "bairro": { "type": ["string", "null"] },
        "municipio": { "type": ["string", "null"] },
        "codigo_municipio_ibge": { "type": ["string", "null"] },
        "uf": { "type": ["string", "null"] },
        "cep": { "type": ["string", "null"] }
      }
    }
  },
  "required": ["request_id", "success", "error"],
  "additionalProperties": true
}