¶ 功能说明
本文档为易抵达物流系统中，配置「FlexHaul 转单 API」的标准化操作指南。
配置完成后，系统可将运单信息推送至 FlexHaul，并从 FlexHaul 获取转单号和面单，适用于需要通过 FlexHaul 进行打单的业务场景。
¶ 一、入口
登录易抵达系统，按以下路径进入配置页面：
菜单 → 报价 → 报价管理
¶ 二、操作流程
¶ 步骤 1：进入转单 API配置页面
1.进入「报价管理」页面，点击顶部标签栏的「转单 API」。
2. 点击「添加」按钮，新建转单 API 配置。
¶ 步骤 2：基础信息配置（「基本」标签页）
在「编辑设置」弹窗中，切换至「基本」标签页，按以下规则完成配置：
- 模板类型：选择「FlexHaul」。用于指定当前转单 API 配置对应 FlexHaul 打单接口。
- 模板名称：自定义填写。建议填写容易识别的名称，例如：FlexHaul打单、FlexHaul-USPS、FlexHaul-UPS。
- 获取模式：同步
- 其他字段：如页面存在备注、启用状态等字段，可按实际业务填写；无特殊要求时保持默认即可。
¶ 步骤 3：API 参数配置（「参数设置」标签页）
切换至「参数设置」标签页，填写 FlexHaul API 对接参数。
- 域名：填写代理给的域名信息，生产环境通常填写：api.flexhaul.ai，沙箱环境通常填写：api-sandbox.flexhaul.ai，注意：这里只填写域名，不要填写 /auth/login、/v1/label/submit、/v1/label/result 等接口路径。
- 登录邮箱：填写 FlexHaul 提供的登录邮箱，对应 FlexHaul 登录接口的 email
- 登录密码：填写 FlexHaul 提供的登录密码，对应 FlexHaul 登录接口的 password
- 承运商代码：承运商代码对应 carrier，填写 FlexHaul 提供的承运商代码。常见示例：usps、ups、fedex、gofo、greatway。具体代码请以 FlexHaul 或代理提供的信息为准
- 服务代码：服务代码对应 serviceType，示例：UPS 可填写 03，USPS 可填写 PRIORITY_MAIL。具体服务代码请以 FlexHaul 或代理提供的信息为准。
- 店铺标识：店铺标识对应 externalKey，该字段对应 FlexHaul 的 external_key，可用于区分客户或店铺。如果 FlexHaul 或代理没有特殊要求，可以不填
- 参数填写完成后，点击「保存」
¶ 步骤 4：绑定代理成本价格
进入代理成本价格配置页面，在「转单API设置」中选择刚刚配置好的 FlexHaul 转单 API，并保存。
绑定完成后，对应代理价格即可使用该 FlexHaul 转单 API 获取转单号。
¶ 三、打单功能验证
¶ 步骤 1：进入运单页面
进入运单管理页面，找到需要获取转单号的运单
¶ 步骤 2：执行获取转单号
选择需要打单的运单，点击「获取转单号」。系统会将运单信息推送至 FlexHaul。FlexHaul 返回成功后，系统会回填转单号和面单。
¶ 步骤 3：查看打单结果
打单成功后，可在运单页面查看转单号和面单信息
¶ 四、注意事项
1.运单信息需要完整。打单前请确认运单中的收件人信息、地址信息、国家、邮编、重量、尺寸等资料完整。如果运单资料不完整，FlexHaul 可能会返回打单失败。
2.重量和尺寸单位：系统推送给 FlexHaul 的重量单位为 kg，尺寸单位为 cm，客户无需在 FlexHaul 参数中单独配置。
3.承运商代码和服务代码必须准确，需要和 FlexHaul 或代理提供的信息保持一致。如果填写错误，可能会导致获取转单号失败。
4.域名不要填写完整接口路径，只填写 api.flexhaul.ai 或 api-sandbox.flexhaul.ai。系统会自动拼接登录、提交打单、查询面单结果等接口路径。