¶ Shopee 店铺对接操作指南：订单同步、发货、面单与轨迹
本指引用于 Shopee 卖家店铺订单：先授权店铺、同步待发货订单，再按订单的物流方式确认发货，并核对转单号、面单与轨迹。它与 Shopee 物流对接 不是同一个功能。
操作顺序：添加并授权店铺 → 抓取待发货订单 → 核对运单并确认发货 → 按物流方式核对回传、面单和轨迹。订单出现在易抵达，只表示抓单成功，不表示已经向 Shopee 确认发货；卖家自发物流不会生成 Shopee 平台面单。
¶ 一、添加并授权店铺
使用前准备：请管理员确认已开通 Shopee 店铺抓单功能；准备好有权授权该店铺的 Shopee 卖家账号。首次授权必须由易抵达的客户账号操作，员工账号看不到“Shopee授权”按钮。不要把卖家密码填到抓单配置或发给客服。
- 打开 菜单 → 抓单接口，在“抓单对接设置”中点击 添加。
- 在 基本 页将“类型”选为 Shopee，填写便于识别的配置名称。“间隔时间”留空时采用系统默认设置。
- 在 参数 页按需勾选“多包裹拆单”：希望一个订单的多个包裹各生成一票运单时勾选；希望仍按一笔订单生成一票时不勾选。然后点击 保存。
- 用客户账号重新打开已保存的配置，进入 参数，点击 Shopee授权，在 Shopee 页面完成授权。返回易抵达后，重新打开配置核对：授权状态应为“已授权”，店铺ID应有值（下图已遮挡具体编号）。店铺 ID 由授权自动取得，无需手填；若状态已授权但店铺 ID 仍为空，请先刷新或请管理员核查，不要直接按授权完成处理。
- 回到配置列表，确认状态为 运行中；若显示“已暂停”，选中该配置并点击 启用。多个店铺应分别建立配置、分别授权。
**何时重新授权？**授权失效、店铺变更或系统提示授权不可用时，用对应店铺的客户账号点击 Shopee重新授权。日常抓单由系统后台执行；“立即抓单”主要供员工排查，不必反复点击。
¶ 二、抓取待发货订单
抓取条件：配置须为“运行中”且店铺已授权。系统默认查询 Shopee 中最近 7 天更新、当前仍待发货的订单；已发货订单不在默认抓取范围。配置暂停时不会抓单，恢复后请核对有无漏单，不要自行重复建单。
**抓取对象：**通常一笔 Shopee 订单生成一票易抵达运单，客户单号对应 Shopee 订单号。若订单实际有多个包裹，且已启用“多包裹拆单”，则每个包裹分别生成运单；单包裹订单不会因为勾选开关而拆开。例如，虚构订单 TESTORDER001 有包裹 PKG-A、PKG-B，拆单后可形成 TESTORDER001-PKG-A、TESTORDER001-PKG-B 两票。
抓取效果：进入运单列表，以 Shopee 订单号搜索“客户单号”；拆单时核对同一订单下的每票包裹运单。打开运单，逐项核对收件人及地址、申报商品、数量、重量和尺寸。若平台返回遮挡地址，或重量尺寸缺失、使用临时值，须在实际发货前核实并更正。
抓单配置列表中的“最近抓取时间、最近抓取状态、最近抓取错误”可用于判断同步结果；它们不是发货确认结果。
¶ 三、确认发货与保存面单
先确认订单属于哪种物流方式，再决定是否在易抵达操作卖家发货：
| 订单物流方式 | 发货前先做什么 | 确认发货后核对什么 |
|---|---|---|
| Shopee 平台物流（上门揽收／自行送站） | 核对订单、包裹及收件资料；不要自行填入其他承运商号码代替平台号码。 | 系统向 Shopee 安排发货，取得平台转单号并生成、保存 PDF 面单。检查运单“转单号”，再到运单 文件 中打开类型为“转单Label”的文件，确认 PDF 可查看。 |
| 卖家自发物流 | 先由实际承运商打单，并把取得的转单号填入运单。 | 系统将该号码提交给 Shopee；检查发货回传结果。此路径不会生成 Shopee 平台面单，如有承运商面单，应查看实际承运商的文件。 |
| Shopee 平台履约订单 | 不按卖家自发物流流程操作。 | 以 Shopee 平台履约状态为准，不要重复提交卖家发货。 |
¶ 实际操作：选择运单、确认发货、核对结果
- 在运单列表切换到 待发货，按 Shopee 订单号搜索客户单号，核对收件资料与该票包裹。启用“多包裹拆单”时，同一订单下的每票运单都要分别核对；勾选本次要发货的运单。
- 点击列表底部的 确认发货。在弹出的确认界面核对所选运单和提示，再完成确认；若系统提示问题件、欠费或资料错误，先处理提示。不要仅凭点击按钮就认定 Shopee 已收到了发货信息。
- Shopee 平台物流：确认后等待平台处理，刷新运单并查看发货回传结果；核对转单号是否已有值。打开该票运单的 文件 页签，找到类型为 转单Label 的文件，打开或下载 PDF，检查面单能正常查看。若平台暂未返回结果，先查看该票的回传结果或日志，不要重复确认发货。
-
卖家自发物流：先向实际承运商取得正确转单号，并填入对应运单，再按上述步骤确认发货、检查回传结果。此路径不会生成 Shopee 平台转单Label；面单和轨迹应按实际承运商核对。
-
**Shopee 平台履约订单：**不要重复操作卖家发货；以 Shopee 平台履约状态为准。
注意：平台物流的转单号在抓单时也可能已经带入，但面单保存仍以确认发货后的结果为准。如果没有看到平台面单或转单号，先检查该票的发货回传结果和运单日志；无法判断时请联系管理员，不要反复确认发货。
¶ 四、查询轨迹
¶ 1. 创建轨迹接口（管理员前置配置）
管理员打开 菜单 → 轨迹接口，新建或检查轨迹接口，在“接口”中选择 Shopee Open，再按实际业务设置抓取条件、抓取天数及是否向客户显示轨迹，保存配置。不要用名称相近的 Shopee 物流接口替代。
¶ 2. 检查运单轨迹设置
新抓取的 Shopee 平台物流运单会自动带上 Shopee Open 轨迹设置，通常不需要逐票配置。打开运单的 轨迹对接设置，核对承运商为 Shopee Open；旧单或设置异常时，请管理员检查并按平台物流的转单号设置。卖家自发物流不走 Shopee Open，应使用实际承运商的轨迹接口。
¶ 3. 抓取并查看结果
平台物流已有转单号、且满足轨迹接口的抓取条件后，系统会自动查询 Shopee 已提供的物流节点。需要核对旧单或重新检查时，可选中运单，点击 立即爬取轨迹 并确认；然后打开该票运单的 轨迹 页签，查看时间和描述。
暂无轨迹不一定表示抓单失败：先检查物流方式、转单号、授权和平台是否已有节点。卖家自发物流的轨迹以实际承运商为准，不能按“Shopee 没有轨迹”判断异常。
¶ 五、常见问题
| 看到什么 | 先检查什么 | 如何处理 |
|---|---|---|
| 授权失败或显示“未授权” | 是否已保存配置、是否使用客户账号、是否选对店铺 | 返回配置重新授权；仍失败时联系管理员检查店铺授权。 |
| 抓单后没有订单 | 配置是否“运行中”；Shopee 是否有最近 7 天更新的待发货订单；最近抓取状态／错误 | 先按订单号查运单，避免重复建单；确认漏单后提供订单号和错误时间给客服。 |
| 一笔订单生成多票或包裹数不符 | “多包裹拆单”开关与 Shopee 实际包裹数 | 按包裹号逐票核对；不要只凭订单号判断重复。 |
| 缺少平台转单号或面单 | 是否为平台物流、是否已确认发货、该票发货回传是否成功 | 核对运单转单号与“文件”中的“转单Label”；失败时提供脱敏后的错误信息。自发物流本来不会生成 Shopee 平台面单。 |
| 卖家自发物流确认发货失败 | 运单是否已有实际承运商转单号、店铺授权是否有效 | 先补齐正确转单号并检查回传结果；结果不明时不要反复提交。 |
| 轨迹页暂时为空 | 是否为平台物流、接口是否为 Shopee Open、转单号和平台节点是否存在 | 等平台产生节点后再查；自发物流改查实际承运商。 |
返回 其他电商平台对接。