NFS-e Nacional na prática: quais dados o XML entrega para uma análise de serviço
Veja como DPS, código nacional, NBS, município, base, alíquota e ISS formam uma trilha de análise de serviços.
A NFS-e Nacional possui estrutura e vocabulário próprios. Tentar tratá-la como NF-e de mercadoria produz resultados frágeis. Um parser específico precisa reconhecer o namespace, localizar a NFS-e e a DPS e extrair fatos adequados a uma operação de serviço.
Identificação do documento
O namespace nacional permite separar esse formato de NFS-e municipais. Quando um provedor municipal ainda não está homologado, o comportamento seguro é identificar o tipo e recusar com mensagem clara, sem forçar a interpretação por outro parser.
Dados relevantes do serviço
O XML pode trazer número, série, prestador, código tributário nacional, NBS, município de incidência e prestação, valor do serviço, base de cálculo, alíquota e valor do ISS. Cada campo precisa manter linhagem até sua origem no documento.
Documento, operação e análise
Depois do parse, o sistema cria o documento fiscal, uma operação de serviço normalizada e a análise individual. Essa separação permite que o documento preserve seu contexto enquanto o motor trabalha com fatos consistentes.
Campos ausentes também informam
Nem toda ausência é erro, mas ela pode limitar a análise. O Pacote de Evidências registra campos ausentes e sua relevância. Assim, uma explicação assistida pode dizer que não há dado suficiente, em vez de completar a informação por suposição.
Histórico e reprocessamento
Quando o parser ou as regras evoluem, o mesmo documento pode ser revalidado. A análise anterior permanece e a nova execução registra sua versão. Isso é especialmente importante em um ecossistema de padrões nacionais e municipais em evolução.
Uso para escritório e software house
O escritório ganha uma visão organizada dos serviços e das lacunas por cliente. A software house pode consultar o resultado por API e corrigir o mapeamento do ERP. Nos dois casos, o valor está na rastreabilidade, não em uma promessa de decisão automática.
Serviço exige contexto próprio
NFS-e não deve ser tratada como uma NF-e com nomes diferentes. Município de incidência, retenções, intermediário, local da prestação e códigos de serviço mudam a leitura. O produto preserva os dados extraídos e aponta ausências ou incoerências para revisão, sem converter automaticamente uma lacuna em conclusão tributária.