NF-e de pedido de marketplace com o complemento do endereço acima de 60 caracteres

A NF-e aceita no máximo 60 caracteres em cada campo do endereço. Pedidos de marketplace chegam com o complemento mais longo (a referência do comprador vem junto); o Hap corta o texto só na nota, avisa no pedido e no histórico da nota, e o endereço gravado fica inteiro para a etiqueta e a separação.

FiscalAtualizado em 25/10/2026

Quando usar

Quando a nota de um pedido de marketplace era recusada com uma mensagem sobre o complemento (xCpl) do endereço, ou quando o aviso de complemento acima de 60 aparecer no pedido.

Antes de começar

  • Integração com o canal de venda ativa (Mercado Livre, Shopee, Amazon, Magalu, Shopify ou loja virtual).

Visão geral

O Mercado Livre (e outros canais) entrega num campo só o complemento do endereço e a referência que o comprador digita, por exemplo "Apto 12 - Referencia: em frente ao bar, na calçada tem uma placa com o nome". Esse texto pode ter 100, 150 caracteres. A NF-e aceita no máximo 60 em cada campo do endereço (logradouro, número, complemento, bairro e município), e até aqui a nota era recusada antes de chegar à Sefaz, com uma mensagem técnica.

Agora o Hap resolve sozinho: o texto que vai para a nota é cortado em 60 caracteres, em palavra inteira quando possível, e o endereço gravado no pedido e no cadastro fica completo. A etiqueta e a lista de separação continuam mostrando a referência inteira para o entregador.

Onde o aviso aparece

  1. 1

    Na importação do pedido: o histórico de importação do canal registra "Complemento do endereço de ENTREGA com 143 caracteres; o limite da NF-e é 60 (na nota o texto vai cortado)". O pedido é importado normalmente.

    Histórico de importação do canal com o aviso do complemento acima de 60
  2. 2

    Na emissão: a nota não é barrada; o texto que vai para a Sefaz sai cortado em 60 e o aviso fica registrado no histórico técnico da nota (o suporte da Hap consulta quando precisar).

O que fazer

Nada, na maioria dos casos: emita a nota como sempre. Se quiser que o complemento da nota saia de outro jeito (por exemplo, só o apartamento), encurte o complemento no endereço do pedido antes de emitir; a referência pode ficar na observação do pedido.

Problemas comuns

  • A Sefaz ainda recusou a nota com a mensagem "Complemento do endereço recusado". O texto tem um caractere que a nota não aceita (emoji, aspas especiais, símbolos). Abra o cadastro do cliente e o endereço do pedido, deixe só letras, números e sinais comuns no complemento e emita de novo.
  • O entregador não viu a referência na etiqueta. A referência continua no endereço do pedido; confira o modelo de etiqueta usado na expedição.
  • O aviso aparece em todo pedido de um cliente. O cadastro dele tem o complemento longo. Pode deixar assim (a nota sai cortada) ou encurtar o complemento no cadastro de Pessoa.

Artigos relacionados