Pular para o conteúdo
FiscalAPI
FiscalAPI
Produtor Rural

Como validar a inscrição estadual do produtor rural pelo CPF antes da nota de compra

Equipe FiscalAPI 5 min de leitura
Produtor RuralInscrição EstadualAPIIntegração

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

  1. 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.
  2. 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.
  3. Antes de emitir, confira a IE escolhida. GET /api/consultar?uf=MT&ie= traz a situação daquela inscrição no estado dela.
  4. 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:

bash
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:

json
{
  "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 voltouO que fazer no cadastro
situacao_ie igual a HabilitadoLibere a IE para a nota da propriedade correspondente
situacao_ie igual a Não habilitadoNã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 vaziaO CPF não tem IE naquele estado
Produtor de São PauloA 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

Compartilhar: WhatsApp LinkedIn Twitter

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