Conectar a Overstock: receber pedidos e enviar fulfillment

Pegue a URL base da API e a chave de API da sua documentação de integração de parceiro da Overstock, cole no Integration, teste, mapeie e ative.

O conector da Overstock traz pedidos da Overstock — agora operando como a plataforma Bed Bath & Beyond — para o OMS e devolve fulfillment à plataforma. 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 parceiro da Overstock que vende na plataforma agora com a marca Bed Bath & Beyond.
• Sua documentação de integração de parceiro da Overstock. A URL base da API e os caminhos dos endpoints vêm dessa documentação: a Overstock não publica uma especificação REST, então os endpoints não podem ser conferidos em nenhum outro lugar.
• A chave de API de parceiro emitida para a sua conta, conforme descrito nessa mesma documentação de integração. Deixe-a pronta para copiar: você a colará no Integration, não a digite de memória.

Obter credenciais#

1. Abra a documentação de integração de parceiro da Overstock da sua conta. Os dois valores de que você precisa — a URL base da API e a chave de API — são retirados dessa documentação; não há uma especificação REST pública para consultá-los.
2. Nessa documentação, encontre a URL raiz da API e copie-a exatamente. É o valor do campo URL base da API e começa com https://. Copie a URL raiz como está escrita e confirme os caminhos dos endpoints com a mesma documentação.
3. Na mesma documentação, encontre sua chave de API de parceiro e copie-a. Guarde-a em local seguro: é um segredo, é enviada como cabeçalho x-api-key em cada solicitação e o Integration nunca a exibe de volta após salvar.

Preencher no Integration#

1. Abra Integration → Marketplace → Overstock → Nova conexão.
2. URL base da API (obrigatório): cole a URL raiz da API copiada da sua documentação de integração de parceiro da Overstock, no formato https://… . Cole a URL raiz como está na documentação: não digite o endereço da loja da plataforma nem adivinhe um endereço, pois a Overstock não publica especificação REST e a documentação é a única fonte desse valor.
3. Chave API (obrigatório): cole a chave de API de parceiro da mesma documentação. Ela é enviada como cabeçalho x-api-key, é criptografada em repouso e nunca é exibida de volta: após salvar, o campo não mostrará a chave de novo, então guarde sua própria cópia da documentação.

Testar a conexão#

Clique em Testar a conexão. O teste usa sua URL base da API e envia sua chave de API como cabeçalho x-api-key para verificar a conectividade, depois mostra uma prévia em nível de documento com um pedido real, campos da plataforma ao lado do pedido padrão. Se sua conta ainda não tiver pedidos, a conectividade pode passar mesmo assim: aguarde ou providencie 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 Overstock. Ele mapeia número do pedido, SKUs das linhas, quantidades e endereço de entrega para o pedido padrão, e devolve fulfillment no formato da plataforma. Revise a prévia antes de ativar, sobretudo se cada SKU da plataforma está vinculado ao produto correto, para que os envios de produto e estoque informem os itens certos.

Ativar#

Após ativar, o Integration traz novos pedidos da Overstock na frequência definida e devolve fulfillment com rastreio, além de atualizações de produto e estoque, à plataforma. Acompanhe os primeiros pedidos em Runs / Logs antes de confiar no processo sem supervisão.

Perguntas frequentes#

O teste falha: a chave de API é rejeitada

A chave de API está incorreta. Cada solicitação leva a chave como cabeçalho x-api-key, então uma chave copiada com um caractere faltando, uma chave de outra conta ou um valor que não seja a chave de API de parceiro será rejeitado na primeira chamada — a URL base nem chega a importar.

Volte à sua documentação de integração de parceiro da Overstock, copie novamente a chave de API de parceiro de lá, substitua o valor da chave de API na conexão, salve e teste de novo. Cole-a, não a digite.

O teste falha: a plataforma não é alcançada pela URL base da API

A URL base da API está preenchida incorretamente. O campo precisa da URL raiz da API da sua documentação de integração; o endereço da loja da plataforma, um endereço de página copiado do navegador ou um endereço adivinhado apontam para lugares onde a API não responde. Como a Overstock não publica especificação REST, uma URL que parece plausível também pode estar errada — só a documentação define a correta, caminhos de endpoints incluídos.

Abra sua documentação de integração, copie novamente a URL raiz da API exatamente como está escrita, substitua a URL base da API na conexão e confirme os caminhos dos endpoints com a mesma documentação. Salve e teste de novo.

Conectado, mas não chegam pedidos

A conexão está bem — o teste passa — mas a plataforma ainda não tem pedidos novos para a sua conta, então não há nada para trazer. Uma conexão funcionando com a lista de pedidos vazia fica exatamente assim até o próximo pedido chegar.

Aguarde o próximo pedido real na plataforma, depois execute uma extração manual e veja Runs / Logs. Pedidos novos aparecem assim que a plataforma os emite; se houver pedidos na plataforma e mesmo assim não aparecerem após uma extração manual, confira primeiro a URL base da API e a chave de API com a sua documentação de integração.