Conectar eBay

Objetivo: Criar anúncios, atualizar preços em massa, sincronizar catálogo.

Tempo: 3 minutos (OAuth automático).

O que você precisa antes de começar

• Conta de vendedor eBay ativa (com permissão para listar)
• Acesso à sua própria conta eBay (não um sub-usuário)
• Business Policies criadas (payment, shipping, return) — necessário apenas se quiser criar anúncios novos
• Um navegador

Sobre Business Policies: Se você já cria anúncios manualmente no eBay, já tem policies. Se vai usar SellerForge para criar anúncios, você precisa criar pelo menos uma policy de cada tipo (pagamento, envio, devolução) no eBay antes de usar a integração.

Passo a Passo

1. Ir para Integrações no SellerForge WMS

1. Na aplicação SellerForge WMS, vá até Configurações → Integrações
2. Clique no card eBay

2. Conectar via OAuth (um clique)

1. Você verá um botão Conectar eBay / Connect eBay
2. Clique nele
3. Você será redirecionado para o site do eBay
4. Faça login com sua conta de vendedor eBay (se não estiver já logado)
5. A tela pedirá permissão:

   Você permitirá que SellerForge WMS acesse:

   • Suas listagens
   • Seus pedidos
   • Seus preços
   • Suas políticas de negócio
   • Seu histórico de vendas

1. Clique em Concordar / Agree / Allow
2. Você será redirecionado de volta para o SellerForge WMS
3. Pronto! eBay está conectado

3. Business Policies (apenas se quiser criar anúncios)

Se você planeja usar SellerForge WMS para criar anúncios novos no eBay, você precisa ter policies de negócio definidas. Se já cria anúncios manualmente, você já tem (ignore este passo).

Para criar/verificar suas policies:

1. Acesse https://www.ebay.com
2. Vá até Seller Hub → Account Settings (engrenagem)
3. Procure por Business Policies no menu à esquerda
4. Você deve ter pelo menos:
   • 1 Payment Policy (como você aceita pagamento)
   • 1 Shipping Policy (opções de envio)
   • 1 Return Policy (você aceita devoluções?)

Se não tiver nenhuma, clique Create Policy e siga o assistente. Leva 2-3 minutos por policy.

4. Testar a Conexão

Após conectar via OAuth:

1. Volte ao card eBay no SellerForge WMS
2. Você deve ver uma mensagem "Conectado como [seu_usuario_ebay]"
3. Clique em Testar conexão / Test Connection
4. A aplicação vai:
   • Buscar suas listagens
   • Verificar se suas business policies existem
   • Confirmar se pode criar anúncios

Testar a Conexão

Após clicar em "Testar conexão":

• "Conexão bem-sucedida" → eBay está pronto para usar
• "Error: Business policies not found" → Você precisa criar policies no eBay (passo 3)
• "Error: Permission denied" → Você não foi quem clicou "Conectar eBay" originalmente. Desconecte e reconecte com sua conta.
• "Error: Token expired" → OAuth dura ~18 meses; clique Conectar eBay novamente para renovar

Seção Avançada (Usar Meu Próprio Keyset)

Isso é opcional e apenas para vendedores com volume muito alto de API (milhões de atualizações de preço por dia).

A maioria dos vendedores não precisa disso. Pule para "Problemas Comuns".

Se você realmente quer usar seu próprio keyset:

1. Se você já é desenvolvedor eBay:
   • Vá até https://developer.ebay.com
   • Production Keyset → Copie Client ID (AppID), Client Secret (Cert ID), RuName
2. Se não é desenvolvedor eBay:
   • Inscreva-se no eBay Developer Program
   • Crie uma produção keyset (leva 10-15 minutos)
   • Copie os valores acima

1. De volta ao SellerForge WMS:
   • Na seção Usar Meu Próprio Keyset / Use Custom Keyset
   • Preencha Client ID, Cert ID, RuName
   • Clique em Salvar / Save

Problemas Comuns

"Error: Business Policies Not Found"

Causa: Você não criou policies de pagamento/envio/devolução no eBay. Solução: Vá a eBay → Seller Hub → Account Settings → Business Policies e crie pelo menos uma de cada tipo.

Fiz a conexão mas não vejo mensagem de "Conectado"

Causa: A página pode precisar de um refresh. Solução: Feche e abra novamente a aba de Integrações do SellerForge WMS (F5 / Cmd+R).

"Error: Permission Denied" ou "Invalid Token"

Causa: Seu token OAuth expirou (dura ~18 meses) ou você foi deslogado do eBay. Solução: Clique Conectar eBay novamente. Siga os passos OAuth. Você será reconectado.

Quero desconectar e reconectar com uma conta diferente

Causa: Você cometeu um erro ao conectar com a conta errada. Solução: No SellerForge WMS, clique em Desconectar / Disconnect eBay. Depois clique Conectar eBay novamente com a conta correta.

"Error: Keyset not found" (se usando keyset customizado)

Causa: Client ID ou Cert ID estão errados. Solução: Volte ao eBay Developer Program, verifique sua Production Keyset, e copie os valores novamente (com cuidado, sem espaços).

Não consigo criar anúncios

Causa: Policies estão configuradas mas há outro erro (ex: falta de imagem, título muito longo). Solução: Tente criar o anúncio manualmente no eBay primeiro. Se funcionar lá, o erro é nos dados que SellerForge está enviando. Contate suporte.

Segurança

Se você usou OAuth (recomendado): O token é criptografado e armazenado apenas no seu banco de dados SellerForge WMS. Ninguém da equipe SellerForge consegue usá-lo.

Se você usou um keyset customizado: Seus Client ID, Cert ID, e RuName são criptografados da mesma forma.

Você pode revogar acesso a qualquer hora: Desconecte a integração no SellerForge WMS. O token eBay não vai funcionar mais.

Próximo passo: Conectar Walmart → (opcional) ou Seu Primeiro Dia →

Referências Oficiais:

• eBay OAuth & Authorization
• eBay OAuth Scopes
• eBay Business Policies