API de produtor rural: inscrição estadual por CPF

GET /api/consultar-ie-todos?cpf=... devolve as inscrições estaduais de produtor rural de um CPF nos 27 estados numa chamada, com situação, município, CNAE e tipo da inscrição, e conta como 1 consulta (de R$ 0,025 a R$ 0,67, conforme o plano).

Produtor rural pessoa física tem a IE ligada ao CPF e pode ter mais de uma inscrição, inclusive em estados diferentes. Por isso a busca em todas as UFs costuma ser o primeiro passo.

Resumo

Quanto custa cada chamada

Valores por consulta dentro da franquia mensal; recarga a R$ 0,12 (Starter), R$ 0,07 (Pro) ou R$ 0,02 (Enterprise). Erro HTTP não é cobrado, nem a varredura em que todos os estados falharam. Veja Planos e limites.

Exemplos

Produtor rural por CPF (27 UFs)

curl -X GET "https://api.fiscalapi.com.br/api/consultar-ie-todos?cpf=12345678909" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-ie-todos?cpf=12345678909",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
const inscricoes = data.results.flatMap((estado) => estado.results);
const habilitadas = inscricoes.filter((ie) => ie.situacao_ie.toLowerCase() === "habilitado");
console.log(`${habilitadas.length} de ${inscricoes.length} inscrições habilitadas`);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-ie-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cpf": "12345678909"},
)
data = response.json()
for estado in data["results"]:
    for ie in estado["results"]:
        print(estado["uf"], ie["inscricao_estadual"], ie["situacao_ie"], ie.get("tipo_ie", ""))

Só uma UF

Quando você já sabe onde fica a propriedade:

curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678909" \
  -H "X-API-Key: fapi_sua_chave_aqui"

Produtor de São Paulo

Em SP, consulte pela inscrição. A de produtor rural tem a letra P antes dos 12 dígitos (no exemplo, P-01234567.5/000, um número fictício).

curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=SP&ie=P012345675000" \
  -H "X-API-Key: fapi_sua_chave_aqui"

Exemplo de resposta

{
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "document": "12345678909",
  "document_type": "cpf",
  "cached_ufs": [],
  "complete": true,
  "results": [
    {
      "uf": "MT",
      "source_status": { "status": "success", "error_code": "", "error_message": "" },
      "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",
          "cnae_codigo": "0111301",
          "cnae_descricao": "CULTIVO DE ARROZ",
          "cpf_cnpj": "123.456.789-09",
          "situacao_cadastral": ""
        }
      ]
    },
    {
      "uf": "RO",
      "source_status": { "status": "success", "error_code": "", "error_message": "" },
      "results": []
    }
  ]
}

Os campos estão descritos em Consultar IE por UF. Se complete vier false, algum estado falhou e a inscrição pode estar justamente nele: repita a consulta antes de concluir que o CPF não tem IE.

O que mais dá para consultar do produtor

Integração com ERPs

A chamada é um GET com o header X-API-Key, feita de onde o sistema já fala com a internet: em geral no cadastro do fornecedor produtor, antes da compra de grãos, leite ou gado. Não existe conector pronto.

Perguntas frequentes

Como consultar a inscrição estadual de produtor rural pelo CPF?

Chame GET /api/consultar-ie-todos?cpf= com o CPF do produtor. A resposta traz as inscrições dele nos 27 estados, com situação e tipo de cada uma. Em SP, consulte pela própria IE, porque a busca pelo CPF não encontra a inscrição.

Quanto custa consultar o produtor rural?

1 consulta por chamada, para as 27 UFs juntas: R$ 0,025 no Enterprise, R$ 0,065 no Pro, R$ 0,10 no Starter e R$ 0,67 no Lite, dentro da franquia do plano.

Um CPF pode ter mais de uma inscrição estadual?

Sim. O mesmo CPF pode ter várias inscrições, inclusive em estados diferentes. A resposta lista todas, agrupadas por UF.

Como saber se a IE do produtor está ativa?

Pelo campo situacao_ie de cada inscrição: Habilitado ou Não habilitado. Compare sem diferenciar maiúsculas.

API de produtor rural · Planos e preços