跳到主要内容

eBay Seller 集成

通过创建开发者应用、获取凭据并在浏览器中授权卖家账号,即可将 eBay 卖家账号连接到 Frevana。

开始之前​

您需要:

  1. eBay 卖家账号。
  2. eBay Developer 账号。
  3. 创建或管理 eBay Developer 应用的权限。
  4. 如果要在 Sandbox 中测试,还需要 Sandbox 测试用户。

第 1 步:打开 eBay Developer​

打开 eBay Developer,使用 eBay 账号登录,或创建开发者账号。

第 2 步:打开 Application Keys​

在 eBay Developer 控制台中打开 Application Keys。如果已有合适的应用,可以直接使用;否则请创建新应用。

备注

请使用属于您企业的应用,不要使用其他商家的应用凭据。

第 3 步:选择环境​

环境用途授权时使用的账号
Sandbox测试 OAuth 和 API 调用eBay Sandbox 测试用户
Production真实卖家账号数据您的真实 eBay 卖家账号

不要混用 Sandbox 和 Production 的值。 仅使用来自同一环境的凭据:

  • Sandbox Client ID、Sandbox Client Secret、Sandbox RuName 和 Sandbox 测试用户。
  • Production Client ID、Production Client Secret、Production RuName 和真实卖家账号。

第 4 步:复制应用凭据​

从选定环境中复制:

Client ID
Client Secret
注意

请妥善保管 Client Secret,不要发布到公开频道或共享文档。

第 5 步:配置并复制 RuName​

在同一个 eBay 应用及同一环境中打开 OAuth / 用户授权设置,配置并复制应用的 RuName。RuName 必须与 Client ID 和 Client Secret 来自同一环境。

第 6 步:向 Frevana 提供设置值​

向 Frevana 提供:

Environment: sandbox or production
Marketplace ID: EBAY_US
Client ID: ...
Client Secret: ...
RuName: ...

使用要连接的 eBay 市场对应的 Marketplace ID。常见示例如下:

市场Marketplace ID
美国EBAY_US
英国EBAY_GB
德国EBAY_DE
加拿大EBAY_CA
澳大利亚EBAY_AU

第 7 步:授权卖家账号​

提供设置值后,Frevana 将生成 eBay 授权 URL。打开该 URL:

  1. 使用所选环境对应的卖家账号登录。
  2. 检查请求的访问权限。
  3. 批准连接。
  4. 复制返回的授权码。
  5. 将授权码粘贴回 Frevana。

Sandbox 请使用 eBay Sandbox 测试用户登录;Production 请使用真实的 eBay 卖家账号登录。

第 8 步:验证连接​

让 Frevana 验证 eBay Seller 连接。设置成功后应确认环境、Marketplace ID、卖家身份和令牌刷新。

所需 OAuth 权限范围​

eBay Seller 使用以下权限范围:

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.finances
https://api.ebay.com/oauth/api_scope/sell.account

设置完成后可以提问​

您可以让 Frevana 列出 eBay 库存商品、查看报价和刊登状态、搜索近期订单、汇总订单收入、显示财务交易、查看付款、费用、退款和卖家资金,以及检查付款、履约和退货政策。

重要说明​

不要粘贴 eBay Developer Portal 中的短期 User Token。Frevana 需要 Client ID、Client Secret、RuName,以及从生成的授权 URL 获取的授权码。授权码使 Frevana 能够创建刷新令牌,从而在短期访问令牌过期后继续保持连接。

eBay 库存模型​

eBay 库存与普通商店产品目录不同。典型流程是:

  1. Inventory Item(库存商品)
  2. Offer(报价)
  3. Published Listing(已发布刊登)

库存商品不一定是已上线刊登;发布报价时才会创建刊登。发布刊登通常需要 eBay 的付款、履约和退货商业政策。

备注

eBay Seller 集成的首个版本以读取为主。发布刊登、更新库存、退款和创建发货履约操作应在执行前获得确认。

官方链接​