Fontes: LC 214, arts. 60 e 62 e NT 004, versão 2, itens 2.1 a 2.1.3.
NFS-e de software e SaaS: identificar cada entrega
Eu começaria pelo catálogo de operações, não pela tela de emissão. Uma empresa pode disponibilizar software, implantar a solução, prestar suporte e intermediar uma contratação. A descrição comercial do pacote não demonstra que todos esses fornecimentos têm o mesmo enquadramento.
O calendário também depende da hipótese. O Ato Conjunto 4/2026, art. 1º, III, distingue plataformas e operações dos subitens 1.03, 1.05 e 1.09, com marco de 1º de dezembro, de outros serviços abrangidos pela alínea d, com marco de 1º de outubro de 2026. As exceções do ato precisam ser examinadas antes da escolha da data. Ato Conjunto RFB/CGIBS 4/2026.
O mapeamento de receitas mistas em tecnologia deve anteceder essa decisão. Para uma operação intermediada, a análise de documento emitido pela plataforma em nome do fornecedor acrescenta outra pergunta: quem está autorizado a emitir e em nome de quem? A disponibilidade de uma integração não responde isso.
Também é necessário distinguir NF-e de NFS-e. O guia de IBS/CBS na nota fiscal trata dessa fronteira e das notas técnicas próprias de cada modelo. Um exemplo de XML de mercadorias não deve ser reaproveitado como se fosse um documento de serviços.
Qual documentação representa o ambiente utilizado
O Portal Nacional da NFS-e reúne documentos publicados, recursos disponíveis e cronogramas futuros. Essas categorias não são equivalentes. No corte de 30 de agosto de 2026, a página RTC informa a base da NT 004 com os ajustes de retenção da NT 007 e esclarece que a NT 009 não estaria disponível em produção e produção restrita em agosto, segundo o cronograma ali publicado. Portal NFS-e, documentação RTC.
O histórico registra, em 10 de agosto, evolução do emissor web para destaque de IBS/CBS conforme a NT 004, além de outros ajustes. A implantação do DANFSe ligado à NT 008 não comprova implantação de todos os grupos da NT 009. Portal NFS-e, atualizações de 03/08 e 10/08/2026.
| Referência consultada | O que informa | Como usar |
|---|---|---|
| Documentação de produção | Pacote XSD identificado como v1.01-20260209 e anexos publicados | Conferir o conjunto aplicável antes de gerar o arquivo |
| Produção restrita | Pacote XSD identificado como v1.01-20260727 | Não presumir identidade com o ambiente de produção |
| Página RTC | Notas técnicas, anexos e ressalvas de implantação | Distinguir desenho publicado de função disponível |
| Histórico de atualizações | Mudanças informadas por data e ambiente | Relacionar cada teste à implantação correspondente |
Fontes: documentação de produção e documentação de produção restrita.
Este artigo não entrega um XML homologado. A implementação executável exige conferir os anexos, o esquema e os parâmetros do município e do ambiente efetivamente utilizado. O número da nota técnica, isoladamente, não demonstra compatibilidade.
Quem é o adquirente, quem é o destinatário e quem paga
No modelo explicado pela NT 004, o tomador corresponde ao adquirente, e há informação própria para destinatário quando aplicável. A versão também remove o grupo separado de adquirente que aparecia em desenho anterior. Copiar uma tabela antiga pode reintroduzir um grupo que já não pertence àquela estrutura. NT 004, itens 2.1, 2.1.1 e 2.1.2.
Imagine um exemplo fictício: a empresa A contrata a solução e assume a obrigação; a empresa B é identificada como destinatária do serviço; a empresa C centraliza o pagamento. O arquivo precisa partir desses fatos. O simples recebimento de dinheiro de C não demonstra que ela deve figurar como adquirente.
O Decreto 12.955/2026, art. 122, V, trata da identificação de pessoa ou estabelecimento diverso do real no exame de idoneidade documental, com a disciplina e ressalvas do próprio dispositivo. Mudar o nome para favorecer o crédito pretendido não corrige o fato subjacente. Decreto 12.955, arts. 121 a 124.
Essa conferência é especialmente relevante quando existe documento no nome errado em operações por conta e ordem. O problema deve ser resolvido na documentação admissível e nos fatos; uma observação livre na nota pode não ser suficiente.
Um dicionário de campos que começa pela evidência
Os campos abaixo ajudam a organizar a conversa entre fiscal e TI. Não são uma prescrição de código para todo SaaS, nem substituem as regras completas do leiaute.
| Dado | O que precisa ser definido antes | Cuidado de preenchimento |
|---|---|---|
| Tomador/adquirente | Quem ocupa esse papel no fornecimento | Não escolher apenas pelo pagador |
| Destinatário | Quem recebe o fornecimento na hipótese aplicável | Distinguir do adquirente quando necessário |
| Descrição do serviço | Qual obrigação foi prestada | Separar operações quando a análise assim exigir |
| cIndOp | Hipótese de localização da operação | Código de seis dígitos; não é CNAE |
| CST de IBS/CBS | Situação tributária fundamentada | A NT 004 prevê três dígitos |
| cClassTrib | Classificação correspondente ao tratamento | A NT 004 prevê seis dígitos; o código não cria benefício |
| Base e valores | Memória de cálculo compatível com a operação | Conferir redutores, alíquotas e totais conforme a regra aplicável |
| Referências documentais | Documento de origem e vínculo com a operação | Guardar chave, valor e justificativa |
Fonte dos campos: NT 004, grupos e itens indicados.
O Anexo VIII de correlação entre item de serviço, NBS, cClassTrib e cIndOp merece uma ressalva. O próprio portal o descreve como trabalho inicial em desenvolvimento e informa que não há regras de negócio baseadas nele nos ambientes indicados. Não se deve promover essa correlação a enquadramento jurídico obrigatório. Portal RTC, observações do Anexo VIII.
Uma redução de alíquota exige verificar seus requisitos antes de selecionar o código. Da mesma forma, endereço estrangeiro não basta para concluir que houve exportação. O campo deve registrar a conclusão fundamentada, e não produzi-la.
PIS/Cofins próprios e retenções ainda precisam de campos corretos
A transição não permite tratar todos os valores de PIS/Cofins como retenção. A NT 007 esclarece que vPis e vCofins representam valores de débitos próprios na operação. As retenções de PIS, Cofins e CSLL são agrupadas em vRetCSLL, conforme o indicador tpRetPisCofins. O nome do campo não significa que ele contenha apenas CSLL. NT 007, item 2, c, pp. 4 a 6.
A mesma nota esclarece que essa forma de informar não altera a escrituração na EFD-Reinf. A integração precisa distinguir contribuição própria, retenção e obrigação de informar. Somar ou deslocar valores apenas porque os nomes dos campos parecem semelhantes pode distorcer a nota e o fechamento.
Os domínios de indicadores também possuem transição. Antes de alterar uma enumeração do sistema, a equipe deve conferir o marco de exigência e a versão correspondente. A publicação de uma nota técnica não é autorização para remover antecipadamente códigos ainda contemplados no período de adaptação.
Repasses, cancelamento e substituição precisam de rastro
A NT 004 prevê o grupo gReeRepRes, com referências documentais e valores de reembolso, repasse ou ressarcimento. A existência desse grupo não decide se determinada quantia pode ser excluída da base. Essa conclusão depende da análise de reembolso de despesas e conta e ordem. NT 004, item 2.1.3.
Se a documentação está errada, é preciso identificar o evento admitido. O manual da API explica que a substituição envolve nova NFS-e e evento de cancelamento por substituição da anterior após as validações pertinentes. Isso não autoriza qualquer mudança de tomador nem fixa prazo único para todos os municípios. Manual da API de contribuintes, itens 1.2, 1.3.2 e 1.5.
O controle proposto é conservar a chave original, a nova chave, o evento, a resposta e a razão da alteração. A conferência de crédito nas compras precisa acompanhar qual documento permanece válido e quais efeitos devem ser revistos.
Contar solicitações não é contar notas válidas
A Declaração de Prestação de Serviço, DPS, passa pelas validações para geração da NFS-e. Uma solicitação rejeitada não equivale a uma nota autorizada. Uma substituição, por sua vez, muda a quantidade acumulada de documentos sem necessariamente aumentar a quantidade de notas válidas ao final.
Considere cinco DPS iniciais fictícias: quatro são aceitas e uma é rejeitada. Em seguida, uma das quatro notas é substituída por nova solicitação aceita. O resultado é o seguinte:
| Medida do lote fictício | Cálculo | Quantidade |
|---|---|---|
| Solicitações transmitidas | 5 iniciais + 1 de substituição | 6 |
| NFS-e emitidas ao longo do processo | 4 iniciais + 1 nova | 5 |
| NFS-e válidas ao final | 3 preservadas + 1 substituta | 4 |
| Notas canceladas por substituição | 1 original substituída | 1 |
| Solicitações rejeitadas | 1 sem geração de NFS-e | 1 |
Dados da figura
| Categoria | Valor |
|---|---|
| Solicitações | 6 |
| Notas emitidas | 5 |
| Notas válidas | 4 |
| Notas canceladas | 1 |
| Rejeições | 1 |
As colunas medem objetos diferentes e não devem ser somadas. Conferir apenas seis respostas recebidas não comprova seis notas válidas. Esse exemplo é uma proposta de reconciliação baseada no funcionamento descrito no manual; não resulta de emissão real ou teste realizado pela TaxUp.
O plano de homologação de ERP para SaaS amplia essa lógica para cenários positivos, rejeições, eventos e fechamento. Antes de liberar o faturamento, a equipe precisa saber o que foi aprovado, o que foi rejeitado e o que mudou depois da emissão.
Perguntas frequentes
Existe um cClassTrib único para todas as receitas SaaS?
Não é seguro escolher um código somente pela expressão SaaS. A classificação precisa refletir a operação e o tratamento tributário fundamentado. Licença, implantação, suporte e intermediação podem exigir análises diferentes, inclusive de documento e calendário.
A NT 009 pode ser usada em produção porque já foi publicada?
A publicação não comprova disponibilidade. No cronograma consultado no Portal RTC, a NT 009 não estaria disponível em produção e produção restrita em agosto de 2026. A implementação precisa observar o ambiente, os anexos e as atualizações oficiais pertinentes.
Quem paga a fatura deve sempre constar como tomador?
Não. O pagamento pode ser centralizado por uma pessoa distinta daquela que adquiriu o serviço. O contrato e os fatos precisam identificar os papéis. A NT 004 distingue informações do tomador/adquirente e do destinatário; o documento não deve alterar esses fatos para atender a um crédito pretendido.
O campo de reembolso prova que o valor não é tributado?
Não. O grupo técnico permite informar referências e valores. O tratamento da base depende do enquadramento jurídico e da documentação da operação. Um custo próprio não se transforma em conta e ordem pela seleção de um campo.
Este artigo fornece um XML pronto para transmitir?
Não. Ele fornece critérios, campos e casos de conferência. Um arquivo executável precisa ser confrontado com o esquema, os anexos, os parâmetros municipais e a versão disponível no ambiente. Nenhum XML foi transmitido ou homologado como parte deste material.
Discutir um caso concreto da sua empresa
30 minutos com consultor sênior. Mapeamos o cenário tributário específico, identificamos as oportunidades aplicáveis e indicamos o caminho técnico — independentemente de você seguir conosco.
Agendar diagnóstico gratuito 30 minutos com consultor sênior. Sem compromisso.