NFCom — emissão avulsa¶
Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.
Módulo: Fiscal
Menu: Operações → Fiscal → NFCom
Público: Operador fiscal / Administrador
Status: Publicado
Atualizado: 2026-09-08
Refs técnicas: ADR-021 ·01-ARQUITETURA/66-nfcom-emissao.md·10-FISCAL/02-nfcom.md·NfcomInfCpl·PrepareNfcomXmlForTransmit
O que faz¶
Emite NFCom modelo 62 a partir de um contrato (tela avulsa) ou a partir de uma venda quando o tipo de documento está com Gera fiscal. Cada item da nota herda a classificação fiscal (e o cClass) do produto.
Quem pode usar¶
fiscal.nfcom.read— consultarfiscal.nfcom.create— emitirfiscal.nfcom.transmit— transmitir à SEFAZ
Pré-requisitos¶
- Filial com ambiente (homologação ou produção), CNPJ, IE, UF e certificado A1.
- Filial com numeração na aba Número de Documento (modelo 62 + série igual à do tipo de documento, em geral
1). - Cliente com CPF/CNPJ e tipo de assinante.
- Produtos do contrato/venda com classificação fiscal e cClass.
- Tipo de documento NFCom (código
NFCOM) gerando fiscal.
Passo a passo¶
- Abra Operações → Fiscal → NFCom.
- Clique Nova emissão. A grade some.
- Informe o contrato (ID ou lupa).
- Opcional: data de emissão. Marque Transmitir à SEFAZ para enviar no ambiente da filial.
- Emitir. O sistema monta itens/tributos, assina o XML e, se marcado, transmite.
- Duplo clique na linha ou botão Detalhes abre o detalhe (itens, eventos, status, XML, DANFE, retransmitir se rejeitada).
- Se a SEFAZ rejeitar, o toast mostra a mensagem e a coluna Retorno SEFAZ na grade resume o motivo.
- Imprimir DANFE: marque uma ou várias notas na grade (checkbox) e clique Imprimir DANFE no topo. Também disponível no detalhe e na aba Nota fiscal da venda. Abre a janela de impressão no layout DANFE-COM.
Informações complementares (infCpl)¶
O texto que aparece na nota (e no XML em <infCpl>) não é digitado na venda. Ele vem de:
- Configurações → Filiais → [filial] → aba Fiscal → Informação complementar padrão da NF
- Se a emissão for por contrato: soma também a Info adicional NF do contrato
Exemplos comuns: texto de Simples Nacional, avisos contábeis, frases de teste.
Regras da SEFAZ (schema ER48)¶
- A SEFAZ não aceita quebra de linha (Enter) nem caracteres de controle nesse campo.
- Na emissão e na retransmissão, o Telvora normaliza o texto (troca Enter por espaço, remove caracteres inválidos, máx. 3000).
- Ao retransmitir uma nota rejeitada, o sistema atualiza o XML, reassina e só então envia de novo (não reaproveita o XML antigo com erro).
Regras importantes¶
- Emissão avulsa na tela NFCom exige contrato.
- Emissão pela venda: ao salvar, se o tipo de documento gera fiscal, a NFCom é criada com
sale_ide aparece na grade (coluna Venda) e na aba Nota fiscal da venda. - Tributação não se informa na tela da nota: vem da classificação de cada produto.
- O ambiente (homologação/produção) é o da filial, não um parâmetro da tela.
- Número e série saem da aba Número de Documento da filial (modelo 62 + série do tipo de documento).
- Autorizada não é reenviada.
- Cancelar (AUTHORIZED NORMAL, no prazo) e Emitir substituição estão no detalhe da nota — ver cancelamento e substituição.
- O DANFE é documento auxiliar. Logo vem do cadastro da filial. Linha digitável/código de barras vêm do boleto quando a emissão tiver financeiro (venda/título).
Erros / avisos comuns¶
| Mensagem / situação | O que fazer |
|---|---|
| Informe a IE da filial | Filiais → aba Fiscal → IE |
| Envie o certificado A1 | Filiais → aba Fiscal → arquivo .pfx + senha |
| Arquivo do certificado não está no servidor | Reenvie o .pfx e a senha na filial |
| Senha ou certificado inválido | Confirme a senha do A1 e reenvie o .pfx se necessário |
| Cadastre o número de documento modelo 62… | Filiais → aba Número de Documento → incluir modelo 62 e série |
| Produto sem classificação fiscal | Cadastre Tributação e vincule no produto |
| Produto sem cClass | Preencha cClass no produto |
| Cliente sem tipo de assinante | Cadastro do cliente |
Falha no schema XML / Pattern em infCpl (cStat 215) |
Abra Filiais → Fiscal e revise a Informação complementar padrão da NF (e Info adicional NF do contrato). Depois use Retransmitir na nota — o sistema normaliza e reassina o XML. Se ainda falhar, edite o texto (evite colar do Word) e retransmita de novo |
| Rejeição SEFAZ (outro cStat) | Leia a mensagem no toast / coluna Retorno SEFAZ; ajuste o cadastro e transmita de novo |
| Falha na descompactação (cStat 244) | Problema técnico no envio compactado; retransmita; se persistir, contate suporte |
| CFOP inválido (cStat 433) | Na classificação fiscal do produto use CFOP de comunicação (ex.: 5307). |
| Item sem CFOP no XML (TV, Learning, Book, comodato…) | Esperado pelo MOC quando o item vai com indSemCST (ISSQN, NT, SVA, comodato demonstrativo): a SEFAZ veda CFOP nesses itens. O CFOP pode existir na classificação fiscal do produto, mas não entra no XML. Só itens de comunicação com ICMS (ex.: SCM 5307) trazem <CFOP>. CFOP 5933 não é usado na NFCom. |
| Grupo da fatura (cStat 270) | Problema técnico; contate suporte se persistir após nova emissão |
| Falha de comunicação SSL / certificado emissor | Problema de confiança ICP-Brasil no servidor; contate suporte técnico |
Relacionados¶
- NFCom — cancelamento e substituição
- Empresa e filial — fiscal
- Classificação fiscal
- CFOP
- Vendas (saídas)
