A integração Protheus Magalu liga o ERP da TOTVS à sua conta de seller no Magalu para que catálogo, saldo, preço, pedidos e notas fiscais passem de um sistema para o outro sem redigitação.
O Protheus segue como fonte da verdade: dele saem o estoque e o preço publicados, nele cada venda vira pedido de venda, e dele sai a NF-e cujo XML o Magalu precisa receber para marcar o pedido como faturado.
O que diferencia este par são as regras de cada lado, várias delas recentes. No Magalu, a Open API substituiu o antigo Integracommerce, separa o pedido por entrega e processa produto, preço e estoque de forma assíncrona; no Fulfillment, quem emite as notas é o Magalu Entregas.
No Protheus, todo pedido passa pela liberação de crédito e de estoque, e a regra fiscal está migrando da TES para o Configurador de Tributos.
A seguir, você vê o que o Protheus precisa ter, o que a API do Magalu permite, como pedido, estoque e nota circulam, o que muda no Fulfillment e onde entram a TOTVS, a Lexos e a Plugar.me.
O que é a integração Protheus Magalu?
A integração Protheus Magalu é a conexão automática que transforma a loja no Magalu em mais um canal de venda do TOTVS Protheus. O Magalu traz o comprador, processa o pagamento e cobra o prazo de postagem; o Protheus decide de qual filial e armazém a mercadoria sai, calcula os tributos e emite a nota.
É a divisão de qualquer integração do Magalu com ERP, a mesma da integração do Protheus com o Mercado Livre.
| Dado | Direção | O que acontece |
|---|---|---|
| Produto (SKU) | Protheus → Magalu | Código, título, NCM, origem, dimensões e EAN, quando houver |
| Preço | Protheus → Magalu | Preço “de” e preço “por” da tabela definida para o canal |
| Estoque | Protheus → Magalu | Saldo disponível do armazém que atende cada CD do Magalu |
| Pedido e comprador | Magalu → Protheus | Viram pedido de venda na filial certa e cadastro de cliente |
| NF-e | Protheus → Magalu | Chave e XML seguem para o pedido ser marcado como faturado |
| Envio e rastreio | Protheus → Magalu | Na logística própria, transportadora e código de rastreio |
| Notas do Fulfillment | Magalu → Protheus | XMLs emitidos pelo Magalu Entregas voltam para o ERP |
Os pedidos do Magalu ainda passam do Portal do Seller para o Protheus pelas mãos de alguém da equipe? Cada pedido digitado atrasa a nota e encurta o tempo até a postagem. A Plugar.me liga o Protheus ao Magalu mantendo o ERP no comando. Converse com o nosso time e veja como ficaria na sua operação.
O Protheus tem integração nativa com o Magalu?
Não como um conector pronto dentro do ERP. A documentação oficial da TOTVS não traz um módulo do Magalu no Protheus: o ERP oferece interfaces oficiais, como rotinas automáticas e serviços REST, e o caminho que a própria TOTVS anuncia para levar os clientes ao marketplace passa por hubs integradores.
| Quando | O que foi anunciado |
|---|---|
| Abril de 2021 | Integração da plataforma TOTVS Omni by Moddo ao marketplace do Magazine Luiza |
| Maio de 2023 | A TOTVS compra a Lexos, dona de um hub de marketplaces |
| Julho de 2023 | Parceria com o Magalu: clientes TOTVS entram no marketplace por hubs integradores, como o Integrador Marketplaces by Lexos |
| Hoje | O TOTVS Integrador de Marketplaces é contratado por assinatura, gerencia vários CNPJs e permite emitir a nota no ERP ou no próprio hub |
Para quem quer um fornecedor único, o hub da TOTVS é um caminho possível. A Plugar.me entra quando a empresa prefere um desenho ERP-first gerenciado de ponta a ponta: pedido gravado pelas rotinas oficiais, com os pontos de entrada do Protheus rodando, NF-e sempre emitida no ERP e cada troca monitorada com log, fila e reprocessamento.
Quem já usa um hub de canais pode mantê-lo e ligá-lo ao Protheus, como na integração do Protheus com a AnyMarket.
Está em dúvida entre o hub da TOTVS, um hub de canais ou uma integração ERP-first? A escolha define onde ficam as regras fiscais e quem responde quando um pedido trava. Converse com a Plugar.me e coloque os três desenhos lado a lado com a sua operação.
O que o Protheus precisa ter para integrar com o Magalu?
O Protheus precisa dos serviços oficiais habilitados e das regras do canal definidas antes do primeiro pedido. Nada de gravar direto nas tabelas: o pedido entra pela rotina automática, que simula o preenchimento padrão da tela e faz rodar validações, campos de usuário e pontos de entrada.
| Item no Protheus | Por que importa |
|---|---|
| Serviços REST habilitados | São uma porta oficial de entrada no ERP; desde a release 12.24.10, todo serviço REST exige autenticação |
| Filial e armazém do canal | Definem qual CNPJ fatura e de qual armazém sai cada pedido |
| TES do canal e Configurador de Tributos | A TES cuida do estoque e do financeiro; o Configurador, do cálculo dos tributos |
| Cadastro de produto completo | NCM, origem, dimensões, EAN quando houver e os atributos que a categoria do Magalu exige |
Pontos de entrada como o MT410TOK, que valida o pedido ao salvar, e o M410STTS, que roda depois da gravação, são ganchos da própria rotina, e é neles que costumam ficar as regras próprias da sua empresa. Gravar direto no banco pula todos eles, risco também tratado na integração do Protheus com a VTEX.
Você sabe quais regras da sua empresa rodam hoje dentro do pedido de venda do Protheus? Uma integração que pula essas regras grava pedido que nenhuma validação conferiu. A Plugar.me faz esse levantamento com o seu time logo no diagnóstico.
O que a API do Magalu permite?
A Open API do Magalu permite cadastrar produtos, preços e estoques, consultar pedidos e entregas, enviar a nota fiscal e informar o envio. O acesso segue o OAuth 2.0 pelo ID Magalu: o seller aprova a aplicação com o login da loja, de pessoa jurídica, e alguns escopos dependem de aprovação adicional.
| Recurso | Como funciona |
|---|---|
| Token de acesso | Vale por até 7.200 segundos (2 horas) e é renovado pelo refresh token |
| Pedido | Separado por entrega (pacote), com datas e nota fiscal em cada entrega |
| Avisos (webhooks) | Pedido novo e aprovado; entrega aprovada, faturada, enviada, entregue ou cancelada |
| Produto, preço e estoque | APIs separadas, com processamento assíncrono e resultado consultado depois |
| Limites | Por minuto e por seller; acima deles, erro 429 |
São 650 requisições por minuto para cadastrar produtos ou estoque e 850 para enviar preços ou consultar pedidos, segundo a documentação oficial da API do Magalu.
Como o webhook só avisa que algo mudou e o detalhe vem de nova consulta, a integração precisa de fila para respeitar esses limites. A versão mais nova dos avisos exige HTTPS e assina cada mensagem, cuidados de segurança e proteção de dados que a integração precisa seguir.
O token da sua loja no Magalu vence e ninguém percebe até faltar pedido novo no Protheus? Num pico de vendas, cada hora parada vira entrega atrasada. A Plugar.me cuida de tokens, limites e avisos do Magalu por você.
Como o pedido do Magalu entra no Protheus?
O pedido entra como pedido de venda, gravado pela rotina automática do MATA410, com cabeçalho na tabela SC5 e itens na SC6. Antes de virar nota, passa pela liberação, que grava a SC9 e deixa o pedido apto a faturar ou bloqueado por crédito ou por estoque.
| Etapa | Sistema | O que a integração faz |
|---|---|---|
| Aviso de pedido | Magalu | Recebe o webhook e consulta pedido e entrega na API |
| Cliente | Protheus | Localiza ou cadastra o comprador no cadastro de clientes (SA1) |
| Pedido de venda | Protheus | Grava pelo MATA410, com filial, armazém e TES do canal |
| Liberação | Protheus | Libera crédito e estoque para o pedido ficar apto a faturar |
| Prazo de postagem | Magalu → Protheus | Converte a data limite, enviada em UTC, para o horário de Brasília |
Três decisões evitam pedido parado. A primeira é quando criar o pedido no ERP: no aviso de pedido novo ou só no de aprovado. A segunda é o crédito: ao contrário da análise de estoque, a de crédito pode ser desligada por parâmetro ou desenhada para o canal, em que quem recebe do comprador é o Magalu.
A terceira é o relógio: a API entrega a data limite em UTC, o Portal do Seller mostra no horário de Brasília, e a conversão errada pode mudar o dia. Postar fora do prazo pesa no indicador de Despacho no Prazo do Magalu Entregas. O mesmo fluxo está descrito na integração do SAP Business One com o Magalu.
Já viu pedido do Magalu travado na liberação de crédito do Protheus, com a venda paga? Enquanto ele espera, a data limite de postagem continua correndo. Deixe a Plugar.me desenhar a regra certa para esse canal.
Como o estoque e o preço do Protheus chegam ao Magalu?
O estoque sai do armazém que atende o canal, e o preço, da tabela definida para o Magalu. No Protheus, cada filial tem os seus armazéns, e a primeira decisão é qual par de filial e armazém abastece cada origem de envio.
| Decisão | Por que importa |
|---|---|
| Saldo disponível, e não saldo atual | O Saldo Atual (B2_QATU) da SB2 soma quantidades empenhadas e de terceiros |
| Um CD do Magalu por origem de envio | A API de estoque aceita o CD cadastrado no Multi-Origem do Magalu Entregas |
| Origem informada no pedido | O pedido diz de qual CD ou loja a entrega sai, e isso aponta filial e armazém |
| Preço “de” e preço “por” | Os dois são obrigatórios, e o “por” não pode ser maior que o “de” |
| Retorno de cada envio | Estoque e preço são processados de forma assíncrona, e a integração confere o resultado |
Saldo errado volta como problema no próprio Protheus: se a TES do canal atualiza estoque e o armazém não tem saldo disponível, o pedido trava na liberação, e essa análise não tem parâmetro para ser desligada. A escolha de filial e armazém também é o centro da integração do WinThor com o Magalu, outro ERP da TOTVS no mesmo marketplace.
O Magalu mostra hoje o saldo do armazém que vai despachar ou um número somado de todas as filiais? Saldo errado vira venda sem mercadoria na prateleira e pedido bloqueado no ERP. A Plugar.me desenha com você o mapa entre filiais e CDs.
Como fica a regra fiscal com a TES e o Configurador de Tributos?
A TOTVS está descontinuando a configuração fiscal da TES e indica o Configurador de Tributos como solução oficial. A TES continua, mas com outro papel: cuida da integração do pedido com faturamento, estoque e financeiro, e as regras de cálculo dos tributos vão para o Configurador.
| Onde fica | O que define |
|---|---|
| TES (MATA080) | Integração com faturamento, compras, estoque, financeiro e ativo |
| Configurador de Tributos (FISA170) | Cálculo, escrituração e apuração dos tributos |
| CBS, IBS e IS | Desde março de 2025, só são configurados no Configurador |
| TES Inteligente | Pode escolher a TES de integração, mas não serve mais como critério fiscal |
Para o Magalu, o pedido continua recebendo a TES certa, mas a regra do imposto precisa estar no Configurador.
As configurações da TES não migram sozinhas, e a convivência vai até a release 12.1.2710, ligada à extinção do PIS e da Cofins prevista para janeiro de 2027, segundo o FAQ da TOTVS sobre a descontinuação das operações fiscais da TES. O FAQ também avisa que futuras atualizações do Protheus não serão compatíveis com a TES.
A sua migração para o Configurador de Tributos já inclui os pedidos dos marketplaces? Se o canal ainda depende da regra fiscal da TES, o risco aparece no cálculo do imposto e na emissão da nota. A Plugar.me mapeia a TES e as regras do canal junto com o seu fiscal.
Como a NF-e e o rastreio voltam para o Magalu?
Com o pedido liberado, o Protheus fatura em Documentos de Saída, gera a NF-e na filial que vendeu e transmite a nota à SEFAZ pelo TSS. A integração envia ao Magalu a chave de acesso, de 44 dígitos, o valor, a data de emissão e o XML autorizado, porque o pedido só muda para faturado depois que o XML chega.
| Etapa | Sistema | O que a integração faz |
|---|---|---|
| Faturamento | Protheus e TSS | Gera a NF-e no documento de saída e transmite à SEFAZ |
| Nota no Magalu | Protheus → Magalu | Envia chave, valor, data de emissão e XML na entrega certa |
| Validação | Magalu | Confere a nota com a SEFAZ de forma assíncrona |
| Correção | Protheus → Magalu | Atualiza a nota que voltar como inválida |
| Envio | Protheus → Magalu | Na logística própria, informa transportadora, rastreio, despacho e previsão de entrega |
Nas entregas pelo Magalu Entregas, a etiqueta pode ser gerada pela API, em PDF ou ZPL, e o rastreio pode ser consultado pela API da Magalog. O caminho da nota pelo TSS até o canal é o mesmo da integração do Protheus com a Shopee.
Quantas entregas da sua loja já ficaram sem faturar no Magalu com a nota autorizada no Protheus? Quase sempre o XML não chegou ou foi para a entrega errada. A Plugar.me envia o XML para a entrega certa e deixa cada recusa visível no log.
Como funciona o Fulfillment do Magalu com o Protheus?
O Fulfillment é uma das quatro modalidades do Magalu Entregas, ao lado da Entrega Vapt, da Agência Magalu Entregas e da Coleta e Entrega.
Nele, o Magalu guarda o seu estoque, separa, embala e entrega os pedidos, e o papel do ERP muda: todas as notas do serviço, de remessa, retorno e venda, são emitidas pelo Magalu Entregas com os dados fiscais que você cadastra e pelos quais responde.
| Ponto | Estoque próprio | Fulfillment do Magalu |
|---|---|---|
| Quem guarda e envia | A sua empresa | O Magalu Entregas, a partir do CD dele |
| Quem emite as notas | O Protheus | O Magalu Entregas, inclusive remessa e retorno |
| Papel do Protheus | Faturar e enviar o XML ao Magalu | Manter o cadastro fiscal e receber os XMLs |
| Estoque no ERP | Armazém de onde sai o envio | Armazém próprio, espelhando o saldo do CD |
A API desconsidera a nota do seller em pedido Fulfillment, e a API de Documentos Fiscais devolve os XMLs pela chave ou em lote para o ERP.
Um mesmo SKU também não pode ser vendido no Fulfillment e no estoque local com a mesma identificação, então quem usa os dois modelos precisa de SKUs separados; com estoque nos dois lugares, o Magalu prioriza o envio pelo Fulfillment. O armazém espelhado segue a lógica do FBA na integração do Protheus com a Amazon.
As notas que o Magalu Entregas emite no Fulfillment estão chegando ao seu Protheus ou ficam paradas no Portal do Seller? Sem esses XMLs no ERP, o fechamento fiscal e o saldo do armazém espelhado ficam incompletos. Converse com a Plugar.me sobre a captura automática desses documentos.
Que problemas a integração resolve?
Ela elimina o trabalho que hoje acontece entre as duas telas: copiar pedido, conferir saldo, reenviar nota. É nesse intervalo que nascem os atrasos de postagem e as notas que não chegam ao canal.
| Sem integração | Com o Protheus integrado ao Magalu |
|---|---|
| Pedido copiado do Portal do Seller | Pedido gravado pela rotina oficial, na filial certa |
| Pedido parado na análise de crédito | Regra de crédito desenhada para o canal |
| Saldo atual publicado como disponível | Saldo disponível de cada armazém |
| Nota autorizada que não chega ao Magalu | XML enviado e pedido faturado |
| XMLs do Fulfillment fora do ERP | Notas do Magalu Entregas no Protheus |
| Erro 429 em pico, sem reenvio | Fila e reprocessamento dentro dos limites |
Em operações de maior volume, a fila pesa tanto quanto o mapeamento, como mostra o cuidado com fila e limites da API na integração do SAP S/4HANA com o Magalu.
Na última data forte de vendas, quantos pedidos do Magalu precisaram de alguém para destravar no Protheus? Cada intervenção manual é um ponto de falha que cresce junto com o canal. A Plugar.me tira esse trabalho das mãos da sua equipe.
Preciso desenvolver essa integração do zero?
Não. A TOTVS não documenta um conector nativo, mas o Protheus e o Magalu expõem interfaces oficiais, e uma integradora especializada constrói e mantém a ponte por você.
| Caminho | Como funciona | Quem mantém |
|---|---|---|
| Desenvolver internamente | O seu time escreve em AdvPL a ponte com a Open API | A sua equipe, a cada mudança do Magalu ou da TOTVS |
| Consultoria sob medida | Um parceiro desenvolve o projeto para o seu ambiente | Novo escopo a cada ajuste |
| Hub ERP-first | Camada pronta sobre as interfaces oficiais dos dois lados | O fornecedor; o Protheus continua sendo a fonte da verdade |
O que pesa é a manutenção. Com a Open API, o pedido passou a ser separado por entrega e o código perdeu o prefixo LU; no Protheus, a regra fiscal está mudando de lugar. Quem constrói sozinho assume cada mudança. Antes de decidir, vale entender o que é um hub de integração de marketplaces e ver os ERPs integrados pela Plugar.me.
Quem vai atualizar a sua integração na próxima mudança da Open API do Magalu ou da regra fiscal do Protheus? Se ninguém tem essa resposta, o projeto feito em casa vira dívida técnica. Peça à Plugar.me uma comparação dos caminhos antes de decidir.
Como a Plugar.me pode ajudar nessa integração?
No modelo ERP-first da Plugar.me, o Protheus decide e o Magalu executa: o pedido entra pelas rotinas oficiais, a NF-e é emitida no ERP e o canal recebe saldo, preço e nota como o Protheus definiu. Tudo roda em nuvem, com cada troca registrada para auditoria e reprocessamento, no desenho do hub ERP-first da Plugar.me.
- Diagnóstico: filiais, armazéns, TES, regras do Configurador de Tributos, pontos de entrada e release do seu Protheus.
- Mapeamento: filial e armazém de cada CD, TES do canal, momento de criar o pedido, regra de crédito e SKUs do Fulfillment.
- Go-live assistido: primeiros pedidos e notas acompanhados de perto, com tratamento das exceções.
- Monitoramento: log de cada envio, fila dentro dos limites da API e reprocessamento do que falhar.
O Magalu já é um canal importante para você, mas a operação ainda depende de alguém conferindo pedido e nota? Cada conferência manual é um atraso esperando para acontecer. A Plugar.me assume a integração do seu Protheus com o Magalu, do diagnóstico ao monitoramento em produção.
Conclusão
A integração Protheus Magalu funciona quando cada sistema faz o seu papel: o Magalu vende, avisa e cobra prazo, e o Protheus decide saldo, preço, filial, tributo e nota. A ponte precisa acompanhar o que mudou, da Open API e do estoque por CD no Magalu ao Configurador de Tributos no Protheus.
Com o ERP no comando, o pedido é liberado sem travas indevidas, o saldo publicado é o disponível e as notas do Fulfillment voltam para o Protheus. Cada NF-e emitida pelo ERP segue o padrão do Portal Nacional da Nota Fiscal Eletrônica antes de o XML chegar ao Magalu.
Fale agora com a Plugar.me e descubra como conectar o seu Protheus ao Magalu com o ERP no comando. Mostre quais filiais e armazéns atendem o canal, diga se você usa o Fulfillment e em que ponto está a sua migração para o Configurador de Tributos, e a gente monta o desenho da integração para o seu cenário.
Não há conector do Magalu documentado dentro do Protheus. A ligação usa as interfaces oficiais do ERP, como rotinas automáticas e serviços REST, e a Open API do Magalu.
Sim. Em 2021, a TOTVS anunciou a integração da plataforma TOTVS Omni by Moddo ao marketplace e, em 2023, firmou parceria para levar os clientes ao Magalu por hubs integradores, como o da Lexos, empresa que a TOTVS comprou naquele ano.
Na venda com estoque próprio, a NF-e é emitida no Protheus, e o XML vai para o Magalu. No Fulfillment, o Magalu Entregas emite as notas de remessa, retorno e venda com os dados fiscais que você cadastrou.
A TOTVS está descontinuando a configuração fiscal da TES e indica o Configurador de Tributos como solução oficial. A TES segue com a integração com estoque e financeiro, e CBS, IBS e IS só são configurados no Configurador.
Sim. A API de estoque aceita o identificador de cada CD cadastrado no Multi-Origem do Magalu Entregas, e a integração envia o saldo disponível do armazém que atende cada um.
Sim. O Magalu exige CNPJ ativo há mais de três meses e emissão de NF-e, e não aceita venda com CPF. O MEI pode vender se cumprir as duas condições.
Funciona por eventos: o Magalu avisa cada mudança por webhook e a integração consulta o detalhe na API. Como produto, preço e estoque são processados de forma assíncrona, a integração confere o resultado de cada envio.
Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.
