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