物流授权
一、功能概述
物流授权 将用户与其合作的物流服务商账号接入DSFulfill系统的过程，授权成功后该账号即可用于申请运单。
货代名称 授权时自定义填写的账号别名，用于在系统内区分同一物流商下的多个授权账号。
渠道 授权账号下由物流商开放、可用于发货的具体运输产品线，需在授权成功后点击"拉取渠道"获取，拉取到的数量即为该账号下可用渠道总数。
物流映射 将本地已授权渠道与销售平台（如Shopify）的物流商名称、追踪网址对应设置的功能，用于运单发出后向平台回传正确的物流商信息和轨迹查询地址。
二、操作流程
进入"物流授权"页面 → 在物流商列表中找到目标物流商，点击"添加授权" → 在弹窗中按该物流商要求填写货代名称、请求Url、客户编号、秘钥等资料（不同物流商所需字段不完全相同，需向对应物流商的业务方获取）→ 点击"确认"提交 → 授权成功后该物流商行展开为账号列表，点击"拉取渠道"，渠道数量显示大于0即为授权成功 → 如需修改可点击"编辑"，需移除可点击"删除" → 如接入Shopify等销售平台，可点击"物流映射"设置运单信息回传规则（可选）。
授权并拉取渠道成功后，该渠道即可在"渠道设置"模块的运费模板中被选用对接申请运单，具体操作详见《渠道设置》文档。
若列表中没有所需物流商，可点击"没有您想要的物流商？"，按"联系客服 → 提供API对接文档及测试密钥 → 开发排期"三步发起定制对接申请。
物流授权列表 → 添加授权(填写资料) → 确认提交 → 拉取渠道(数量>0=成功) → [可选]物流映射
三、操作指南
3.1 添加物流授权账号
【操作步骤】
- 在物流商列表中找到目标物流商，点击其"操作"列的"添加授权"。
- 在"授权"弹窗中填写"货代名称"（自定义账号别名）。
- 填写"请求Url"（该物流商的API请求地址）。
- 填写"客户编号"（物流商业务部门提供的客户身份唯一标识编号）。
- 填写"秘钥"（申请物流商API接口服务时由其业务部门提供的密钥）。
- 选择"物流面单备注内容"（面单展示格式，如"sku+数量"或"sku+规格+数量"）。
- 点击"确认"完成添加。
【界面说明】弹窗标题为"授权"，货代名称、请求Url、客户编号、秘钥为必填项（红色星号标注）；部分物流商名称旁附"授权教程"链接。
重要提示：不同物流商所需的授权字段不完全一致，具体的请求Url、客户编号、秘钥需联系对应物流商业务方获取，不能沿用其他物流商的信息。
3.2 拉取渠道
【操作路径】设置> 物流授权 【操作步骤】
- 授权成功后，点击物流商名称左侧箭头展开账号列表。
- 在账号操作列点击"拉取渠道"。
- 拉取完成后，"渠道数量"列显示该账号下的可用渠道总数。
【界面说明】账号列表含"货代名称""渠道数量""状态"（开关，控制账号启用/停用）"操作"（编辑、删除、拉取渠道、物流映射）四列。
重要提示：渠道数量大于0即代表授权成功；若为0，需点击"编辑"核对授权资料是否正确并重新拉取。
3.3 编辑与删除授权账号
【操作步骤】
- 展开账号列表后，点击目标账号"操作"列的"编辑"。
- 在弹窗中核对或修改货代名称、请求Url、客户编号、秘钥、物流面单备注内容。
- 点击"确认"保存。
- 如需移除该授权，点击"操作"列的"删除"。
【界面说明】编辑弹窗标题为"编辑--[物流商名称]"，字段与添加授权一致，已回显此前填写内容。
3.4 设置物流映射（接入Shopify平台适用）
【操作步骤】
- 在已授权账号操作列点击"物流映射"。
- 在"平台物流映射"弹窗中选择"本地渠道"（本次授权拉取到的渠道）。
- 选择"国家"（默认"所有国家"，可按国家单独设置）。
- 选择"对应平台物流"（该渠道在Shopify上对应的物流商名称）。
- 如需自定义查询地址，填写"追踪网址"。
- 如需配置多条规则，点击"加一行"新增。
- 点击"保存"完成设置。
重要提示：不配置物流映射时，Shopify默认使用17Track进行轨迹查询；配置对应平台物流（如DHL、UPS）后，Shopify会自动识别该运单所属快递公司，客户在Shopify订单页点击运单号即可直接跳转至对应快递商的官方轨迹查询页面。
四、注意事项
- 不同物流商所需的授权字段不完全相同，具体资料需向该物流商的服务方获取，不可套用其他物流商的信息。
- 拉取渠道后渠道数量大于0才代表授权成功，否则需检查并修正授权资料。
- 物流映射为可选设置，仅在接入Shopify等需要向平台回传运单号及快递公司信息的销售渠道时需要配置。
- 授权成功并拉取渠道后，渠道才可在"渠道设置"模块的运费模板中被选用。
五、状态说明
- 状态开关（开启）：该授权账号处于启用状态，可在渠道设置中被选用。
- 状态开关（关闭）：该授权账号已停用，其渠道不可在渠道设置中选用。
- 渠道数量为0：该账号尚未成功拉取到渠道，需核对授权资料后重新拉取。
六、常见问题（FAQ）
Q：点击"添加授权"后拉取渠道显示渠道数量为0，是什么原因？
A：通常是填写的请求Url、客户编号、秘钥等信息有误。请联系物流商业务方核对资料，通过"编辑"更新后再次点击"拉取渠道"。
Q：不同物流商需要填写的授权信息都一样吗？
A：不一样。每家物流商所需字段（如请求Url、客户编号、秘钥等）可能不同，以实际弹窗展示的字段为准，并向对应物流商索取相应资料。
Q：不设置物流映射会有什么影响？
A：不影响运单正常发出，但Shopify端会默认使用17Track进行轨迹查询，无法自动识别并跳转至实际承运商（如DHL、UPS）的官方查询页面。
Q：列表中找不到我要合作的物流商怎么办？
A：可点击"没有您想要的物流商？"发起定制物流服务商API接口对接，按"联系客服→提供API对接文档及测试密钥→开发排期"流程处理，年费用户3个工作日完成，月付用户5~7个工作日完成，开发对接不收取额外费用。