Central de Ajuda Quaza Provedores

NFe modelo 55 é a nota fiscal para mercadoria (produto físico que sai do estoque pro cliente). Esta wiki cobre o módulo NFe ponta a ponta: quando emitir, como configurar, o fluxo Espelho → Criada → Transmitida → Protocolada, as ações da nota, cancelamento, Carta de Correção, manifestação e troubleshooting. Para provedor de internet, NFe sai principalmente quando vende equipamento (roteador, ONU, decoder, antena) — para serviço use NFSe , para internet/telefonia use NFCom .

Quando emitir NFe (e quando NÃO)

NFe modelo 55 cobre mercadoria — coisa física que sai do seu estoque e vai pro cliente. Para um provedor de internet, isso é menos frequente que outros documentos fiscais. Resumo de quando emitir cada:

Passo a passo — emitir sua primeira NFe

Roteiro mínimo, do zero até o DANFE na mão do cliente:

Fluxo geral — do espelho ao DANFE

Glossário

Configuração — pré-requisitos

Antes de emitir a primeira NFe, configure a Empresa NFe. É lá que o Quaza decide UF/endpoint, regime tributário, certificado, ambiente.

Produto fiscal — linkagem com estoque

NFe é diferente de NFCom/NFSe porque cobre produto físico. Cada item da NFe precisa apontar pra um cadastro de produto com classificação fiscal completa. O Quaza encadeia: Equipamento (cadastro) → Produto (estoque + classificação fiscal).

Tela de NFe — listagem e detalhe

Duas telas que trabalham juntas: listagem + detalhe. Navega-se da listagem pro detalhe pelo ícone da coluna de editar (lápis).

Listagem

Lista todas as NFes (espelhos, criadas, transmitidas, protocoladas, rejeitadas, canceladas, inutilizadas) com filtros por período, situação, cliente, série, ambiente. Ordenada por número decrescente.

Listagem de NFe — a lupa/lápis na coluna de ações abre o detalhe; o ícone da impressora baixa o DANFE direto da listagem.

Detalhe / formulário

Onde você confere/edita os dados antes de transmitir, e de onde dispara todas as ações. Quando a nota está em Protocolada ou Cancelada, a tela vira somente leitura — só as ações do painel lateral funcionam.

Formulário de edição da NFe — cabeçalho (cliente, natureza, série), itens (com NCM/CFOP/CST e tributos), totalizadores, transporte, cobrança, pagamento.

O formulário é organizado em abas:

• Principal — dados gerais (cliente, série, natureza, observações) e os itens da nota.
• Transporte — modalidade de frete, transportadora, peso, placa, volumes.
• Protocolo — protocolos retornados pela SEFAZ (autorização, cancelamento, manifestações). O contador entre parênteses mostra a quantidade.
• Carta correção — só aparece quando há pelo menos uma CCe registrada na nota.
• Histórico — registro de alterações da nota.

Estados da nota e transições

Anatomia do XML 4.00

NFe versão atual: 4.00, namespace http://www.portalfiscal.inf.br/nfe. A integração usa a lib NFePHP/sped-nfe pra montar, assinar e transmitir.

<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
<infNFe Id="NFe43260512345..." versao="4.00">
<ide>
<cUF>43</cUF>                                     # codigo IBGE da UF do emitente
<cNF>87654321</cNF>                               # codigo numerico aleatorio (8 digitos)
<natOp>Venda de mercadoria</natOp>
<mod>55</mod>                                     # modelo fiscal (55 = NFe)
<serie>1</serie>
<nNF>12345</nNF>                                  # numero sequencial da serie
<dhEmi>2026-05-12T10:00:00-03:00</dhEmi>          # data/hora emissao
<dhSaiEnt>2026-05-12T10:00:00-03:00</dhSaiEnt>    # data/hora saida (opcional)
<tpNF>1</tpNF>                                    # 0=entrada, 1=saida
<idDest>1</idDest>                                # 1=interna, 2=interestadual, 3=exterior
<cMunFG>4310902</cMunFG>                          # codigo IBGE do municipio fato gerador
<tpImp>1</tpImp>                                  # 0=sem DANFE, 1=retrato, 2=paisagem, 4/5=NFC-e
<tpEmis>1</tpEmis>                                # 1=normal, 6=SVC-AN, 7=SVC-RS (contingencia)
<cDV>5</cDV>                                      # digito verificador da chave (calculado)
<tpAmb>1</tpAmb>                                  # 1=Producao, 2=Homologacao
<finNFe>1</finNFe>                                # 1=normal, 2=complementar, 3=ajuste, 4=devolucao
<indFinal>1</indFinal>                            # 0=normal, 1=consumidor final
<indPres>1</indPres>                              # 1=presencial, 2=internet, 4=teleatendimento, 9=outros
<procEmi>0</procEmi>                              # 0=emissao com aplicativo do contribuinte
<verProc>1</verProc>                              # versao do aplicativo emissor
</ide>
<emit>                                              # EMITENTE (sua empresa)
<CNPJ>12345678000100</CNPJ>
<xNome>Empresa Exemplo LTDA</xNome>
<xFant>Empresa Exemplo</xFant>                    # nome fantasia (opcional)
<enderEmit>...</enderEmit>
<IE>1234567890</IE>                               # inscricao estadual
<CRT>1</CRT>                                      # 1=Simples, 2=Lucro Real, 3=Lucro Presumido
</emit>
<dest>                                              # DESTINATARIO (cliente)
<CPF>12345678901</CPF>                            # ou <CNPJ> se PJ
<xNome>Cliente Exemplo</xNome>
<enderDest>...</enderDest>
<indIEDest>9</indIEDest>                          # 1=contribuinte, 2=isento, 9=nao contribuinte
<email>cliente@exemplo.com.br</email>             # opcional, max 60 chars
</dest>
<det nItem="1">                                     # ITEM 1
<prod>
<cProd>ROUTER-AC1200</cProd>                    # codigo interno do produto
<cEAN>7891234567890</cEAN>                      # codigo de barras
<xProd>Roteador Wi-Fi AC1200</xProd>
<NCM>85176294</NCM>                             # classificacao Mercosul (8 digitos)
<CFOP>5102</CFOP>                               # 5xxx=saida intra, 6xxx=saida inter
<uCom>UN</uCom>                                 # unidade comercial
<qCom>1.0000</qCom>                             # quantidade
<vUnCom>299.90</vUnCom>                         # valor unitario
<vProd>299.90</vProd>                           # valor total do item
<indTot>1</indTot>                              # 1=valor compoe o total da NF, 0=nao
</prod>
<imposto>
<ICMS>                                          # ou <ICMSSN> se Simples Nacional
<ICMS00>                                      # CST 00 = tributada integralmente
<orig>0</orig>                              # 0=nacional, 1/2/3=importada
<CST>00</CST>
<modBC>3</modBC>                            # modalidade base de calculo
<vBC>299.90</vBC>                           # base de calculo
<pICMS>17.00</pICMS>                        # aliquota
<vICMS>50.98</vICMS>                        # valor do ICMS
</ICMS00>
</ICMS>
<IPI>...</IPI>                                  # CST 99 = outras (provedor revendedor)
<PIS>...</PIS>
<COFINS>...</COFINS>
</imposto>
</det>
<total>
<ICMSTot>
<vBC>299.90</vBC>                               # base de calculo ICMS
<vICMS>50.98</vICMS>
<vProd>299.90</vProd>
<vFrete>0.00</vFrete>
<vSeg>0.00</vSeg>                               # seguro
<vDesc>0.00</vDesc>                             # desconto
<vNF>299.90</vNF>                               # valor TOTAL da nota
<vTotTrib>50.98</vTotTrib>                      # Lei Transparência: total de tributos federais+estaduais+municipais
</ICMSTot>
</total>
<transp>                                            # TRANSPORTE
<modFrete>9</modFrete>                            # 0=emitente, 1=destinatario, 2=terceiros, 3=propria/rem, 4=propria/dest, 9=sem
<transporta>                                      # se modFrete = 0,1,2 ou 3
<CNPJ>...</CNPJ>
<xNome>Transportadora X</xNome>
</transporta>
<vol>                                             # volumes transportados
<qVol>1</qVol>                                  # quantidade
<esp>CAIXA</esp>                                # especie
<pesoB>0.500</pesoB>                            # peso bruto kg
<pesoL>0.450</pesoL>                            # peso liquido kg
</vol>
</transp>
<pag>                                               # PAGAMENTO
<detPag>
<tPag>01</tPag>                                 # 01=dinheiro, 02=cheque, 03=cartao cred, 04=cartao deb, 05=crediario, 15=boleto, 17=pix, 90=sem pgto, 99=outros
<vPag>299.90</vPag>
</detPag>
</pag>
<infAdic>                                           # informacoes adicionais (opcional)
<infCpl>Texto livre p/ contador/cliente</infCpl>  # ate 5000 chars
</infAdic>
<infRespTec>                                        # responsavel tecnico do software emissor
<CNPJ>35786059000131</CNPJ>                       # CNPJ do responsavel tecnico (parceiro)
<xContato>Pixel Midia Digital</xContato>
<email>atendimento@pixelmidia.com.br</email>
</infRespTec>
</infNFe>
<Signature>...</Signature>                            # assinatura digital A1
</NFe>

Tela de adicionar/editar — barra de ações

A tela de edição da NFe tem uma área de botões fixa à direita, com as ações disponíveis para a nota — mesma estrutura que aparece em NFCom e NFSe . Os botões aparecem dinamicamente conforme o estado da nota.

Área de botões em NFe Protocolada — botões visíveis numerados. Os botões que dependem de outras situações (Processar, Gerar nota) não aparecem aqui; veja a tabela abaixo.

Lista de botões

Tarefas automáticas — geração e transmissão

O Quaza tem um conjunto de tarefas que rodam em horários programados e cuidam de gerar, transmitir e reprocessar NFes sem intervenção manual. As tarefas são lidas a partir da crontab do servidor — cada linha da crontab aponta para um arquivo PHP de uma tarefa e define a frequência (diária, a cada X minutos, etc).

Configuração-chave: "Geração automática de notas"

Antes de qualquer coisa, existe uma configuração global que rege se o sistema gera notas sozinho. Sem ela ligada, as tarefas de geração não fazem nada — mesmo ativas e rodando.

Tarefas relacionadas a NFe

Onde ver se uma tarefa falhou

Quando uma tarefa dá erro:

1. O Quaza envia e-mail para o endereço configurado na própria tarefa (campo "E-mail" em Admin → Tarefas → [a tarefa]).
2. O campo Resumo da tarefa mostra o que aconteceu na última execução.
3. NFes que falharam ficam em situação Rejeitada (4) com motivo na aba Protocolo — corrija o cadastro e a próxima execução da 511 retransmite.

DANFE — o PDF

O DANFE (Documento Auxiliar da NFe) é o PDF gerado após autorização. Não é a nota fiscal — a nota é o XML. O DANFE é representação visual com QR Code que permite consultar o XML no portal nacional.

Cancelamento e Carta de Correção

Cancelamento — prazo de 24h

NFe Protocolada pode ser cancelada em até 24h da autorização. O sistema envia um pedido de cancelamento à SEFAZ (não é uma nova NFe — é um evento vinculado à original), com justificativa de no mínimo 15 caracteres.

Carta de Correção (CCe) — prazo de 30 dias

Permite corrigir campos textuais não-fiscais em até 30 dias da autorização. O sistema envia o pedido de correção à SEFAZ com um texto entre 15 e 1000 caracteres descrevendo o que está sendo corrigido.

Manifestação do destinatário

Quando alguém emite NFe contra o CNPJ da sua empresa (como destinatário PJ), você pode/deve manifestar dizendo o que aconteceu. No Quaza, o operador acessa a tela de manifestação, informa a chave de acesso da NFe e escolhe o evento.

Inutilização de numeração

Inutilização queima um intervalo de números que nunca foram usados — corrige pulos na numeração fiscal. Use quando, por algum motivo, gerou o número 1, 2, 4 e pulou o 3 (falha de sistema, gravação interrompida, etc).

Importação de XML — NFe de compra

Quando seu provedor compra equipamento, o fornecedor emite uma NFe contra seu CNPJ e envia o XML. O Quaza tem uma tela pra importar esse XML — ele lê, valida e gera movimentações de estoque automaticamente, sem precisar lançar item por item.

Endpoints SEFAZ por UF

Cada estado tem seu próprio webservice SEFAZ pra NFe modelo 55. O Quaza decide automaticamente baseado na UF da empresa emissora — você só configura a UF e o ambiente. Não configure URL.

Operações suportadas em todos: Autorização, Consulta, Status Serviço, Inutilização, Recepção de Evento, Consulta Cadastro.

Tributos calculados

NFe é a mais complexa das notas em tributação. O Quaza calcula tudo a partir do Produto (com NCM e situação tributária) + CRT da empresa + UF do destinatário.

De onde vêm os dados

Como ler erros e debugar

Onde achar a mensagem de erro

1. Abra a NFe Rejeitada (situação 4).
2. Vá na aba Protocolo — mostra todos os retornos da SEFAZ com cStat + xMotivo (texto do erro).
3. Botão XML do painel lateral mostra o XML enviado — confira o campo apontado pelo erro.

Códigos cStat mais comuns na NFe

Pegadinhas frequentes

FAQ

Documentos relacionados