Conectar a WooCommerce: receber pedidos e enviar fulfillment

Crie uma chave de REST API no WooCommerce, cole a URL da loja, a Consumer key e o Consumer secret no Integration, teste, mapeie e ative.

O conector da WooCommerce traz pedidos da sua loja WooCommerce para o OMS e devolve o fulfillment à WooCommerce. Também pode enviar produtos e estoque, para que os anúncios e o estoque fiquem sincronizados nos dois lados. Uma conexão por loja: cada loja tem sua própria Consumer key e Consumer secret.

Pré-requisitos#

• Uma loja WooCommerce no WordPress, com acesso de administrador às configurações da WooCommerce.
• Permissão para criar chaves de REST API nessa loja (WooCommerce → Configurações → Avançado → REST API).
• A URL da sua loja usa https e os links permanentes não estão no modo Simples: a REST API não funciona com links permanentes simples.

Obter credenciais#

1. No painel da sua loja, vá a WooCommerce → Configurações → Avançado → REST API → Adicionar chave.
2. Selecione o usuário da chave, defina as permissões como Leitura/Gravação (Read/Write) e gere a chave. Leitura/Gravação é necessário porque o conector não só traz pedidos, também devolve fulfillment, produtos e estoque.
3. Copie a Consumer key. Começa com ck_.
4. Na mesma página, copie o Consumer secret. Começa com cs_ e é exibido uma única vez: guarde os dois valores em local seguro imediatamente.

Preencher no Integration#

1. Abra Integration → Marketplace → WooCommerce → Nova conexão.
2. URL da loja (Store URL), obrigatória: a URL completa da loja, incluindo https, p. ex. https://www.example.com. Preencha o endereço da loja em si, não o endereço do painel.
3. Consumer key, obrigatória: cole a Consumer key copiada de WooCommerce → Configurações → Avançado → REST API (começa com ck_).
4. Consumer secret, obrigatório: cole o Consumer secret da mesma página (começa com cs_). É criptografado em repouso e nunca exibido.

Testar a conexão#

Clique em Testar a conexão. O teste tem dois níveis: conectividade (a URL da loja responde e a Consumer key e o Consumer secret são aceitos) e prévia em nível de documento (traz um pedido real e mostra campos da plataforma → pedido padrão lado a lado). Se a loja ainda não tem pedidos, faça primeiro um pedido de teste na WooCommerce: a prévia precisa de um documento real. Se o teste falhar, anote o erro e veja a FAQ antes de mudar qualquer outra coisa.

Mapping / escolher modelo#

Escolha o modelo padrão da WooCommerce. Mapeia número do pedido, SKU de linha, quantidades, endereço de entrega e status de fulfillment. Revise a prévia com um pedido real antes de ativar, principalmente se cada SKU da WooCommerce está vinculado a um produto do OMS e se o endereço cai no campo certo.

Ativar#

Após ativar, o Integration traz pedidos novos na frequência definida e devolve o fulfillment com códigos de rastreio à WooCommerce. O envio de produtos e estoque mantém anúncios e estoque sincronizados. Acompanhe os primeiros pedidos em Runs / Logs antes de deixar sem supervisão.

Perguntas frequentes#

O teste falha com 401

A Consumer key ou o Consumer secret não corresponde à loja, ou a chave foi criada com permissão somente leitura. Uma cópia incorreta ou incompleta é rejeitada, e uma chave somente leitura não consegue devolver fulfillment, produtos nem estoque, então as gravações também são rejeitadas.

Vá a WooCommerce → Configurações → Avançado → REST API, crie uma chave nova com permissões de Leitura/Gravação (Read/Write), copie a nova Consumer key e o Consumer secret exatamente como exibidos no Integration e teste novamente. Ao gerar uma nova chave, os valores antigos param de funcionar, então atualize a conexão no mesmo passo.

O caminho da REST API não responde

Os links permanentes do WordPress estão no modo Simples. Nesse modo as páginas da loja continuam abrindo, mas os caminhos da REST API da WooCommerce não funcionam, então o Integration não consegue alcançar a API para trazer pedidos nem devolver nada.

No WordPress, abra Configurações → Links permanentes, escolha qualquer estrutura que não seja Simples, salve a alteração e teste a conexão novamente no Integration.

A URL da loja está incorreta e o teste não conecta

A URL da loja no Integration não aponta para a loja: o mais comum é faltar o https://, ou ter sido colado o endereço do painel em vez do da loja, então o teste fala com o lugar errado e nunca chega à WooCommerce.

Corrija o campo de URL da loja com o endereço completo da loja, incluindo https, p. ex. https://www.example.com: o endereço que os clientes abrem, não o do painel, e teste novamente.

Conectado mas nenhum pedido novo chega

A conexão está bem: a loja simplesmente não tem pedidos novos no intervalo de extração, então ainda não há nada para importar.

Faça um pedido de teste na sua loja WooCommerce, verifique se o horário está dentro do intervalo de extração, execute uma extração manual e confirme que o pedido aparece na prévia ou em Runs / Logs.