Conectar a Wayfair: receber pedidos e enviar fulfillment

Copie seu Client ID e Client secret do Wayfair Partner Home, cole no Integration, teste, mapeie e ative.

O conector da Wayfair traz pedidos da Wayfair para o OMS e devolve fulfillment à Wayfair. Também pode enviar atualizações de produto e estoque, para que pedidos, envios e estoque fiquem sincronizados nos dois lados.

Pré-requisitos#

• Uma conta de fornecedor da Wayfair com acesso ao Wayfair Partner Home.
• Permissão para abrir as configurações de API no Wayfair Partner Home: o Client ID e o Client secret são exibidos lá.
• Seu ID de fornecedor da Wayfair, se for enviar estoque ou tracking: os dois envios o exigem. O valor de exemplo do campo é 5000; use seu próprio ID, não o exemplo.
• Decida qual ambiente conectar primeiro: sandbox para um primeiro teste, produção para pedidos reais. Sandbox e produção não compartilham pedidos, então não os misture.

Obter credenciais#

1. Entre no Wayfair Partner Home e abra as configurações de API.
2. Nessa página, copie o Client ID.
3. Na mesma página, copie o Client secret. Guarde-o num local seguro: você o colará no Integration na próxima etapa.
4. Você não precisa obter um token de acesso manualmente. Deixe esse campo vazio no Integration e o sistema o gera automaticamente a partir do Client ID e do Client secret (client_credentials, válido por 12 horas) e o mantém renovado.

Preencher no Integration#

1. Abra Integration → Marketplace → Wayfair → Nova conexão.
2. Client ID (obrigatório): cole o Client ID copiado do Wayfair Partner Home → Configurações de API.
3. Client secret (obrigatório): cole o Client secret da mesma página. É criptografado em repouso e nunca exibido.
4. Token de acesso (opcional): deixe vazio. O sistema gera um token automaticamente a partir do Client ID e do Client secret (client_credentials, token de 12h). Só preencha se quiser substituir deliberadamente o token gerado por um próprio.
5. ID de fornecedor: preencha seu ID de fornecedor da Wayfair, por exemplo 5000. É obrigatório para o push de estoque e o push de tracking: sem ele esses envios não funcionam, embora os pedidos ainda possam ser trazidos.
6. Modo sandbox: digite "true" para usar o ambiente sandbox da Wayfair. Deixe no padrão ("false") para usar produção. Defina isso de propósito: uma conexão sandbox nunca vê pedidos de produção.

Testar a conexión#

Clique em Testar a conexão. O teste troca seu Client ID e Client secret por um token de acesso e sonda a API da Wayfair, depois mostra uma prévia em nível de documento com um pedido real, campos da plataforma ao lado do pedido padrão. Se a conta ainda não tiver pedidos, a conectividade pode passar mesmo assim: faça ou aguarde um pedido real antes de avaliar a prévia, e veja as perguntas frequentes se o teste falhar.

Mapping / escolher modelo#

Escolha o modelo padrão da Wayfair. Ele mapeia número do pedido, SKUs das linhas, quantidades e endereço de entrega para o pedido padrão, e devolve fulfillment e tracking no formato da Wayfair. Revise a prévia antes de ativar, sobretudo se cada SKU da Wayfair está vinculado ao produto correto, para que o push de estoque informe os itens certos.

Ativar#

Após ativar, o Integration traz novos pedidos da Wayfair na frequência definida e devolve fulfillment com rastreio, além de atualizações de produto e estoque, à Wayfair. Acompanhe os primeiros pedidos em Runs / Logs antes de confiar no processo sem supervisão; em especial, verifique se o primeiro push de tracking passa, pois ele precisa do ID de fornecedor.

Perguntas frequentes#

O teste falha: a autenticação é rejeitada

O Client ID ou o Client secret estão incorretos, então a Wayfair não os trocará por um token de acesso. Os dois valores formam um par da mesma página de configurações de API: misturar um valor copiado de outro lugar, ou um secret com um caractere faltando, quebra a troca.

Volte ao Wayfair Partner Home → Configurações de API, copie novamente o Client ID e o Client secret dessa mesma página, substitua os dois valores na conexão, salve e teste de novo.

A conexão funcionava e começou a falhar após algumas horas

Um token de acesso preenchido manualmente expirou. Um token obtido assim só é válido por 12 horas, então um token colado no campo Token de acesso funciona no início e depois para — enquanto a troca automática a partir do Client ID e do Client secret o teria mantido renovado.

Limpe o campo Token de acesso e salve, para que o sistema volte a gerar o token automaticamente a partir do Client ID e do Client secret, e teste de novo. Use o campo manual apenas para uma substituição de curta duração.

Os pedidos chegam, mas o push de estoque ou tracking falha

O ID de fornecedor está faltando ou incorreto. Trazer pedidos só precisa do Client ID e do Client secret, mas o push de estoque e o push de tracking também precisam do seu ID de fornecedor da Wayfair: com o campo vazio, com o ID de outra pessoa ou com o valor de exemplo, a Wayfair não pode aceitar esses envios.

Preencha seu próprio ID de fornecedor da Wayfair na conexão (não o exemplo 5000, a menos que esse seja realmente o seu ID), salve e execute o push novamente a partir de Runs / Logs.

O teste passa, mas os pedidos reais nunca aparecem

Sandbox e produção foram misturados. Se o modo sandbox estiver em "true", a conexão fala com o ambiente sandbox da Wayfair, que só contém dados de sandbox: pedidos de produção nunca aparecem lá, por mais que você extraia.

Para pedidos reais, defina o modo sandbox como "false" (o padrão) e teste de novo. Mantenha uma conexão separada, com nome claro, se também quiser uma conexão sandbox para testes.

Conectado, mas não chegam pedidos

A conexão está bem — o teste passa — mas a Wayfair ainda não tem pedidos novos para esta conta de fornecedor, então não há nada para trazer.

Aguarde o próximo pedido real na Wayfair (em modo sandbox, use um pedido de sandbox), depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a Wayfair os emite.