Resumo rápido
- O XML da NFCom segue uma ordem fixa: ide, emit, dest, assinante, det, total, gFat, infAdic e gRespTec, mais infNFComSupl (QR Code) e a assinatura.
- Cada item (det) exige cClass de 7 dígitos, CFOP, unidade de medida, quantidade, valores e o grupo de impostos.
- Os totais precisam bater exatamente com a soma dos itens; divergência de centavos gera rejeição.
- gSub, gCofat, gFatCentral e indSemCST só entram em situações específicas (substituição, cofaturamento, faturamento centralizado e item sem ICMS).
- A maioria das rejeições nasce de cadastro incompleto do assinante e de tributação incoerente entre cClass, CFOP e CST.
Os campos obrigatórios da NFCom modelo 62 estão distribuídos em grupos do XML definidos no layout versão 1.00, publicado no Portal NFCom (SVRS) e detalhado no Manual de Orientação do Contribuinte (MOC). Toda nota precisa, no mínimo, de identificação (ide), emitente (emit), destinatário (dest), assinante (assinante), ao menos um item (det) com seus impostos, totais (total) e, na nota normal, os dados da fatura (gFat).
Abaixo, cada grupo aparece com uma tabela "campo, o que é e dica para provedor", seguida dos grupos condicionais e dos erros de preenchimento mais comuns. Se você está começando agora, leia antes o guia completo de NFCom.
Campos obrigatórios da NFCom: como o XML é organizado
O documento raiz é NFCom, no namespace http://www.portalfiscal.inf.br/nfcom. Dentro dele ficam infNFCom (os dados da nota, com o atributo Id="NFCom" seguido da chave de acesso de 44 dígitos), infNFComSupl (o QR Code) e Signature (a assinatura digital). A ordem dos grupos é validada pelo schema: um grupo fora de lugar derruba a nota antes mesmo das regras de negócio.
| Ordem | Grupo | Quando aparece |
|---|---|---|
| 1 | ide | Sempre |
| 2 | emit | Sempre |
| 3 | dest | Sempre |
| 4 | assinante | Sempre |
| 5 | gSub | Só em nota de substituição |
| 6 | gCofat | Só em cofaturamento |
| 7 | det | Sempre (1 a n itens) |
| 8 | total | Sempre |
| 9 | gFat | Omitido em nota de ajuste |
| 10 | infAdic | Opcional |
| 11 | gRespTec | Conforme exigência da UF |
Para ver todos esses grupos montados em um documento, consulte o exemplo comentado de XML da NFCom.
ide: identificação da nota
| Campo | O que é | Dica para provedor |
|---|---|---|
cUF | Código IBGE da UF do emitente | Define também o autorizador: SVRS para 24 UFs; MG, MS e MT têm ambiente próprio. |
tpAmb | 1 produção, 2 homologação | Teste sempre em homologação antes de virar a chave. |
mod | Modelo do documento | Sempre 62. |
serie / nNF | Série e número da nota | A numeração é sequencial por série; nunca reutilize número já transmitido. |
cNF / cDV | Código numérico aleatório e dígito verificador da chave | Gerados pelo emissor; não devem ser digitados. |
dhEmi | Data e hora de emissão com fuso (AAAA-MM-DDThh:mm:ss-03:00) | Servidor com relógio errado ou fuso ausente é causa clássica de rejeição. |
tpEmis | 1 normal, 2 contingência | Em contingência, o schema exige dhCont e xJust. |
nSiteAutoriz | Identificação do site do autorizador | Preenchido pelo emissor, compõe a chave. |
cMunFG | Município do fato gerador (código IBGE) | Use a tabela IBGE, não o nome da cidade. |
finNFCom | 0 Normal, 3 Substituição, 4 Ajuste | A fatura mensal comum é sempre 0. |
tpFat | 0 Normal, 1 Centralizado, 2 Cofaturamento | 1 e 2 ativam grupos adicionais (veja os condicionais). |
verProc | Versão do aplicativo emissor | Informado automaticamente pelo software. |
Há ainda campos opcionais, como indPrePago (serviço pré-pago) e gCompraGov (compras governamentais), que só entram quando a operação exige.
emit e dest: emitente e destinatário
| Campo | O que é | Dica para provedor |
|---|---|---|
emit/CNPJ | CNPJ do estabelecimento emitente | Deve ser o mesmo CNPJ do certificado digital usado na assinatura. |
emit/IE | Inscrição estadual do emitente | Precisa estar ativa no cadastro da SEFAZ da UF de emissão. |
emit/CRT | Código de regime tributário | Tem de ser coerente com o grupo de ICMS usado nos itens (Simples Nacional usa ICMSSN). |
emit/xNome e enderEmit | Razão social e endereço | Endereço com município em código IBGE e CEP válido. |
dest/xNome | Nome do tomador do serviço | Evite abreviações e caracteres especiais que o sistema de gestão importa errado. |
dest/CPF ou CNPJ | Documento do tomador | CPF ou CNPJ inválido é uma das causas mais frequentes de rejeição. |
dest/IE | Inscrição estadual do tomador, quando contribuinte | A situação do destinatário influencia o CFOP escolhido. |
enderDest | Endereço do tomador | Código de município e UF precisam ser coerentes entre si. |
assinante: o grupo específico de telecom
O grupo assinante é o que diferencia a NFCom de outros documentos fiscais: ele descreve a relação contratual entre o provedor e o cliente.
| Campo | O que é | Dica para provedor |
|---|---|---|
iCodAssinante | Código do assinante no sistema do emitente | Use o ID do cliente no seu sistema de gestão, estável ao longo do tempo. |
tpAssinante | Tipo de assinante | 1 Comercial, 2 Industrial, 3 Residencial/Pessoa física, 4 Produtor rural, 5 Órgão da administração pública estadual, 6 Prestador de telecom responsável pelo recolhimento, 7 Missões diplomáticas, 8 Igrejas e templos, 99 Outros. |
tpServUtil | Tipo de serviço utilizado | 1 Telefonia, 2 Comunicação de dados, 3 TV por assinatura, 4 Provimento de acesso à internet, 5 Multimídia, 6 Outros, 7 Vários. |
nContrato | Número do contrato | Mantenha o mesmo número em todas as faturas do contrato. |
dContratoIni / dContratoFim | Início e fim do contrato | A data de fim só é informada quando existe. |
A descrição completa das tabelas de tpAssinante e tpServUtil está no MOC da NFCom; confira sempre a versão vigente, porque notas técnicas podem alterá-las.
det e prod: os itens da fatura
Cada serviço cobrado vira um det, numerado pelo atributo nItem. Dentro dele, o grupo prod descreve o serviço:
| Campo | O que é | Dica para provedor |
|---|---|---|
cProd / xProd | Código e descrição do serviço | Use o código do plano no sistema e uma descrição clara para o assinante. |
cClass | Classificação do item (7 dígitos) | Ex.: 0100401 assinatura SCM; 0600501 instalação; 0800601 roteador; 1000301 juros de mora. |
CFOP | Natureza da prestação | Grupo 5.30x/6.30x; para pessoa física o comum é 5.307/6.307. Valide com a contabilidade. |
CNPJLD | CNPJ da operadora de longa distância | Só em cofaturamento. |
uMed | Unidade de medida | 1 minuto, 2 MB, 3 GB, 4 UN. |
qFaturada | Quantidade faturada | Para assinatura mensal, normalmente 1 UN. |
vItem / vProd | Valor unitário e valor total do item | Arredondamento diferente entre sistema de gestão e emissor gera divergência de totais. |
vDesc / vOutro | Desconto e outros valores | Informe o desconto no item, não "embutido" no preço. |
dExpiracao / indDevolucao | Expiração de crédito e indicador de devolução | Usados em cenários como pré-pago e devoluções. |
A tabela oficial de cClass é publicada no Portal NFCom e atualizada por notas técnicas. A escolha certa do cClass conversa diretamente com o CFOP e com o CST, como detalhado em CST da NFCom para provedor.
imposto: tributos por item
| Grupo | O que é | Dica para provedor |
|---|---|---|
ICMS00, ICMS20, ICMS40, ICMS51, ICMS90 | ICMS por situação tributária (o grupo 40 atende CST 40 e 41) | Use apenas um grupo de ICMS por item, coerente com o CST. |
ICMSSN | ICMS do Simples Nacional | Para emitentes optantes do Simples. |
pFCP / vFCP | Fundo de Combate à Pobreza | Aparece nos grupos 00 e 20 quando a UF exige. |
ICMSUFDest | ICMS devido à UF de destino | Relevante em prestações interestaduais, conforme a legislação. |
PIS / COFINS | Contribuições federais | O emissor SyncNFe aceita os CST 01, 02, 06, 07, 08, 09 e 49. |
FUST / FUNTTEL | Contribuições setoriais de telecom | Informe quando aplicável ao seu enquadramento. |
retTrib | Retenções de tributos | Comum em clientes órgãos públicos e algumas empresas. |
IBSCBS | Grupo da reforma tributária (NT 2025.001) | 2026 é ano de transição; acompanhe as notas técnicas. |
total, gFat e infAdic
| Campo | O que é | Dica para provedor |
|---|---|---|
total/vProd | Soma dos itens | Deve ser exatamente a soma dos vProd dos itens. |
ICMSTot | vBC, vICMS, vICMSDeson, vFCP | Somatórios dos grupos de ICMS dos itens. |
vPIS, vCOFINS, vFUST, vFUNTTEL, vRetTribTot | Totais de contribuições e retenções | Nunca digite totais à mão: deixe o emissor somar. |
vDesc, vOutro, vNF | Descontos, outros valores e valor da nota | O vNF precisa fechar com a regra de cálculo do MOC. |
IBSCBSTot / vTotDFe | Totais da reforma tributária | Presentes quando os grupos de IBS/CBS são usados. |
gFat | Dados da fatura (competência, vencimento, período de uso, cobrança) | Omitido na nota de ajuste; na nota normal, espelha o boleto ou PIX do mês. |
infAdFisco | Informações de interesse do fisco | Até 2.000 caracteres. |
infCpl | Informações complementares | Até 5 ocorrências de até 3.000 caracteres cada. |
gRespTec, infNFComSupl e assinatura
gRespTec: identifica o responsável técnico pelo software emissor. A exigência varia por UF; o emissor SyncNFe gera o grupo para emitentes de MG.infNFComSupl/qrCodNFCom: URL do QR Code impresso no DANFE-COM. No SVRS, o padrão éhttps://dfe-portal.svrs.rs.gov.br/NFCom/QRCode?chNFCom={chave}&tpAmb={1|2}; MG, MS e MT têm URL própria.Signature: assinatura digital com certificado ICP-Brasil (A1 ou A3) do CNPJ emitente.
Campos condicionais da NFCom modelo 62: quando entram
| Campo ou grupo | Quando usar | Dica para provedor |
|---|---|---|
gSub | Nota de substituição (finNFCom=3) | Informe o motivo (motSub: 01 erro de preço, 02 erro cadastral, 03 decisão judicial, 04 erro de tributação, 05 descontinuidade do serviço) e a nota substituída: chave da NFCom ou, na migração, série, número, competência e hash115 da nota 21/22. |
gCofat | Cofaturamento (tpFat=2) | Referencia o documento da operadora cofaturada; os itens usam CNPJLD e cClass de cofaturamento. |
gFatCentral | Faturamento centralizado (tpFat=1) | Usado quando um estabelecimento centraliza a fatura de outros; confira os requisitos no MOC. |
indSemCST | Item sem ICMS | Informado com valor 1 no lugar do grupo de ICMS, por exemplo em itens como juros e multa, conforme a orientação da contabilidade. |
dhCont / xJust | Contingência (tpEmis=2) | Data/hora de entrada em contingência e justificativa. |
Erros comuns no preenchimento dos campos da NFCom
- CPF/CNPJ inválido ou ausente no destinatário, geralmente herdado de cadastro antigo.
- Município sem código IBGE ou divergente da UF informada.
- Totais que não fecham por arredondamento diferente entre o sistema de gestão e o emissor.
- cClass incompatível com o CFOP ou com o grupo de ICMS usado (por exemplo, SVA tributado como SCM).
- CRT incoerente com o grupo de ICMS (regime normal usando
ICMSSN, ou o contrário). - dhEmi com fuso errado ou relógio do servidor desajustado.
- Grupo fora de ordem ou vazio em integrações que montam o XML manualmente.
- Certificado de outro CNPJ ou vencido na assinatura.
Para entender como a SEFAZ responde a esses erros e como corrigir cada um, veja NFCom rejeitada: códigos e soluções.
Regra geral x emissor
O que está nas tabelas acima é o layout oficial. O que muda de um emissor para outro é quanto disso é preenchido e validado automaticamente. No emissor de NFCom da SyncNFe, os grupos são montados a partir do cadastro e do faturamento (MKAuth, MikWeb, BeesWeb, MKMAuth ou API), com totais calculados pelo sistema. Quer conferir com a sua base? Faça um teste grátis.
Conteúdo informativo. Regras de tributação, CFOP, CST e prazos variam por UF e mudam com novas notas técnicas; valide o enquadramento da sua operação com a contabilidade e a SEFAZ competente. Base normativa: Ajuste SINIEF 7/22 e Portal da NFCom (SVRS).