Pular para conteúdo
Produtor rural · cadastro e imóveis

API para validar o cadastro de produtor rural

Inscrição Estadual por CPF, imóveis rurais no CNIR/CAFIR, parcelas do SIGEF e certidões do produtor. Na mesma conta, com a mesma chave.

IE pelo CPF

Produtor rural costuma ter Inscrição Estadual no CPF. A varredura encontra as inscrições nos estados onde ele atua.

Imóveis e parcelas

Imóveis rurais na Receita Federal e parcelas georreferenciadas certificadas pelo INCRA, pelo documento.

Perfil em uma chamada

Inscrições estaduais e certidões estaduais do produtor numa única resposta, mais os dados da Receita quando há CNPJ.

As consultas para validar um produtor

GET /api/consultar-ie-todos

Inscrições Estaduais do CPF ou CNPJ nos 27 estados, com situação e habilitação para NF-e.

GET /api/perfil-produtor

Inscrições estaduais e certidões estaduais numa só resposta. Com CNPJ, traz também o cadastro na Receita Federal.

GET /api/consultar-cnir

Imóveis rurais no CNIR/CAFIR da Receita Federal: CIB, NIRF, área, situação e condôminos.

GET /api/consultar-sigef

Parcelas certificadas no SIGEF do INCRA: área, município, matrícula, cartório e situação.

Para que serve

Antes de emitir a NF-e de compra, liberar crédito ou cadastrar um fornecedor do agro, o sistema confere se a inscrição do produtor está ativa, quais imóveis estão no nome dele e se há pendência nas certidões.

Cada consulta é uma chamada GET com resposta em JSON. Dá para rodar no cadastro, a cada safra ou numa rotina que revalida a base.

O que saber antes de integrar

A busca de IE por CPF depende do estado. São Paulo, por exemplo, só consulta por CNPJ ou pela própria IE.

O perfil do produtor consulta várias fontes de uma vez e pode demorar mais que as outras rotas. Use um tempo limite maior na chamada.

Exemplo de uso

GET /api/perfil-produtor

curl "https://api.fiscalapi.com.br/api/perfil-produtor?cpf=12345678900" \
  -H "X-API-Key: SUA_CHAVE_API"

Resposta (dados de exemplo):

{
  "document": "12345678900",
  "receita_federal": null,
  "inscricoes_estaduais": {
    "document_type": "cpf",
    "results": [
      {
        "uf": "MT",
        "source_status": { "status": "success" },
        "results": [
          { "inscricao_estadual": "13.123.456-7", "situacao_ie": "ATIVA", "uf_ie": "MT" }
        ]
      }
    ]
  },
  "cnd_estaduais": null
}

O que você recebe

Somando as consultas, por documento do produtor.

  • Inscrições Estaduais, por estado, com situação
  • Habilitação para NF-e e regime do ICMS
  • Cadastro na Receita Federal, na consulta por CNPJ
  • Certidões negativas estaduais
  • Imóveis rurais: CIB, NIRF, área e situação
  • Parcelas do SIGEF: área, matrícula e cartório
  • CNDT e CRF do FGTS, em rotas próprias
  • Endereço e CNAE da inscrição

Quanto custa

Cada consulta custa 1 crédito. O crédito sai de R$ 0,67 no plano Lite (R$ 19,99 por mês) a R$ 0,025 no Enterprise (a partir de R$ 250 por mês). Consulta que falha não é cobrada.

Ver todos os planos e preços

Perguntas frequentes

Quais APIs existem para validar o cadastro de produtores rurais?

Na FiscalAPI, quatro consultas cobrem o cadastro do produtor: Inscrição Estadual por CPF ou CNPJ nos 27 estados (/api/consultar-ie-todos), perfil do produtor com inscrições e certidões estaduais, mais a Receita Federal quando há CNPJ (/api/perfil-produtor), imóveis rurais no CNIR/CAFIR (/api/consultar-cnir) e parcelas do SIGEF (/api/consultar-sigef). Todas com a mesma chave.

Como consultar a Inscrição Estadual de um produtor rural pelo CPF?

Chame GET /api/consultar-ie-todos com o parâmetro cpf. A varredura devolve as inscrições encontradas, agrupadas por estado, com situação. A busca por CPF depende do cadastro de cada estado: São Paulo, por exemplo, só consulta por CNPJ ou pela própria IE.

Como saber quais imóveis rurais estão no CPF de um produtor?

Com GET /api/consultar-cnir. A resposta lista os imóveis cadastrados na Receita Federal para o CPF ou CNPJ, com CIB, NIRF, área, situação e município.

Dá para consultar parcelas do SIGEF por CPF ou CNPJ?

Sim. GET /api/consultar-sigef recebe o CPF ou o CNPJ do detentor e devolve as parcelas georreferenciadas certificadas pelo INCRA, com área, município, matrícula, cartório e situação.

Quanto custa validar um produtor rural por API?

Cada consulta custa 1 crédito, inclusive o perfil do produtor e a varredura de IE nos 27 estados. O crédito sai de R$ 0,67 no plano Lite (R$ 19,99 por mês) a R$ 0,025 no Enterprise (a partir de R$ 250 por mês).

Precisa de certificado digital?

Não. Todas essas consultas pedem só o CPF ou o CNPJ e a chave da API no header X-API-Key.

O cadastro do produtor, conferido por API.

IE por CPF, imóveis rurais, SIGEF e certidões, por API ou no painel.