Configuração do XML para NFS-e: por que a prefeitura lê o XML, não o PDF
Uma NFS-e não é só o PDF que chega para o cliente — por trás dela existe um arquivo XML que carrega os dados que a prefeitura efetivamente valida: dados da agência e do cliente, ambiente de emissão, código de serviço, série, numeração do RPS e do lote. Configurar cada um desses campos corretamente é o que garante que a nota seja aceita de primeira, sem rejeição.
Confira os dados da agência e do cliente
A base de tudo que vai para o XML.
Antes de emitir, confirme que os dados cadastrais da agência (emissora) e do cliente (tomador do serviço) estão completos e atualizados — CNPJ, endereço, inscrição municipal, entre outros campos exigidos pela prefeitura.
Configure o ambiente de produção
Cada prefeitura tem suas próprias regras — o ambiente precisa refletir isso.
Configure o ambiente de produção correspondente à prefeitura da agência. Esse ambiente é o que determina como o iClips se comunica com o sistema da prefeitura para validar e autorizar a nota.
Defina o código de serviço
O código que classifica o tipo de serviço prestado perante a prefeitura.
Configure o código de serviço correspondente à atividade da agência, conforme a lista de códigos aceita pela prefeitura local. Esse código entra diretamente no XML e é um dos primeiros pontos verificados na validação.
Configure série, RPS e lote
A numeração que evita duplicidade e mantém a sequência esperada pela prefeitura.
Configure a série da nota, a numeração do RPS (Recibo Provisório de Serviços) e o número do lote de envio. Esses três campos precisam seguir uma sequência consistente — um conflito de numeração é motivo comum de rejeição pela prefeitura.
O que todo mundo pergunta antes de configurar o XML da NFS-e
Por que a nota foi rejeitada mesmo com o PDF parecendo correto?
Porque a prefeitura valida o XML por trás da nota, não o PDF. Um dado incompleto ou uma numeração em conflito no XML causa rejeição mesmo quando o PDF exibido parece correto.
O ambiente de produção é o mesmo para todas as prefeituras?
Não — cada prefeitura tem suas próprias regras de ambiente. Configure o ambiente específico da prefeitura da agência antes da primeira emissão.
O que causa conflito na numeração de série, RPS e lote?
Numeração fora de sequência ou duplicada em relação ao que já foi enviado à prefeitura. Mantenha esses três campos configurados de forma consistente para evitar rejeição por duplicidade.
Preciso reconfigurar esses dados a cada nota emitida?
Não — a configuração é feita uma vez. A partir daí, cada nova NFS-e emitida usa os dados já configurados, desde que o cadastro do cliente e da agência permaneça atualizado.
Ainda precisa de ajuda? Fale com a gente pelo suporte@iclips.com.br ou pelo chat da plataforma.