Integração WinThor Magazord: catálogo por loja e saldo vindo do ERP

A integração WinThor Magazord conecta o seu ERP ao Magazord de forma automática, sincronizando produtos, estoque, preços e pedidos sem digitação manual. O catálogo nasce no WinThor, o saldo publicado é o saldo real e cada venda entra no ERP como pedido, pronto para separação e faturamento.

O TOTVS WinThor é um ERP de atacado e distribuição, com filiais, política comercial por região e um fluxo de expedição feito para mover volume. O Magazord é uma plataforma brasileira que reúne e-commerce e gestão de pedidos numa operação só. A integração é a ponte entre os dois — e ela só funciona bem quando respeita o que cada lado exige de verdade.

Neste conteúdo você vai ver como a conexão funciona na prática, quais problemas ela elimina, o que a API do Magazord permite e por que o modelo ERP First é o caminho mais seguro para quem leva o WinThor a sério.

O que é a integração WinThor Magazord?

É a conexão automática entre o ERP TOTVS WinThor e o Magazord, fazendo os dois sistemas trocarem dados sem intervenção manual.

A divisão de papéis não deveria ser negociável: o WinThor é a fonte oficial — controla estoque, preços, faturamento e fiscal. O Magazord é canal — apresenta o produto, capta o cliente e registra o pedido.

Por que integrar o WinThor exige atenção?

Porque um conector genérico ignora justamente o que faz o ERP funcionar:

• Estoque por filial. Uma distribuidora com mais de um centro de distribuição não tem “um” estoque. O canal precisa enxergar o saldo da filial que realmente atende aquele pedido.
• Política comercial. Preço no WinThor depende de tabela e condição. O valor publicado precisa sair da regra certa, não de um campo solto.
• Fluxo por rotinas encadeadas. Pedido, separação, faturamento e expedição seguem uma ordem. Um pedido que entra fora dela vira exceção no fechamento.
• Tratamento fiscal distinto. Vender no atacado para CNPJ e vender pelo canal para consumidor final não são a mesma operação.

O que a API do Magazord permite?

• A API autentica por HTTP Basic, com o token no lugar do usuário e a senha correspondente.
• Estoque e preço têm conjuntos de endpoints próprios, separados do cadastro de produto.
• Ao criar produto são obrigatórios codigo, nome, marca e o vínculo produtoLoja[], com a loja informada.
• Variações são tratadas como derivação de um produto pai — tamanho, cor, sabor — em endpoint próprio.
• A nota fiscal é anexada ao pedido em XML, e a plataforma permite consultar a NF e obter a DANFE em PDF.
• Há webhooks para pedido registrado e para alteração de situação do pedido. Os limites numéricos de requisição não são publicados; a orientação oficial é tratar o retorno com retry e backoff exponencial.

O campo de peso exige formatação específica, com separador de milhar: 1 kg é enviado como 1,000 e 100 g como 0,100. Parece bobagem, mas diverge do padrão decimal da maioria dos ERPs — e peso errado vira frete errado, que vira margem errada em cada pedido.

Quais problemas surgem sem a integração entre WinThor e Magazord?

• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• 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.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

Quanto custa continuar no manual?

O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como uma pessoa dedicada a copiar pedido, como venda perdida por ruptura que não existia no estoque real, e como margem errada em item cujo preço mudou sem o canal acompanhar.

Enquanto o volume é baixo, dá para absorver. O problema é o teto: passado 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 WinThor Magazord?

A Plugar.me opera como uma camada entre o WinThor e a API do Magazord. Ela traduz os dados de um lado para o outro, orquestra a ordem das operações e trata os erros que aparecem no caminho — porque eles aparecem.

Produto sem loja não existe

O vínculo com a loja é obrigatório na criação do produto. Isso força uma decisão logo no início do projeto: qual estrutura do ERP corresponde a qual loja no Magazord. Para operações com uma loja só, é burocracia. Para quem tem mais de uma, é a decisão que determina qual catálogo e qual saldo cada vitrine enxerga — e refazer esse mapa depois da carga custa caro.

Como funciona o controle de estoque?

O saldo sai do WinThor e atualiza o canal. A pergunta relevante não é apenas “quanto tem”, e sim quanto pode ser vendido ali.

É comum não querer expor todo o saldo: parte está comprometida com pedidos do atacado, parte é de outra filial que não atende aquele canal. A integração precisa respeitar essa separação, senão você vende o que já está reservado.

Como funciona o faturamento e a emissão de notas fiscais?

A nota nasce no WinThor. É a regra que separa uma integração ERP First de um conector qualquer.

Para uma distribuidora acostumada a vender para CNPJ, a venda pelo canal é majoritariamente para consumidor final, pessoa física — o que muda tratamento fiscal e cadastro. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

Qual é o fluxo completo, do clique à nota fiscal?

1. O cliente compra no Magazord.
2. A integração captura o pedido e o cria no WinThor, na operação correta.
3. O estoque é baixado no ERP e o saldo do canal é atualizado.
4. O pedido segue o fluxo interno de separação e conferência.
5. O faturamento é executado no WinThor e a NF-e é emitida.
6. Número da nota e rastreio voltam para o canal.
7. O painel da Plugar.me registra cada etapa em log, para auditoria.

Preciso desenvolver essa integração do zero?

Não existe conector nativo entre o TOTVS WinThor e o Magazord. Os dois lados têm interface; ninguém fez a ponte por você. E a ponte não é só transporte de dados: é mapear a estrutura do ERP, respeitar os limites do canal e tratar o que falha.

O que costuma ser subestimado no desenvolvimento interno não é construir. É manter: o canal muda regra de API, muda exigência de cadastro, muda comportamento. Quem construiu internamente assume essa fila para sempre.

Quais os benefícios para distribuidoras e atacadistas?

• Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
• Menos cancelamento. O saldo publicado passa a refletir o estoque real.
• Margem sob controle. O preço do canal sai da política definida no ERP.
• Fiscal em um lugar só. A nota nasce no WinThor, com a operação 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 e atacadistas abrindo venda direta ao consumidor.
• Operações com mais de uma filial, onde estoque e faturamento não são triviais.
• Empresas que já rodam WinThor e não pretendem trocar o ERP para vender online.

Se o volume é baixo e não há complexidade fiscal, o manual ainda se sustenta. A conta vira quando o volume cresce ou quando o erro passa a custar reputação.

Por que escolher uma integração ERP First para o WinThor?

Porque a alternativa é deixar o canal ditar a operação. Existe um modelo comum em que a plataforma vira o centro: o catálogo passa a viver nela, o pedido é tratado nela e o ERP recebe um resumo depois. Para quem investiu em TOTVS WinThor, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o WinThor.
• A nota fiscal nasce no ERP, com a operação da sua empresa.
• O canal é canal — importante, mas não dono do dado.
• Se amanhã você abrir outro canal, a fonte da verdade não muda.

Como a Plugar.me realiza a integração WinThor Magazord?

A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.

1. Diagnóstico. Entender como o seu WinThor está configurado e o que a operação exige.
2. Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido do Magazord deve usar e qual saldo o canal enxerga.
3. 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 WinThor ao Magazord?

Vale quando o Magazord 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 tempo e margem.

A integração bem feita não muda a forma como a sua empresa opera. Faz o contrário: garante que o canal se encaixe na operação que já existe no WinThor, em vez de obrigar a operação a se contorcer para caber no canal.

Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu WinThor está estruturado hoje: volume, estrutura de estoque e como funciona o seu faturamento.

Luan Carvalho

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.