Pular para o conteúdo principal

Configurar WooCommerce

Use este guia para preparar sua loja WooCommerce no Connector. As imagens usam dados de exemplo; os menus do WooCommerce podem aparecer em outro idioma.

Antes de começar​

  • Tenha acesso de administrador à loja WooCommerce e ao Connector.
  • Confirme que o endereço da loja começa com https:// e abre normalmente pela internet.
  • Decida o papel da loja. A matriz fornece o catálogo de referência e recebe pedidos dos canais. Uma loja periférica recebe catálogo e estoque da matriz e envia seus próprios pedidos ao Connector. Você pode conectar duas lojas WooCommerce, uma em cada papel.
  • Separe um produto e um pedido de teste. Confira como os estados de pedido da sua loja afetam o estoque antes de começar a vender pelos canais.

1. Criar a chave de acesso no WooCommerce​

No WordPress, abra WooCommerce → Configurações → Avançado → API REST e selecione Adicionar chave. Esse é o nome do menu no WooCommerce. Dê à chave um nome que identifique o Connector, escolha uma conta autorizada e defina Leitura/Escrita. Gere a chave e guarde os dois valores exibidos, Consumer Key e Consumer Secret, em local seguro. O segundo valor pode deixar de ser exibido depois que você sair da página.

Formulário de chave da API REST do WooCommerce com a permissão Leitura/Escrita selecionada

O exemplo acima usa o painel do WooCommerce em inglês: Read/Write corresponde a Leitura/Escrita. Não coloque a chave em imagens, chamados ou mensagens.

2. Incluir e verificar a conexão​

No Connector, abra Conexões → Nova conexão, informe um nome fácil de reconhecer e selecione WooCommerce. Preencha a URL pública HTTPS, a Consumer Key e a Consumer Secret. Selecione Incluir e verificar. O Connector verifica o acesso antes de apresentar a conexão como válida.

Formulário de nova conexão WooCommerce no Connector, sem credenciais preenchidas

Se a verificação recusar a chave, confira o endereço da loja, a conta associada à chave e a permissão de leitura e escrita. Para trocar uma chave depois, use a ação de atualização de credenciais da conexão; o Connector fará nova verificação.

3. Definir o papel e os estados dos pedidos​

Abra Gerenciar na conexão verificada e defina a loja como sistema central ou periférica. Configure as equivalências entre os estados de pedido do WooCommerce e os estados do Connector antes de liberar pedidos. Se você usar duas lojas WooCommerce, conecte cada uma separadamente e escolha um papel para cada uma.

Na matriz, o Connector pode criar pedidos recebidos dos outros canais. Ele não marca esses pedidos como pagos. A loja periférica envia seus próprios pedidos para a operação. Cancelamentos e outras mudanças de estado seguem as equivalências configuradas. Faça um pedido de teste e confira seu estado e o efeito no estoque das duas lojas.

4. Ativar as notificações de produtos e pedidos​

Na página da conexão no Connector, selecione Mostrar endereço e chave. Copie o endereço de entrega e a chave de assinatura. Essa ação mostra a chave existente; não cria uma nova. Guarde-a em local seguro.

No WooCommerce, abra WooCommerce → Configurações → Avançado → Webhooks → Adicionar webhook. “Webhook” é o nome usado pelo WooCommerce para uma notificação automática. Crie cinco notificações ativas: produto criado, produto atualizado, produto excluído, pedido criado e pedido atualizado. Em cada uma, escolha o assunto correspondente e informe o mesmo endereço de entrega e a mesma chave de assinatura que o Connector mostrou para essa conexão. Salve cada notificação.

Formulário de webhook do WooCommerce com campos de tópico, endereço de entrega e chave

Se uma notificação ficar pendente, consulte Gerenciar → Ver notificações pendentes na conexão. Confira o endereço e a chave preenchidos no WooCommerce antes de solicitar outra tentativa.

5. Escolher como distribuir estoque​

Em Configurações → Gestão de estoque no Connector, mantenha Controlar estoque pela matriz ligado se a matriz informa quantidades. Nesse modo, um produto sem quantidade numérica informada equivale a estoque zero.

Se a operação não controla quantidades na matriz, desligue a opção e salve uma Quantidade enviada para cada conexão periférica, por exemplo 10 para uma e 100 para outra. O item precisa estar ativo e disponível para venda para receber essa quantidade. Item indisponível, variação indisponível ou conexão sem quantidade configurada recebe zero. Essa configuração não altera o preço.

Configuração do Connector com controle de estoque pela matriz desligado e quantidade 100 definida para uma loja periférica

Essa opção vale para a operação no Connector. Ela é diferente de Gerenciar estoque em um produto do WooCommerce. Se um produto não informa quantidade e você mantém Controlar estoque pela matriz ligado, ele terá estoque zero nos canais.

6. Instalar o plugin somente se a matriz receber pedidos tributados​

Quando o WooCommerce é a matriz e receberá pedidos com imposto, instale o plugin Connector para WooCommerce. No WordPress, abra Plugins → Adicionar plugin → Enviar plugin, selecione o arquivo baixado, instale e ative. O plugin conserva o valor total dos impostos e do pedido recebido de outros canais.

Tela do WordPress para enviar o ZIP do plugin Connector para WooCommerce

Lojas periféricas e matrizes que recebem apenas pedidos sem imposto não precisam instalar o plugin. Mesmo com o plugin instalado, configure as cinco notificações da etapa 4.

7. Conferir antes de operar​

  1. Crie ou atualize um produto simples de teste na matriz. Confira sua entrada no Connector e sua publicação na loja periférica, com o mesmo preço e a quantidade esperada.
  2. Se vender variações, altere uma delas e confirme código (SKU), preço, disponibilidade e estoque na periférica.
  3. Faça um pedido de teste na periférica, com frete ou desconto se forem usados na operação. Verifique que ele aparece no Connector e uma única vez na matriz, sem pagamento marcado pelo Connector.
  4. Altere o estado para cancelado e confira a situação e o estoque nas duas lojas. Se houver impostos, teste após ativar o plugin na matriz e confira imposto e total.
  5. Consulte as notificações pendentes e resolva qualquer falha antes de liberar o fluxo.

Se o Connector não conseguir confirmar que um pedido foi criado na matriz, pesquise o pedido na loja antes de confirmar que ele não existe. O Connector aguardará essa conferência para evitar um pedido duplicado. Se não localizar o pedido, siga a ação indicada no painel.