Contabilidade: como conferir o DIFAL de vários clientes de e-commerce de uma vez
Para conferir o DIFAL de vários clientes de e-commerce, a contabilidade precisa, para cada cliente e cada mês, cruzar as notas com DIFAL destacado e as guias pagas em cada estado de destino. Com o certificado A1 de cada cliente, dá para fazer esse cruzamento por API, um cliente por requisição, e ter no fim do mês a lista de quem tem nota sem guia paga e quanto.
Atualizado em novembro de 2026.
Por que isso é trabalho da contabilidade
O DIFAL de venda a consumidor final não contribuinte de outro estado é de quem vende (LC 87/96, art. 4º, § 2º, II). Se o cliente é uma loja virtual, o débito é dele, nota a nota, em cada estado para onde vendeu. Quem não tem inscrição no estado de destino recolhe por guia, na saída da mercadoria (Convênio ICMS 236/2021, cláusula quinta).
Na prática, o ERP ou a plataforma da loja calcula o DIFAL e gera as guias, e alguém precisa pagar. Para conferir o cálculo de uma venda, há a calculadora de DIFAL. Quando uma guia fica para trás, ninguém vê até chegar a notificação. Veja o que acontece com o DIFAL não pago.
A rotina, mês a mês
| Quando | O que fazer |
|---|---|
| Começo do mês | Consultar o mês anterior de cada cliente que vende para outros estados |
| Logo depois | Separar quem tem valor em aberto e mandar a lista de notas ao cliente |
| Antes de cobrar | Conferir as notas "sem guia no portal" no sistema onde o cliente gera as guias |
| Fim do mês | Consultar de novo quem tinha pendência, para ver se a guia foi paga |
Onde a pendência aparece
Em 10 estados de destino (AC, AP, DF, GO, MS, MT, RR, RS, SC e SE), o Módulo de Apuração do Portal da DIFAL mostra as notas e as guias do emitente. Ele abre com o certificado digital do próprio cliente e só mostra as notas dele. Os outros estados têm sistema próprio. Veja Portal da DIFAL: o que é e quais estados usam.
À mão, são até 10 estados por cliente, com duas telas em cada um. Com 30 clientes, são centenas de telas por mês.
Por API, um cliente por requisição
A FiscalAPI lê o Módulo de Apuração com o A1 do cliente e devolve, em JSON, os estados do mês com as notas, a situação da guia de cada nota e o valor em aberto. O certificado e a senha vão na requisição, são usados só durante a consulta e não são guardados. A consulta está em beta.
Um laço simples sobre a carteira:
import base64
import requests
URL = "https://api.fiscalapi.com.br/api/consultar-difal-saida"
CHAVE = "fapi_sua_chave_aqui"
clientes = [
{"nome": "Loja A", "pfx": "certs/loja-a.pfx", "senha": "senha-a", "ufs": ["RS", "SC"]},
{"nome": "Loja B", "pfx": "certs/loja-b.pfx", "senha": "senha-b", "ufs": []}, # [] = as 10 UFs
]
for c in clientes:
with open(c["pfx"], "rb") as f:
cert = base64.b64encode(f.read()).decode()
r = requests.post(
URL,
headers={"X-API-Key": CHAVE},
json={"certificado": cert, "senha": c["senha"], "competencia": "2026-10", "ufs": c["ufs"]},
timeout=90,
)
d = r.json()
if r.status_code != 200:
print(c["nome"], "erro:", d)
continue
print(c["nome"], "em aberto:", d["valor_em_aberto"], "completo:", d["completo"])
for uf in d["ufs"]:
for n in uf["notas"]:
if n["em_aberto"]:
print(" ", uf["uf"], n["serie"], n["numero"], n["destinatario"], n["valor_em_aberto"]) Cada requisição pode levar até cerca de um minuto com os 10 estados. Use timeout de 90 segundos. Campos, erros e exemplos em outras linguagens estão na documentação da API.
Sem programar, o painel faz a mesma consulta, um cliente por vez, com o arquivo do certificado.
Como ler o resultado
| Campo | O que significa |
|---|---|
| valor_em_aberto | Notas sem guia no portal, com guia pendente de pagamento ou com geração rejeitada |
| valor_a_conferir | Notas com guia cujo pagamento o portal ainda não confirmou. Fica fora do valor em aberto |
| completo | true só quando todos os estados pedidos voltaram completos |
| status de cada estado | ok, parcial, erro ou nao_consultada. Só ok é cobrado |
Antes de cobrar o cliente por uma nota "sem guia no portal", pergunte onde ele gera as guias. Guia emitida no Portal GNRE, no ERP ou no sistema do estado não aparece no módulo. DF, GO e MT, por exemplo, indicam sistema próprio para a guia. E quem tem inscrição estadual no destino recolhe o mês por apuração, não nota a nota. Veja guia do DIFAL gerada não é guia paga.
Quanto custa a carteira
Cada estado que volta completo conta como uma consulta, no preço da consulta do plano.
| Plano | Por estado, com créditos do plano | 30 clientes × 10 estados por mês |
|---|---|---|
| Starter (R$ 50/mês) | R$ 0,10 | R$ 30,00 |
| Pro (R$ 130/mês) | R$ 0,065 | R$ 19,50 |
| Enterprise (R$ 250/mês) | R$ 0,025 | R$ 7,50 |
Para gastar menos, mande em ufs só os estados para onde cada cliente vende. É preciso ter saldo para todos os estados pedidos, mas só os que voltam completos são descontados. Essa consulta não entra nas 10 consultas grátis do mês. Planos em preços.
Perguntas frequentes
A contabilidade pode usar o próprio certificado? Não. O portal mostra as notas do titular do certificado. É preciso o A1 de cada cliente, e-CNPJ ou e-CPF de quem emitiu as notas.
A FiscalAPI guarda os certificados dos clientes? Não. O certificado vai em cada requisição e é descartado depois da consulta. A guarda continua com a contabilidade.
Serve para clientes que vendem para São Paulo? Não. A consulta cobre os 10 estados do Módulo de Apuração. São Paulo tem sistema próprio.
Mais sobre o produto na página da consulta de DIFAL de saída.
Fontes: Lei Complementar 87/96, Convênio ICMS 236/2021 e Portal da DIFAL.
Veja o DIFAL sem guia paga, por UF
Com o certificado A1 do emitente, as notas do mês com DIFAL e FCP e a situação da guia de cada uma, em 10 UFs. Só cobra a UF que volta completa.
Ver a consulta de DIFAL de saída