eBay + AtoShip
将 eBay 卖家账户的订单导入 atoship，购买折扣价的 USPS / UPS / FedEx 面单，并把物流单号与发货状态自动回传——全程通过安全的 OAuth 授权，无需安装插件。
运作原理
eBay 采用 OAuth 2.0 进行安全授权。你在 atoship 后台连接卖家账户，在 eBay 完成授权，订单便会按你设定的周期自动同步。购买面单后，物流信息会自动回传到 eBay。
通过 OAuth 连接
在你的 eBay 卖家账户中授权 atoship
订单按计划同步
已付款订单通过 Fulfillment API 导入
购买面单，订单发货
物流单号自动回传到 eBay
连接你的 eBay 账户
第 1 步 — 发起连接
在 atoship 后台，进入 渠道 → 添加渠道 → eBay。 点击 连接 eBay 账户 即可启动 OAuth 授权流程。
eBay 的沙盒（sandbox）和正式（production）环境均受支持。上线前，用沙盒环境做测试会很方便。
第 2 步 — 在 eBay 上授权
系统会将你跳转到 eBay 的授权确认页面。请确认 atoship 所需的权限（销售、履约），然后点击 我同意。
atoship 请求访问你的销售与履约数据。你的 eBay 密码永远不会被保存——我们仅保存一个安全、可随时撤销的 OAuth 令牌。
第 3 步 — 验证连接
授权完成后，你会被跳转回 atoship 后台。你的 eBay 账户应会出现在 渠道 中，状态显示为 已激活。 此时你可以立即手动触发一次同步，或配置自动同步。
订单同步
atoship 使用 eBay 的 Sell Fulfillment API 拉取订单。订单按创建日期筛选，并连同完整信息（收货地址、商品明细、付款信息）一并导入。
同步方式
- 手动同步 — 在 eBay 店铺页面点击"同步订单"按钮，即可按需拉取订单。
- 自动同步 — 开启定时同步（每 1、2、4 或 8 小时一次），让订单源源不断地自动流入。
同步时间窗口
设定往前回溯多久来查找订单：1 周、2 周 或 1 个月。 只有在此窗口内的订单才会被同步。系统中已存在的订单会被更新（而非重复导入），依据是 eBay 的唯一订单 ID。
令牌管理
eBay 的访问令牌 2 小时后过期。atoship 会使用长期有效的刷新令牌（有效期 18 个月）自动续期。如果续期失败，渠道状态会变更，以提示你需要重新授权。
履约与物流跟踪
当你在 atoship 为某个 eBay 订单购买运输面单时，物流单号与承运商信息会通过 Fulfillment API 自动回传到 eBay。
物流单号回传的工作方式
- 你在 atoship 购买面单（USPS、UPS、FedEx 等）
- atoship 调用 eBay 的
POST /sell/fulfillment/v1/order/{orderId}/shipping_fulfillment - eBay 将订单标记为"已发货"，并向买家显示物流单号
- eBay 自身会向承运商轮询运输动态（in_transit、delivered 等）
你只需回传一次物流单号即可。之后，eBay 会自动处理所有承运商状态轮询与买家通知——无需 atoship 再做任何后续更新。
同步设置
点击你已连接的 eBay 店铺，然后打开 订单同步 选项卡。各选项的含义如下：
订单同步
- 自动同步 — 开启或关闭订单自动导入。
- 同步频率 — 多久拉取一次订单：1、2、4 或 8 小时。
- 同步窗口 — 往前回溯多久查找订单：1 周、2 周或 1 个月。
履约与物流跟踪
- 更新履约状态 — 购买面单后，自动回传物流单号并在 eBay 上将订单标记为已发货。
- 发送物流通知邮件 — 创建履约记录时，eBay 会向买家发送物流通知。如果你想自行处理通知，可关闭此项。
同步哪些内容
eBay → atoship
- 订单 ID、日期、总金额
- 收货地址（来自履约指令）
- 商品明细，含标题、SKU、数量、单价
- 买家用户名与邮箱
- 付款状态（已付款、已退款等）
- 履约状态（未开始、进行中、已履约）
- 买家结账备注
atoship → eBay
- 物流单号
- 承运商代码（USPS、UPS、FedEx、DHL）
- 发货日期
- 商品明细的履约信息
- 订单标记为"已发货"
订单同步使用 eBay 的 Fulfillment API，采用基于偏移量（offset）的分页。 重复订单通过 eBay 的唯一订单 ID 识别——对同一时间段同步两次也不会产生重复订单。
状态映射
eBay 将付款状态与履约状态分开管理。atoship 会把它们映射为统一的状态：
付款状态
PAID→PAIDPENDING→PENDINGPARTIALLY_REFUNDED→PARTIALLY_REFUNDEDFULLY_REFUNDED→REFUNDEDFAILED→FAILED履约状态
NOT_STARTED→UNFULFILLEDIN_PROGRESS→PARTIALLY_FULFILLEDFULFILLED→FULFILLED断开连接
断开你的 eBay 账户：
- 从 atoship 端：进入渠道，点击你的 eBay 店铺，然后点击 删除店铺。输入"delete"以确认。atoship 端的 OAuth 令牌会被撤销。
- 从 eBay 端：进入你的 eBay 账户 → 账户设置 → 已授权应用，找到 atoship，撤销其访问权限。
断开连接不会删除 atoship 中已有的任何订单、面单或物流数据，仅会停止后续同步。
故障排查
OAuth 跳转失败或超时
eBay 的授权流程有时间限制。如果你等待过久，请返回渠道页面重试。同时请确保没有为 ebay.com 屏蔽弹窗。
订单未同步
请检查同步窗口设置——只有在所设定时间范围内的订单才会被导入。 另外，请确认你的 eBay 账户中有付款状态为"PAID"的近期订单。 你可以在店铺设置页面手动触发一次同步。
令牌已过期 / 需要重新授权
eBay 的访问令牌每 2 小时过期一次。atoship 会自动续期，但如果刷新令牌本身过期（18 个月后）或被撤销，你就需要通过断开并重新连接店铺来重新授权。
eBay 上未显示物流单号
请确保同步设置中已启用"更新履约状态"。订单必须有有效的 platformOrderId，物流单号回传才能生效。若回传失败，请查看渠道日志。
沙盒环境与正式环境
请确认你使用的是正确的环境。沙盒订单不会出现在正式环境中，反之亦然。当前环境会显示在店铺详情页上。
前提条件
- eBay 卖家账户（任意等级——Starter、Basic、Premium、Anchor、Enterprise）
- 有可供同步的在售商品与订单
- 无需 eBay 应用或插件——仅通过 OAuth 连接
- 支持的市场站点：美国站（ebay.com），更多站点即将上线