本页说明“对接Yywexpress_fedex操作指南”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 打单对接
¶ 入口
菜单-报价管理-转单API
¶ 操作流程
1、进入报价管理页面，点击转单API
- 打开转单API页面，点击新建，填写必要参数
| 参数名称 | 描述 |
| 模板名称 | 自拟，以便后续对接查找 |
| 模板 | 选择Yywexpress_fedex |
| 获取模式 | 同步 |
2、切换至参数设置tab，填写必要的参数
| 参数名称 | 描述 |
| 域名、账号、userld、密码、账户渠道ID、出货地、扣款账户余额类型 | 均需要找代理提供 |
¶ 打单成功效果图
¶ 二次确认面单接口
¶ 入口
菜单-报价管理-运单回传
确认面单接口，支持客户二次获取调用确认面单接口重新获取标签（首次获取换单号代理返回临时面单和单号，二次获取换单号，返回联邦面单和单号）
¶ 操作流程
1、进入报价管理页面，点击转单API，点击运单回传-添加
2、打开运单回传页面，点击添加，填写必要参数
| 参数名称 | 描述 |
| 模板名称 | 自拟，以便后续对接查找 |
| API名称 | 选择Yywexpress_fedex |
| 域名、账号密码、userld | 询问代理提供 |
3、打开需要二次确认面单的发货渠道绑定的换单api设置进行配置推单前脚本
第一次获取换单号，转单回传/清除换单号按钮触发确认面单回传，然后第二次获取换单时，通过脚本判断是否回传成功，如果回传成功就切换成Label字段，否则使用markLabel
//推单前脚本
if ("true".equals($yunDanEntity.getExtraJson().getString("callbackSucc"))) {
$yunDanEntity.getZhuanDanApiEntity().put("labelField", "label");
} else {
$yunDanEntity.getZhuanDanApiEntity().put("labelField", "markLabel");
}
¶ 二次确认面单成功效果图
