No Magalu, o erro que mais custa caro não é de código: é colocar o mesmo SKU em Fulfillment e em estoque local com a mesma identificação. A própria documentação do marketplace alerta para isso, e a consequência aparece como inconsistência de preço, estoque e oferta — sintomas que parecem bug de integração e não são.
A autenticação das APIs de Marketplace passou a ser OAuth 2.0 pelo ID Magalu, com client_id, client_secret e tokens renováveis. A API de Produtos é segmentada em módulos independentes — SKUs, Preços e Estoques —, cada um com endpoints próprios de criação, consulta e atualização, e a API de Pedidos cobre pedidos e entregas separadamente.
Os limites também são por módulo e por seller: 650 requisições por minuto em cadastro de Produtos, 850 em Preços, 650 em Estoques e 850 em consulta de Pedidos, com 429 no excesso. Como o SAP Business One trabalha por cadeia de documentos, o desenho precisa decidir em que momento o pedido do Magalu vira pedido de venda no ERP e como o modelo de fulfillment altera o saldo que pode ser publicado. Veja as demais integrações do SAP Business One.
O que é a integração SAP Business One Magalu?
É a conexão automática entre o ERP SAP Business One e o marketplace da Magalu, fazendo os dois sistemas trocarem dados sem intervenção manual.
A divisão de papéis: o SAP B1 é a fonte oficial — controla estoque, preços, faturamento, fiscal e financeiro. O Magalu é canal de venda — capta o cliente, processa o pedido e cobra o prazo de envio.
Vale lembrar que vender no Magalu não significa vender em uma vitrine só. O grupo reúne outras frentes, e o seller aprovado alcança essa base a partir do mesmo cadastro. Isso amplia o alcance — e amplia também o custo de manter catálogo e estoque errados.
Por que o SAP Business One exige uma integração bem feita?
Porque ele não aceita atalho. Um conector genérico ignora justamente a estrutura que faz o SAP B1 ser confiável:
- Mesmo SKU em Fulfillment e em estoque local. A própria documentação do Magalu alerta: um SKU não pode ser comercializado ao mesmo tempo nas duas modalidades com a mesma identificação. Quando isso acontece, aparecem inconsistências de preço, estoque e oferta que parecem bug de integração e não são.
- Módulo estrangulado enquanto os outros respiram. Os limites são por módulo e por seller: 650 por minuto no cadastro de Produtos, 850 em Preços, 650 em Estoques e 850 na consulta de Pedidos. Tratar tudo como uma fila única desperdiça cota de um lado e estoura do outro.
- Token expirado no meio da operação. A autenticação passou a ser OAuth 2.0 pelo ID Magalu, com tokens renováveis. Integração que não renova o token para de publicar sem aviso.
- Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
- Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.
Quais problemas surgem sem a integração entre SAP B1 e Magalu?
- Venda sem estoque. O anúncio segue no ar enquanto o item já saiu no ERP por outro canal. Cancelamento no Magalu cobra caro em reputação de seller.
- Atraso na expedição. O pedido espera digitação enquanto o prazo do marketplace corre.
- Preço desatualizado. A lista mudou no SAP B1 e o anúncio não acompanhou. Você vende com margem errada.
- Documento fora da cadeia. Pedido lançado às pressas, sem seguir o fluxo, gera nota com problema e retrabalho fiscal.
- Repasse que não bate. O que o Magalu repassou não confere com o que o ERP registrou, e alguém passa o mês conciliando.
Quanto custa continuar no manual?
O custo raramente aparece como uma linha no orçamento. Ele aparece como uma pessoa dedicada a copiar pedido, como cancelamento que derruba reputação, e como margem errada em item cujo preço mudou sem o anúncio acompanhar.
Enquanto o volume é baixo, dá para absorver. O problema é o teto: a partir de certo número de pedidos por dia, a digitação deixa de ser incômoda e passa a ser o que impede o canal de crescer.
Como funciona a integração ERP SAP B1 Magalu?
A Plugar.me opera como uma camada entre o SAP Business One e a API do Magalu, traduzindo os dados, orquestrando a ordem das operações e tratando os erros que aparecem no caminho.
| Dado | Direção | O que acontece |
|---|---|---|
| Produtos e atributos | SAP B1 → Magalu | Cadastro sai do ERP com os atributos exigidos pela categoria |
| Estoque | SAP B1 → Magalu | Saldo do depósito correto atualiza o anúncio |
| Preços | SAP B1 → Magalu | Valor sai da lista de preços definida no ERP |
| Pedidos | Magalu → SAP B1 | Venda entra como pedido, na série e operação corretas |
| Clientes | Magalu → SAP B1 | Parceiro de negócio criado ou vinculado para faturar |
| Nota fiscal | SAP B1 → Magalu | NF-e emitida no ERP e devolvida ao marketplace |
| Rastreio | SAP B1 → Magalu | Código de envio atualiza o pedido no canal |
Como funciona a sincronização de pedidos?
Assim que a venda é confirmada no Magalu, a integração captura o pedido e cria o documento correspondente no SAP B1 — com o parceiro de negócio certo, a série definida para o canal e a operação fiscal adequada.
O objetivo é que o pedido do Magalu seja indistinguível de qualquer outro para quem opera o ERP: entra nos mesmos relatórios, passa pelas mesmas conferências, fecha junto com o resto.
Como funciona o controle de estoque?
O saldo sai do SAP B1 e atualiza o anúncio. A pergunta relevante não é “quanto tem”, e sim “quanto tem, em qual depósito, e quanto disso pode ser vendido no marketplace”.
É comum não querer expor todo o saldo: parte está comprometida com pedidos em aberto, parte é de um depósito que não atende o canal. A integração precisa respeitar essa separação para não vender o que já está reservado.
No Magalu o estoque tem módulo próprio, com endpoints separados de criação, consulta e atualização. A decisão que antecede qualquer chamada é a modalidade: em Fulfillment quem controla o saldo é o marketplace, porque a mercadoria está no centro dele; em estoque local o controle continua no SAP Business One. Misturar as duas para o mesmo SKU é o erro que a documentação sinaliza explicitamente.
Como funciona a sincronização de preços?
O preço enviado ao Magalu sai de uma lista de preços do SAP B1, não de planilha paralela. Quando a lista muda no ERP, o anúncio acompanha.
Vale tomar uma decisão consciente aqui: o preço do marketplace normalmente não é o preço praticado nos demais canais. Comissão, frete e a dinâmica do próprio Magalu pedem lista própria. O papel da integração é garantir que seja essa lista a publicada — e que ela continue governada pelo ERP.
Como funciona o faturamento e a emissão de notas fiscais?
A nota nasce no SAP B1. É a regra que separa uma integração ERP First de um conector qualquer.
O pedido segue a cadeia de documentos da sua empresa, a NF-e é emitida com CFOP e tributação corretos, e o número volta para o marketplace dentro do prazo. Seu fiscal continua sendo um só, dentro do sistema onde sempre esteve.
O Magalu exige o documento fiscal para liberar o faturamento do pedido, e o prazo de envio faz parte da régua de qualidade do seller — atraso na emissão vira indicador ruim no marketplace, não apenas problema interno. No fluxo ERP First a NF-e é emitida na cadeia de documentos do ERP e comunicada em seguida.
Qual é o fluxo completo, do clique à nota fiscal?
- O cliente compra no Magalu.
- A integração captura o pedido e cria o documento no SAP B1, na série e operação corretas.
- O estoque é baixado no ERP e o saldo do anúncio é atualizado.
- O pedido segue a cadeia de documentos: separação, entrega, faturamento.
- A NF-e é emitida no SAP B1.
- Número da nota e rastreio voltam para o Magalu.
- O painel da Plugar.me registra cada etapa em log, para auditoria.
Preciso desenvolver uma integração do zero?
Não existe conector nativo entre o SAP Business One e o Magalu. O SAP B1 expõe suas próprias interfaces; o Magalu tem API de marketplace. Alguém precisa traduzir entre os dois, respeitar a cadeia de documentos e tratar as falhas.
| Caminho | Investimento inicial | Tempo até operar | Manutenção |
|---|---|---|---|
| Desenvolver internamente | Alto | Longo | Sua equipe, para sempre — inclusive quando a API mudar |
| Consultoria sob medida | Alto | Médio | Depende de contrato; cada ajuste é novo escopo |
| Hub ERP-first | Baixo | Curto | Do fornecedor, com o ERP seguindo como fonte da verdade |
O que costuma ser subestimado no desenvolvimento interno não é construir. É manter. Marketplace muda regra de API, exigência de categoria e prazo. Quem construiu internamente assume essa fila para sempre.
Quais os benefícios para empresas em crescimento?
- Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
- Reputação preservada. Menos cancelamento por ruptura e menos atraso de expedição.
- Margem sob controle. O preço do canal sai da lista definida no ERP.
- Fiscal em um lugar só. A nota nasce no SAP B1, na cadeia correta.
- Fechamento sem conciliação manual. O que aconteceu no canal está registrado no ERP.
- Rastreabilidade. Log de cada etapa, para quando algo precisar ser auditado.
Para quais empresas essa integração é indicada?
- Distribuidoras, importadoras e indústrias que rodam SAP B1 e querem o Magalu como canal sério.
- Operações com mais de um depósito, onde estoque e faturamento não são triviais.
- Empresas com volume suficiente para que a digitação manual já esteja doendo.
- Negócios que precisam de fiscal correto por obrigação, não por preferência.
Por que escolher uma integração ERP First para o SAP B1?
Porque a alternativa é deixar o marketplace ditar a operação. Existe um modelo em que o hub vira o centro: o catálogo passa a viver nele, o pedido é tratado nele, e o ERP recebe um resumo depois. Para quem investiu em SAP Business One justamente pela estrutura de documentos e pelo controle fiscal, isso é inverter o comando.
- Estoque, preço e cadastro têm uma origem: o SAP B1.
- A nota fiscal nasce no ERP, na cadeia de documentos da sua empresa.
- O canal é canal — importante, mas não dono do dado.
- Se amanhã você abrir outro marketplace, a fonte da verdade não muda.
Como a Plugar.me realiza a integração SAP B1 Magalu?
A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.
- Diagnóstico. Entender como o seu SAP B1 está configurado: depósitos, listas de preço, séries, cadeia de faturamento e regras fiscais.
- Mapeamento e setup. Definir de onde sai cada dado, qual série e operação o pedido do Magalu deve usar e qual saldo o canal enxerga.
- Go-live assistido. Acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.
Conclusão: vale a pena integrar o SAP B1 ao Magalu?
Vale quando o Magalu deixa de ser teste e passa a ser canal. A partir daí, digitação manual não é economia: é o teto do canal e a origem dos erros que custam reputação de seller.
A integração bem feita não muda a forma como a sua empresa opera. Garante que o marketplace se encaixe na cadeia de documentos que já existe no SAP Business One, em vez de obrigar a operação a se contorcer para caber no marketplace.
Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu SAP B1 está estruturado hoje: quantos depósitos, qual o volume e como funciona o seu faturamento.
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.
