Como validar a inscrição estadual do produtor rural pelo CPF antes da nota de compra
Na cooperativa, na cerealista e na revenda de insumos, o produtor chega ao balcão com o CPF e, muitas vezes, sem saber qual inscrição estadual vai na nota. A nota de compra precisa da IE da propriedade de onde sai o grão, o leite ou o gado, e essa IE precisa estar ativa. Dá para resolver no próprio cadastro: o sistema envia o CPF e recebe as inscrições do produtor nos 27 estados, com a situação de cada uma.
Atualizado em 18/11/2026.
Por que só o CPF não resolve
O produtor rural pessoa física tem a IE ligada ao CPF, e pode ter mais de uma: é uma inscrição por propriedade, às vezes em mais de um estado. Para a trading que compra em vários estados, o mesmo CPF pode aparecer com uma inscrição diferente em cada um.
O risco está na escolha: IE baixada ou de outra propriedade na nota vira rejeição ou retrabalho. Conferir estado por estado, produtor por produtor, não acompanha o ritmo de uma safra.
O passo a passo no seu sistema
- No cadastro, envie o CPF para os 27 estados.
GET /api/consultar-ie-todos?cpf=devolve as inscrições encontradas, agrupadas por estado. É 1 consulta, não 27. - Escolha a IE da propriedade. Compare o município e o endereço de cada inscrição com a fazenda cadastrada na sua compra ou coleta.
- Antes de emitir, confira a IE escolhida.
GET /api/consultar?uf=MT&ie=traz a situação daquela inscrição no estado dela. - Grave o resultado e revalide a base a cada safra, ou todo mês, se a compra é contínua.
A chamada é um GET com a chave no cabeçalho X-API-Key, feita no cadastro do fornecedor produtor, antes da compra. Não há conector pronto: a documentação mostra como chamar do Protheus, do SAP e de ERPs que só se integram por um serviço intermediário.
Exemplo com dados fictícios, como está na documentação:
curl -X GET "https://api.fiscalapi.com.br/api/consultar-ie-todos?cpf=12345678909" \
-H "X-API-Key: fapi_sua_chave_aqui" O trecho da resposta que interessa ao cadastro:
{
"document": "12345678909",
"document_type": "cpf",
"results": [
{
"uf": "MT",
"source_status": { "status": "success" },
"results": [
{
"inscricao_estadual": "13.123.456-0",
"razao_social": "JOAO DA SILVA FAZENDA SANTA MARIA",
"situacao_ie": "Habilitado",
"uf_ie": "MT",
"tipo_ie": "IE de Produtor Rural",
"municipio": "RONDONOPOLIS"
}
]
},
{
"uf": "RO",
"source_status": { "status": "success" },
"results": []
}
]
} Leitura: o produtor tem uma IE de produtor rural habilitada em Rondonópolis (MT) e nenhuma em RO.
O que fazer com cada resposta
| O que voltou | O que fazer no cadastro |
|---|---|
| situacao_ie igual a Habilitado | Libere a IE para a nota da propriedade correspondente |
| situacao_ie igual a Não habilitado | Não use essa IE. A inscrição existe, mas não está apta a operar. Peça ao produtor a IE ativa da propriedade |
| situacao_contribuinte com "Vedada operação como Destinatário na UF" ou "Bloqueado como Destinatário na UF" | Na revenda de insumos, em que o produtor é o destinatário, revise antes de faturar para ele |
| Estado com status igual a success e lista vazia | O CPF não tem IE naquele estado |
| Produtor de São Paulo | A busca pelo CPF não encontra a inscrição. Peça a IE (a de produtor rural paulista costuma começar com a letra P) ou o CNPJ e consulte por eles |
Duas dicas de integração. Compare situacao_ie sem diferenciar maiúsculas, porque a grafia varia (Não habilitado e Não Habilitado). E, quando o estado informa, situacao_cadastral traz o detalhe da inscrição não habilitada, como Baixado - NÃO HABILITADO ou Suspenso - NÃO HABILITADO.
Milhares de produtores de uma vez
Para a base inteira, há dois caminhos.
Sem programar: no painel, suba a lista de CPFs dos produtores numa planilha .xlsx de até 20.000 linhas e baixe um Excel com a IE, a situação e a UF de cada um. Se a lista já traz IEs, formate a coluna como texto: IEs que começam com zero, como as de MG e MT, perdem os zeros quando o Excel trata a coluna como número.
Com programa: um job seu chama a API uma vez por produtor, por exemplo na virada da safra.
Para testar a integração antes de ir para produção, crie no painel uma chave de homologação (começa com fapi_test_). Nas rotas de IE, ela responde com dados fictícios, no mesmo formato da produção, sem gastar créditos.
Quanto custa
Achar as IEs de um produtor nos 27 estados é 1 consulta, o mesmo preço de conferir uma IE num estado: R$ 0,025 no Enterprise (R$ 250 por mês, 10.000 consultas), R$ 0,065 no Pro e R$ 0,10 no Starter (R$ 50 por mês, 500 consultas). Na planilha, cada documento conta 1 consulta. No painel, a conta que nunca assinou plano tem 10 consultas grátis por mês; pela API, é preciso plano ativo ou créditos extras.
Para começar
Veja a API de inscrição estadual por CPF e CNPJ, a consulta em massa por planilha e a documentação do produtor rural por CPF.
Perguntas frequentes
O produtor tem IE em dois estados. Qual vai na nota? A da propriedade de onde sai o produto. Compare o município e o endereço de cada inscrição com a propriedade cadastrada na compra.
E o produtor de São Paulo? Lá a busca pelo CPF não encontra a inscrição. Consulte pela IE do produtor ou pelo CNPJ. Veja por que a IE do produtor paulista não aparece pelo CPF.
O produtor já informou a IE. Preciso do CPF? Não. Envie ie com a uf em /api/consultar. Se não souber o estado, /api/consultar-ie-todos?ie= procura o número nos 27.
Precisa de certificado digital? Não. A consulta de inscrição estadual pede só a chave da API no cabeçalho X-API-Key.
Artigos relacionados
Consulte dados fiscais via API
Consulte Inscrições Estaduais, CNPJs e Certidões Negativas via API REST, com resposta em JSON. Planos a partir de R$ 50/mês.
Criar conta