eBay Seller 集成
通过创建开发者应用、获取凭据并在浏览器中授权卖家账号,即可将 eBay 卖家账号连接到 Frevana。
开始之前
您需要:
- eBay 卖家账号。
- eBay Developer 账号。
- 创建或管理 eBay Developer 应用的权限。
- 如果要在 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:
- 使用所选环境对应的卖家账号登录。
- 检查请求的访问权限。
- 批准连接。
- 复制返回的授权码。
- 将授权码粘贴回 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 库存与普通商店产品目录不同。典型流程是:
- Inventory Item(库存商品)
- Offer(报价)
- Published Listing(已发布刊登)
库存商品不一定是已上线刊登;发布报价时才会创建刊登。发布刊登通常需要 eBay 的付款、履约和退货商业政策。
eBay Seller 集成的首个版本以读取为主。发布刊登、更新库存、退款和创建发货履约操作应在执行前获得确认。