1.操作场景
定义：领星管理后台授权 Ship123 打单系统是领星 OMS（订单管理系统）与第三方打单平台 Ship123 深度整合的功能模块，通过 API 授权实现订单数据、物流配置与面单生成的自动化流转。
作用：将 Ship123 的打单能力嵌入领星管理端的全链路管理体系，支持跨境电商卖家和海外仓服务商在统一平台完成订单处理、物流面单获取及履约跟踪，尤其适用于多渠道订单整合与复杂物流场景。
2.操作指引
2.1登录ship123系统
登录ship123系统，输入账号和密码，登录网址：ship123
2.2获取ship123的APi密钥
登录后，进入设置-APi密钥、文档界面，找到并复制信息。
2.3获取ship123的物流产品代码
进入设置-物流产品页面，复制产品代码，APi密钥和产品代码两个信息是后续在领星系统授权时的关键凭证。
2.4登录领星管理后台进行添加授权
在管理后台的【物流管理】-【物流商账号】页面中，点击【添加授权】按钮。
在【打单系统】页签下搜索ship123，选择ship123图标，点击下一步。
2.5填写API授权信息
填写自定义的账户名称和在Ship123 中的API 密钥，点击授权。
API 密钥可参考2.2步骤获取的密钥
2.6创建物流渠道
在授权好的账号-【操作】-【新建渠道】，注意API服务代码这一栏，需要填写的是ship123中的物流产品代码。物流产品代码可参考2.3步骤获取的产品代码。
2.7配置物流渠道
（1）编辑渠道
导航至管理后台-物流管理-物流渠道列表，找到刚刚新建的渠道，点击编辑。
（2）基础设置
①保险服务/签名服务：勾选后，OMS客户下单时，可以选到对应的服务，取消勾选则无法下单对应服务
②Track123查询承运商：支持给物流渠道配置要向Track123查询的承运商，使轨迹查询更精准。如渠道配置了Track123查询承运商，会按配置承运商来同步轨迹；如未配置，则仍按现有自动识别来同步轨迹。
③偏远邮编可送范围：支持给物理渠道配置可发货的偏远邮编类型。
（3）绑定可用仓库（必选）
在编辑渠道页面，勾选需要与该渠道进行绑定的仓库，勾选完成后点击“确认”按钮。
注意：必须要绑定仓库后，渠道才可使用
（4）设置发货地址（可选）
面单上的发货地址默认为创建仓库时填写的地址，系统支持针对渠道设置指定发货地址。部分打单系统要求填写addID，请设置发货地址，并填写在“服务商地址编码”。
注意：需绑定仓库后才能设置。同个仓库针对同个渠道仅能设置一个发货地址。
路径：物流商账号 - 点击已创建的物流渠道名称—编辑—发货地址—添加地址
物流渠道列表 - 点击编辑旁的展开键—发货地址—添加地址
（注：如果填写完页面信息后点击确认无响应，可以下划检查所有带“*”号的所有必填字段是否填写完成）
（5）绑定可用客户（可选）
物流渠道默认对绑定同个仓库的客户可用，若无需该仓库下所有客户都使用此物流渠道，可点击 “绑定客户” 进行更精准的客户范围管控。这里提供 “可用名单” 和 “不可用名单” 两种设置方式：
选择 “可用名单” 时，从列表中勾选特定客户，只有被选中的客户能使用当前物流渠道；
选择 “不可用名单” 时，从列表中勾选特定客户，被选中的客户将无法使用该物流渠道，以此灵活管理不需要使用此渠道的客户。
注意：如您想把渠道开放给所有客户，请切换到【不可用名单】，并不选择任何客户，然后点击确定
（6）设置下单规则（可选）
您可根据业务需求设置与该物流渠道相关的下单规则。这些规则能规范订单在使用该物流渠道时的下单逻辑，保障下单流程符合业务场景要求。
注：只对一件代发出库、备货中转出库生效；当满足条件时，则可以下单，或者将会进入OMS-异常中，并展示对应渠道的下单限制。支持同时配置多个条件。
2.8渠道状态管理与授权验证
（1）查看渠道状态
新建渠道完成后，可以查看该渠道状态，也可以在渠道列表选择启用/停用渠道。
（2）OMS下单使用已授权渠道
①刚授权的物流商账号，授权状态仍为“未知”，需要使用OMS账号创建单据测试打单系统授权信息的正确性，面单和跟踪号获取成功，授权状态才会同步更新。
②创建单据选物流渠道步骤：
OMS -仓储服务-一件代发出库-新建-填写单据信息-提交-草稿-待获取面单-获取面单
若获取面单提示异常，报错为“物流商返回错误”开头，需联系第三方物流商确认。
3.补充说明
3.1 名词解释
（1）预报方式
● 整单预报：一个出库单只获取一个面单
● 按箱预报：按照sku/箱子数量出多张面单，类似子母件
（2）绑定客户
● 不可用客户：当不可用客户为空时，即所有客户都可以使用这个渠道
● 可用客户：当可用客户为空时，即所有客户都不可以使用这个渠道
4.常见问题
Q1：为什么刚授权完成的物流商授权状态显示未知，是授权失败了吗？
答案：需要使用OMS账号创建单据测试打单系统授权信息的正确性，面单和跟踪号获取成功，授权状态会同步更新。
Q2：为什么创建了这个渠道，但是客户选不到这个渠道呢？
答案：看下渠道是否有绑定仓库（必填），是否有绑定客户，以及渠道组里是否有绑定这个渠道，设置了对客户不可见。