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.