Configuração do conector do eBay¶
Visão geral¶
O conector eBay do Odoo permite que as listagens do eBay se conectem aos produtos do Odoo. Uma vez conectado, é possível fazer atualizações das listagens no Odoo ou no eBay. Quando um item é vendido no eBay, são criados pedidos de venda provisórios no Odoo para o usuário revisar e confirmar. Depois que o pedido de venda é confirmado, os aplicativos Inventário e Vendas do Odoo funcionam de forma padrão para retirar produtos do estoque e permitir que o usuário crie faturas.
Veja também
Para saber mais sobre o conector do eBay, visite também estas páginas:
eBay - campos vinculados ao Odoo¶
A seguir estão os detalhes do produto do eBay. Cada um desses campos do eBay atualiza os campos correspondentes no Odoo.
URL do eBay
Status do eBay
Quantidade vendida
Data de início
Título
Subtítulo
Condição do item
Categoria
Categoria 2
Categoria de loja
Categoria de loja 2
Política de pagamento
Perfis de vendedores
Código postal
Política de envio
Tipo de anúncio (preço fixo ou leilão)
Preço inicial do leilão
Preço de ‘Comprar agora’
Valor do preço fixo
Usar quantidade no estoque
Quantidade no eBay
Duração
Permitir melhor oferta
Listagem privada
Descrição do eBay
Imagem do produto do eBay
País
Condições do eBay¶
As variações agrupam vários produtos em um só, com opções de variação (ou variante), e podem ser sincronizadas com os atributos e valores do Odoo. Elas aparecerão em menus suspensos próximos à parte superior da página ao visualizar uma listagem do eBay. Variações são comparáveis às variantes de produtos no Odoo.
As especificações do item, localizadas na parte inferior da listagem, detalham informações específicas do produto. Essas especificações não são sincronizadas com os campos do Odoo por padrão; é necessário um desenvolvimento para vincular esses campos.
Sandbox e Produção são termos usados para categorizar os ambientes do eBay como ainda em desenvolvimento/teste (Sandbox) ou para uso na instância real da base de dados com informações/dados reais do cliente (Produção). Recomenda-se começar primeiro no Sandbox para testar e, depois, seguindo os processos abaixo, criar uma instância de Produção.
Dica
O ambiente sandbox do eBay pode ser acessado navegando para o portal sandbox do eBay em https://sandbox.ebay.com/. O ambiente de produção do eBay pode ser acessado navegando para o portal eBay.com ou https://www.ebay.com/.
Importante
A seleção de ambiente deve permanecer a mesma em todas as configurações de ambiente no eBay e no Odoo durante toda essa configuração.
Ações do eBay disponíveis no Odoo¶
A seguir estão as ações integradas no Odoo que adicionam ou atualizam as listagens do eBay:
Listar/ Vincular: gere uma nova listagem no eBay com um produto Odoo clicando em Listar item no eBay ou Vincular com listagem existente do eBay.
Botão Revisar item: depois de fazer alterações em um anúncio do eBay no Odoo, salve o registro e, em seguida, clique no botão Revisar item no Odoo para atualizar o anúncio do eBay.
Listar novamente: se a listagem de um item tiver sido encerrada antecipadamente ou se Listar novamente - automático não tiver sido selecionado, um usuário poderá refazer a listagem do item no Odoo. A data de início será redefinida.
O botão Encerrar listagem do item encerra uma listagem no eBay diretamente do Odoo.
Desvincular listagens de produtos: os usuários podem desvincular um produto da listagem do eBay; a listagem permanecerá intacta no eBay.
Configuração necessária no Odoo antes da configuração do eBay¶
Para vincular o eBay ao Odoo, instale o módulo eBay navegando até o painel do Odoo e clicando no aplicativo Aplicativos. Pesquise o termo eBay e instale o módulo Conector eBay.
Os itens a seguir devem ser configurados antes da configuração do eBay:
No Odoo, crie e configure produtos que devem ser listados no eBay. O eBay não importa novos produtos para o Odoo. Todos os produtos devem primeiro ser criados no Odoo e, em seguida, vinculados às listagens.
O Odoo não permite que várias listagens do eBay sejam vinculadas por produto no Odoo. Se a empresa vender o mesmo produto em várias listagens, siga estas instruções:
Configure um produto base (anotado no campo Componente da LM) do qual todos os anúncios do eBay serão extraídos. Esse será um produto armazenável para que o estoque possa ser mantido. O produto destacado em verde será incluído no kit em cada produto subsequente “vinculado” abaixo.
Configure mais de dois produtos vinculados (anotados no campo Produto da LM, um para cada listagem do eBay. O tipo de produto será determinado pelas configurações de contabilidade da empresa, conforme explicado na documentação do Odoo. Destacado em amarelo abaixo, cada produto deve ter o tipo de LM Kit e ter o produto base como um Componente do kit. Quando esse produto vinculado do eBay for vendido, o pedido de entrega criado terá o produto base listado no lugar do produto vinculado.
Veja também
O eBay não cria automaticamente as faturas de pedidos do eBay que são enviados para o Odoo. Defina a política de faturamento dos produtos do eBay: a política de faturamento ditará quando o produto poderá ser faturado. Como a maioria dos usuários do eBay recebe o pagamento antes de o produto ser enviado, “faturar no pedido” permitirá que os usuários criem faturas em massa para os pedidos do eBay todos os dias.
Defina a rota Remessas enviadas para o depósito como Entregar mercadorias diretamemente (1 etapa).
Aviso
Quando a rota Remessas enviadas é definida para duas ou três etapas, ocorre um bug conhecido: o eBay marca erroneamente os pedidos como entregues quando a operação de coleta no Odoo é confirmada. O comportamento esperado é marcar os pedidos como entregues após o pedido de entrega ser confirmado. Essa marcação incorreta impede que os números de rastreamento no eBay sejam importados para o pedido de entrega.
Se os aplicativos Financeiro/Faturamento estiverem instalados, faça o registro de pagamentos e a conciliação de faturas criadas a partir de pedidos do eBay com a entrada de caixa do eBay.
Veja também
Gere um token de notificação de exclusão/encerramento de conta do marketplace. Para começar, navegue até . No cabeçalho eBay, altere o modo para Produção e insira valores de texto aleatórios para Chave de certificado de produção. Em seguida, clique no botão Gerar token na seção Notificações de exclusão/encerramento de conta do eBay Marketplace. Esse token será usado durante a instalação no eBay para a configuração das notificações de exclusão/encerramento.
Configuração no eBay¶
Configurar uma conta de desenvolvedor do eBay¶
Para começar, crie uma conta de desenvolvedor do eBay pelo portal de desenvolvedores do eBay <https://go.developer.ebay.com/>`_. Esse site exige um login e uma senha diferentes da conta do eBay, embora o mesmo endereço de e-mail possa ser usado para o registro. A verificação para criar uma conta de desenvolvedor é de cerca de 24 horas.
Configuração de conjunto de chaves do eBay¶
Depois que a conta de desenvolvedor do eBay for criada, configure um aplicativo no portal do desenvolvedor do eBay <https://go.developer.ebay.com/>`_. Em seguida, navegue até o cabeçalho Olá [nome de usuário] no canto superior direito da tela e, a partir das opções do menu suspenso, clique em Conjunto de chaves do aplicativo. Isso abre uma janela pop-up que solicita que o usuário Insira o título do aplicativo (até 50 caracteres) e escolha um ambiente de desenvolvimento (Sandbox ou Produção). Esses dois campos geram o primeiro conjunto de chaves. Esse título do aplicativo não é salvo até que o conjunto de chaves seja gerado. Clique em Criar um conjunto de chaves para gerar o conjunto de chaves.
Aviso
O conjunto de chaves de produção recém-criado está desativado por padrão. Ative-o se inscrevendo nas “notificações de exclusão ou encerramento de conta” do eBay Marketplace ou solicitando uma isenção ao eBay. Uma vez ativado, a vase de dados pode fazer 5.000 chamadas por dia usando esse conjunto de chaves.
Configurar as definições de notificação/exclusão de conta (Produção)¶
Para configurar notificações ou excluir a base de dados em um ambiente de produção, navegue até o portal do desenvolvedor do eBay. Defina as configurações de notificação/exclusão de conta no eBay navegando até Olá [nome de usuário] no canto superior direito da tela e, em seguida, para conjunto de chaves do aplicativo.
Então, clique na opção notificação de exclusão/encerramento de conta do marketplace na coluna do conjunto de chaves Produção. Digite um e-mail em E-mail a notificar se o endpoint de notificação de exclusão de conta do marketplace estiver inativo. Clique em Salvar para ativar o e-mail.
Após essa ação, insira o URL do endpoint de notificação de exclusão de conta do Marketplace fornecido pelo Odoo. Esse endpoint HTTPs pode ser encontrado no Odoo navegando até , no campo Notificações de exclusão/encerramento de conta do eBay Marketplace.
Clicar no botão Gerar token no Odoo abaixo desse campo cria um token de verificação para o ambiente de produção do eBay. No Odoo, copie o token recém-criado e navegue até o eBay para preencher o campo Token de notificação. Clique em Salvar para ativar o Método de entrega de notificação de eventos.
Depois de preencher os campos acima, clique em Enviar notificação de teste para testar as novas notificações. Prossiga para a próxima etapa quando a marca de confirmação verde for exibida. Revise as configurações acima se a publicação de teste não for a esperada.
Após definir as configurações de notificação, volte para a página para gerar conjuntos de chaves de produção.
Criação do conjunto de chaves¶
Uma configuração bem-sucedida das notificações possibilita de criar conjuntos de chaves de produção que são necessários no restante da configuração do Odoo. Navegue de volta à página para gerar um conjunto de chaves de produção.
O administrador é solicitado a . Insira ou confirme o proprietário da conta (a pessoa legalmente responsável pelo Contrato de Licença de API do eBay). Preencha o Nome, Sobrenome, E-mail, Telefone. Em seguida, selecione as opções Individual ou Empresa.
Nota
O endereço de e-mail ou número de telefone fornecido não precisa corresponder ao da conta. O eBay usa essas informações para entrar em contato com a empresa ou indivíduo em caso de problemas com tokens de usuário. Contatos adicionais podem ser adicionados pela página Perfil e Contatos no eBay.
Clique em Continuar para criar chaves para confirmar o contato principal. As Chaves do aplicativo são preenchidas em uma nova tela e um e-mail também é enviado para a conta do desenvolvedor. Os ID do aplicativo (ID do cliente), ID do dev e ID do certificado (Segredo do cliente) são preenchidos.
Copie esses valores, pois eles serão inseridos no Odoo posteriormente.
Criar token de usuário do eBay¶
Agora, crie um token de usuário no eBay navegando até Olá [nome de usuário] no canto superior direito da tela e, em seguida, Tokens de acesso do usuário.
Selecione o Ambiente correto: Sandbox para testes ou Produção para a base de dados ativa. Mantenha a mesma seleção para todas as configurações de ambiente no eBay e no Odoo.
Em seguida, selecione o botão de opção rotulado como Auth’n’Auth.
Escolha Fazer login em Produção ou Fazer login no Sandbox para obter um token de usuário no ambiente escolhido. Esse botão varia de acordo com a seleção feita acima para Sandbox ou Produção.
Isso aciona uma janela pop-up para Confirmar seu endereço legal. Preencha os campos obrigatórios, que são: Nome, Sobrenome, E-mail principal, Endereço legal e Tipo de conta. Em Tipo de conta, selecione Individual ou Empresa. Para concluir a confirmação, clique em Fazer login no eBay para obter um token.
Nota
O eBay entrará em contato com essa pessoa ou empresa caso haja algum problema com as chaves do aplicativo. Outros contatos podem ser adicionados na página do eBay.
O administrador será redirecionado para uma página de login de sandbox ou de produção do eBay. Esse login é diferente do console do desenvolvedor do eBay, pois é a conta do eBay na qual os itens serão vendidos. Esse e-mail e/ou login pode ser diferente da conta de desenvolvedor do eBay.
Digite o E-mail ou Nome de usuário e entre na conta do eBay.
Importante
Se houver necessidade de um usuário adicional para a simulação do sandbox, será preciso criar um usuário de teste. Visite o formulário eBay’s Register for Sandbox. Instruções detalhadas podem ser encontradas nas páginas de ajuda do eBay: Criar um usuário de teste Sandbox.
Conceder acesso ao aplicativo¶
Após o login no ambiente de produção ou sandbox, o eBay apresenta ao administrador um acordo para conceder acesso aos dados do eBay do usuário.
Clicar em Concordar permite que o eBay vincule a conta do eBay com a interface de programação de aplicativos (API). Esse acordo pode ser alterado a qualquer momento nas preferências da conta do eBay.
Aviso
O eBay tem uma sequência de tempo entre o login e a aceitação dos termos da vinculação da API à conta. Uma vez concluído, um Token do usuário será preenchido na página .
Um Token do usuário será exibido na tela. Certifique-se de copiar esse token, pois ele será usado nas próximas etapas juntamente com o Conjunto de chaves do aplicativo.
Importante
É necessário fazer login na conta do eBay para criar o token. O desenvolvedor do eBay também pode revogar o token clicando no link Revogar token.
API explorer¶
Agora que o Conjunto de chaves do aplicativo e o Token do usuário foram criados, um teste pode ser executado pelo API Explorer para garantir que a API esteja configurada corretamente. Esse teste executará uma pesquisa simples usando a API.
Para iniciar o teste da API, clique em Obter token do aplicativo OAuth. Isso preencherá a chave no campo Token.
Uma função de pesquisa básica está definida para ser executada. Clique em Executar para concluir o teste. Um teste bem-sucedido responderá com uma Resposta de chamada de 200 OK com um Tempo correspondente.
Inserir credenciais no Odoo¶
O Token do usuário e o Conjunto de chaves do usuário copiados anteriormente agora estão prontos para serem inseridos na base de dados do Odoo.
Volte para as configurações do eBay no Odoo () e cole as seguintes credenciais do eBay nos campos correspondentes no Odoo.
Plataforma |
Chave/ID do desenvolvedor |
Token |
Chave/ID do aplicativo |
Chave/ID do certificado |
|---|---|---|---|---|
eBay |
ID do desenvolvedor |
Token do usuário |
ID do aplicativo (ID do cliente) |
ID do certificado (segredo do cliente) |
Odoo |
Chave de desenvolvedor |
Token de produção/sandbox |
Chave do aplicativo de Produção/Sandbox |
Chave de certificação de Produção/Sandbox |
Importante
O Conjunto de chaves do aplicativo pode ser acessado no portal do desenvolvedor do eBay. Navegue até Olá [nome de usuário] no canto superior direito da tela, depois clique em Conjuntos de chaves do aplicativo. Acesse o Token do usuário no eBay navegando até Olá [nome de usuário] no canto superior direito da tela, depois Tokens de acesso do usuário e clique em Fazer login no Sandbox. O Token do usuário também pode ser acessado clicando em Tokens do usuário na página .
Confirme se a configuração está correta salvando as credenciais no Odoo. Quando a configuração inicial estiver concluída, será exibida uma nova aba de menu chamada eBay em produtos, com a opção de Vender no eBay. Consulte a documentação de gerenciamento para saber como listar produtos.
Dica
Sincronize as categorias de produtos clicando em Categorias de produto. Após a sincronização, um novo item de menu, Categoria do eBay, aparece disponível para os produtos a serem configurados. Essas categorias do eBay são importadas da base de dados do Odoo e estão disponíveis ao listar um item no eBay pelo Odoo.
Importante
Se forem necessárias categorias de produtos com mais de quatro caminhos, os usuários precisarão adicionar manualmente esses caminhos. Historicamente, isso é feito obtendo uma lista de todas as categorias de produtos com mais de quatro caminhos, importando-as manualmente para o modelo de categoria de produto no Odoo e, em seguida, vinculando-as individualmente ao produto.
Veja também
Agora que a configuração foi concluída, prossiga para: