Perguntas frequentes e glossário
Este capítulo reúne as dúvidas mais comuns sobre a Integração de Notas Fiscais com Marketplace (Mercado Livre) e um glossário dos termos usados ao longo do manual. Se você chegou aqui direto, vale ler antes os capítulos Como funciona e Envio da NF ao Mercado Livre, que explicam o fluxo completo.
Perguntas frequentes
Sincronizei e não veio nenhum pedido
Quando você clica em Sincronizar e a grade continua vazia, quase sempre a causa é uma destas duas.
| Causa provável | O que fazer |
|---|---|
| A autorização foi feita logado em outra conta do Mercado Livre. O navegador estava logado numa conta diferente da conta vendedora, então o acesso foi concedido para a conta errada e não há pedidos daquela conta. | Reautorize a conta na tela de Configuração. Se o navegador estiver logado na conta errada, use a opção de copiar a URL de autorização e abra-a num navegador (ou aba anônima) já logado como o vendedor correto. |
| O período não tem pedidos pagos. A sincronização traz apenas pedidos com pagamento confirmado dentro do intervalo escolhido. | Confira a Data inicial e a Data final no topo da tela e amplie o período. Lembre-se de que pedidos aguardando pagamento não aparecem. |
O botão Sincronizar traz somente pedidos Pagos do Mercado Livre. Isso é proposital: só faz sentido faturar e enviar nota de venda efetivamente paga.
O Mercado Livre recusou por valor divergente
O Mercado Livre compara o valor da NF-e com o valor da compra registrada na plataforma. Se não baterem, a nota é recusada com a mensagem valor da NF diverge do valor da compra.
- Revise preço, desconto e frete lançados na nota em relação ao que foi efetivamente cobrado do comprador no Mercado Livre.
- Atenção especial a kits: a soma dos componentes precisa fechar com o valor vendido no anúncio. Veja o capítulo De-para de produtos e kits.
- Corrija a divergência, cancele a nota errada se já emitida e reemita com os valores corretos.
A coluna Validação na grade avisa antecipadamente (sem bloquear) quando o valor ou o documento da nota parecem divergir do pedido do Mercado Livre. Use esse alerta para corrigir antes de enviar.
Recusou dizendo que o envio não está pronto
A mensagem o envio ainda não está pronto para receber a NF significa que aquele pedido ainda não chegou ao ponto em que o Mercado Livre gera a etiqueta e aceita a nota fiscal. Não é erro de configuração nem da nota.
Aguarde o pedido avançar até ficar pronto para despacho e use novamente Enviar NF ao Mercado Livre. Nada precisa ser reemitido.
O pedido é Full
Em pedidos com logística Full (fulfillment), quem emite a nota fiscal é o próprio Mercado Livre, porque a mercadoria já está nos centros de distribuição dele. Por isso, nesses pedidos não há nada para você enviar.
Pedidos Full aparecem na grade com a situação Não aplicável e a linha em cinza claro. É o comportamento esperado, não uma pendência.
O comprador cancelou depois de eu emitir a NF
Um pedido entra na lista como Pago, mas o comprador ainda pode cancelar depois. Para não deixar a tela lenta, o sistema não fica reconsultando todos os pedidos o tempo todo; a verificação acontece no momento em que você manda enviar.
Se, na hora do envio, o pedido estiver cancelado, o sistema bloqueia o envio e marca a linha como Cancelado no ML (laranja). Nesse caso, a NF-e já emitida deve ser cancelada no ERP.
No envio em lote ("Enviar selecionadas ao Mercado Livre"), os pedidos cancelados são automaticamente pulados. O resumo ao final informa quantos foram ignorados por cancelamento, para você tratá-los depois.
Como imprimo a etiqueta / PLP?
Depois que a NF é enviada e o envio fica pronto para despacho, use "Baixar etiqueta" (uma) ou "Baixar etiquetas (lote)" (várias num PDF só) na tela de conciliação. Se aparecer "a etiqueta ainda não está disponível", é porque o envio ainda não ficou pronto — aguarde e tente de novo. Pedidos Full não têm etiqueta para você imprimir (quem imprime é o Mercado Livre). Detalhes no capítulo Baixar etiqueta / PLP.
Preciso mudar meu jeito de faturar?
Não. Esta integração foi criada justamente para não obrigar você a trabalhar por pedido. Diferente da integração antiga (o HUB, que trazia o pedido do marketplace e criava um pedido no ERP), aqui os pedidos do Mercado Livre só espelham numa lista de trabalho — nenhum pedido é criado no ERP.
Você continua emitindo a nota do jeito que já faz. O Faturamento assistido é apenas um atalho opcional que abre a emissão já pré-preenchida para agilizar. Se preferir, emita manualmente e use só a conciliação e o envio.
Na prática: muitas empresas que pediram essa integração não queriam mudar a forma de trabalhar — queriam apenas enviar as notas ao Mercado Livre de forma automática. É exatamente para isso que o módulo serve.
O Mercado Livre só aceita NF-e de PRODUÇÃO. Nota emitida em ambiente de homologação/teste é sempre rejeitada. Antes de operar, confirme que sua emissão está em produção.
Glossário
| Termo | Significado |
|---|---|
| Conciliar | Casar a NF que você já emitiu com o pedido correspondente do Mercado Livre, para que o sistema saiba qual nota pertence a qual venda. |
| Carimbo / Observações de Interesse do Contribuinte | Número do pedido do Mercado Livre gravado na nota, no campo obsCont (identificador PedidoMercadoLivre). É a forma mais segura de o sistema reconhecer a nota automaticamente. |
| De-para | Relação entre o anúncio do Mercado Livre e o produto do ERP. Uma vez definida, é memorizada e reaproveitada nas próximas vendas. |
| Lista de trabalho (staging) | Espelho dos pedidos do Mercado Livre dentro do ERP. Serve para conciliar e enviar, mas nunca vira um pedido do ERP. |
| Anexar | Enviar a NF ao pacote do pedido. Apenas disponibiliza a nota ao comprador, sem mexer no envio. Usado em Flex e ME1. |
| Importar | Enviar a NF ao envio. Muda o status do envio e libera a etiqueta. Usado em Correios/Agência, Places, Coletas e Coleta rápida. |
| Flex | Logística de entrega feita pelo próprio vendedor (self service). A NF é anexada ao pacote. |
| Correios/Places/Coletas/Coleta rápida | Logísticas em que o Mercado Livre coordena a coleta ou postagem. A NF é importada no envio, o que muda o status e libera a etiqueta. |
| Full | Logística em que a mercadoria fica nos centros do Mercado Livre e é ele quem emite a nota. Aparece como Não aplicável; não há nota para enviar. |
| GTIN/EAN | Código de barras do produto. Usado pela auto-identificação do de-para para casar o anúncio com o produto do ERP. |
| SKU | Código interno do anúncio/produto. Também usado pela auto-identificação do de-para quando não há GTIN/EAN. |
| Kit | No Mercado Livre é um único anúncio, mas na NF os componentes precisam ser listados. Basta relacionar o anúncio ao produto kit do ERP: no faturamento assistido a nota já sai com todos os componentes. |
| Etiqueta / PLP | Documento de envio gerado pelo Mercado Livre, baixado em PDF para impressão e despacho. Fica disponível quando o envio está pronto (após a importação da NF, nas logísticas de coleta/postagem). Não se aplica ao Full. |
Os status da conciliação (Pendente, Casada, Enviada, Não aplicável, Manual, Erro, Cancelado no ML, Ignorada) e o significado das cores das linhas estão detalhados no capítulo Conciliação (casar NF e pedido).
Versão do manual: Rev 2 — Integração de NF com Mercado Livre