Como migrar do SintegrAPI ou do SintegraWS para a FiscalAPI?

Troque o endereço, passe a chave no header X-API-Key e leia as inscrições agrupadas por estado em results[].results. A consulta continua sendo um GET com o documento na query string e resposta em JSON; as tabelas abaixo dão o equivalente de cada parâmetro, campo e erro.

• Custo: a consulta de IE nos 27 estados, com endereço, é 1 consulta: de R$ 0,025 a R$ 0,67 conforme o plano (comparação).
• Também aceita: CPF (produtor rural) e IE, além de CNPJ.
• Comece: crie a conta e a chave de API e siga o checklist da troca.

Do SintegrAPI

Fonte: docs.sintegrapi.com.br/sintegra, docs.sintegrapi.com.br/errors e sintegrapi.com.br/planos, lidas em 07/11/2026.

Requisição

Resposta

No SintegrAPI, as inscrições vêm numa lista única inscricoes_estaduais. Na FiscalAPI, results tem um item por estado, e cada estado tem a sua lista results de inscrições.

A FiscalAPI também traz, em cada inscrição, nome_fantasia, cnae_codigo, cnae_descricao, regime_apuracao_icms, situacao_nfe e situacao_contribuinte. A lista completa está em Consultar IE por UF.

Erros

O código, antes e depois

import requests

r = requests.get(
    "https://api.sintegrapi.com.br/consultas/v2/sintegra/12345678000195",
    headers={"x-api-key": "SUA_CHAVE"},
    params={"uf": "BR", "endereco": "true"},
)
for ie in r.json()["inscricoes_estaduais"]:
    print(ie["uf"], ie["inscricao_estadual"], ie["ativa"])

import requests

r = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-ie-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000195"},
)
r.raise_for_status()
for estado in r.json()["results"]:
    for ie in estado["results"]:
        ativa = ie["situacao_ie"].lower() == "habilitado"
        print(estado["uf"], ie["inscricao_estadual"], ativa)

Do SintegraWS

Fonte: documentação da API SINTEGRA do SintegraWS e página de pagamento, lidas em 07/11/2026.

Requisição

Resposta

No SintegraWS, a resposta descreve um estabelecimento, e as outras inscrições vêm em outras_ies (em beta, sem endereço). Na FiscalAPI, /api/consultar-ie-todos devolve, para cada estado, a lista results de inscrições com todos os campos; /api/consultar devolve a lista de uma UF.

Erros

O SintegraWS informa o resultado nos campos status e code do corpo. A FiscalAPI usa o status HTTP.

O código, antes e depois

import requests

r = requests.get(
    "https://www.sintegraws.com.br/api/v1/execute-api.php",
    params={"token": "SEU_TOKEN", "cnpj": "12345678000195", "plugin": "ST"},
)
dados = r.json()
if dados["status"] == "OK" and dados["code"] == "0":
    print(dados["inscricao_estadual"], dados["situacao_ie"])

import requests

r = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-ie-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000195"},
)
r.raise_for_status()  # 400, 402, 403, 429 e 5xx viram exceção
dados = r.json()
for estado in dados["results"]:
    for ie in estado["results"]:  # lista vazia = sem IE nesse estado
        print(estado["uf"], ie["inscricao_estadual"], ie["situacao_ie"])
if not dados["complete"]:
    print("Algum estado não respondeu: tente de novo antes de concluir que não há IE.")

Custo comparado

Só com os preços públicos lidos em 07/11/2026. Na FiscalAPI, a consulta nos 27 estados e a de uma UF contam como 1 consulta, com endereço.

Pelas páginas do SintegrAPI: uma UF custa 1 crédito (2 com endereço) e todas as UFs, 2 créditos (3 com endereço). O SintegrAPI tem 10 créditos grátis por mês e planos anuais com bônus de créditos (por exemplo, Freelancer a R$ 285/ano com 100 créditos mais 20 de bônus por mês). A página do SintegraWS cita outros pacotes (Standard, Professional, Gold, Platinum), mas sem preço e quantidade que desse para conferir.

Na FiscalAPI, a recarga além da franquia custa R$ 0,12 (Starter), R$ 0,07 (Pro) e R$ 0,02 (Enterprise) por consulta. Resposta com erro HTTP não é cobrada. Conta que nunca assinou plano, sem recarga e com e-mail confirmado, tem 10 consultas grátis por mês de IE em um estado e de CNPJ, no painel e pela API; a consulta nos 27 estados usa plano ou recarga. Veja Planos e limites.

Checklist da troca

1. Crie a conta e a chave no painel e teste com as consultas grátis (/api/consultar, uma UF).
2. Troque o endereço e passe a chave no header X-API-Key.
3. Ajuste a leitura da resposta: inscrições em results (uma UF) ou results[].results (todas as UFs).
4. Troque a checagem de ativa/inativa por situacao_ie igual a Habilitado.
5. Trate os erros pelo status HTTP: 402 sem saldo, 429 limite por minuto, 400 documento ausente ou sem dígitos. Valide o dígito verificador do CNPJ antes de chamar: na consulta em todos os estados, um CNPJ errado é consultado e cobrado.
6. Respeite o limite por minuto do plano, somando todas as chaves: 5 no Lite, 20 no Starter, 60 no Pro e 120 no Enterprise. Veja Rate limiting.
7. Na consulta de todas as UFs, confira complete antes de concluir que não há IE.

Se o seu código é Python, Node.js ou PHP, os SDKs oficiais já tratam 429 e falhas temporárias: veja os guias de Python, Node.js e PHP.

Perguntas frequentes

Como trocar o SintegrAPI pela FiscalAPI?

Troque GET https://api.sintegrapi.com.br/consultas/v2/sintegra/{cnpj}?uf=BR por GET https://api.fiscalapi.com.br/api/consultar-ie-todos?cnpj={cnpj}, mantendo a chave no header (X-API-Key). As inscrições passam a vir agrupadas por estado em results[].results, e ativa vira situacao_ie igual a Habilitado.

Como trocar o SintegraWS pela FiscalAPI?

Troque execute-api.php?token=...&cnpj=...&plugin=ST por GET https://api.fiscalapi.com.br/api/consultar-ie-todos?cnpj=..., com a chave no header X-API-Key. Não precisa de UF: a consulta procura o CNPJ nos 27 estados. O resultado deixa de vir em status e code no corpo e passa a vir no status HTTP; as inscrições ficam em results[].results.

A FiscalAPI consulta a inscrição estadual por CPF?

Sim. /api/consultar e /api/consultar-ie-todos aceitam cpf, além de cnpj e ie. É o caso do produtor rural pessoa física.

Quanto custa a consulta de IE em todos os estados na FiscalAPI?

1 consulta por chamada, com endereço: R$ 0,67 no Lite, R$ 0,10 no Starter, R$ 0,065 no Pro e R$ 0,025 no Enterprise, dentro da franquia do plano.

Dá para testar a FiscalAPI antes de migrar?

Dá. Conta que nunca assinou plano, sem recarga e com e-mail confirmado, tem 10 consultas grátis por mês de IE em um estado (/api/consultar) e de CNPJ, também pela API. A consulta nos 27 estados usa plano ou recarga.

Planos e preços