Consulta DIFAL: as notas com DIFAL em aberto, por UF
Com o certificado A1 de quem vendeu, veja quais notas de venda a consumidor final de outro estado estão sem guia ou com a guia não paga, antes de virarem dívida ativa. No painel ou pela API.
R$ 0,025 a R$ 0,10 por UFerro não cobra

12.345.678/0001-95Exemplo
Vendas de outubro de 2026
DIFAL em aberto
R$ 370,05
| UF | Notas do mês | Em aberto |
|---|---|---|
| RS | 3 | R$ 370,05 |
| SC | 0 | R$ 0,00 |
| GO | 1 | R$ 0,00 |
- RS · nº 1001Sem guia · MARIA DA SILVAR$ 120,00
- RS · nº 1002Guia não paga · JOAO PEREIRAR$ 250,05
{ "request_id": "550e8400-e29b-41d4-a716-446655440000", "fonte": "Portal da DIFAL (SVRS) - Módulo de Apuração", "emitente_tipo": "CNPJ", "emitente_documento": "12345678000195", "competencia": "2026-10", "periodo_inicio": "2026-10-01", "periodo_fim": "2026-10-31", "total_documentos": 4, "valor_difal": 746.05, "valor_fcp": 20.0, "valor_em_aberto": 370.05, "notas_em_aberto": 2, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "completo": true, "ufs": [ { "uf": "RS", "status": "ok", "mensagem": "", "total_documentos": 3, "valor_difal": 650.05, "valor_fcp": 20.0, "valor_em_aberto": 370.05, "notas_em_aberto": 2, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [ { "serie": "1", "numero": "1001", "data_emissao": "2026-10-03", "vencimento": "2026-10-03", "destinatario": "MARIA DA SILVA", "uf_destino": "RS", "valor_total": 1000.0, "valor_difal": 100.0, "valor_fcp": 20.0, "situacao_guia_difal": "sem_guia_no_portal", "situacao_guia_fcp": "sem_guia_no_portal", "em_aberto": true, "valor_em_aberto": 120.0, "a_conferir": false, "valor_a_conferir": 0.0 }, { "serie": "1", "numero": "1002", "data_emissao": "2026-10-09", "vencimento": "2026-10-09", "destinatario": "JOAO PEREIRA", "uf_destino": "RS", "valor_total": 2500.0, "valor_difal": 250.05, "valor_fcp": 0.0, "situacao_guia_difal": "pendente_pagamento", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": true, "valor_em_aberto": 250.05, "a_conferir": false, "valor_a_conferir": 0.0 }, { "serie": "1", "numero": "1003", "data_emissao": "2026-10-14", "vencimento": "2026-10-14", "destinatario": "ANA SOUZA", "uf_destino": "RS", "valor_total": 3000.0, "valor_difal": 300.0, "valor_fcp": 0.0, "situacao_guia_difal": "paga", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": false, "valor_em_aberto": 0.0, "a_conferir": false, "valor_a_conferir": 0.0 } ], "guias": [ {"numero": "2026100000001", "vencimento_imposto": "2026-10-09", "data_limite_pagamento": "2026-10-09", "uf": "RS", "tributo": "ICMS DIFAL", "valor": 250.05, "situacao": "pendente_pagamento"}, {"numero": "2026100000002", "vencimento_imposto": "2026-10-14", "data_limite_pagamento": "2026-10-14", "uf": "RS", "tributo": "ICMS DIFAL", "valor": 300.0, "situacao": "paga"} ] }, { "uf": "SC", "status": "ok", "mensagem": "", "total_documentos": 0, "valor_difal": 0.0, "valor_fcp": 0.0, "valor_em_aberto": 0.0, "notas_em_aberto": 0, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [], "guias": [] }, { "uf": "GO", "status": "ok", "mensagem": "", "total_documentos": 1, "valor_difal": 96.0, "valor_fcp": 0.0, "valor_em_aberto": 0.0, "notas_em_aberto": 0, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [ { "serie": "1", "numero": "1004", "data_emissao": "2026-10-21", "vencimento": "2026-10-21", "destinatario": "CARLOS LIMA", "uf_destino": "GO", "valor_total": 800.0, "valor_difal": 96.0, "valor_fcp": 0.0, "situacao_guia_difal": "paga", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": false, "valor_em_aberto": 0.0, "a_conferir": false, "valor_a_conferir": 0.0 } ], "guias": [ {"numero": "2026100000003", "vencimento_imposto": "2026-10-21", "data_limite_pagamento": "2026-10-21", "uf": "GO", "tributo": "ICMS DIFAL", "valor": 96.0, "situacao": "paga"} ] } ], "avisos": [], "creditos_cobrados": 3}O que vem na consulta
As notas em aberto, por UF
Série, número, data, destinatário, DIFAL e FCP de cada nota em aberto.
A situação de cada guia
As guias do mês, com número, vencimento, valor e se foram pagas.
O valor a regularizar
O total em aberto do mês, por UF e somado, para gerar a guia que faltou.
Para quem é
Contabilidade e BPO fiscal
Com o A1 de cada cliente, veja em quais UFs ele tem DIFAL pendente, sem entrar no portal.
E-commerce e marketplace
Confira todo mês se cada venda a consumidor final de outro estado teve a guia gerada e paga.
As 10 UFs do Portal da DIFAL
- ACAcre
- APAmapá
- DFDistrito Federal
- GOGoiás
- MSMato Grosso do Sul
- MTMato Grosso
- RRRoraima
- RSRio Grande do Sul
- SCSanta Catarina
- SESergipe
Pela API, uma chamada POST
O certificado A1 do emitente em base64, a senha, o mês e as UFs vão no corpo; a chave da API, no header X-API-Key. A partir de R$ 50 por mês.
POST/api/consultar-difal-saida
- certificadoobrigatório
- O arquivo .pfx do certificado A1 do emitente, em base64.
- senhaobrigatório
- Senha do certificado.
- competenciaobrigatório
- Mês de emissão das notas, AAAA-MM.
- ufsopcional
- UFs de destino, entre AC, AP, DF, GO, MS, MT, RR, RS, SC e SE. Sem ela, as 10.
- X-API-Keyobrigatório
- Header com a sua chave da API.
curl -X POST https://api.fiscalapi.com.br/api/consultar-difal-saida \ -H "X-API-Key: SUA_CHAVE_API" \ -H "Content-Type: application/json" \ -d '{ "certificado": "<.pfx do emitente em base64>", "senha": "sua-senha", "competencia": "2026-10", "ufs": ["RS", "SC", "GO"] }'{ "request_id": "550e8400-e29b-41d4-a716-446655440000", "fonte": "Portal da DIFAL (SVRS) - Módulo de Apuração", "emitente_tipo": "CNPJ", "emitente_documento": "12345678000195", "competencia": "2026-10", "periodo_inicio": "2026-10-01", "periodo_fim": "2026-10-31", "total_documentos": 4, "valor_difal": 746.05, "valor_fcp": 20.0, "valor_em_aberto": 370.05, "notas_em_aberto": 2, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "completo": true, "ufs": [ { "uf": "RS", "status": "ok", "mensagem": "", "total_documentos": 3, "valor_difal": 650.05, "valor_fcp": 20.0, "valor_em_aberto": 370.05, "notas_em_aberto": 2, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [ { "serie": "1", "numero": "1001", "data_emissao": "2026-10-03", "vencimento": "2026-10-03", "destinatario": "MARIA DA SILVA", "uf_destino": "RS", "valor_total": 1000.0, "valor_difal": 100.0, "valor_fcp": 20.0, "situacao_guia_difal": "sem_guia_no_portal", "situacao_guia_fcp": "sem_guia_no_portal", "em_aberto": true, "valor_em_aberto": 120.0, "a_conferir": false, "valor_a_conferir": 0.0 }, { "serie": "1", "numero": "1002", "data_emissao": "2026-10-09", "vencimento": "2026-10-09", "destinatario": "JOAO PEREIRA", "uf_destino": "RS", "valor_total": 2500.0, "valor_difal": 250.05, "valor_fcp": 0.0, "situacao_guia_difal": "pendente_pagamento", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": true, "valor_em_aberto": 250.05, "a_conferir": false, "valor_a_conferir": 0.0 }, { "serie": "1", "numero": "1003", "data_emissao": "2026-10-14", "vencimento": "2026-10-14", "destinatario": "ANA SOUZA", "uf_destino": "RS", "valor_total": 3000.0, "valor_difal": 300.0, "valor_fcp": 0.0, "situacao_guia_difal": "paga", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": false, "valor_em_aberto": 0.0, "a_conferir": false, "valor_a_conferir": 0.0 } ], "guias": [ {"numero": "2026100000001", "vencimento_imposto": "2026-10-09", "data_limite_pagamento": "2026-10-09", "uf": "RS", "tributo": "ICMS DIFAL", "valor": 250.05, "situacao": "pendente_pagamento"}, {"numero": "2026100000002", "vencimento_imposto": "2026-10-14", "data_limite_pagamento": "2026-10-14", "uf": "RS", "tributo": "ICMS DIFAL", "valor": 300.0, "situacao": "paga"} ] }, { "uf": "SC", "status": "ok", "mensagem": "", "total_documentos": 0, "valor_difal": 0.0, "valor_fcp": 0.0, "valor_em_aberto": 0.0, "notas_em_aberto": 0, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [], "guias": [] }, { "uf": "GO", "status": "ok", "mensagem": "", "total_documentos": 1, "valor_difal": 96.0, "valor_fcp": 0.0, "valor_em_aberto": 0.0, "notas_em_aberto": 0, "valor_a_conferir": 0.0, "notas_a_conferir": 0, "notas": [ { "serie": "1", "numero": "1004", "data_emissao": "2026-10-21", "vencimento": "2026-10-21", "destinatario": "CARLOS LIMA", "uf_destino": "GO", "valor_total": 800.0, "valor_difal": 96.0, "valor_fcp": 0.0, "situacao_guia_difal": "paga", "situacao_guia_fcp": "nao_se_aplica", "em_aberto": false, "valor_em_aberto": 0.0, "a_conferir": false, "valor_a_conferir": 0.0 } ], "guias": [ {"numero": "2026100000003", "vencimento_imposto": "2026-10-21", "data_limite_pagamento": "2026-10-21", "uf": "GO", "tributo": "ICMS DIFAL", "valor": 96.0, "situacao": "paga"} ] } ], "avisos": [], "creditos_cobrados": 3}- valor_em_aberto
- DIFAL e FCP do mês sem guia, com a guia não paga ou com a geração rejeitada.
- notas_em_aberto
- Quantas notas estão em aberto.
- valor_a_conferir
- Valor a conferir: guia gerada sem pagamento confirmado e, em DF, GO e MT, nota sem guia no portal (lá a guia sai no sistema da SEFAZ).
- completo
- true quando todas as UFs vieram completas.
- ufs[].uf
- A UF de destino.
- ufs[].status
- ok quando a UF veio completa.
- ufs[].valor_em_aberto
- O valor em aberto na UF.
- ufs[].notas[]
- Série, número, data, destinatário, valor da nota, DIFAL, FCP e a situação da guia de cada um.
- ufs[].notas[].situacao_guia_difal
- paga, pendente_pagamento, sem_guia_no_portal, geracao_rejeitada e outras; situacao_guia_fcp, o mesmo para o FCP.
- ufs[].guias[]
- As guias do mês: número, vencimento, tributo, valor e situação.
Bom saber
- Certificado A1 do emitente das notas: e-CNPJ ou e-CPF. O A3 (token ou cartão) não serve.
- Só quer calcular o DIFAL de uma venda? Use a calculadora DIFAL, grátis.
Quanto custa
Cada UF conta uma consulta: as 10 UFs de um mês saem a 1,00 créditos no Starter e a 0,25 créditos no Enterprise. Fora das consultas grátis. = crédito. 1 crédito = R$ 1.
- Starter
- 0,10 créditos
- por UF
- Pro
- 0,065 créditos
- por UF
- Enterprise
- 0,025 créditos
- por UF
Se a consulta der erro, você não paga.
Perguntas frequentes
Outra dúvida? contato@fiscalapi.com.br
Descubra o DIFAL em aberto antes que vire dívida ativa.
Ver documentaçãoJá tem conta? Entrar


