Criar Loja Virtual na Plataforma de E-commerce - WBUY

Na Manda Bem você vai precisar:

- Acessar as configurações e integrações
- Criar uma nova ID e Token

Na wBuy você vai precisa:

- Habilitar o módulo
- Configurar o ID e Token

Credenciais de API - Manda Bem

Acesse o painel da Manda Bem.

No canto superior, clique em “Bem-vindo, seu nome” e depois em Integrações.

Role a tela até o final da página até encontrar a seção:

Web Service / WooCommerce / wBuy / E-com Plus

No seletor de plataforma:

• Escolha wBuy;
• Se não existir nenhuma chave, clique em “Ativar Web Service”;
• Se já existir uma chave ativa, desative-a e ative novamente selecionando a plataforma wBuy.

Após a ativação, guarde os seguintes dados:

• API ID
• API Token

Configurarando na wBuy

Acesse o painel administrativo da wBuy.

Vá em Configurações > Frete e Logística.

Clique em Adicionar e procure pelo método Manda Bem.

Selecione o módulo para adicioná-lo à loja.

Na tela de configuração do módulo, ajuste os seguintes campos:

• Status: Marque como habilitado.
• API ID: Cole o API ID gerado no painel da Manda Bem.
• API Token: Cole o API Token correspondente.
• Valor declarado (seguro): Selecione Sim ou Não, conforme o seu contrato com a Manda Bem.
• Serviços: Selecione quais serviços estão disponíveis no seu contrato da Manda Bem
• Valor fixo adicional: (Opcional) Defina um valor extra para o frete.
• Restrição por estado: Se desejar, selecione os estados atendidos. Se deixar em branco, o método ficará disponível para todos os estados.

_{Importante: Caso nenhum serviço seja selecionado,Correios SEDEX e PAC serão os serviços padrões.}

_{Importante: Para serviços de Jadlog e Loggi solicite suporte ao Manda Bem para liberar antes de ativar na wBuy}

Após finalizar as configurações, clique em Salvar.

Enviando um pedido para a Manda Bem

Para enviar um pedido à Manda Bem é necessário que o mesmo esteja com o status de "Pagamento efetuado". 

Acesse Pedidos > Listagem e vá nas opções do pedido (seta para baixo) e clique na opção Enviar pedido para Manda Bem (envios):

Escolha o servidço que deseja enviar e gerar sua etiqueta,  marque a opção de declar valor ou não, neste ponto consulte a Manda Bem para maiores informações se deve ou não declarar o valor com o tpo de serviço enviado. Depois só clicar em Enviar Pedido

Feito isso o pedido será adicionado ao seu painel da Manda Bem e integrado na wBuy (consulte se a sessão de status de pedido mais abaixo para detalhes).

Teste de Cotação do Frete

Após a configuração do módulo:

1. Acesse a sua loja.
2. Adicione um produto ao carrinho.
3. Informe um CEP válido.
4. Verifique se o método Manda Bem retorna corretamente o valor do frete.

Este teste confirma que a integração está funcionando corretamente.

Atualização de status de pedido

A atualização automática de status somente ocorrerá quando o pedido estiver integrado à Manda Bem, ou seja, quando ele for efetivamente enviado para a plataforma da Manda Bem.

Para confirmar se a integração foi realizada:

• Acesse o detalhe do pedido.
• Vá até a aba Histórico.
• Verifique se existe um evento de order da Manda Bem.
• Logo abaixo, será exibido o ID do pedido gerado na Manda Bem, conforme demonstrado na imagem abaixo.

Se essas informações estiverem presentes, significa que o pedido está integrado corretamente.

Após a integração, a wBuy vai fazer a consulta na API da Manda Bem para procurar os status do pedido, isso vai ocorrer de 3h em 3h (num total de 8 vezes por dia) e até 30 tentativas no total (3 dias de tentativas). Isso ocorre pois até o momento a Manda Bem não possuim um sistema de webhooks, onde a wBuy recebe atualizações em tempo real. Cada status vem descrito de uma forma, mas fizemos um mapa dos princiapais e vamos atualizar o pedido quando:

Atualizado em: 13/03/2026

Dessa forma, todo o fluxo de entrega é atualizado automaticamente, dentro do prazo de atualizações, e que o pedido tenha sido integrado corretamente à Manda Bem.

^{Atenção: não exclua um pedido no painel da Manda Bem para criá-lo novamente. Caso isso seja feito, o vínculo com o pedido da wBuy será perdido.}

Se isso ocorrer, verifique com o time de suporte da wBuy se o retorno do pedido na Manda Bem foi realizado com sucesso. Caso seja apresentado algum erro, por exemplo, "Dados de Postagem não encontrados" entre em contato com o suporte da Manda Bem informando o ID do pedido que mencionamos acima.
 
 Conforme orientação da Manda Bem, um pedido só pode ser excluído antes da geração da etiqueta. Ainda assim, essa ação pode ocorrer e acabar impactando o funcionamento da integração.