Bem-vindo!
Como podemos te ajudar?

Dúvidas frequentes

  1. Mandaê
  2. Geral
  3. Integrações e APIs

🛒 Integração WooCommerce + Mandaê

🛒 Integração WooCommerce + Mandaê

Guia completo para configurar o plugin de e-commerce e sistema de entregas

📋 Observação:

⚠️ Esta integração é compatível apenas com o PHP a partir da versão 8.2. Versões inferiores não são suportadas.

Para consultar sua versão do plugin WooCommerce, acesse o seguinte caminho:

Ferramentas > Diagnóstico > Informação:

Informações diagnósticos

 

🛒 O que é o WooCommerce?

O WooCommerce é um plugin de e-commerce para lojas virtuais que utilizam o WordPress.

Este artigo explica como configurar o módulo de frete da Mandaê na plataforma WooCommerce e como habilitar o sistema para importação de vendas.

📦 Integração WooCommerce: Importação de encomendas

📋 Nesta seção você irá encontrar:

  • Criando o usuário de acesso
  • Habilitando o WooCommerce no sistema da Mandaê
  • Atualização do código de rastreamento
  • Importando seu primeiro pedido
  • Versões compatíveis

👤 Criando o usuário para acesso

1

Acesse o painel de administração

Faça login no painel de administração do WooCommerce com usuário admin.

2

Vá para Configurações

Clique no link do WooCommerce no menu esquerdo e depois vá para a opção Configurações.

3

Ativar API REST antiga

Clique no menu horizontal AvançadoAPI antiga (menu em azul) e marque a caixa de seleção Ativar a API REST antiga, depois clique no botão Salvar alterações.

Configurações avançadas do WooCommerce

4

Gerar as chaves da API

Agora é preciso gerar as chaves. No menu horizontal em azul clique em API REST, em seguida clique no botão Adicionar chave.

Menu API REST

5

Preencher campos para criação da chave

Preencha os campos solicitados para a criação da chave:

  • No campo Descrição, preencha com "Integração Mandaê"
  • No campo Usuário, selecione o usuário que você está conectado (preenchimento padrão)
  • No campo Permissões, selecione a opção "Ler"

Formulário de criação de chave API

6

Gerar e visualizar as chaves

Para finalizar clique na opção Gerar uma chave de API e veja as chaves geradas.

Chaves de API geradas

⚠️ ATENÇÃO - Dados Sensíveis

Anote essas informações em algum lugar seguro, pois não será possível visualizar novamente e você vai precisar para conectar na Mandaê.

⚙️ Habilitando o WooCommerce no sistema da Mandaê

7

Acesse as Configurações da Mandaê

Após fazer o login no sistema da Mandaê, clique em Configurações localizada no menu do lado esquerdo.

Menu de configurações da Mandaê

8

Clique em Integrações

Ao carregar a tela, clique em Integrações na parte superior.

Tela de integrações

9

Conectar ao WooCommerce

Localize a WooCommerce na tela e clique em conectar.

Conectar WooCommerce

10

Inserir informações de autenticação

Agora será necessário digitar as informações que foram criadas na plataforma WooCommerce no passo 6 deste documento.

Formulário de autenticação

💡 Importante:

A URL do site deve ser inserida com https no link.

11

Salvar configurações

Para finalizar clique na opção Salvar.

12

Acessar configurações avançadas

Retornando ao menu configuraçõesintegrações, vá até WooCommerce e clique em Configurações.

Configurações WooCommerce

13

Definir filtros e finalizar

Nessa tela você pode definir filtros e opções definidas junto ao comercial. Após aplicar as alterações desejadas, clique em salvar.

Filtros e configurações finais

📋 Observação:

No menu lateral Coletas, clicando na integração WooCommerce, irá carregar os pedidos importados, conforme mostrado nas imagens abaixo.

Menu de coletas WooCommerce

Lista de pedidos importados

📋 Atualização do código de rastreamento

⚠️ Informação Importante

Essa integração ainda não fornece a atualização do código de rastreamento diretamente na plataforma.

📦 Importando seu primeiro pedido

💡 Saiba mais:

Para informações detalhadas sobre como importar pedidos, clique aqui e acesse nosso guia completo.

✅ Versões Compatíveis

📋 Compatibilidade:

A importação de pedidos é homologada nas versões: 3.0 ou superior.

💰 Integração WooCommerce: Cálculo de Frete

📋 Nesta seção você irá encontrar:

  • Obtendo a API Key
  • Instalando o Módulo
  • Configurando o Módulo
  • Definindo as formas de envio
  • Usando o Módulo na sua loja
  • Versões suportadas

🔑 Obtendo a API Key

1

Acesse o painel da Mandaê

Após fazer o login no painel da Mandaê, clique na opção Minha Conta localizada no menu ao lado esquerdo.

Menu Minha Conta da Mandaê

2

Localizar o TOKEN da API

Selecione a opção API no menu superior. Nesse momento as informações necessárias para integração são exibidas. Localize o campo TOKEN, é esse campo que você precisa! Lembre-se de usar a informação do ambiente correto: Sandbox (testes) ou Produção.

Tela da API com TOKEN

📦 Instalando o Módulo

📋 Passos para instalação:

  1. Baixe a última versão do plugin em formato zip clicando aqui
  2. Faça login no painel do seu WordPress com o login de administrador
  3. No menu lateral esquerdo, localize a opção Plugins e clique nela. Em seguida clique na opção Adicionar Novo
  4. Na parte superior da tela, ao lado do texto Instalar Plugins clique no botão Enviar Plugin
  5. Clique na opção Escolher Arquivo e selecione o arquivo que fez download no passo 1. Depois, clique na opção Instalar Agora
  6. Uma mensagem Plugin instalado com sucesso vai ser exibida juntamente com um botão Ativar Plugin, clique nele

✅ Pronto! O Plugin está instalado.

⚙️ Configurando o Módulo

📋 Passos para configuração:

  1. No menu lateral esquerdo, localize a opção WooCommerce e clique nela. Em seguida vai abrir algumas opções na parte inferior. Clique na opção Configurações
  2. No menu superior localize a opção Integração, clique nela, em seguida localize a opção Mandaê
  3. Para usar o Plugin é necessário fazer as configurações abaixo:

⚙️ Configurações necessárias do Plugin

📋 Campo 💡 Valor/Configuração
🔧 Habilitar/Desabilitar Deixe sempre marcado a opção "Ativar a tabela de histórico de rastreamento"
🔑 Autorização Informe o Token API (descrito nesse documento)
🌐 Ambiente Deixe sempre marcado a opção Live para usar em produção. Caso esteja em modo de testes selecione a opção Sandbox
💰 Valor declarado Caso queira repassar o custo do seguro no valor do frete marque SIM
📦 Taxa de Manuseio Informe o valor que deseja acrescentar ao frete
⏰ Prazo Adicional Informe a quantidade de dias que deseja acrescentar no prazo
📊 Log de depuração Deixe marcada a opção "Ativar log para histórico de rastreamento"

👉 Clique em Salvar alterações no canto superior direito.

🚀 Definindo as Formas de Envio

📋 Passos para definir formas de envio:

  1. No menu lateral esquerdo, localize a opção WooCommerce e clique nela. Em seguida vai abrir algumas opções na parte de baixo. Clique na opção Configurações
  2. No menu superior localize a opção Entrega, clique nela
  3. Localize a opção que você oferece venda em todo território nacional, geralmente com os nomes "Em toda parte" ou "Brasil inteiro"
  4. Passe o mouse sobre o nome da área e clique na opção Editar
  5. Clique na opção Adicionar método de entrega e depois selecione Rápido e depois Econômico

👏 Pronto! As modalidades já estão disponíveis na sua loja.

✅

Pronto! Integração concluída.

Sua integração entre o WooCommerce e Mandaê está ativa e configurada corretamente.

💡 Dica:

Se você ainda não é cliente da Mandaê, entre em contato conosco para conhecer nossos serviços.

❓

Precisa de ajuda?

Entre em contato com o time de suporte ou com seu gerente de contas.
Estamos aqui para te apoiar! 💪

Artigos relacionados

Esse artigo foi útil?

Powered by Zendesk