Como transmitir a NFCom
Web services, registro de eventos, consulta pública, contingência off-line e a regra do número de protocolo, como o Manual de Orientação do Contribuinte da NFCom define. Os números desta página saem do manual, não de recomendação nossa.
Este manual é de 25/01/2023, de antes de a NFCom obrigar (01/10/2026)
O MOC 1.00a da NFCom foi publicado em janeiro de 2023 e não foi reeditado para a Reforma. O que mudou na NFCom chegou por Nota Técnica, e as 3 publicadas até agora alteram campos e regras de validação — não o transporte.
- NT 2025.001 RTC 1.14a (12/03/2026) — campos e regras de validação do grupo IBS/CBS
- NT 2026.001 RTC Vinculação de Pagamento 1.01 (11/03/2026) — vinculação de pagamento
- NT 2026.002 1.01 (16/07/2026) — exigência de IBS/CBS, motivo de substituição, Suframa, devolução, antecipação de pagamento
Ou seja: web services, QR Code, consulta pública, contingência e protocolo continuam sendo os desta página; o leiaute e as regras de preenchimento, não. Para os campos, veja a vertical da NFCom.
O modelo de comunicação
Um web service por serviço
Com um método para cada tipo de serviço. O envio da solicitação e a obtenção do retorno acontecem na mesma conexão, por um único método — não há segunda chamada para buscar o resultado.
Sempre iniciado pelo contribuinte
Mensagem em XML e SOAP, sobre TLS com autenticação mútua. Qualquer erro na validação dos dados recebidos interrompe o processo e devolve código e descrição do erro.
As URLs não estão no manual — e isso é da fonte
O endereço é de cada Unidade Federada e o MOC manda buscá-lo no Portal Nacional da NFCom.
O WSDL de cada serviço se obtém acessando o endereço do web service seguido de
?WSDL.
Os 8 tipos de evento
O web service de evento é único e genérico: a parte comum é igual para todos e o
XML específico de cada tipo entra numa tag any.
É o desenho que permite criar evento novo sem serviço novo.
⚠ Todos os 8 exigem que a NFCom já exista na base do autorizador.
| Código | Evento | Autor | Meio |
|---|---|---|---|
| 110111 | Cancelamento | 1-Empresa Emitente | 1=via WS Evento |
| 240140 | Autorizada NFCom de Substituição | 2-Fisco Emitente | 1=via WS Evento |
| 240150 | Autorizada NFCom de Ajuste | 2-Fisco Emitente | 1=via WS Evento |
| 240151 | Cancelada NFCom de Ajuste | 2-Fisco Emitente | 1=via WS Evento |
| 240160 | Autorizada NFCom de Cofaturamento | 2-Fisco Emitente | 1=via WS Evento |
| 240161 | Cancelada NFCom de Cofaturamento | 2-Fisco Emitente | 1=via WS Evento |
| 240162 | Substituída NFCom de Cofaturamento | 2-Fisco Emitente | 1=via WS Evento |
| 240170 | Liberação Prazo Cancelamento | 2-Fisco Emitente | 1=via WS Evento; |
Os eventos de marcação (quando um documento referencia outro, como substituição e nota de ajuste) são gerados automaticamente pelo Fisco no momento da autorização, assinados com o certificado da SEFAZ, e aparecem na consulta pública do documento referenciado.
A consulta pública e os 8 códigos que ela devolve
A consulta é feita pela digitação dos 44 caracteres da chave de acesso impressa no DANFE-COM ou pela leitura do QR Code. A mensagem exibida é deliberadamente genérica — o MOC diz que detalhar o erro em excesso seria "de pouco interesse e apenas poderá acabar por gerar dúvidas e inseguranças" para quem recebeu a fatura.
quando Se a Chave de Acesso da NFCom não preenchida ou com menos de 44 caracteres.
quando Se dígito verificador da Chave de Acesso da NFCom inválido
quando Se o modelo constante da Chave de Acesso difere de 62 (NFCom) ou CNPJ do emitente constante na Chave de Acesso com dígito verificador inválido ou UF da chave de acesso diferente do código da UF da consulta.
quando Se o parâmetro tpAmb (Identificação do ambiente) não preenchido ou difere de 1 ou 2 no QRCODE.
quando Se a forma de emissão for 1 (normal) e a NFCom da chave de acesso não encontrado na base de dados.
quando Se a forma de emissão for 2 (contingência off-line) e a NFCom não for encontrado na base de dados.
quando Se NFCom possuir evento de cancelamento.
quando Se NFCom possuir evento de Substituição.
Os endereços são padronizados, para o contribuinte não depender de descobrir a URL de cada UF:
- http(s)://URL_da_SEFAZ/NFCom/consulta
- http(s)://URL_da_SEFAZ/NFCom/qrcode
Contingência off-line
⚠ É decisão exclusiva da Unidade Federada: ela pode não autorizar essa modalidade para todos ou para determinados emissores, e existe regra de validação no leiaute para implementar essa decisão. A entrada em contingência, por outro lado, não depende de autorização prévia do Fisco — é decisão do contribuinte.
O roteiro, na ordem
- Selecionar
tpEmis = 2(contingência off-line). Não há série específica nem papel especial. - Preencher
dhContexJust— data/hora e justificativa da entrada. Nenhum dos dois é impresso no DANFE-COM. - Gerar nova chave de acesso com
tpEmis = 2, mantendo o mesmocNF. - Gerar o QR Code com o parâmetro
sign, que assina a chave de acesso com o certificado que assinou a NFCom. - Imprimir o DANFE-COM com a mensagem "EMITIDA EM CONTINGÊNCIA".
- Transmitir assim que superada a dificuldade técnica, até o fim do primeiro dia útil seguinte.
⚠ Recomendação do próprio manual: avançar um número na sequência ao entrar em contingência, para a NFCom não ser rejeitada depois por duplicidade.
Os três riscos que o manual nomeia
- A NFCom emitida em contingência pode ser rejeitada depois — e a fatura já foi entregue ao cliente.
- Ela só aparece na consulta pública quando for autorizada, o que gera reclamação de quem consulta ao receber a fatura.
- Até constar da base do Fisco, o risco de perda da informação é do contribuinte. Na autorização online o dado já está seguro.
⚠ Emissão em lote dentro da empresa é emissão NORMAL (tpEmis = 1).
A contingência entra quando a transmissão desse faturamento falha por dificuldade técnica — as
demais notas seguem normais.
Consumo indevido: a rejeição 678
O ambiente autorizador mantém controles contra aplicação em loop. São 4 regras, e todas devolvem a mesma rejeição — 678, Consumo Indevido.
| Regra | Crítica | Rejeição | Efeito |
|---|---|---|---|
| CI01 | Facult | 678 | Rej. |
| CI03 | Facult | 678 | Rej. |
| CI04 | Facult | 678 | Rej. |
| CI05 | Facult | 678 | Rej. |
Os gatilhos: mais de 30 rejeições iguais na autorização ou mais de 10 consultas da mesma chave em uma hora, bloqueiam o web service por até uma hora. ⚠ Os números são preferenciais e parametrizáveis por ambiente autorizador — não são garantia. E a critério da UF, após 50 bloqueios o contribuinte pode receber a 678 de forma permanente, até entrar em contato com ela.
A verificação pode ser por CNPJ do certificado de transmissão + IP ou pelo CNPJ do emitente — quem compartilha IP com outro emissor herda o bloqueio.
O número do protocolo, posição por posição
São 16 posições, geradas pelo ambiente autorizador para identificar univocamente cada autorização de uso e cada registro de evento. Serve para ler um protocolo e saber de onde ele veio.
⚠ Protocolo que começa em 2 é site alternativo de contingência do autorizador, com numeração sequencial própria e de forma transparente para a empresa emitente. Junto do protocolo, o DANFE-COM traz data e hora.
Perguntas frequentes
Como a NFCom é transmitida para a SEFAZ?
Por web service, um por serviço, com um método por tipo de serviço. O processo é sempre iniciado pelo contribuinte, com mensagem em XML e SOAP sobre TLS com autenticação mútua. O envio e o retorno acontecem na mesma conexão — não há segunda chamada para buscar o resultado. As URLs são de cada Unidade Federada e ficam no Portal Nacional da NFCom (https://dfe-portal.svrs.rs.gov.br/NFCom); o MOC 1.00a não publica endereço nenhum.
Quantos tipos de evento a NFCom tem?
8: 1 da empresa emitente (cancelamento) e 7 gerados pelo Fisco. ⚠ Todos exigem que a NFCom já exista na base do ambiente autorizador. O web service de evento é único e genérico: o XML específico de cada tipo entra numa tag do tipo any.
O que a consulta pública da NFCom devolve quando algo está errado?
Um dos 8 códigos padronizados (201 a 208), com uma mensagem deliberadamente genérica. O MOC é explícito quanto ao motivo: detalhar o erro em excesso "será de pouco interesse e apenas poderá acabar por gerar dúvidas e inseguranças" para quem recebeu a fatura. Os endereços seguem padrão fixo — http(s)://URL_da_SEFAZ/NFCom/consulta e http(s)://URL_da_SEFAZ/NFCom/qrcode.
Existe contingência para a NFCom?
Existe a contingência off-line (tpEmis = 2), e ela é decisão exclusiva da Unidade Federada: a UF pode não autorizá-la para todos ou para determinados emissores. A entrada em contingência não depende de autorização prévia do Fisco, mas o XML tem de ser transmitido até o fim do primeiro dia útil seguinte, mantendo a mesma chave de acesso e o mesmo cNF. ⚠ Emissão em lote dentro da empresa é emissão NORMAL — a contingência só entra quando a transmissão falha por dificuldade técnica.
Por que minha aplicação recebeu a rejeição 678?
Consumo indevido. O MOC define 4 regras (CI01, CI03, CI04, CI05) que bloqueiam o web service por até uma hora quando a aplicação repete a mesma requisição — mais de 30 rejeições iguais na autorização ou mais de 10 consultas da mesma chave em uma hora. ⚠ Os números são preferenciais e parametrizáveis por ambiente autorizador, e a critério da UF o bloqueio pode virar permanente até o contribuinte procurá-la.
O MOC da NFCom é de 2023. Ele ainda vale?
Vale para o transporte. A NFCom é obrigatória desde 01/10/2026. A Reforma chegou nela por Nota Técnica: a mais recente é a NT 2026.002 1.01, de 16/07/2026. As NTs mudam campos e regras de validação — grupo IBS/CBS, motivo de substituição, Suframa, devolução, antecipação de pagamento — e nenhuma delas altera web services, QR Code, consulta pública, contingência ou protocolo. ⚠ O Buscador NCM publica a data de cada coisa em vez de apresentar tudo com a data de hoje.