¶ 功能说明
Sodexi 运单回传仅支持空海运主单操作，触发回传后系统会自动同步该主单绑定的全部 EPS 子单数据至 Sodexi 系统，用于对方清关处理；独立快递、专线运单无法使用该功能。
系统会根据已配置通道，自动组装主单运输信息、子单申报、尺寸重量等全部字段推送接口。
¶ 适用场景&适用单据范围
¶ 适用前提
仅已开通 Sodexi 回传权限的空海运代理渠道可用。
¶ 支持单据
- 空运 / 海运主单（回传操作仅能在主单页面发起）
- 绑定在空海运主单下的 EPS 子单（系统自动批量回传）
¶ 覆盖业务场景
空运 / 海运主单 + 关联 EPS 子单清关数据回传，同步单件尺寸重量、包号、航班 / 起运地 / 目的地等运输信息。
¶ 不支持范围
无主单绑定的独立快递、专线运单。
¶ 操作入口
¶ 路径 1（菜单标准入口）
标准菜单路径：员工端首页 → 空运 / 海运标签页 → 转单回传
¶ 路径 2（快捷入口）
- 空运 / 海运主单列表、主单详情页内置【转单回传】按钮，可直接选中主单发起回传
提示：「快递 / 专线」菜单仅用于前期 EPS 子单录入、订仓操作，不可在此页面发起 Sodexi 回传，回传操作必须切换至空运 / 海运主单页面执行。
¶ 回传前置校验清单（缺项直接回传失败）
¶ 一、接口配置信息
- Sodexi 接口域名填写完整
- Sodexi 分配 API Key 录入无误
¶ 二、空海运主单必填信息
- 主提单号
- 空运：航班号、起飞时间；海运：船号、发船时间
- 起运港、目的港
¶ 三、子单硬性要求
待同步子单必须是 EPS 类型
¶ 四、EPS 子单必填信息
- 客户单号、寄件人信息完整
- 申报：币种、英文品名、申报单价、数量、海关编码、单品价值
- 商品毛重、净重与单件重量一致
- 单件包号、长、宽、高、重量全部填写
- 运单已填写发货时间
¶ 申报价值填写说明
单件申报价值填写整票总货值仅适用于一票仅 1 条申报明细场景；
若一票多条申报明细，请按各商品实际明细价值分别填写；
¶ 操作步骤
一. 配置 Sodexi 运单回传接口
- 菜单进入：报价管理 → 运单回传
- 切换标签页：【转单 API】→【运单回传】
- 点击左下角【添加】，弹出编辑配置弹窗
- 字段填写规范：
- API 名称：下拉选择「Sodexi 空海运清关回传」
- 模板名称：（例：test_sodexi 运单回传_dev-45524）
- Sodexi 接口域名：填写官方提供接口地址（示例：https://customerapi-test.sodexi.fr）
- API Key：录入 Sodexi 授权key
- 确认信息无误后，点击弹窗右下角【确定】完成接口创建。
二. 渠道绑定回传接口
创建接口后，需要将接口绑定至对应空运 / 海运渠道，绑定后渠道运单才可发起回传：
- 菜单路径：报价管理 → 发货渠道 → 基本
- 选中目标空运 / 海运代理渠道，打开渠道编辑弹窗
- 在「运单回传」下拉框，选中上一步新建的 Sodexi 回传模板
- 点击【确认】保存渠道绑定配置。
三. 运单预校验与订仓
- 返回员工端首页，进入【快递 / 专线 → 订仓】页面；
- 通过客户单号 / 订仓号筛选待回传运单，对照「回传前置准备」校验全部数据完整性；
- 勾选目标运单，点击列表底部下拉按钮，选择【订仓】，完成运单订仓操作。
四. 发起 Sodexi 运单回传
- 顶部业务栏切换至【空运】/【海运】业务标签；
- 通过订仓号检索已完成订仓的目标运单；
- 核对主提单号、起运地、目的地、航班号、航班时间等运输信息；
- 勾选运单，执行页面【转单回传】操作；
- 系统自动按 Sodexi 接口推送运单数据，操作完成后查看页面反馈结果。
¶ 回传结果查看
¶ 查询路径
运单详情页 → 【日志】标签页，查看回传操作记录。
¶ 成功标识
日志内出现两条成功记录：
- 留言：运单推送成功（事件：手动回传 Sodexi 空海运清关回传）
- 留言：Sodexi 空海运主单子单回传全部成功: 1/1 出现以上两条记录即代表运单数据已完整同步至 Sodexi 系统。
