1. 操作场景
定义：在跨境电商业务流程里，为了让领星系统能与物流商 JIU_YUE_GLOBAL 实现系统层面的对接，从而能在领星系统中调用 JIU_YUE_GLOBAL 的物流服务，需要完成JIU_YUE_GLOBAL 在领星的授权操作。
作用：通过该授权操作，可在领星系统内便捷使用 JIU_YUE_GLOBAL 的物流服务，涵盖物流订单的创建、物流状态的追踪等功能，进而提升跨境电商物流环节的管理效率与操作便利性。
2. 操作指引
2.1登录JIU_YUE_GLOBAL系统获取授权信息
登录网址： http：//ups.jygj88.com/home
2.2获取JIU_YUE_GLOBAL的授权信息
登录后，进入系统设置界面，找到并记录下API Key和密钥（App Secret）信息，这两个信息是后续在领星系统授权时的关键凭证。
2.3登录领星管理后台系统
导航至管理后台-物流管理模块
2.4添加JIU_YUE_GLOBAL 授权
导航至物流管理-物流商账号，点击添加授权，找到JIU_YUE_GLOBAL，点击下一步
2.5填写物流商授权信息
在跳转页面填写相关授权信息，Base Api Domain填写可参考：http：//ups-api.jygj88.com
App Secret和Api Key的填写可参考2.2步骤获取的秘钥和Api Key信息
2.6获取 JIU_YUE_GLOBAL 的物流商代码
在 JIU_YUE_GLOBAL 系统的运单管理-运单查询界面，搜索查询对应的物流渠道，咨询 JIU_YUE_GLOBAL 的客服获取对应渠道的物流商代码
2.7在管理后台新建物流渠道
导航至物流管理-物流商账号，找到刚才授权的 JIU_YUE_GLOBAL 物流商，点击新建渠道
2.8填写渠道授权信息
填写对应信息完成新建渠道
2.9配置物流渠道
（1）编辑渠道
导航至管理后台-物流管理-物流渠道列表，找到刚刚新建的渠道，点击编辑。
（2）基础设置
①保险服务/签名服务：勾选后，OMS客户下单时，可以选到对应的服务，取消勾选则无法下单对应服务
②Track123查询承运商：支持给物流渠道配置要向Track123查询的承运商，使轨迹查询更精准。如渠道配置了Track123查询承运商，会按配置承运商来同步轨迹；如未配置，则仍按现有自动识别来同步轨迹。
③偏远邮编可送范围：支持给物理渠道配置可发货的偏远邮编类型。
（3）绑定可用仓库（必选）
在编辑渠道页面，勾选需要与该渠道进行绑定的仓库，勾选完成后点击“确认”按钮。
注意：必须要绑定仓库后，渠道才可使用
（4）设置发货地址（可选）
面单上的发货地址默认为创建仓库时填写的地址，系统支持针对渠道设置指定发货地址。部分打单系统要求填写addID，请设置发货地址，并填写在“服务商地址编码”。
注意：需绑定仓库后才能设置。同个仓库针对同个渠道仅能设置一个发货地址。
路径：物流商账号 - 点击已创建的物流渠道名称—编辑—发货地址—添加地址
物流渠道列表 - 点击编辑旁的展开键—发货地址—添加地址
（注：如果填写完页面信息后点击确认无响应，可以下划检查所有带“*”号的所有必填字段是否填写完成）
（5）绑定可用客户（可选）
物流渠道默认对绑定同个仓库的客户可用，若无需该仓库下所有客户都使用此物流渠道，可点击 “绑定客户” 进行更精准的客户范围管控。这里提供 “可用名单” 和 “不可用名单” 两种设置方式：
选择 “可用名单” 时，从列表中勾选特定客户，只有被选中的客户能使用当前物流渠道；
选择 “不可用名单” 时，从列表中勾选特定客户，被选中的客户将无法使用该物流渠道，以此灵活管理不需要使用此渠道的客户。
注意：如您想把渠道开放给所有客户，请切换到【不可用名单】，并不选择任何客户，然后点击确定
（6）设置下单规则（可选）
您可根据业务需求设置与该物流渠道相关的下单规则。这些规则能规范订单在使用该物流渠道时的下单逻辑，保障下单流程符合业务场景要求。
注：只对一件代发出库、备货中转出库生效；当满足条件时，则可以下单，或者将会进入OMS-异常中，并展示对应渠道的下单限制。支持同时配置多个条件。
2.10渠道状态管理与授权验证
（1）查看渠道状态
新建渠道完成后，可以查看该渠道状态，也可以在渠道列表选择启用/停用渠道。
（2）OMS下单使用已授权渠道
①刚授权的物流商账号，授权状态仍为“未知”，需要使用OMS账号创建单据测试打单系统授权信息的正确性，面单和跟踪号获取成功，授权状态才会同步更新。
②创建单据选物流渠道步骤：
OMS -仓储服务-一件代发出库-新建-填写单据信息-提交-草稿-待获取面单-获取面单
若获取面单提示异常，报错为“物流商返回错误”开头，需联系第三方物流商确认。
3. 补充说明
3.1名词解释
● 物流商：对外提供物流服务的第三方服务主体，是 LMS 的下游调用方。就相当于我们国内的顺丰、中通等快递服务商，渠道的话就是顺丰的半日达、标快等，所以实际使用中还需要建立物流渠道；根据不同类型，系统将物流商分为官方物流商、打单系统、自定义物流商。
● 官方物流商 ：实际提供物流服务的物流商，如顺丰物流、京东物流、USPS、FedEx、UPS 等。官方物流商在完成授权后，系统会根据系统支持的官方渠道自动为每个物流商添加渠道。● 打单系统 ：基于官方物流对外提供一套物流服务集成系统，如聚水潭、快递 100 等，本身并不提供实际物流运输。每家打单系统渠道各异，且更替频繁，因此系统并不提供自动添加渠道服务，需要客户在系统自行设置。打单系统可被看作一个中间平台，集合了快递账号，用户配置完打单系统后在上面获取面单，本质上是把信息推到官方获取面单，类似物流查询平台 Track 123，其物流轨迹来源于官方抓取。
● 自定义物流商 ：部分平台单据在系统无需进行物流处理，为了系统流程完整进行的配置，此类型不在 LMS 进行实际处理。在系统里一般指一些没办法或不需要打印面单、非快递的线下自定义渠道，如卡牌渠道、自提渠道等，用户可自定义其名称和配置。
4. 常见问题
Q1：订单报错开头提示“物流系统返回异常”，要怎么处理？
答案：这种开头的报错是打单系统返回的异常，可在管理后台—工具模块—打单报错记录—复制报错单据报文，发给打单系统咨询。
Q2：客户需要一票多件，一个主单号，3个子单号要怎么实现？
答案：看下使用的物流渠道的预报方式是否可以开启【按箱预报】，开启后，每个箱子都会出一个面单；按箱预报仅适用于备货中转出库（按箱出库）以及FBA退货出库（按换标装箱出库）。
Q3：渠道设置了按箱预报，备货中转出库选择按产品出库只会获取一个面单嘛？
答案：是的。
Q4：物流渠道已绑定仓库也设置了可用名单，但是OMS一件代发出库单时，选择不到对应的渠道？
答案：一件代发出库单的渠道列表不展示①按箱预报的自定义物流商渠道；②不支持客户上传物流面单的渠道。
Q5：为什么创建发货地址但是推送给打单系统的还是仓库地址？
答案：看下渠道是否有绑定多个仓库，发货地址是根据仓库进行创建的，如果绑定了多个仓库，发货地址设置的是A仓库，订单单据下单使用的是B仓库，那传给打单系统的还是仓库地址，不会按照发货地址执行。
Q6：为什么渠道停用了，OMS还是可以选择停用渠道下单？
答案：停用了，只代表这个特殊渠道不会在OMS页面被用户选到。但通过导入和openapi进单的方式还是会走到创建逻辑。
Q7：物流渠道的限制下单规则-物流跟踪号里-空格是属于特殊符号的吗？
答案：属于，一般是只勾选数字+字母.
Q8：怎么设置客户下单的时候必须填写跟踪号？
答案：在管理后台-物流渠道列表中针对这个渠道设置下单规则，设置物流跟踪号不为空。