¶ 全运汇打单接口配置与使用指引
全运汇打单接口用于在易抵达中创建全运汇订单，并在订单处理完成后自动获取转单号和 PDF 面单。多箱订单返回多份面单时，系统会合并为一份 PDF，方便统一打印。
适用对象：负责报价、渠道和打单配置的操作人员。若下拉框显示“保护期内·请联系销售开通”，请先联系销售开通，开通前无法选择该模板。
¶ 一、使用前准备
请先向全运汇取得以下资料：
- 接口地址
- Open ID
- 产品编码
- 全运汇平台公钥
- 我方调用私钥
同时确认运单已填写完整的收件信息和每件货物的长、宽、高、实重。可下载以下示例进行核对：
安全提醒：私钥属于敏感信息，只能由授权人员保管和填写，不要通过群聊、邮件或截图传递。
¶ 二、创建全运汇转单 API 模板
¶ 步骤 1：进入转单 API
- 登录易抵达员工端。
- 进入“报价管理”。
- 点击页面上方的“转单API”。
- 在“报价对接设置”窗口确认当前标签为“转单API”。
- 点击“添加”。
¶ 步骤 2：填写基础信息
- 在“模板名称”中填写容易识别的名称，例如“全运汇打单”。
- 打开“模板”下拉框。
- 输入“全运汇”快速查找。
¶ 步骤 3：确认是否已经开通
如果“全运汇”显示为灰色，并带有“保护期内·请联系销售开通”提示，说明当前机构尚未开通，请先联系销售处理。开通后重新进入此页面，再选择“全运汇”。
¶ 三、填写参数设置
- 选择“全运汇”后，点击“参数设置”。
- 填写“接口地址”。
- 填写“Open ID”。
- 填写“产品编码”。
- 填写“全运汇平台公钥”。
- 填写“我方调用私钥”。
- 复核无误后，点击“确定”保存。
| 参数 | 如何填写 |
|---|---|
| 接口地址 | 填写全运汇提供的协议和域名，例如 https://api.example.com，不要自行拼接接口路径 |
| Open ID | 填写全运汇提供的 Open ID |
| 产品编码 | 填写全运汇提供的产品编码 |
| 全运汇平台公钥 | 填写 Base64 X.509 公钥正文，不包含 BEGIN/END 头尾和换行 |
| 我方调用私钥 | 填写 Base64 PKCS#8 私钥正文，不包含 BEGIN/END 头尾和换行 |
¶ 四、绑定到实际打单报价
¶ 步骤 1：打开代理成本报价
- 回到报价列表。
- 找到“类型”为“代理成本”的实际打单报价。
- 双击打开该报价。
¶ 步骤 2：绑定转单 API 模板
- 点击“转单API设置”。
- 打开“转单API模板”下拉框。
- 选择刚创建的全运汇模板。
- 点击“确认”保存。
只有绑定到实际打单报价后，订单选择该报价打单时，系统才会调用全运汇接口。
¶ 五、打单后的正常结果
- 系统先向全运汇创建订单。
- 订单创建成功后，系统会继续等待并获取转单号和面单。
- 面单尚未生成时，不需要重复打单，请稍后刷新或重新查看。
- 单箱订单会取得一份 PDF 面单。
- 多箱订单返回多份面单时，系统会合并为一份 PDF，并保留各箱转单号。
¶ 六、常见问题
¶ 1. 下拉框无法选择“全运汇”
看到“保护期内·请联系销售开通”时，请先联系销售开通。开通后退出当前编辑窗口，再重新进入选择。
¶ 2. 提示接口地址、Open ID、产品编码、公钥或私钥不能为空
说明参数设置未填写完整。返回模板的“参数设置”，逐项补齐后再试。
¶ 3. 提示缺少单件信息
检查运单是否至少有一件货物，并确认每件都填写了长、宽、高和实重。
¶ 4. 已创建订单，但暂时没有转单号或面单
全运汇面单为异步生成。请稍后刷新或重新查看，不要反复创建同一订单。
¶ 5. 多箱订单只有一个 PDF 文件
这是正常结果。系统会把多份 PDF 面单合并为一个文件，打开后按页打印即可。