API gratuita para monitorar serviços da SEFAZ, SVRS e documentos fiscais brasileiros

Um projeto gratuito para ajudar desenvolvedores de ERPs, SaaS fiscais e times de tecnologia a pararem de consultar portais manualmente

Quem trabalha com integração fiscal no Brasil conhece bem esse cenário: uma Nota Técnica nova aparece, um schema muda, um portal da SEFAZ fica instável, um serviço entra em contingência, e de repente o time inteiro precisa descobrir se o problema está no sistema, no cliente ou na própria infraestrutura fiscal.

Foi pensando nisso que criei o **Monitor Fiscal**.

A ideia é simples: centralizar informações públicas e técnicas sobre documentos fiscais eletrônicos, status de portais, publicações da SEFAZ/SVRS e mudanças relevantes em um único lugar.

Você pode acessar pelo site: https://fiscal.mateusemth.dev

E também integrar direto no seu sistema usando a API: https://fiscal.mateusemth.dev/api-docs

O problema

Hoje, muitos desenvolvedores que trabalham com NF-e, NFC-e, CT-e, MDF-e e outros DF-e precisam acompanhar várias fontes diferentes:

• portais nacionais;
• portais da SEFAZ;
• SVRS;
• páginas de documentos técnicos;
• manuais;
• schemas XML;
• notas técnicas;
• páginas de status;
• comunicados de manutenção ou contingência.

Isso normalmente vira uma mistura de abas abertas, scraping improvisado, planilhas, alertas manuais e muita investigação repetida.

Para quem mantém ERP, gateway fiscal, sistema de emissão, automação tributária ou suporte técnico, essa rotina custa tempo.

E tempo, nesse contexto, quase sempre vira atraso para corrigir regra fiscal, responder cliente ou identificar indisponibilidade externa.

O que é o Monitor Fiscal

O Monitor Fiscal é uma ferramenta gratuita para consultar e monitorar informações fiscais públicas em uma experiência mais direta.

Pelo site, você consegue pesquisar documentos técnicos, acompanhar portais fiscais e visualizar dados importantes sem precisar navegar manualmente por várias fontes.

Pela API, você consegue levar essas informações para dentro do seu próprio produto.

Alguns exemplos de uso:

• mostrar status da SEFAZ dentro do seu ERP;
• criar alertas internos quando aparecer uma nova Nota Técnica;
• alimentar um painel de suporte;
• monitorar documentos técnicos de NF-e, NFC-e, CT-e e MDF-e;
• consultar publicações persistidas;
• comparar mudanças entre documentos;
• criar automações com notificações e webhooks.

API gratuita para desenvolvedores

Criei também exemplos oficiais de integração em várias linguagens:

• JavaScript;
• Python;
• C#;
• PHP;
• Go;
• C++;
• Delphi.

O repositório está aqui: https://github.com/mateusemth/api-monitor-sefaz

A proposta é que qualquer desenvolvedor consiga pegar uma API Key, rodar um exemplo localmente e entender rapidamente como integrar.

Para gerar uma chave: https://fiscal.mateusemth.dev/conta-api

A API aceita autenticação via header:

Authorization: Bearer SUA_API_KEY

ou

x-api-token: SUA_API_KEY

Alguns endpoints disponíveis

A API expõe endpoints para consultar escopos, status, documentos, notificações e comparações.

Por exemplo:

GET /api/fiscal-status?portal=nfe

Consulta status e sinais de disponibilidade de um portal fiscal.

GET /api/fiscal-documents?portal=nfe&limit=10

Lista documentos fiscais técnicos já persistidos.

GET /api/fiscal-api?portal=nfe

Busca documentos diretamente na fonte monitorada.

GET /api/fiscal-notifications

Consulta notificações vinculadas à sua API Key.

GET /api/fiscal-document-comparisons

Retorna comparações textuais entre documentos persistidos, quando há histórico compatível.

Exemplo em JavaScript

Um exemplo simples de consumo:

const token = ‘SUA_API_KEY_AQUI’;

const response = await fetch(
 ‘https://fiscal.mateusemth.dev/api/fiscal-status?portal=nfe',
 {
 headers: {
 Authorization: `Bearer ${token}`
 }
 }
);

const data = await response.json();

console.log(data);

Com isso, um sistema pode consultar status fiscal sem depender de lógica própria para cada portal.

Para quem esse projeto pode ser útil

Esse projeto foi pensado principalmente para:

• desenvolvedores de ERP;
• empresas de software fiscal;
• times de suporte técnico;
• produtos SaaS que dependem de emissão fiscal;
• integrações com NF-e, NFC-e, CT-e e MDF-e;
• equipes que precisam acompanhar mudanças em documentos técnicos;
• pessoas que querem reduzir consulta manual em portais fiscais.

Se você já perdeu tempo tentando descobrir se uma rejeição veio do seu sistema ou de instabilidade externa, provavelmente entende o motivo desse projeto existir.

O site também é parte importante do projeto

Além da API, o site do Monitor Fiscal funciona como uma interface pública para consultar informações fiscais de forma visual.

Ele reúne:

• busca de documentos técnicos;
• consulta por portal;
• status de serviços nos sites oficiais e também WebMania e Tecnospeed;
• histórico de documentos;
• notificações;
• comparação de documentos;
• documentação interativa da API;
• criação de conta e API Key.

Acesse aqui: https://fiscal.mateusemth.dev

Uma camada simples para um problema recorrente

O Monitor Fiscal não é um serviço oficial da SEFAZ.

Ele é uma camada independente que organiza informações públicas monitoradas e oferece uma forma mais prática de consulta para desenvolvedores e empresas.

A fonte oficial continua sendo indispensável para decisões fiscais críticas.

Mas para automação, acompanhamento técnico, suporte, produto e engenharia, ter uma API centralizada pode economizar bastante tempo.

Quero feedback de outros desenvolvedores

Esse projeto nasceu de uma necessidade real: facilitar a vida de quem trabalha com tecnologia fiscal no Brasil.

Agora quero abrir para mais pessoas testarem, integrarem e sugerirem melhorias.

Links principais:

• Site: https://fiscal.mateusemth.dev
• Criar conta API: https://fiscal.mateusemth.dev/conta-api
• Documentação OpenAPI: https://fiscal.mateusemth.dev/api-docs
• Exemplos oficiais: https://github.com/mateusemth/api-monitor-sefaz

Se você trabalha com ERP, emissão fiscal, documentos eletrônicos ou integrações com SEFAZ, testa a API e me conta o que sentiu falta.

Minha meta é transformar o Monitor Fiscal em uma ferramenta cada vez mais útil para a comunidade técnica que constrói software fiscal no Brasil.