Integração de Notas Fiscais com Marketplace
O módulo Integração de Notas Fiscais com Marketplace (Mercado Livre) tem um objetivo simples e direto: pegar as NF-e que a sua empresa já emite normalmente e enviá-las ao Mercado Livre de forma automática. Além do envio, ele ajuda você a casar (conciliar) cada nota fiscal com o pedido correspondente do marketplace e, se quiser, a emitir essa nota já com os dados pré-preenchidos
- Visão geral e justificativa
- Como funciona
- Configuração inicial
- Sincronização de pedidos
- Conciliação (casar NF e pedido)
- De-para de produtos e kits
- Faturamento assistido
- Envio da NF ao Mercado Livre
- Perguntas frequentes e glossário
- Baixar etiqueta / PLP
Visão geral e justificativa
O módulo Integração de Notas Fiscais com Marketplace (Mercado Livre) tem um objetivo simples e direto: pegar as NF-e que a sua empresa já emite normalmente e enviá-las ao Mercado Livre de forma automática. Além do envio, ele ajuda você a casar (conciliar) cada nota fiscal com o pedido correspondente do marketplace e, se quiser, a emitir essa nota já com os dados pré-preenchidos. O ponto mais importante de entender logo de início é o que ele não faz: ele nunca cria um pedido no ERP. Seus pedidos do Mercado Livre são apenas espelhados numa lista de trabalho para você conciliar e enviar as notas — a sua forma de vender e faturar continua exatamente como é hoje.
O que é: uma integração de envio de notas fiscais ao Mercado Livre. Ela foi desenhada para não mudar a forma de trabalhar do cliente: você continua emitindo suas NF-e do jeito que já faz, e o módulo cuida de conciliar e mandar essas notas para o marketplace.
Como este manual está organizado
Este livro está dividido em nove capítulos. Abaixo, um resumo comentado de cada um para você saber onde encontrar o que precisa:
- Visão geral e justificativa (este capítulo): o que o módulo faz, por que ele foi criado, para quem serve e qual o pré-requisito essencial.
- Como funciona: o fluxo completo em quatro passos — Sincronizar, Conciliar, Faturar assistido (opcional) e Enviar — e a lógica geral por trás de cada etapa.
- Configuração inicial: como preparar a conta do marketplace (a Configuração) e deixar o módulo pronto para uso.
- Sincronização de pedidos: como puxar os pedidos pagos do período para a lista de trabalho, usando os filtros de período e o botão Sincronizar.
- Conciliação (casar NF e pedido): como o sistema encontra a nota que corresponde a cada pedido, os níveis de confiança, os status da coluna Situação e o significado das cores das linhas.
- De-para de produtos e kits: como relacionar cada anúncio do Mercado Livre ao produto do ERP (inclusive kits), para que o faturamento assistido saiba o que colocar na nota.
- Faturamento assistido: como abrir a emissão de NF já pré-preenchida com destinatário, itens e o carimbo do pedido — lembrando que essa etapa é opcional.
- Envio da NF ao Mercado Livre: como enviar uma nota ou um lote de notas, o que o sistema faz por trás (anexar x importar conforme a logística) e as mensagens de erro mais comuns.
- Baixar etiqueta / PLP: como baixar a etiqueta de envio (uma ou várias num PDF só) depois que a NF é enviada e o envio fica pronto.
- Perguntas frequentes e glossário: dúvidas rápidas e o significado dos principais termos usados no módulo.
Por que uma integração nova?
Talvez você já conheça a integração antiga de marketplace do ERP, que funcionava como um HUB: ela trazia os pedidos do e-commerce e criava um pedido dentro do ERP, que depois era faturado. Esse fluxo funciona bem para quem quer trabalhar por pedido — mas obriga a empresa a adotar esse modo de trabalho.
A necessidade que originou este módulo é comum a muitas empresas que vendem no Mercado Livre e vinham pedindo melhorias na integração. Parte desses vendedores, porém, não quer passar a trabalhar por pedido — isso mudaria toda a forma de operar da empresa. A intenção principal é outra e bastante objetiva: enviar as notas fiscais ao Mercado Livre.
Por isso foi criada uma integração nova, com um propósito diferente da anterior. Ela não gera pedidos, simplifica o faturamento e envia as notas fiscais automaticamente pela API do Mercado Livre. Em vez de transformar cada venda do marketplace num pedido do ERP, o módulo apenas espelha esses pedidos numa lista de trabalho (o chamado staging), concilia a NF que você já emitiu e faz o envio.
Integração anterior (HUB) x Integração nova
| Aspecto | Integração anterior (HUB) | Integração nova |
|---|---|---|
| Pedido no ERP | Cria um pedido a partir da venda do marketplace | Não cria pedido — apenas espelha numa lista de trabalho |
| Forma de trabalhar | Muda: obriga a operar por pedido | Mantém: você continua emitindo a NF do seu jeito |
| Foco | Trazer a venda e gerar o pedido | Conciliar e enviar a nota fiscal ao Mercado Livre |
| Faturamento | Faturamento do pedido criado | Faturamento assistido opcional (ou emissão manual, como sempre) |
As duas integrações têm propósitos diferentes. Se a sua operação prefere trabalhar por pedido, o HUB antigo continua fazendo sentido. Se o que você quer é apenas enviar ao Mercado Livre as notas que já emite, este é o módulo certo.
Para quem é
Este módulo é indicado para a empresa que já emite suas próprias notas fiscais das vendas do Mercado Livre e só precisa de uma forma simples e automática de enviar essas notas ao marketplace, sem alterar a rotina de faturamento. É voltado ao administrador ou operador que cuida das vendas do Mercado Livre e da emissão das notas no dia a dia.
Exemplo típico: a empresa vende no Mercado Livre, emite a NF-e de cada venda pelo processo que já usa e, hoje, envia essas notas ao marketplace manualmente (ou não envia). Com este módulo, ela sincroniza os pedidos pagos, confirma o casamento das notas e dispara o envio — em lote, se quiser — em poucos cliques.
Pré-requisito importante: o módulo só serve para quem emite NF-e modelo 55 (empresa PJ contribuinte). Pessoa Física e PJ não-contribuinte não emitem NF-e (usam DC-e, que está fora do escopo desta integração). Além disso, o Mercado Livre só aceita NF-e de produção — nota emitida em ambiente de homologação/teste é sempre rejeitada.
Nos próximos capítulos, vamos detalhar cada etapa. Comece pelo capítulo Como funciona para entender o fluxo em quatro passos e, em seguida, pela Configuração inicial para deixar o módulo pronto para uso.
Como funciona
Antes de usar a integração no dia a dia, vale entender o modelo mental por trás dela. Diferente da integração antiga com o Mercado Livre, esta integração foi pensada para uma ideia central: você continua trabalhando do jeito que já trabalha e emitindo suas notas como sempre fez. O papel dela é apenas organizar os pedidos pagos do Mercado Livre e enviar a nota fiscal para lá.
O princípio mais importante desta integração: ela nunca cria pedido no ERP. Os pedidos pagos do Mercado Livre são apenas espelhados numa lista de trabalho dentro da tela de conciliação. Essa lista é um retrato dos pedidos do marketplace para você acompanhar e casar com suas notas — não é um pedido do ERP, não movimenta estoque e não entra no faturamento por conta própria. Se você já conhecia a integração antiga (o HUB, que criava pedidos automaticamente), esta é a grande diferença.
Os 4 passos
O trabalho todo se resume a quatro passos, sendo que o terceiro é opcional. Você faz o primeiro e o segundo com frequência (normalmente todos os dias ou a cada período de vendas), e o quarto quando a nota já estiver emitida e casada.
-
Sincronizar — Você informa a conta do marketplace e um período (data inicial e final) e clica em
Sincronizar. O sistema busca no Mercado Livre os pedidos pagos daquele período e os traz para a lista de trabalho. Só pedidos pagos são trazidos, porque são esses que geram nota fiscal. É o ponto de partida: sem sincronizar, a lista fica vazia. -
Conciliar — Aqui o sistema casa a nota fiscal que você já emitiu com o pedido correspondente do Mercado Livre. Na maioria das vezes isso acontece sozinho; quando há dúvida, você confirma manualmente. Conciliar é o que amarra "esta nota é deste pedido", e é pré-requisito para enviar a nota ao Mercado Livre.
-
Faturar assistido (opcional) — Se você ainda não emitiu a nota, o sistema pode abrir a tela de emissão de NF já pré-preenchida com o destinatário, os itens e o número do pedido do Mercado Livre. É só uma comodidade para agilizar. Este passo é totalmente opcional: se você prefere continuar emitindo suas notas do jeito que já faz, pode pular direto para a conciliação e o envio.
-
Enviar — Com a nota emitida e conciliada, você a envia ao Mercado Livre, uma por vez ou várias de uma vez (em lote). O sistema decide sozinho a forma de envio conforme a logística do pedido e confere, na hora, se aquele pedido não foi cancelado antes de enviar.
Conciliação em poucas palavras
Conciliar é simplesmente casar a nota fiscal que você já emitiu com o pedido certo do Mercado Livre. O sistema tenta fazer isso automaticamente de duas maneiras:
-
Pelo carimbo do número do pedido — Quando a nota traz o número do pedido do Mercado Livre gravado nas Observações de Interesse do Contribuinte (o que chamamos de "carimbo"), ou quando você escreve algo como
ML Venda 1234567890nas Informações Complementares, o casamento é certeiro. Essa é a forma mais confiável. -
Por semelhança — Se não houver carimbo, o sistema procura o pedido mais provável comparando o CNPJ/CPF do destinatário, o valor dos produtos e a data. Nesse caso ele indica um grau de Confiança (Alta, Média ou Baixa) para você conferir antes de confirmar.
Dica prática: se você já tem o hábito de carimbar o número do pedido do Mercado Livre na nota, a conciliação tende a acontecer sozinha e com Confiança Alta, sobrando pouquíssimo trabalho manual. O capítulo Conciliação explica isso em detalhe.
Como a NF chega ao Mercado Livre
A forma como a nota chega ao Mercado Livre depende da logística do pedido. Você não precisa escolher nada: o sistema roteia sozinho. A tabela abaixo resume o que acontece em cada caso.
| Logística do pedido | O que o sistema faz com a NF |
|---|---|
| Flex e ME1 (você mesmo entrega/despacha) | Anexa a nota ao pacote — apenas disponibiliza o documento ao comprador, sem mexer no status do envio. |
| Correios/Agência, Places, Coletas e Coleta rápida | Importa a nota no envio — muda o status do envio e libera a impressão da etiqueta. |
| Full (o estoque está no Mercado Livre) |
Nada — nesse modelo o próprio Mercado Livre emite a nota. O envio não se aplica e a linha aparece como Não aplicável. |
A diferença entre anexar e importar é o que muda no Mercado Livre depois do envio. Anexar (Flex e ME1) só disponibiliza a nota para o comprador — o despacho continua por sua conta. Importar (Correios, Places, Coletas e Coleta rápida) faz o Mercado Livre avançar o status do envio e liberar a etiqueta, porque nesses modelos a nota precisa estar presente para o pacote seguir. Você não precisa decidir qual dos dois usar; o sistema identifica a logística e faz o certo.
O Mercado Livre só aceita NF-e de produção. Notas emitidas em ambiente de homologação/teste são sempre rejeitadas no envio. O capítulo Envio da NF ao Mercado Livre detalha as mensagens de erro e o que fazer em cada uma.
Preparado para outros marketplaces
Embora hoje a integração funcione apenas com o Mercado Livre, ela foi construída de forma multi-marketplace por dentro. Isso significa que, no futuro, outros marketplaces (por exemplo, a Shopee) poderão ser adicionados sem mudar a sua forma de trabalhar: o mesmo fluxo de sincronizar, conciliar e enviar continuará valendo.
Configuração inicial
Antes de sincronizar pedidos ou enviar notas fiscais, é preciso conectar o TryERP à sua conta de vendedor do Mercado Livre. Essa conexão é feita uma única vez por emitente e fica guardada nas configurações do sistema. Este capítulo mostra onde configurar, como gerar o token de acesso corretamente e como preparar usuários de teste antes de trabalhar com pedidos reais.
A integração só funciona para empresas que emitem NF-e modelo 55 (pessoa jurídica contribuinte). Se você ainda tem dúvidas sobre o funcionamento geral, leia antes os capítulos Visão geral e justificativa e Como funciona.
Onde configurar
A conexão com o Mercado Livre fica em Configurações Adicionais, na aba Mercado Livre. É nessa aba que você informa as credenciais do aplicativo do Mercado Livre e gera o token que autoriza o TryERP a conversar com a plataforma em nome do vendedor.
A configuração é por emitente. Se a sua empresa trabalha com mais de um emitente (mais de um CNPJ), cada um pode ter a sua própria conta do Mercado Livre configurada de forma independente. Isso permite que empresas com múltiplos CNPJs vendam por contas diferentes do marketplace sem misturar tokens.
As credenciais (App ID, Secret e código de autorização) vêm do aplicativo que você cria no portal de desenvolvedores do Mercado Livre. Esse aplicativo é o "crachá" que identifica o TryERP perante a plataforma. Se você ainda não tem essas informações, peça ao responsável pela conta do Mercado Livre da sua empresa ou ao seu suporte para criar o aplicativo e fornecer os dados.
Passo a passo da conexão
Com a aba Mercado Livre aberta, siga a ordem abaixo. Cada campo depende do anterior, então respeite a sequência.
- Preencha o campo App ID com o identificador do aplicativo do Mercado Livre.
- Preencha o campo Secret com a chave secreta desse mesmo aplicativo.
- Informe o código de autorização gerado pelo aplicativo do Mercado Livre.
- Clique em Autorizar Usuário para vincular a conta do vendedor (detalhado na próxima seção).
- Gere o token. É o token que efetivamente dá ao TryERP permissão para ler os pedidos e enviar as notas fiscais.
Depois de gerado, o token fica salvo e é renovado automaticamente pelo sistema quando necessário. Você não precisa repetir esse processo a cada uso.
O botão "Autorizar Usuário"
Ao clicar em Autorizar Usuário, o sistema pergunta como você deseja abrir a página de autorização do Mercado Livre: abrir direto no navegador ou copiar a URL para você colar manualmente em um navegador de sua escolha.
Essa escolha existe por um motivo importante. A autorização gera o token da conta que estiver logada no navegador naquele momento. Se o seu navegador padrão estiver logado em outra conta do Mercado Livre (a sua conta pessoal, por exemplo, e não a conta da loja), o token será gerado para a conta errada.
Por isso, quando houver qualquer dúvida sobre qual conta está logada, prefira copiar a URL e colá-la em um navegador (ou janela anônima) onde você tenha certeza de estar logado como o vendedor — o dono da loja no Mercado Livre.
| Opção | Quando usar |
|---|---|
| Abrir no navegador | Quando você tem certeza de que o navegador padrão já está logado na conta da loja. |
| Copiar a URL | Quando quer controlar exatamente em qual navegador/conta a autorização acontece. Cole em uma janela logada como o vendedor. |
O token PRECISA ser da conta do vendedor (a loja do Mercado Livre). Se o token for gerado a partir de uma conta errada, a integração conecta, mas o botão Sincronizar traz 0 pedidos — porque está lendo os pedidos de outra conta, que não tem as vendas da loja. Se isso acontecer, refaça a autorização copiando a URL e colando em uma janela logada como o vendedor. Veja também o capítulo Perguntas frequentes e glossário.
Usuários de teste
O Mercado Livre não oferece um ambiente de sandbox separado como outros sistemas. Para testar a integração sem mexer em vendas reais, a própria plataforma permite criar usuários de teste: contas fictícias de comprador e de vendedor que existem só para experimentar o fluxo.
Na aba Mercado Livre há o botão Criar usuários de teste. Use-o para gerar as contas fictícias que você usará para simular compras e acompanhar o passo a passo de sincronizar, conciliar e enviar a nota — tudo sem afetar clientes de verdade.
Ao testar com usuários fictícios, emita apenas notas de HOMOLOGAÇÃO. Nunca emita nota de produção para um comprador de teste: além de não representar uma venda real, isso gera uma NF-e válida no seu movimento fiscal para um destinatário que não existe.
Atenção ao inverso, que é o erro mais comum: o Mercado Livre só aceita NF-e de PRODUÇÃO em vendas reais. Nota emitida em ambiente de homologação/teste é sempre rejeitada pela plataforma. Ou seja, homologação serve apenas para os usuários de teste; para clientes reais, sempre nota de produção.
Recomendação prática: faça um ciclo completo com usuários de teste antes de ir para o ambiente real. Crie os usuários de teste, simule uma compra, sincronize, concilie e envie uma nota de homologação. Assim você conhece cada etapa (descritas nos capítulos seguintes) sem risco antes de trabalhar com pedidos de verdade.
Com a conta conectada e o token válido gerado pela conta correta do vendedor, o próximo passo é trazer os pedidos pagos do período para a lista de trabalho. Continue no capítulo Sincronização de pedidos.
Sincronização de pedidos
A sincronização é o primeiro dos quatro passos da integração. É ela que traz para dentro do sistema os pedidos que o Mercado Livre já registrou como pagos, montando a sua lista de trabalho. Lembre-se de que, nesta integração, sincronizar não cria pedido no ERP: apenas espelha as vendas do marketplace numa lista, para que você concilie e envie as notas fiscais que a sua empresa já emite.
Passo a passo
- Abra a tela Conciliação de NF x Marketplace pelo menu do sistema.
- No topo da tela, escolha a Configuração desejada. A Configuração representa a conta (o vendedor) do marketplace de onde os pedidos serão puxados. Se você opera com mais de uma conta, é aqui que decide de qual delas quer trazer as vendas.
- Informe a Data inicial e a Data final do período que deseja consultar.
- Clique em Sincronizar.
Escolha um período curto o suficiente para ser rápido, mas que cubra as vendas que você ainda não conciliou. Você pode sincronizar quantas vezes quiser: pedidos já trazidos são atualizados, não duplicados.
O que o Sincronizar faz
Ao clicar em Sincronizar, o sistema consulta o Mercado Livre e busca os pedidos pagos daquele período. Cada pedido encontrado vira uma linha na grade. Nesse mesmo momento, o sistema já adianta trabalho para você: tenta conciliar automaticamente a nota fiscal que você já emitiu (quando encontra o carimbo do número do pedido na nota) e tenta identificar os produtos de cada venda pelo de-para de anúncios. Ou seja, boa parte das linhas já chega parcial ou totalmente resolvida.
A sincronização traz apenas pedidos pagos. Pedidos aguardando pagamento não aparecem, porque ainda não há venda a faturar. Se um comprador cancelar depois de pagar, o pedido continua na lista, mas o sistema o sinaliza como cancelado (veja a seção de cores das linhas).
O resumo ao terminar
Toda vez que a sincronização termina, aparece uma caixa de resumo. Ela existe justamente para você ter certeza de que a operação rodou e contra qual conta ela rodou. O resumo mostra:
- A conta / vendedor associada ao acesso usado (o "dono" do token da Configuração escolhida);
- O período consultado;
- Quantos pedidos foram processados;
- Quantos foram vinculados (conciliados automaticamente com uma NF);
- Eventuais avisos e erros.
Confira sempre a conta e o período no resumo antes de continuar. Se o vendedor mostrado é o esperado e a quantidade de processados faz sentido para o período, você pode seguir com tranquilidade para a conciliação.
As colunas da grade
Depois de sincronizar, a grade mostra uma linha por pedido do Mercado Livre. Entenda o que cada coluna informa:
| Coluna | O que mostra |
|---|---|
| Pedido | Número do pedido no Mercado Livre. É a referência principal da venda. |
| Data | Data do pedido no marketplace. |
| Status ML | Situação do pedido no Mercado Livre, por exemplo Pago ou Cancelado. |
| Comprador | Identificação do comprador no Mercado Livre. |
| Documento/Nome do destinatário | CNPJ/CPF e nome de quem deve constar como destinatário da nota fiscal. |
| Valor produtos | Valor dos itens vendidos, sem frete e outros acréscimos. |
| Valor total | Valor total da venda no Mercado Livre. |
| Logística | Tipo de envio (Flex, ME1, Correios/Agência, Places, Coleta rápida, Coletas ou Full). Define como a NF será enviada mais tarde. |
| Método de envio da NF | Se a nota será anexada ao pacote ou importada no envio, decidido automaticamente pela logística. |
| Situação | Situação da conciliação (Pendente, Casada, Enviada, Erro, etc.). É o principal indicador do que falta fazer. |
| Confiança | Grau de certeza do casamento automático: Alta, Média ou Baixa. |
| Parceiro ERP | O parceiro (cliente) do ERP vinculado ao comprador, quando já identificado. |
| Validação | Alerta, sem bloquear, quando o documento ou o valor da NF diverge do pedido do Mercado Livre. |
| Produtos | Quantos itens já foram identificados pelo de-para, no formato n/m (identificados / total). |
| Chave NF enviada | A chave da NF-e que já foi enviada ao Mercado Livre, quando houver. |
| Retorno do ML | A resposta do Mercado Livre ao envio da nota (confirmação ou mensagem de erro). |
A sincronização traz apenas pedidos com Status ML igual a Pago. Os demais status (aguardando pagamento, por exemplo) existem no Mercado Livre, mas não são úteis aqui, porque não há venda concretizada para faturar.
As cores das linhas
Para você identificar de relance o que precisa de atenção, cada linha ganha uma cor conforme a situação. Use as cores como um "mapa de calor" da sua lista de trabalho:
| Cor da linha | Significado |
|---|---|
| Verde | NF já enviada ao Mercado Livre. Nada mais a fazer nessa linha. |
| Amarelo claro | NF já casada com o pedido (conciliada), pronta para ser enviada. |
| Laranja | Pedido cancelado no Mercado Livre. A NF-e emitida deve ser cancelada no ERP. |
| Vermelho | Erro. Algo impediu a conciliação ou o envio; verifique a coluna de retorno. |
| Cinza claro | Cancelado, tratado manualmente, ignorado ou Não aplicável (caso do Full, em que o próprio Mercado Livre emite a nota). |
| Rosa | Pedido não pago. |
| Laranja claro | Divergência de validação: documento ou valor da NF diferente do pedido do Mercado Livre. |
Se a sincronização terminar com 0 pedidos processados num período em que você sabe que houve vendas, o motivo mais comum é estar usando o token de uma conta diferente daquela em que as vendas ocorreram. Confira a conta/vendedor no resumo e a Configuração escolhida. Veja o capítulo Perguntas frequentes e glossário para o passo a passo de verificação.
Com os pedidos na lista, o próximo passo é a conciliação — casar cada nota fiscal já emitida com o pedido correspondente, tratada no capítulo Conciliação (casar NF e pedido).
Conciliação (casar NF e pedido)
Conciliar é o coração desta integração. Como o módulo não cria pedido no ERP, ele precisa descobrir qual nota fiscal que você já emitiu corresponde a cada pedido do Mercado Livre que apareceu na lista de trabalho. Esse "casamento" entre a NF e o pedido é o que chamamos de conciliação. Só depois de um pedido estar conciliado (com uma NF vinculada) é que faz sentido enviá-la ao Mercado Livre, assunto do capítulo Envio da NF ao Mercado Livre.
Este capítulo mostra como o casamento acontece sozinho, o que você pode fazer para garantir que ele seja sempre automático, como conciliar na mão quando necessário e como interpretar os alertas da coluna Validação.
A conciliação acontece na tela Conciliação de NF x Marketplace. Cada linha da grade é um pedido do Mercado Livre; a coluna Situação mostra o estágio da conciliação daquela linha. O significado de cada situação está na seção As situações da conciliação, ao final deste capítulo.
Conciliação automática
Sempre que você usa o botão Sincronizar (veja o capítulo Sincronização de pedidos), o sistema já tenta casar cada pedido trazido com uma nota fiscal que você emitiu no ERP. Ele faz isso em três frentes, da mais confiável para a menos confiável:
- Pelo número do pedido carimbado na nota — se a NF traz o número do pedido do Mercado Livre nas Observações de Interesse do Contribuinte (o "carimbo"), o casamento é direto e não deixa dúvida. É o método ideal.
- Pelo texto "ML Venda <número>" nas Informações Complementares — muitos clientes já escrevem essa observação na nota. Se o número do pedido aparece ali, o sistema também reconhece e casa.
- Por semelhança (heurística) — quando não há número carimbado, o sistema procura a nota comparando o CNPJ/CPF do destinatário, o valor dos produtos e a data, dentro de uma janela próxima ao pedido. Esse casamento é uma aposta calculada, não uma certeza.
Como os dois primeiros métodos identificam o pedido pelo próprio número, eles resultam em alta confiança. O terceiro, por depender de coincidência de dados, gera confiança Média ou Baixa — e por isso merece uma conferência sua antes do envio.
A coluna Confiança
A coluna Confiança resume o quanto o sistema tem certeza de que aquela NF é mesmo daquele pedido:
| Confiança | O que significa | Como foi casada | O que fazer |
|---|---|---|---|
| Alta | Casamento seguro, pelo número do pedido | Carimbo (obsCont) ou "ML Venda <número>" | Pode enviar com tranquilidade |
| Média | Provável, mas por semelhança de dados | CNPJ/CPF + valor + data | Confira o destinatário e o valor antes de enviar |
| Baixa | Palpite fraco; pode estar errado | Semelhança parcial de dados | Revise com atenção; considere conciliar manualmente |
Se você já carimba o número do pedido do Mercado Livre em toda nota que emite, praticamente todo o trabalho de conciliação desaparece: ao Sincronizar, os pedidos já chegam Casados e com confiança Alta, prontos para enviar. Vale a pena adotar esse hábito.
Como carimbar o número do pedido na nota
O carimbo é simplesmente o número do pedido do Mercado Livre gravado dentro da própria NF-e, num campo padrão da nota. Na tela de emissão de NF, abra a aba Observações de Interesse do Contribuinte e inclua uma linha com:
-
Identificador: qualquer texto que ajude a reconhecer a origem — sugerimos
PedidoMercadoLivre. - Observação: o número do pedido do Mercado Livre, exatamente como ele aparece na coluna Pedido da grade.
É esse dado que garante o casamento automático de alta confiança. Ele fica gravado dentro do arquivo da nota (não é só uma anotação de tela), então o sistema consegue lê-lo e ligar a NF ao pedido certo sem depender de coincidências de valor ou data. Se você emite pelo Faturamento assistido (capítulo seguinte), esse carimbo já vem preenchido automaticamente.
Conciliação manual
Quando o casamento automático não acontece (pedido com confiança Baixa, sem carimbo, ou uma nota que o sistema não encontrou), você resolve na própria grade. Clique com o botão direito sobre a linha do pedido para abrir o menu de contexto:
| Ação | Quando usar |
|---|---|
| Vincular NF (informar número)... | Você já sabe qual nota é aquela: informe o número e o sistema faz o vínculo direto. |
| Conciliar / ver candidatos | Você não tem certeza de qual NF é: o sistema lista as notas mais parecidas (os "candidatos") para você escolher a correta. |
| Desvincular NF | O sistema casou a nota errada, ou você quer refazer o vínculo: solta a NF e a linha volta a ficar Pendente. |
Ao vincular manualmente, confira se está ligando a nota ao pedido certo — principalmente quando há vários pedidos do mesmo comprador ou com valores parecidos. Um vínculo errado leva a enviar a nota de uma compra para outra. Na dúvida, use Conciliar / ver candidatos em vez de digitar o número às cegas.
Validação
Depois que uma NF é casada com o pedido — automática ou manualmente — a coluna Validação compara os dados da nota com os dados da venda no Mercado Livre. Ela funciona como um alerta, sem bloquear: aponta divergências para você decidir o que fazer, mas não impede a conciliação. Os dois pontos verificados são:
- Documento do destinatário — o CNPJ/CPF de quem recebe a nota deve bater com o comprador da venda.
- Valor da nota — o total da NF deve corresponder ao valor da compra.
Quando há divergência, a linha fica com um destaque (laranja claro) e a coluna Validação descreve o problema.
Não ignore os avisos da coluna Validação. O que aqui é só um alerta pode virar recusa no envio: o Mercado Livre pode rejeitar uma nota com destinatário ou valor diferentes da venda (mensagens como "dados do destinatário divergentes" ou "valor da NF diverge do valor da compra"). Resolva a divergência — reemitindo a nota corrigida ou desvinculando e vinculando a nota certa — antes de tentar o envio, tratado no capítulo Envio da NF ao Mercado Livre.
As situações da conciliação
A coluna Situação resume em que ponto do fluxo cada pedido está. Estas são as situações possíveis:
| Situação | Significado | Cor da linha |
|---|---|---|
| Pendente | Ainda sem nota fiscal vinculada — falta conciliar. | — |
| Casada | Nota vinculada ao pedido, pronta para enviar ao Mercado Livre. | Amarelo claro |
| Enviada | Nota já enviada ao Mercado Livre. Nada mais a fazer. | Verde |
| Não aplicável | Pedido Full: o próprio Mercado Livre emite a nota; não há envio a fazer. | Cinza claro |
| Manual | Logística sem envio automático pela integração; trate manualmente. | Cinza claro |
| Erro | O envio foi recusado pelo Mercado Livre; o motivo aparece na coluna Retorno do ML. | Vermelho |
| Cancelado no ML (cancelar NF) | O pedido foi cancelado no Mercado Livre; a NF-e emitida deve ser cancelada no ERP. | Laranja |
| Ignorada | Linha marcada para não ser tratada nesta conciliação. | Cinza claro |
As cores das linhas seguem essa mesma lógica e funcionam como um "mapa de calor" da lista de trabalho — a tabela completa de cores está no capítulo Sincronização de pedidos.
Com os pedidos conciliados e a validação em ordem, você tem duas frentes possíveis: se ainda precisa emitir a nota, use o Faturamento assistido (próximo capítulo), que abre a emissão já pré-preenchida e com o carimbo do pedido pronto; se a nota já está emitida e casada, siga direto para o Envio da NF ao Mercado Livre.
De-para de produtos e kits
Quando você usa o Faturamento assistido (o botão "Faturar / Carregar dados no ERP"), o sistema precisa preencher a nota fiscal com os produtos certos. O problema é que o Mercado Livre identifica o que foi vendido pelo anúncio, e o seu ERP identifica pelo produto cadastrado. São dois mundos diferentes: o anúncio do ML não sabe qual é o código do produto no seu estoque, e o seu ERP não sabe o que é aquele anúncio.
O de-para de produtos é a ponte entre esses dois mundos. Ele guarda a relação "este anúncio do Mercado Livre corresponde a este produto do ERP". Sem essa relação, o faturamento assistido não tem como saber quais itens colocar na nota.
Este capítulo só é relevante para quem pretende usar o Faturamento assistido (capítulo Faturamento assistido). Se você prefere continuar emitindo a NF do seu jeito e usar a integração apenas para conciliar e enviar, o de-para não é obrigatório — mas ainda ajuda, porque melhora a identificação dos itens.
Relacionar produtos
Na tela "Conciliação de NF x Marketplace", selecione a linha do pedido e escolha, no menu de contexto (ou nos botões do rodapé), a ação "Relacionar produtos (de-para)...". Abre-se a tela de de-para, com uma linha para cada anúncio do pedido e uma coluna de situação indicando se aquele item já está identificado ou ainda pendente.
Nessa tela você tem três ações:
| Botão | O que faz | Quando usar |
|---|---|---|
| Auto-identificar pendentes | Tenta casar os anúncios pendentes automaticamente, por GTIN/EAN (código de barras) e por SKU. | Primeira tentativa, sempre. Resolve a maioria dos casos sozinho. |
| Relacionar a um produto (buscar)... | Abre a busca de produtos para você escolher manualmente o produto do ERP que corresponde ao anúncio. | Quando a auto-identificação não achou, ou achou errado. |
| Limpar vínculo | Remove a relação de um anúncio, deixando-o pendente de novo. | Quando o vínculo foi feito errado e precisa ser refeito. |
O ideal é sempre começar por "Auto-identificar pendentes" e só tratar manualmente o que sobrar. Isso funciona bem se os seus anúncios do Mercado Livre estiverem preenchidos com o código de barras (GTIN/EAN) ou com o mesmo SKU que você usa no ERP.
O vínculo é memorizado por anúncio. Depois que você relaciona um anúncio a um produto, nas próximas vendas daquele mesmo anúncio o produto é reconhecido sozinho, sem precisar refazer nada. Ou seja: o trabalho de de-para tende a diminuir com o tempo — você configura uma vez por anúncio e pronto.
Na coluna Produtos da grade principal você acompanha o progresso no formato n/m — quantos itens do pedido já foram identificados sobre o total. Quando chega a 3/3, por exemplo, todos os itens estão prontos e o faturamento assistido consegue montar a nota completa.
Kits
Os kits merecem atenção especial. No Mercado Livre, um kit é vendido como um único anúncio — o comprador vê um item só. Mas a nota fiscal precisa listar todos os componentes do kit separadamente, porque cada componente é um produto que sai do seu estoque.
A boa notícia é que você não precisa fazer nada de diferente na hora de relacionar: basta apontar o anúncio do ML para o produto KIT do ERP (o produto que você já cadastrou como kit, com seus componentes). O ERP já sabe "explodir" o kit em seus componentes. Assim, no Faturamento assistido, a nota sai automaticamente com todos os componentes, cada um na sua linha, a partir de um único anúncio.
Antes de faturar, o sistema confere o kit e avisa em duas situações: (1) se o produto kit estiver sem componentes cadastrados no ERP — nesse caso não há o que explodir e você precisa completar o cadastro do kit; e (2) se a soma dos valores dos componentes divergir do valor vendido no ML. A divergência de valor é especialmente importante nas logísticas que importam a NF (Correios/Agência, Places, Coletas), porque o Mercado Livre recusa a nota quando o valor não bate. Ajuste os valores na tela de emissão antes de concluir.
Sobre as logísticas que "anexam" e as que "importam" a NF, e por que a divergência de valor derruba o envio, veja o capítulo Envio da NF ao Mercado Livre. Sobre como conferir e emitir a nota já pré-preenchida, veja o capítulo Faturamento assistido.
Faturamento assistido
O faturamento assistido é o terceiro passo do fluxo da integração. Ele pega um pedido que já está na lista de trabalho e abre a emissão de NF-e do ERP com quase tudo preenchido, poupando digitação e garantindo que o número do pedido do Mercado Livre já saia gravado na nota.
Este passo é opcional. Se você já tem um jeito de emitir suas notas e prefere continuar com ele, tudo bem: o faturamento assistido apenas agiliza o trabalho e já cuida do carimbo do número do pedido para você. Emitindo do seu jeito de sempre, basta depois usar "Vincular NF (informar número)..." (ver capítulo de Conciliação) para casar a nota com o pedido.
A vantagem principal do assistido é justamente o carimbo: a nota sai com o número do pedido do Mercado Livre gravado nas Observações de Interesse do Contribuinte. É esse carimbo que faz a nota casar sozinha com o pedido logo depois de emitida, sem você precisar procurar nada.
Como usar
Na tela Conciliação de NF x Marketplace, clique com o botão direito sobre a linha do pedido (ou use o botão no rodapé) e escolha "Faturar / Carregar dados no ERP".
O sistema abre a tela de emissão de NF já pré-preenchida com:
- Destinatário — o comprador do pedido (desde que já esteja vinculado a um parceiro do ERP; veja a seção abaixo).
- Itens — os produtos vindos do de-para (a relação entre o anúncio do Mercado Livre e o produto do ERP; veja o capítulo De-para de produtos e kits). Se o anúncio for um kit, a nota já sai com todos os componentes.
- Carimbo do número do pedido — gravado nas Observações de Interesse do Contribuinte.
A partir daí o operador segue o fluxo normal de emissão: confere e ajusta a operação, os valores, os impostos e o que mais for necessário, e emite a nota como de costume.
O pré-preenchimento é um ponto de partida, não um resultado final. Você continua no controle: revise natureza da operação, tributação, frete e valores antes de emitir. O sistema apenas evita que você redigite o que já sabemos a partir do pedido do Mercado Livre.
Parceiro (comprador)
Para emitir a nota, o comprador do Mercado Livre precisa estar cadastrado como parceiro no ERP. Se o comprador ainda não existe, você tem duas opções no menu da linha:
| Ação | Quando usar |
|---|---|
| Cadastrar parceiro no ERP (dados do ML) | Quando o comprador é novo. Traz os dados do comprador vindos do Mercado Livre e cria o cadastro para você. |
| Vincular parceiro existente... | Quando o comprador já está cadastrado no ERP e você só precisa ligar o pedido a esse cadastro. |
O Mercado Livre não fornece o código do município (IBGE) do comprador. Por isso, ao usar "Cadastrar parceiro no ERP (dados do ML)", o cadastro pode vir sem a cidade completa. Complete a cidade no cadastro do parceiro antes de emitir — sem o município válido a NF-e não é autorizada.
Aviso de status
Antes de abrir a tela de emissão, o sistema verifica a situação do pedido. Se o pedido estiver cancelado no Mercado Livre, ou ainda não pago, você recebe um aviso na hora — assim evita emitir uma nota para uma venda que não se concretizou.
Emitir NF para um pedido cancelado ou não pago gera retrabalho: a nota depois terá de ser cancelada. Ao ver o aviso, confirme a situação da venda no Mercado Livre antes de prosseguir.
Depois de emitir
Assim que a nota é autorizada, ela casa sozinha com o pedido do Mercado Livre pelo carimbo do número que o assistido gravou. A linha na tela de conciliação passa para a situação Casada e fica pronta para o último passo: enviar a NF ao Mercado Livre.
Fluxo típico e rápido: clique em "Faturar / Carregar dados no ERP", confira e emita a nota, e ela já aparece Casada na lista. Em seguida use "Enviar NF ao Mercado Livre" (ver capítulo Envio da NF ao Mercado Livre) e a venda está concluída — tudo sem criar um único pedido no ERP.
Se preferir emitir por fora do assistido, o casamento automático pelo carimbo só acontece se o número do pedido estiver gravado nas Observações de Interesse do Contribuinte (ou se você escrever "ML Venda <número>" nas Informações Complementares). Sem isso, use "Vincular NF (informar número)..." para casar manualmente.
Envio da NF ao Mercado Livre
Este é o passo final do fluxo da integração: depois que a nota já está conciliada (casada com o pedido do Mercado Livre), você envia essa NF-e ao próprio Mercado Livre direto pela tela Conciliação de NF x Marketplace. O sistema faz a parte técnica sozinho — você só escolhe a linha (ou várias) e manda enviar.
Enviar a NF ao Mercado Livre cumpre a obrigação de disponibilizar a nota fiscal ao comprador e, dependendo da logística, também libera a etiqueta de envio. Por isso o envio é parte do trabalho do dia a dia, e não algo opcional: sem a NF, o pedido pode ficar travado no lado do Mercado Livre.
Enviar
Há duas formas de enviar, ambas disponíveis no menu de contexto da linha (clique com o botão direito sobre o pedido) e nos botões do rodapé da grade:
- Enviar NF ao Mercado Livre — envia a nota de uma linha selecionada. Use quando quer tratar um pedido específico.
- Enviar selecionadas ao Mercado Livre — envia em lote todas as linhas que você marcou. Aparece uma barra de progresso durante o processo e, ao final, um resumo com quantas notas foram enviadas com sucesso, quantas falharam e quantos pedidos foram pulados (por exemplo, cancelados no Mercado Livre).
Só faz sentido enviar linhas cuja Situação esteja Casada (a NF já foi conciliada com o pedido). Se você tentar enviar uma linha ainda Pendente, o sistema não terá qual nota mandar. Consulte o capítulo Conciliação (casar NF e pedido) se a linha ainda não estiver casada.
O sistema decide sozinho: anexar ou importar
Você não precisa saber qual é o tipo de logística do pedido. Ao enviar, o sistema lê a coluna Logística daquela venda e roteia automaticamente entre anexar a NF ao pacote ou importar a NF no envio. A diferença importa porque muda o efeito no lado do Mercado Livre:
| Logística | O que o sistema faz | Efeito no Mercado Livre |
|---|---|---|
| Flex (self service) e ME1 | Anexa a NF ao pacote | Apenas disponibiliza a nota ao comprador; não mexe no envio. |
| Correios / Agência (drop off) | Importa a NF no envio | Muda o status do envio e libera a etiqueta. |
| Places (xd drop off) | Importa a NF no envio | Muda o status do envio e libera a etiqueta. |
| Coleta rápida (xd same day) | Importa a NF no envio | Muda o status do envio e libera a etiqueta. |
| Coletas (cross docking) | Importa a NF no envio | Muda o status do envio e libera a etiqueta. |
| Full (fulfillment) | Nada — não se envia | O próprio Mercado Livre emite a nota. A linha aparece como Não aplicável. |
Nos pedidos Full, quem emite a nota é o Mercado Livre, então não há o que enviar — a linha já vem marcada como Não aplicável e você pode ignorá-la. Isso é normal, não é erro.
Quando o envio dá certo, a linha fica verde (Situação Enviada), a coluna Chave NF enviada passa a mostrar a chave da nota, e a coluna Retorno do ML traz a confirmação. Se algo der errado, a linha fica vermelha (Erro) e o motivo aparece na coluna Retorno do ML — veja a tabela de mensagens mais adiante.
O Mercado Livre só aceita NF-e emitida em PRODUÇÃO. Nota emitida em ambiente de homologação/teste é sempre rejeitada, porque não tem valor fiscal. Por isso, o funcionamento 100% do envio só se confirma com uma venda real — não é possível validar o ciclo completo usando notas de teste.
Pedido cancelado
Um pedido entra na lista como Pago, mas o comprador pode cancelar depois. Para não deixar a tela lenta, o sistema não fica reconsultando todos os pedidos o tempo todo; em vez disso, na hora de enviar, ele confere no Mercado Livre a situação daquele pedido específico.
Se o pedido tiver sido cancelado, o sistema não envia a NF e marca a linha como Cancelado no ML (cancelar NF) — a linha fica na cor laranja. Assim você identifica de imediato os pedidos que precisam de tratamento.
Quando o pedido é cancelado no Mercado Livre, a NF-e que você já emitiu deve ser CANCELADA no ERP. Ela não pode ser reaproveitada para outra venda: cada nota carrega o carimbo do número daquele pedido e os dados daquele comprador. Deixar de cancelar a nota gera imposto sobre uma venda que não aconteceu.
No envio em lote, os pedidos cancelados são automaticamente ignorados — o sistema não interrompe o processo por causa deles. No resumo final ele informa quantos foram pulados por estarem cancelados, para que você trate cada um depois (cancelando a respectiva NF no ERP).
Mensagens quando o ML recusa
Quando o Mercado Livre recusa a nota, a linha fica em Erro e o motivo aparece na coluna Retorno do ML. As mensagens são acionáveis — ou seja, dizem o que precisa ser corrigido. A tabela abaixo resume as mais comuns e o que fazer em cada caso:
| Mensagem | O que fazer |
|---|---|
| Valor da NF diverge do valor da compra | Revise preço, desconto e frete da nota. O total da NF precisa bater com o valor da venda no Mercado Livre. Ajuste e reemita a NF. |
| O envio ainda não está pronto para receber a NF | O pedido ainda não chegou ao ponto de despacho. Aguarde o pedido ficar pronto para envio e tente de novo mais tarde. Não é erro na nota. |
| Dados do destinatário divergentes | Confira CNPJ/CPF, Inscrição Estadual, CEP e UF: precisam ser iguais aos da venda no Mercado Livre. Corrija o cadastro do destinatário e reemita a NF. |
| Já existe NF para o pedido | O pedido já tem nota associada. Confira antes de reenviar para não duplicar a nota fiscal daquela venda. |
Nos casos que pedem para reemitir, lembre-se de que a nota errada, se já foi emitida, também precisa ser tratada no ERP (cancelada, quando aplicável). A coluna Validação da grade costuma antecipar divergências de documento ou de valor antes mesmo do envio — vale conferi-la para evitar recusas.
Depois de corrigir e reenviar com sucesso, a linha passa para verde (Enviada), a Chave NF enviada é preenchida e o comprador passa a ver a nota fiscal no pedido — encerrando o ciclo da integração para aquela venda.
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
Baixar etiqueta / PLP
Depois que a nota fiscal é enviada ao Mercado Livre e o envio fica pronto para despacho, o Mercado Livre disponibiliza a etiqueta de envio (a PLP) para impressão. Este capítulo mostra como baixar essa etiqueta em PDF — uma de cada vez ou várias num único arquivo — direto da tela Conciliação de NF x Marketplace.
O que é: a etiqueta de envio é o documento que acompanha o pacote (no caso dos Correios, é o que se leva à agência). Ela é gerada pelo Mercado Livre e fica disponível para impressão depois que o envio está pronto — o que, nas logísticas de coleta/postagem, acontece justamente após o envio da NF (capítulo Envio da NF ao Mercado Livre).
Quando a etiqueta fica disponível
A etiqueta só pode ser baixada quando o envio está pronto para impressão. O que leva o envio a esse ponto depende da logística:
| Logística | A etiqueta fica disponível… |
|---|---|
| Correios/Agência, Places, Coletas, Coleta rápida | Depois que a NF é importada (enviada por esta integração) e o pedido fica pronto para despacho. |
| Flex | Quando o envio fica pronto no fluxo do Mercado Livre (no Flex a NF é anexada ao pacote e não destrava a etiqueta). |
| Full | Não se aplica — quem imprime é o Mercado Livre, pois o estoque está com ele. |
Se você tentar baixar antes da hora, o sistema avisa que a etiqueta ainda não está disponível (o envio precisa estar pronto para impressão). Não é erro — é só aguardar o pedido avançar e tentar de novo.
Baixar uma etiqueta
Na grade, selecione a linha do pedido e use uma destas opções:
- O botão "Baixar etiqueta" no rodapé da tela; ou
- Clique com o botão direito sobre a linha e escolha "Baixar etiqueta/PLP (Mercado Livre)".
O sistema baixa o PDF da etiqueta, pergunta onde salvar (sugere o nome etiqueta_<pedido>.pdf) e abre o arquivo para você imprimir.
Baixar várias em um PDF só
Para imprimir várias etiquetas de uma vez, marque as linhas desejadas (a coluna de seleção da grade) e clique em "Baixar etiquetas (lote)" no rodapé. O sistema baixa a etiqueta de cada venda marcada e junta todas em um único PDF, pronto para imprimir de uma vez.
As etiquetas que ainda não estão disponíveis (envio não pronto) são puladas automaticamente — não interrompem o processo. Ao final, o sistema informa quantas entraram no PDF e lista as que ficaram de fora, para você tratá-las depois.
Assim como no envio da NF, a etiqueta só sai de verdade em produção: como em homologação a importação da NF é recusada, o envio de teste não chega a ficar "pronto para impressão" e a etiqueta não é gerada. O funcionamento completo se confirma numa venda real.
Sobre o termo "PLP": o que o Mercado Livre disponibiliza por aqui é a etiqueta de envio do pedido — o documento que acompanha o pacote e é usado no despacho (na agência dos Correios, na coleta, etc.). É esse arquivo que você baixa e imprime.
Com a etiqueta impressa, o ciclo daquela venda está completo: pedido conciliado, NF enviada e etiqueta em mãos para o despacho. Dúvidas comuns e o significado dos termos estão no capítulo Perguntas frequentes e glossário.