Objeto: ver schema
Entrada: 2 XSD
Ambiente: offline
Dependências: zero
Testes: 230
Em CI: sai ≠ 0

A prefeitura mudou o XSD. Você ficou sabendo pelo erro 500.

Em duas palavras de quem já levou: “A prefeitura da minha cidade do nada, em pleno dia 23/12 comunicou que a partir do dia 01/01…” Diff os dois schemas e receba a lista do que parou de funcionar — e o que fazer com cada item.

saída real $ nfse-watch --perfil cidade.json --esquema-antes v1.xsd --esquema-depois v2.xsd

[QUEBRADO] Vila Real do Planalto (SP/3550999)

NFSEW001 Namespace divergente — o perfil emite v1, o provedor passou a servir v2

→ Mude o namespace e regenere a serialização. Se o XSD antigo ainda responder, emita em paralelo até a prefeitura cortar o anterior.

NFSEW002 Elemento obrigatório removido — OptanteSimplesNacional

→ Campo que não existe mais no schema é rejeição na hora. Remova da serialização.

veredito: FALHA · exit 1

Cada alerta traz o campo, o motivo e a ação. Não é “algo mudou”: é o que fazer. Roda offline, e roda em CI a cada deploy.

O que ele decide

Regras fixas, não palpite

Um dev precisa confiar no alerta e conseguir explicar ele para o contador. Por isso o motor é determinístico — 18 códigos, sem machine learning, cada um com regra explícita e testada.

QUEBRADO: namespace divergente, obrigatório removido, obrigatório novo, XSD movido, discriminação desativada
ATENÇÃO: novo campo opcional, elemento com tipo trocado, versão subindo dentro do mesmo major, certificado descontinuado, prazo de comunicado
COMPATÍVEL: nada observado afeta este perfil
Diff de XSD e de DSL simples, via xml.parsers.expat
Modo frota: todos os municípios numa tabela, QUEBRADO primeiro
Sai com código ≠ 0 em CI quando algo quebra

pip install nfse-watch

# um município
nfse-watch --perfil perfis/sp.json --esquema-antes antes.xsd --esquema-depois depois.xsd

# a frota inteira, ordenado por urgência
nfse-watch --todos perfis/

# no CI
nfse-watch --todos perfis/ --json

Contratar

A biblioteca é livre. Vigiar os seus municípios, não.

O código é MIT e está no GitHub. O serviço é manter o diff dos schemas Rodando por você — porque alguém precisa lembrar de baixar o XSD novo da prefeitura e comparar, e ninguém lembra.

Biblioteca

R$ 0

Roda tudo local. Sem rede, sem conta, sem limite.
Baixar do GitHub
MIT · Python 3.8+ · zero dependências · 230 testes
Setup dos perfis

R$ 89 / instalação

Você manda o XSD e o exemplo de XML de cada município que mantém. Eu monto os perfis, calibro as regras para aquele contrato e entrego rodando, com o CI pronto.
Pagar R$ 89
Pix direto · 5 dias úteis · nota fiscal emitida
Vigilância contínua

R$ 59 /mês por município

Diff semanal do schema de cada município ativo, aviso antes de a mudança entrar em vigor, e aviso quando a prefeitura publicar comunicado. Você só é avisado quando algo precisa de você.
Começar por R$ 89
Por município · cancele quando quiser

Não consulta a prefeitura sozinho

Isto diffa dois schemas que você fornece. Não baixa nada do site da prefeitura, não envia nada para SEFAZ, não substitui homologação e não é aconselhamento fiscal. A parte que exige gente —ligar com a prefeitura, obter o XSD novo — continua sendo sua.

Limites

O que isto não é

Não busca o XSD sozinho — você baixa e compara
Não emite NFS-e nem substitui homologação
Não valida assinatura nem criptografia
Não é aconselhamento fiscal nem jurídico
Nunca envia seu XML ou schema para nenhum servidor