Conectar a eBay: receber pedidos e enviar fulfillment
Obtenha App ID e Cert ID no eBay Developers Program, cole no Integration, teste, mapeie e ative.
O conector da eBay traz pedidos para o OMS pela Sell API da eBay e devolve estoque e fulfillment à eBay. Também traz devoluções e pode enviar produtos e estoque.
Pré-requisitos#
- Uma conta de vendedor da eBay com itens à venda.
- Acesso ao eBay Developers Program para ver suas Application keys de Production.
- No primeiro teste use primeiro o sandbox: defina Use sandbox como "true" antes de ir para produção.
Obter credenciais#
- Vá a eBay Developers Program → Application keys → Production.
- Copie o App ID. É o seu OAuth Client ID: cole no campo Client ID (App ID) do Integration.
- Na mesma página, copie o Cert ID. É o seu OAuth Client Secret: cole no campo Client Secret (Cert ID) do Integration.
Preencher no Integration#
- Abra Integration → Marketplace → eBay → Nova conexão.
- Client ID (App ID), obrigatório: cole o App ID de Application keys → Production. É usado como OAuth Client ID.
- Client Secret (Cert ID), obrigatório: cole o Cert ID da mesma página. É usado como OAuth Client Secret, criptografado e nunca exibido.
- User access token, opcional: cole um token de usuário do fluxo de código de autorização OAuth se tiver um (válido por 2 horas); ele é usado diretamente na Sell API. Se deixar vazio, o sistema troca suas credenciais por um token de app de curta duração.
- Use sandbox, texto opcional: preencha "true" para testar no sandbox (api.sandbox.ebay.com). Em produção, deixe vazio.
Testar a conexão#
Clique em Testar a conexão. O teste troca suas credenciais por um token e verifica a API da eBay. Se passar, App ID, Cert ID e ambiente coincidem. Se falhar, anote o código e veja a FAQ.
Mapping / escolher modelo#
Escolha o modelo padrão da eBay. Mapeia número do pedido, SKU, quantidades, endereço de entrega e status de fulfillment. Revise a prévia com um pedido real antes de ativar.
Ativar#
Após ativar, o Integration traz pedidos e devoluções na frequência definida e devolve fulfillment com rastreio e mudanças de estoque à eBay. Acompanhe os primeiros pedidos em Runs / Logs.
Perguntas frequentes#
O teste falha com 401
As credenciais não coincidem: o mais comum é App ID e Cert ID trocados, ou um deles copiado incompleto ou com espaço extra.
Volte a eBay Developers Program → Application keys → Production, copie o App ID em Client ID (App ID) e o Cert ID em Client Secret (Cert ID) exatamente como exibido, e teste novamente.
Sandbox e produção estão misturados
O ambiente e as chaves não coincidem: Use sandbox está "true" e as chamadas vão para api.sandbox.ebay.com, mas App ID e Cert ID são de produção, ou o contrário.
Faça os dois coincidirem e teste novamente: em produção deixe Use sandbox vazio e use as chaves de Production; para testar, preencha "true" e use chaves sandbox nessa mesma conexão.
Conectado mas nenhum pedido chega
A conexão está bem: a loja simplesmente não tem pedidos novos no intervalo de extração.
Faça um pedido de teste na sua loja eBay, verifique se o horário está dentro do intervalo de extração, execute uma extração manual e confirme que ele aparece na prévia ou em Runs / Logs.
O SKU aparece não mapeado
O SKU da linha do pedido da eBay não corresponde a nenhum produto do OMS, então a linha não pode ser importada até ser vinculada.
Abra a aba pendente em Product Mapping, vincule cada SKU da eBay ao produto OMS correto, salve e execute a prévia ou a extração novamente.