Dicas e tutoriais
DANFE NFC-e com QR Code cortado: como resolver
Atualizado em outubro de 2026. O DANFE NFC-e segue o Manual de Padrões Técnicos do DANFE-NFC-e e QR Code, versão 6.0, de março de 2025, publicado no Portal Nacional da NF-e. Quando o QR Code sai cortado ou o celular não lê, a causa costuma estar na largura configurada, na densidade de impressão, na cabeça térmica suja ou na bobina. As regras podem mudar: confirme sempre a versão vigente no portal e, para o leiaute impresso, fale com o fornecedor do sistema emissor.
Por equipe técnica ASTEC Informática · publicado em
O que o manual do DANFE NFC-e exige (versão 6.0, março de 2025)
| Item | O que diz o manual |
|---|---|
| Largura do papel | Mínimo de 56 mm, com margens laterais de pelo menos 2 mm de cada lado. Também pode ser impresso em A4. |
| Tamanho do QR Code | Mínimo de 25 mm x 25 mm: 22 mm de código e 3 mm de margem livre (“quiet zone”). Acima de 25 mm, a margem livre deve ser de 10% do tamanho total. |
| Posição do QR Code | À esquerda dos dados do consumidor e da identificação da NFC-e, ou centralizado. |
| Padrão do QR Code | ISO/IEC 18004, correção de erros nível M e caracteres UTF-8. |
| Cabeçalho | CNPJ (ou CPF) e razão social do emitente, endereço e o texto “Documento Auxiliar da Nota Fiscal de Consumidor Eletrônica”. |
| Durabilidade | O texto impresso e o papel devem continuar legíveis por no mínimo seis meses. |
| Onde imprimir | Em impressora comum (não fiscal). É proibido imprimir o DANFE NFC-e em ECF, nem como relatório gerencial. |
Dica: O manual explica que 25 mm foi o menor tamanho que os celulares sem zoom conseguiram ler. Se o sistema reduz o QR abaixo disso, o problema não está na impressora.
QR Code cortado: confira a largura da bobina e do driver
- O papel configurado no driver e no sistema precisa ser igual à bobina colocada. No driver Epson APD6, com papel definido pelo usuário, a impressão não é ampliada nem reduzida para caber na largura do papel.
- O APD6 tem a opção de imprimir um leiaute de 80 mm reduzido em papel de 58 mm (nem todo modelo aceita). Reduzir o leiaute também reduz o QR Code: confira se ele continua com pelo menos 25 mm.
- Na Bixolon SRP-S300, o manual pede para não voltar a usar papel mais largo depois de usar um mais estreito: o desgaste desigual do rolete pode prejudicar a impressão.
| Impressora | Largura de papel aceita pelo manual |
|---|---|
| Epson TM-T20X e TM-T20X II | Só 79,5 ± 0,5 mm. A área de impressão máxima é de 72 mm, com cerca de 3,75 mm livres de cada lado. |
| Elgin i8 | 79,5 ± 0,5 mm. |
| Elgin i9 Full | 80 ± 0,5 mm ou 57,5 ± 0,5 mm. Para 58 mm, encaixe o batente lateral na fenda própria. |
| Bixolon SRP-S300 | 80, 62, 58 ou 40 mm, com divisória: para 58 mm, uma divisória na posição 1. A área impressa em 58 mm é de 48 mm. |
| Control iD Print iD | 80 mm (padrão) ou 58 mm, com a peça que vem com a impressora encaixada no compartimento da bobina. |
| Tanca TP-650 | Bobina de 80 mm, papel térmico de 55 g/m² ou mais. |
| Sweda SI-300 SIX | 79,5 ± 0,5 mm de largura e 80 mm de diâmetro. |
Economia de papel e redução de código de barras
- As Epson TM-T20X têm a função de redução automática de papel. Na TM-T20X, ela inclui opções para reduzir espaços, entrelinhas e a altura do código de barras (todas desligadas de fábrica).
- A Epson avisa que, com a altura do código de barras reduzida, a leitura não é garantida, e que é preciso testar a leitura antes de usar.
- No driver APD6, a redução de papel corta só as margens de cima e de baixo do cupom.
- Se o QR Code passou a falhar depois de ligar uma economia de papel, desligue a opção e teste de novo.
QR Code fraco ou falhado: densidade, cabeça e bobina
- Faixa vertical em branco atravessando o QR Code: os manuais Elgin apontam cabeça suja. Se continuar depois da limpeza, a cabeça pode estar danificada.
- Faixa colorida no papel indica fim da bobina: troque o rolo.
- Use papel de boa qualidade, como pedem os manuais Elgin. A Epson pede para evitar papel com o lado térmico pré-impresso, que pode reduzir a densidade.
| Impressora | Onde ajustar a densidade | Limpeza da cabeça térmica |
|---|---|---|
| Epson TM-T20X / TM-T20X II | Modo de configuração (depois do autoteste) ou TM-T20X Utility. TM-T20X: níveis 1 a 7; TM-T20X II: de -3 a +3. Densidade mais alta pode deixar a impressão mais lenta. | Mais ou menos a cada 3 meses, com cotonete umedecido em álcool (etanol ou isopropílico), com a impressora desligada e fria. |
| Elgin i8 | Chave DIP 3 (densidade de impressão). | Algodão levemente umedecido com álcool isopropílico. |
| Elgin i9 Full | Software Utilitário (as configurações das chaves DIP são feitas por software). Níveis 1 a 4. | Algodão levemente umedecido com álcool isopropílico. |
| Elgin i9 Full 2 | Software Utility da impressora. Graus 1 a 4. | Pelo menos 1 vez por semana: desligue, espere 2 a 3 minutos e use algodão ou pano com álcool isopropílico. |
| Bixolon SRP-S300 | Modo VMSM do autoteste (opção 2) ou Unified Utility. | A cada troca de bobina e pelo menos a cada 3 meses, com álcool de uso médico, com a impressora desligada. |
| Tanca TP-650 | Tanca Printer Tool, “Tempo de aquecimento”: de 300 a 800 µs; quanto maior o valor, mais escura a impressão. | A documentação da Tanca não traz o procedimento. |
| Control iD Print iD | O guia rápido não detalha o ajuste. Ele diz só que a interface web altera alguns parâmetros de impressão. | O guia manda limpar o interior (poeira e restos de papel), mas não limpar nem encostar na cabeça térmica. |
| Sweda SI-300 SIX | O manual não traz o ajuste. | Só pano levemente umedecido em água, sem detergente, solventes ou álcool, com a impressora fora da tomada. |
Dica: Na Tanca TP-650, o Printer Tool também tem uma opção que liga e desliga a impressão de QR Code. Se o QR não aparece de jeito nenhum, confira essa opção.
Teste: autoteste e leitura com o celular
- Faça o autoteste. Epson, Elgin i8, i9 Full e Bixolon: ligue segurando o botão de avanço (Feed). Control iD Print iD: ligue segurando POWER até 3 bipes. Tanca TP-650: “Self Test” no Printer Tool.
- Se o autoteste sai falhado ou fraco, o problema é da impressora ou da bobina. Se sai perfeito e só o DANFE falha, confira o driver e o sistema emissor.
- Imprima uma NFC-e de teste e meça o QR Code com régua: no mínimo 25 mm x 25 mm, com margem branca em volta.
- Leia o QR com o celular. Pelo manual, a leitura abre a consulta da NFC-e no portal da Sefaz do estado, com o DANFE completo.
- A Epson lembra que a leitura de códigos 2D depende do tamanho dos módulos, da densidade, da temperatura, do papel e do leitor: teste sempre com o papel que vai usar.
Dúvidas comuns
O celular lê o QR Code, mas a consulta mostra “QR Code Inválido”
Aí a impressão está boa: o problema está no conteúdo. Pela tabela do manual, essa mensagem aparece em erros de hash ou de CSC (código de segurança do contribuinte), que são gerados pelo sistema emissor. Fale com o fornecedor do sistema.
Posso usar bobina de 58 mm na NFC-e?
O manual pede papel de no mínimo 56 mm com 2 mm de margem de cada lado, então 58 mm atende. Mas a impressora precisa aceitar essa largura (Elgin i9 Full, Bixolon SRP-S300 e Control iD Print iD aceitam) e o driver e o sistema devem estar configurados para 58 mm. Veja “Bobina térmica 80 mm ou 58 mm: qual usar na impressora”.
O QR Code sai cortado na lateral
Quase sempre o leiaute é mais largo que o papel: o sistema ou o driver está em 80 mm com bobina de 58 mm, ou o contrário. Ajuste o papel no driver e no sistema para a bobina que está na impressora.
O DANFE inteiro sai fraco, não só o QR Code
Siga “Impressora térmica imprimindo fraco ou apagado: o que fazer”: confira o papel, a densidade e a limpeza da cabeça.
Troquei o SAT pela NFC-e e o QR Code não sai bem
A impressora pode ser a mesma, mas o leiaute agora é o do DANFE NFC-e, gerado pelo sistema emissor. Confira a largura e o tamanho do QR Code com o fornecedor do sistema. Veja também “Fim do SAT em SP: o que fazer com o SAT e a impressora”.
Documentos oficiais usados
Conteúdo montado a partir do material oficial dos fabricantes. Em caso de dúvida, vale o documento original.
- Manual de Padrões Técnicos do DANFE-NFC-e e QR Code v6.0 (março/2025) (página oficial)
- Portal Nacional da NF-e — Manuais (página oficial)
- Guia de referência técnica TM-T20X (inglês) (PDF)
- Guia de referência técnica TM-T20X II (inglês) (PDF)
- Manual do driver APD6 (inglês) (PDF)
- Manual do usuário - i8 Impressora Térmica de Cupom (PDF)
- Manual do usuário - i9 Full Impressora Térmica de Cupom (PDF)
- Manual Usuario_CKD_i9 Full 2_rev05 (PDF)
- Manual do usuário Bixolon SRP-S300 (inglês) (PDF)
- Guia rápido Print iD (PDF)
- Drivers e Utilitários (ZIP)
- Ficha técnica TP-650 (PDF)
- Manual de Instrução SI-300 SIX (PDF)