Como Integrar o Magalu Marketplace no Olist ERP: Passo a Passo Completo Magalu Entregas, Full e NF-e (Com Telas)

Dominar como integrar o Magalu Marketplace no Olist ERP (antigo Tiny ERP) é um passo decisivo para qualquer operação de e-commerce que deseja escalar vendas em um dos maiores ecossistemas varejistas da América Latina sem sofrer com rupturas de estoque, atrasos de faturamento na SEFAZ ou travamento de etiquetas no Magalu Entregas. Com mais de 1.300 lojas físicas que funcionam como agências de postagem, pontos de retirada (Retira Loja) e mini-hubs logísticos espalhados pelo Brasil, o Magazine Luiza oferece uma capilaridade omnichannel única — mas cobra um padrão rigoroso de SLA operacional e conformidade fiscal.

Na minha experiência auditando dezenas de contas de alta performance no Universo Magalu, mais de 80% das suspensões preventivas de anúncios e perdas de destaque em campanhas gigantescas — como a tradicional Liquidação Fantástica de janeiro e a Black Friday Magalu — acontecem por falhas de integração. Lojistas que tentam operar manualmente ou com conectores mal parametrizados esbarram em três problemas clássicos: erro de autenticação OAuth por perfil de Pessoa Física no ID Magalu, rejeição de Nota Fiscal Eletrônica (NF-e Modelo 55) por ausência do CNPJ do Intermediador do Magazine Luiza S/A e demora no envio do arquivo XML para destravar a etiqueta térmica de postagem.

Neste super tutorial técnico e ilustrado com as telas oficiais do sistema, você vai aprender passo a passo como instalar, autenticar e configurar 100% da integração do Magalu Marketplace no Olist ERP. Vamos cobrir desde a autorização no portal Universo Magalu (Gestão de Integradoras), regras de reserva de estoque e segurança, estratégias de preço De/Por para campanhas promocionais, preenchimento fiscal do Intermediador, transmissão automática de Chave de Acesso/XML e rastreio na expedição, até as diferenças arquiteturais para a operação no Magalu Fulfillment (Full).

1. O Que é a Integração Magalu Marketplace no Olist ERP e Quais Recursos Ela Automatiza?

A integração nativa entre o Magalu Marketplace e o Olist ERP estabelece uma ponte bidirecional em tempo real via API REST oficial da plataforma Magazine Luiza, disponível para todos os planos do Olist ERP. Em vez de sua equipe precisar acessar o portal Universo Magalu manualmente a cada hora para conferir se entraram vendas, baixar planilhas de estoque ou digitar chaves de 44 dígitos da NF-e, o ERP passa a atuar como o centro de comando (Master Source of Truth) de toda a sua operação.

Quando devidamente configurada, a extensão oficial do Magalu Marketplace no Olist ERP habilita automaticamente os 10 recursos operacionais fundamentais abaixo:

• 1. Receber produtos (Importação de Catálogo): Importa os anúncios já publicados na sua loja do Magalu diretamente para o cadastro de produtos do ERP, trazendo fotos, SKU, GTIN/EAN, medidas e variações.
• 2. Enviar produtos (Publicação Multicanal): Exporta produtos simples ou com grade de variações do seu catálogo do Olist ERP direto para o Universo Magalu, com validação de ficha técnica e descrição complementar.
• 3. Enviar e atualizar estoque em tempo real: Sincroniza o saldo disponível (descontando reservas de pedidos em aberto em outros canais como Mercado Livre, Shopee e Amazon) e aplica regras de estoque de segurança.
• 4. Enviar e atualizar preços (De / Por): Dispara atualizações instantâneas de Preço de Venda (Preço “De”) e Preço Promocional (Preço “Por”), permitindo operar listas de preços dedicadas e campanhas agressivas.
• 5. Efetuar cotações de fretes: Integra regras de cálculo logístico e tabelas de contingência quando a operação trabalha com transportadoras próprias homologadas.
• 6. Receber pedidos automaticamente (OMS): Captura todos os pedidos do Magalu assim que entram ou têm o pagamento aprovado, reservando o estoque imediatamente e criando o cadastro completo do cliente para emissão da nota.
• 7. Sincronizar situações dos pedidos da plataforma para o ERP: Mantém o status de cada venda espelhado entre o Universo Magalu e o fluxo de pedidos do Olist ERP (New, Approved, Finished, Cancelled).
• 8. Enviar dados das NF-es (Chave de Acesso + Arquivo XML): Transmite automaticamente o número, série, data de emissão, chave de 44 dígitos e o XML protocolado na SEFAZ para validar a nota no Magalu e liberar a etiqueta do Magalu Entregas.
• 9. Enviar rastreamentos: Informa automaticamente o código de rastreio (tracking code) da transportadora ou Correios assim que o pacote é expedido no ERP.
• 10. Enviar situação de “Entregue” para os pedidos: Finaliza o ciclo logístico informando à plataforma quando a mercadoria foi entregue ao comprador (essencial para acelerar o ciclo de repasse financeiro em entregas próprias).

2. Pré-Requisitos e Regras de Compliance para Vender no Magalu Marketplace

Diferente de plataformas abertas que permitem o cadastro de vendedores pessoas físicas (CPF) ou empresas recém-abertas sem histórico, o Magazine Luiza adota um processo rigoroso de curadoria (Know Your Business – KYB) para proteger a reputação da marca e a experiência do consumidor. Antes de instalar a extensão no Olist ERP, certifique-se de que a sua empresa cumpre todos os pré-requisitos oficiais exigidos pelo Magalu:

1. Apenas Pessoa Jurídica com Tempo Mínimo de Atividade: É obrigatório possuir CNPJ ativo há mais de 6 meses (sendo exigido, na análise comercial padrão da curadoria Magalu, que a operação empresarial tenha pelo menos 1 ano de existência comprovada no mercado e Razão Social regularizada na Receita Federal e SEFAZ para emissão de NF-e Modelo 55).
2. Reputação Digital e Nota no Reclame Aqui: A empresa deve manter nota no portal Reclame Aqui acima de “Bom”, além de possuir boa avaliação nos principais sites de defesa do consumidor e nas mídias sociais.
3. Idoneidade Jurídica e Compliance Ético: O CNPJ e seus sócios não podem ter o nome envolvido em processos judiciais ou administrativos que abalem a reputação corporativa, tais como: trabalho análogo ao escravo, corrupção, contrabando ou descaminho, falsificação ou pirataria de marcas, sonegação fiscal, evasão de divisas ou histórico de lavagem de dinheiro.
4. Sortimento Qualificado e Produtos Idôneos: O lojista deve comercializar exclusivamente mercadorias originais, com procedência fiscal comprovada, certificação ANATEL/INMETRO/ANVISA (quando exigido pela categoria) e oferecer um catálogo diversificado e competitivo.
5. Domicílio Bancário Vinculado ao CNPJ: A conta-corrente bancária cadastrada no portal Universo Magalu para recebimento dos repasses das vendas deve estar obrigatoriamente vinculada ao mesmo CNPJ titular que assinou o contrato de adesão ao marketplace (não são aceitas contas de pessoa física dos sócios nem de terceiros).

3. Como Instalar a Extensão Magalu Marketplace e Autenticar via Universo Magalu / ID Magalu OAuth

A conexão entre o Olist ERP e o Magalu Marketplace utiliza o protocolo seguro de autorização OAuth 2.0 via ID Magalu, iniciado dentro do painel de gestão do vendedor no Universo Magalu e confirmado diretamente no ERP. Siga rigorosamente os 5 passos abaixo para conectar sua conta sem erros:

Figura 2: Acessando Menu > Início > Integrações no Olist ERP para localizar e instalar o conector oficial do Magalu Marketplace.

Passo a Passo Oficial de Instalação e Handshake OAuth

1. Instalar a Extensão no Olist ERP: No menu lateral esquerdo do seu sistema, acesse Menu > Início > Integrações. Clique no botão Adicionar integração, pesquise por Magalu Marketplace na barra de busca e clique em Instalar.
2. Autorizar a Integradora no Painel Universo Magalu: Para estabelecer o vínculo de segurança, abra uma aba no seu navegador e acesse o Painel da Magalu (Portal Universo Magalu). No menu lateral da plataforma, navegue pelo caminho: Menu > Gestão de integradoras.
3. Selecionar e Autorizar o ERP da Olist: Na vitrine de integradoras homologadas pelo Magazine Luiza, localize o card do ERP da Olist e clique no botão Autorizar. O sistema solicitará a confirmação através do seu ID Magalu.
4. Redirecionamento e Login no Olist ERP: Imediatamente após conceder a autorização no Universo Magalu, o navegador redirecionará você para o painel de login do ERP da Olist. Faça login normalmente na sua conta do ERP e acesse novamente Menu > Início > Integrações.
5. Confirmação da Conexão: Pronto! A integração com o Magalu Marketplace já estará salva, autenticada com os tokens de segurança e exibindo o status Conectada.

4. Como Configurar o Magalu Marketplace no Olist ERP: Guia Aba por Aba

Após conectar a conta, o Olist ERP inicia um fluxo guiado em etapas para parametrizar todas as regras de catálogo, estoque, preços, faturamento e logística. Vale destacar uma facilidade operacional importante: a integração ficará disponível para uso em produção somente após a conclusão de todas as etapas, mas você pode pausar a configuração a qualquer momento clicando no botão “Continuar depois” no rodapé da tela e retomar exatamente do ponto em que parou quando desejar.

4.1. Aba Produtos: Envio, Recebimento, Imagens e Tratamento de Variações

Na Aba Produtos, você estabelece como os cadastros de mercadorias transitam entre o Olist ERP e o Magalu Marketplace:

Bloco 1: Enviar Produtos

• Regra para envio de produtos: Define a política de transmissão de cadastros tanto para exportação de novos itens quanto para sincronização com o e-commerce.
• Enviar imagens dos produtos ao sincronizar: Escolha se, ao atualizar produtos na plataforma, as fotografias serão sempre enviadas (`Sim`) ou enviadas apenas para produtos novos (itens que ainda não estão cadastrados no Magalu). Recomendação de especialista: selecione “Apenas para produtos novos” no dia a dia para tornar a sincronização de estoque e preços muito mais rápida, mudando para “Sim” somente quando você reformular as fotos do catálogo no ERP.

Bloco 2: Receber Produtos

• Ao importar produtos (Tratamento de Imagens): Define como o Olist ERP salvará as fotos dos seus anúncios vindos do Magalu:
  • Importar imagens como anexo (Recomendado): O ERP baixa o arquivo físico das imagens e as registra permanentemente dentro do cadastro do produto no Olist, permitindo republicar o item em outros canais com segurança.
  • Apenas importar a URL externa das imagens: Salva somente o link externo hospedado no servidor da plataforma.
• Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): Habilite este parâmetro se quiser que o código SKU interno do ERP seja sobrescrito pelo SKU do Magalu sempre que houver reimportação de dados.
• Importar anúncios com uma variação como anúncios simples: No Magalu, muitos vendedores criam anúncios com apenas 1 variação (ex: “Voltagem: Bivolt” ou “Cor: Única”) que possuem um ID de variação separado do ID do produto pai. Ao habilitar esta chave inteligente, o Olist ERP converte automaticamente esses anúncios de variação única em um Produto Simples dentro do ERP, simplificando drasticamente o controle de estoque!

4.2. Sincronização de Estoque, Reserva, Estoque de Segurança e Magalu Fulfillment

Ainda dentro da Aba Produtos, na seção de Regras de Estoque (Receber/Enviar de Estoque), configuramos a blindagem antirruptura da sua conta:

1. Atualizar estoque na loja virtual a partir do ERP: Você encontrará três opções:
   • Não atualizar (não envia saldo ao Magalu; usar apenas em homologação);
   • Enviar saldo físico (envia o estoque total da prateleira, sem descontar pedidos pendentes);
   • Enviar saldo disponível (Altamente Recomendado: envia o estoque total já descontando a reserva de estoque de pedidos aprovados que aguardam emissão de NF-e).
2. Depósito a ser considerado na integração: Define qual depósito físico do ERP concentrará todas as movimentações de importar pedido, importar produtos e enviar estoque para o Magalu (exibido nas contas que possuem a extensão Depósitos de estoque instalada).
3. Utilizar estoque de segurança: Ative este parâmetro para definir um colchão de proteção contra vendas simultâneas. Quando o seu saldo disponível atingir esse número limite, o Olist ERP enviará imediatamente estoque = zero (`0`) para o Magalu Marketplace. Exemplo prático oficial: se você configurar Estoque de segurança = 5 e o seu Estoque atual cair para 2, na atualização automática para o Magalu será enviado Saldo = 0, pausando o anúncio a tempo de evitar cancelamentos! (Nota: este parâmetro não é considerado para itens configurados como produtos sob encomenda).
4. Utilizar Magalu Fulfillment: Habilite este parâmetro específico caso a sua operação utilize a logística de armazenagem Full do Magazine Luiza. Mais adiante neste guia (na Seção 8), detalhamos uma tabela comparativa completa explicando as diferenças entre operar via Magalu Entregas e ativar a extensão dedicada do Magalu Fulfillment.

4.3. Regras de Preço De/Por para Campanhas “Liquidação Fantástica” e Black Friday

O algoritmo promocional do Magazine Luiza valoriza fortemente a relação entre o Preço de Venda original (Preço “De”) e o Preço Promocional (Preço “Por”) para conceder selos de desconto e destacar ofertas nas vitrines da Liquidação Fantástica (que ocorre na primeira quinzena de janeiro com descontos de até 70% e tráfego massivo no SuperApp Magalu), no Aniversário Magalu e na Black Friday.

No Olist ERP, você domina essa estratégia sem precisar alterar o preço base dos seus outros canais:

• Preço de Venda (De) + Preço Promocional (Por) Nativos: Tanto na importação quanto no envio de produtos e na ferramenta de Gerenciar Preços de Anúncios, o Olist ERP sincroniza separadamente os campos Preço de venda e Preço promocional.
• Regra de Lockdown de Preço Pré-Campanha (Regra dos 30/60 dias): Para que o Magalu aprove a entrada de um SKU na Liquidação Fantástica ou na Black Friday com o selo de “Menor Preço dos últimos 30 dias”, você não pode inflar o preço na véspera (prática conhecida como “metade do dobro”, bloqueada pelo algoritmo de auditoria de histórico do Magalu). A estratégia de elite no Olist ERP consiste em vincular uma Lista de Preços exclusiva para o Magalu mantendo o Preço de Venda (De) posicionado com a margem cheia de tabela e operando no dia a dia através do campo de Preço Promocional (Por). Quando chega a semana da Liquidação Fantástica ou Black Friday, você apenas aprofunda o desconto no campo Preço Promocional em lote via planilha ou gerenciador de anúncios, cumprindo 100% da regra de histórico real da plataforma!

4.4. Aba Pedidos: Sincronização de Status, Etiquetas Térmicas ZPL e CNPJ do Intermediador Magazine Luiza S/A

Na Aba Pedidos, parametrizamos o fluxo de entrada das vendas, a impressão das etiquetas do Magalu Entregas e a blindagem fiscal da Nota Fiscal Eletrônica (NF-e):

1. Sincronização Automática dos Pedidos e Particularidade do Status “Shipped”

Habilite a opção Sincronização automática dos pedidos. Com ela ativa, todos os pedidos que assumirem no Magalu as situações New (Novo), Approved (Aprovado), Finished (Concluído/Entregue) ou Cancelled (Cancelado) serão automaticamente sincronizados com o Olist ERP.

Detalhe Técnico Importante: Por regra da API da integração, a situação intermediária Shipped (Enviado) não é sincronizada automaticamente da plataforma para o ERP. Caso você precise forçar a sincronização manual de status para pedidos específicos previamente selecionados, basta acessar no menu do ERP o caminho Vendas → Pedidos de venda → Sincronizar situação.

2. Envio Automático de Rastreamento e Método de Impressão de Etiquetas (PDF vs. Térmica ZPL)

• Enviar rastreamento ao alterar a situação no ERP para enviado: Mantenha este parâmetro habilitado para que o código de rastreio seja transmitido automaticamente ao Magalu sempre que o pedido mudar para a situação “Enviado” na sua expedição.
• Método de impressão de etiquetas: Selecione como sua bancada de embalagem imprimirá as etiquetas do Magalu Entregas:
  • Fornecido pela Magazine Luiza (PDF): Gera o documento padrão em folha A4 ou PDF visual para impressoras convencionais.
  • Impressora térmica (ZPL — Altamente Recomendado): Gera a etiqueta oficial do Magalu Entregas + DANFE Simplificado diretamente em linguagem nativa ZPL (100x150mm) para impressoras térmicas industriais como Zebra ZD220, Elgin L42 Pro ou Argox, permitindo colar a etiqueta na caixa em menos de 3 segundos!

3. Preenchimento Obrigatório do CNPJ do Intermediador Magazine Luiza S/A na NF-e (SEFAZ NT 2020.006)

Desde a implementação da Nota Técnica 2020.006 da SEFAZ, toda Nota Fiscal Eletrônica (NF-e Modelo 55) emitida para acobertar vendas realizadas em marketplaces deve trazer obrigatoriamente o indicador de operação intermediada (<indIntermed>1</indIntermed>) e o grupo <infIntermed> preenchido com os dados da plataforma. Se você tentar emitir uma NF-e do Magalu sem esses dados, a SEFAZ bloqueará o faturamento com as Rejeições 434, 439 ou 440.

Para automatizar 100% dessa obrigação fiscal na aba Pedidos da integração do Magalu no Olist ERP, cadastre e selecione o Intermediador da Transação utilizando exatamente estes dados oficiais:

• Nome do Intermediador: Magazine Luiza S/A (ou Magalu Marketplace)
• CNPJ do Intermediador da Transação (<CNPJ>): 47.960.950/0001-21 (CNPJ Matriz oficial da Magazine Luiza S/A, sediada em Franca/SP)
• Identificador do Intermediador / Loja no Canal (<idCadIntTran>): Informe o nome/identificador exato da sua loja cadastrado dentro do Universo Magalu.
• CNPJ da Instituição de Pagamento: Informe o CNPJ da processadora financeira responsável pela liquidação dos pagamentos no Magalu (ou o próprio CNPJ 47.960.950/0001-21 / MagaluPay conforme orientação da sua contabilidade).

4.5. Aba Mapeamentos e Aba Custos (Comissão Fixa ou Percentual)

Nas abas finais da configuração da integração, você amarra as situações de pedidos, as formas de recebimento/frete e a apuração de custos operacionais:

• Aba Custos (Comissão do Marketplace): Disponível para todas as contas que possuem a extensão Custos do e-commerce instalada no Olist ERP. Nesta aba, você define exatamente a estrutura de comissionamento cobrada pelo Magazine Luiza para cada categoria de produto: informe se a comissão terá um valor fixo (R$) e/ou uma taxa percentual (%) (geralmente entre 12% e 18% no Magalu, além da coparticipação logística), e escolha se a base de cálculo da comissão considerará o valor total da venda (produtos + frete) ou o total da venda sem o frete. Isso alimenta automaticamente a sua DRE Gerencial e o Contas a Receber com o lucro líquido real de cada pedido!

5. Como Usar o Olist ERP com o Magalu Marketplace no Dia a Dia: Regras de Ouro de Catálogo e Anatel

Com a integração ativa, existem quatro especificidades técnicas da API do Magazine Luiza que você e sua equipe de cadastro precisam conhecer para publicar anúncios com 100% de aprovação logo na primeira tentativa:

1. Diagnóstico de Falhas pelo Botão “Com problema (E)”: Sempre que um anúncio não puder ser sincronizado ou publicado no Magalu, o Olist ERP exibirá o indicador vermelho com problema (E) ao lado do registro. Basta clicar sobre esse ícone para ler a mensagem exata retornada pela validação do Magalu e corrigir o campo faltante em segundos.
2. Obrigatoriedade do Campo “Descrição Complementar”: Para que o envio dos anúncios do Olist ERP para o Magalu Marketplace ocorra com sucesso, é obrigatório que o campo Descrição complementar esteja preenchido dentro do cadastro do produto. Nunca deixe a descrição complementar em branco (use a IA LIS do Olist ERP para gerar descrições ricas e persuasivas automaticamente!).
3. Extensão “Embalagens” para Envio de Dimensões: Para que o Olist ERP envie corretamente as dimensões logísticas dos produtos (Altura, Largura e Comprimento) exigidas pelo cálculo de cubagem do Magalu Entregas, é necessário ter instalada na sua conta a extensão Embalagens e possuir uma embalagem definida no cadastro do produto.
4. Envio do Certificado de Homologação da Anatel: Se você vende produtos de telecomunicações, celulares, fones Bluetooth, roteadores, smartwatches ou caixas de som sem fio, o Magalu exige o número da Anatel para não derrubar o anúncio. Na integração do Olist ERP com o Magalu, apenas o atributo Certificado de homologação da Anatel é enviado da ficha técnica para a integração. Para que esse envio ocorra perfeitamente, cadastre o código exato desse atributo dentro da aba Ficha Técnica no cadastro do seu produto no ERP.

6. Como Receber (Importar) Produtos do Magalu Marketplace para o Olist ERP

Se você já possui um catálogo estruturado rodando dentro do Universo Magalu e quer trazê-lo para o Olist ERP criando automaticamente o vínculo de sincronização de estoque e preços, siga este procedimento oficial passo a passo:

1. No menu principal do Olist ERP, navegue até Menu > Cadastros > Produtos > Receber do e-commerce.
2. Selecione a sua loja do Magalu no campo Integração e clique em Continuar importação de anúncios. (Dica prática: caso você queira importar apenas um anúncio específico em vez do catálogo inteiro, preencha o código dele no campo Identificador do anúncio).
3. Defina a Regra de Relacionamento (Pareamento): Escolha como o Olist ERP deve identificar se um anúncio do Magalu já existe como produto cadastrado no seu ERP:
   • Possuem o mesmo código (SKU) (Padrão mais seguro e recomendado);
   • Possuem a mesma descrição (título); ou
   • Possuem o mesmo GTIN (EAN).
4. Configure a Atualização de Produtos Relacionados: Marque Sim ou Não para atualizar os dados dos produtos que já existem no ERP. Caso marque Sim, escolha se deseja atualizar todos os dados do produto ou apenas dados não preenchidos, e marque se deseja atualizar preço, atualizar o estoque ou atualizar imagens, clicando em Relacionar.
5. Criação de Produtos Novos e Dados Fiscais Padrão: Recomendamos fortemente marcar a opção Criar produtos novos com base nos anúncios para garantir que todos os pedidos futuros gerem notas fiscais sem travamento. Selecione o Depósito padrão, marque Importar as imagens do anúncio para os novos produtos e preencha os dados fiscais padrão (Unidade, NCM e Origem) que serão aplicados aos itens que não possuírem classificação fiscal.
6. Exceções de Lista de Preços e Conclusão: Se desejar, marque a opção Criar exceções na lista de preços vinculada ao e-commerce (para que itens com preços diferenciados no Magalu já sejam gravados na lista de preços vinculada à integração) e clique em Criar produtos para finalizar.

Os 19 Campos Importados Automaticamente do Magalu pelo Olist ERP

Durante o processo de recepção de produtos, o motor do Olist ERP importa e estrutura automaticamente os seguintes 19 campos técnicos e comerciais dos seus anúncios do Magalu:

• Identificação e Catálogo: Código (SKU), Código da categoria no e-commerce, Descrição (Título), Descrição complementar, Marca, Garantia e Variações (grade completa);
• Preços e Estoque: Preço de venda (De), Preço promocional (Por), Estoque atual e Imagens;
• Fiscal e Códigos de Barras: NCM, GTIN (EAN unitário) e GTIN Embalagem (caixa master);
• Logística e Cubagem: Altura embalagem, Largura embalagem, Comprimento embalagem, Peso bruto e Peso líquido.

Recurso de Pausa e Retomada (Até 7 Dias): Se você estiver importando milhares de SKUs do Magalu e precisar interromper o processamento (ou se houver qualquer oscilação momentânea), basta clicar na ação Interromper. O Olist ERP salva o progresso exato na nuvem e permite que você retome a importação do exato ponto em que parou em até 7 dias corridos!

7. Expedição Magalu Entregas: Como Enviar Chave de Acesso/XML da NF-e, Rastreio e Marcar como Entregue

A etapa mais crítica do SLA do Magazine Luiza é o faturamento e a expedição. No modelo Magalu Entregas (seja postagem em lojas Magalu/Correios ou coleta via transportadoras parceiras), a etiqueta oficial de envio só é liberada pela API do Magalu depois que o ERP transmite a Chave de Acesso de 44 dígitos e o arquivo XML da NF-e autorizada pela SEFAZ.

7.1. Como Enviar Dados da Chave de Acesso e XML ao Magalu pela Expedição

Além do envio automático ao autorizar a nota fiscal, você pode transmitir ou reenviar a qualquer momento a Chave de Acesso e o XML diretamente pelo módulo de Expedição do Olist ERP seguindo este fluxo:

1. Acesse Início > Vendas > Expedição;
2. Adicione o filtro Agrupamentos, altere a visualização para Visão por pedidos e, no filtro Por forma de envio, selecione Transportadora;
3. Localize o número da expedição desejada, clique no menu de contexto (`…`) e selecione a ação Enviar chave de acesso para o e-commerce.

O que o Olist ERP transmite nesse exato segundo? O sistema envia simultaneamente para a API do Magalu a Chave de Acesso (44 dígitos), o Número da NF-e, a Série da Nota Fiscal, a Data e Hora de emissão, a Data Prevista de entrega e, para otimizar e acelerar a validação fiscal na plataforma, o arquivo XML completo da NF-e também é enviado automaticamente! Com isso, o status do pedido no Magalu muda instantaneamente para Despachado e a etiqueta térmica fica 100% liberada.

7.2. Como Enviar o Código de Rastreio para a Plataforma

Para que o código de rastreamento (tracking code) seja transmitido ao Magalu, certifique-se de que o transportador (Correios ou Transportadora) esteja devidamente identificado no Pedido de Venda ou na Nota Fiscal e que o agrupamento (PLP ou Coleta) tenha sido gerado no módulo de Expedição:

• Acesse Início > Vendas > Expedição;
• Ao concluir a expedição e enviar o rastreio, o Olist ERP adiciona um marcador visual na linha do pedido confirmando que o código de rastreamento (junto com chave de acesso, número, série, data/hora e previsão de entrega) já foi recebido pelo Magalu Marketplace, atualizando o pedido na plataforma para Despachado.

7.3. Como Marcar Pedidos como “Entregues” no Magalu Marketplace

Especialmente para lojistas que operam com transportadoras próprias ou entrega direta, informar ao Magalu que o pacote já foi entregue na mão do cliente final é fundamental para cumprir o SLA e destravar o prazo de liquidação financeira:

1. No Olist ERP, acesse Menu > Vendas > Expedição;
2. Selecione a Forma de envio correspondente e clique na aba Concluídas;
3. Clique no menu de contexto (`…`) da expedição e selecione Marcar pedidos como entregue.

⚠️ Regra Obrigatória de Precedência da API Magalu: Para que o comando de marcar os pedidos como “Entregues” seja aceito pelo Magalu Marketplace, é estritamente necessário que esses pedidos já estejam previamente no status “Despachado” dentro do e-commerce (ou seja, com a NF-e/XML e o despacho já enviados anteriormente).

8. Tabela Comparativa das Modalidades Logísticas no Magalu (Magalu Entregas vs. Entrega Direta vs. Magalu Fulfillment no Olist ERP)

Uma dúvida muito comum entre vendedores em fase de escala é entender a diferença operacional no Olist ERP entre despachar via Magalu Entregas, operar com Entrega Direta (Transportadora Própria) e utilizar a operação de armazenagem Magalu Fulfillment (Full). Analise o quadro comparativo abaixo para configurar sua arquitetura logística com perfeição:

FAQ — Perguntas Frequentes sobre Como Integrar o Magalu Marketplace no Olist ERP

1. Por que está dando erro de login ao autorizar o Olist ERP no portal Universo Magalu (ID Magalu)?

O erro mais comum na autenticação OAuth entre o Magalu Marketplace e o Olist ERP ocorre quando o vendedor está logado no ID Magalu com um perfil de Pessoa Física (CPF) selecionado. A integração oficial exige obrigatoriamente que o perfil selecionado no momento da autorização seja um perfil de Pessoa Jurídica (CNPJ). Além disso, lembre-se de que atualmente só é permitido vincular uma única conta do Magalu a uma única conta no Olist ERP.

2. Qual é o CNPJ do Intermediador da Transação do Magazine Luiza para preencher na NF-e no Olist ERP?

Para atender à Nota Técnica 2020.006 da SEFAZ e evitar as Rejeições 434, 439 e 440 na emissão da Nota Fiscal Eletrônica (NF-e Modelo 55), você deve configurar na aba Pedidos da integração do Olist ERP o Intermediador Magazine Luiza S/A com o CNPJ oficial 47.960.950/0001-21, além de informar o identificador da sua loja no canal.

3. Como enviar a Chave de Acesso e o arquivo XML da NF-e pelo Olist ERP para liberar a etiqueta do Magalu Entregas?

Após emitir e autorizar a NF-e na SEFAZ, acesse no Olist ERP o caminho Início > Vendas > Expedição, aplique o filtro Agrupamentos na Visão por pedidos (forma de envio Transportadora), clique no menu de contexto (`…`) e selecione Enviar chave de acesso para o e-commerce. O Olist ERP enviará a chave de 44 dígitos, número, série, data/hora e o próprio arquivo XML da nota para validação imediata na plataforma, alterando o status para Despachado e liberando a etiqueta térmica ZPL/PDF.

4. Por que a situação “Shipped” (Enviado) não sincroniza sozinha do Magalu para o Olist ERP?

Por padrão da integração, a sincronização automática contempla os status New, Approved, Finished e Cancelled, enquanto o status intermediário Shipped não é atualizado de forma automática no sentido plataforma → ERP. Caso precise atualizar manualmente essa situação para pedidos selecionados, acesse Vendas → Pedidos de venda → Sincronizar situação.

5. Quais campos são obrigatórios no Olist ERP para que os produtos e o certificado da Anatel sejam enviados sem erro ao Magalu?

Para evitar que o anúncio caia no filtro vermelho com problema (E), certifique-se de preencher obrigatoriamente o campo Descrição complementar no cadastro do produto e instalar a extensão Embalagens (definindo uma embalagem padrão com altura, largura e comprimento). Para itens regulados pela Anatel, cadastre o atributo Certificado de homologação da Anatel diretamente na aba Ficha Técnica do produto no ERP.

6. Como faço para ativar o Cupom GEFF (30 dias grátis + 50% OFF) no Olist ERP e o Flip Crédito para minha loja no Magalu?

Para ativar o benefício máximo da parceria oficial, acesse https://info.olist.com/lp-geff e utilize o cupom GEFF, garantindo 30 dias grátis + 3 meses com 50% de desconto em qualquer plano do Olist ERP com a IA LIS inclusa. E se precisar de capital de giro rápido para comprar estoque para a Liquidação Fantástica ou Black Friday, acesse https://olist.com/credito/ e aplique o cupom GEFFALENCAR no Flip Crédito.

Conclusão: Escale Suas Vendas no Ecossistema Magalu com Operação 100% Automatizada

Integrar o Magalu Marketplace ao Olist ERP transforma uma operação manual sujeita a furos de estoque e gargalos fiscais em uma linha de produção digna dos maiores sellers do Brasil. Ao autenticar corretamente seu perfil de Pessoa Jurídica via ID Magalu, proteger seu inventário com o envio de Saldo Disponível + Estoque de Segurança, parametrizar o CNPJ do Intermediador (`47.960.950/0001-21`) e automatizar o envio de XML + impressão ZPL na Expedição, sua equipe ganha velocidade para faturar centenas de pacotes por hora com margem líquida auditada centavo por centavo.

Comece agora mesmo com o pé direito: resgate seu Cupom GEFF (30 dias grátis + 3 meses com 50% OFF + IA LIS) em info.olist.com/lp-geff e acelere seu fluxo de caixa com o Flip Crédito (Cupom GEFFALENCAR) em olist.com/credito!