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.
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
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
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.
