Como reconstruir o mapa de códigos municipais usados na NFS-e

Uma exportadora muda de escritório e encontra três códigos de serviço em notas que parecem ter a mesma descrição. Um veio do sistema municipal antigo, outro do emissor nacional e um terceiro de um cadastro atualizado. Copiar o último código para todos os contratos pode aplicar o parâmetro errado. Reconstrua o mapa por tipo de serviço, município, sistema, competência e documento, depois valide as regras atuais com o contador.

Colete código, descrição e origem em cada nota

Use XML, PDF, protocolo e os dados do emissor. Identifique código municipal, código nacional, item da lista de serviços e outros classificadores quando existirem. Guarde os valores como aparecem na origem e preserve zeros e pontuação. A documentação técnica do Portal NFS-e diferencia campos e anexos de domínio, conforme o leiaute. Consulte a versão usada no período e verifique a configuração do município. Uma mudança de código pode vir de alteração de leiaute, de classificação ou de correção. O histórico deve mostrar qual hipótese está comprovada.

Registre descrição do serviço, referência contratual e local ou resultado conforme a documentação. A Lei Complementar 116 traz a lista de serviços e trata da não incidência de ISS nas exportações dentro de suas condições, com a ressalva sobre resultado no Brasil. Não conclua o enquadramento só pelo país do tomador ou por um código. A análise depende da prestação, da legislação municipal e das evidências. Para situação com dúvida, confirme a orientação da contabilidade e, quando necessário, consulta ao município.

Separe o código histórico da regra para novas emissões

Monte uma linha por contrato ou tipo de serviço e vigência. Use colunas para sistema, código anterior, código em uso, fonte, data de confirmação e responsável. Marque situações em que mais de um código foi usado. Compare XML com o espelho do portal. Se o ERP armazenou um código interno, registre a correspondência, preservando o valor original. Uma mudança de sistema pode adotar outra formatação sem mudar a natureza do serviço. Uma alteração de escopo pode exigir decisão diferente, mesmo com o mesmo cliente.

Liste notas canceladas e substituídas, com vínculo entre documentos. Se encontrar divergência em competência encerrada, não faça alteração automática. O CFC oferece referência para escrituração e retificação. Confirme com o contador e o emissor quais procedimentos são aplicáveis e quem vai acompanhar. Preserve os documentos existentes. Para a primeira emissão após a transição, valide cadastro e campos em revisão, sem transmitir uma nota de teste como se fosse prestação real.

Exemplo de duas atividades para o mesmo comprador

Uma consultoria brasileira presta implantação e treinamento ao mesmo cliente. No portal antigo, o escritório usava códigos municipais distintos. Na migração, o cadastro do comprador aparece com uma única descrição genérica. O novo escritório recupera notas de cada atividade, compara XML e pedido e identifica os campos nacionais e complementares quando presentes. Registra a relação por tipo de serviço e período. A empresa confirma a configuração atual com a orientação aplicável antes de usar o novo cadastro.

Uma nota antiga foi substituída por outra que corrigiu descrição e código. O mapa mantém as duas referências e aponta qual documento está vigente. Ao testar o fechamento, o contador consegue encontrar a nota correta por competência. Uma dúvida sobre resultado de parte do treinamento fica registrada como análise própria e não é resolvida apenas copiando o código da implantação.

Prepare a conferência da primeira nota

Confira cadastro, município, descrição, campo de serviço, tomador, competência e tratamento definido. Compare com o contrato e o emissor disponível. Registre a versão da orientação usada. Se o sistema pede um campo novo, não preencha por analogia com um código sem verificar a documentação. Mantenha as exceções em fila, com nota, período, risco, responsável e prazo. Faça uma amostra de nota vigente, substituída e de atividade que mudou de escopo. Isso permite confirmar o histórico sem confundir regra antiga e cadastro atual.

Revise as referências de data. Um XML pode ter data de emissão e competência diferentes, e a regra de código deve ser consultada pelo evento relevante. Quando houver correção, preserve motivo, versão e protocolo. Para um serviço recorrente, selecione pelo menos uma nota de cada mudança de sistema e compare os campos usados. Se o emissor apresenta só uma descrição, confira se o código está no arquivo ou na configuração. Documente quem verificou a correspondência e a data da consulta. Inclua no procedimento o que fazer quando o cliente passa a contratar atividades que não estavam no cadastro antigo.

Perguntas frequentes

Código municipal e código nacional são a mesma coisa?

São campos com funções que dependem do emissor e da parametrização. Preserve ambos quando existirem e confirme a correspondência nas fontes aplicáveis.

Posso copiar o código da última nota?

Confira serviço, competência, município e configuração vigente. Uma alteração de escopo ou leiaute pode exigir outra análise.

O que fazer se duas notas semelhantes têm códigos diferentes?

Compare XML, descrição, período e histórico de correção. Registre a diferença e confirme o tratamento com a contabilidade e, se necessário, o município.

Fontes oficiais

• Câmara dos Deputados — Lei Complementar 116 atualizada
• Portal NFS-e — documentação atual
• CFC — escrituração e retificação do Livro Diário

Leituras relacionadas

• Como arquivar XML, protocolo e DANFSe de serviços ao exterior
• Guias para exportadores de serviços

Como a Zen pode ajudar

A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.