本页说明“对接菜鸟spain操作指南”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 打单
¶ 入口
菜单-报价管理-转单API
¶ 操作流程
1、菜单-报价管理-进入报价列表页面-点击转单API-添加
2、填写基本参数
| 参数名称 | 说明 |
| 模板名称 | 自拟填写 |
| 模板 | 选择菜鸟Spain |
| 获取模式 | 选择同步 |
3、切换至参数设置-询问代理填写对应参数
- 所有选项均需要代理提供
¶ 成功效果
¶ 轨迹回传
¶ 入口
菜单-报价管理
¶ 操作流程
1、进入菜单-报价管理页面
- 点击转单API，选择轨迹回传，点击添加
2、输入配置参数
| 参数名称 | 备注 | |
| 模板名称 | 自拟 | |
| API名称 | 选择-菜鸟 | |
| 地址、appSecret、transportType、msg_type、资源code、Op Code、deliveriedTimes | 联系代理提供 | |
| 退件信息 | 根据自己退回件地址填写 | |
3、自定义条件(公式)、轨迹状态，若想添加多个判定条件回传轨迹，添加多行进行配置即可
举例，
1）运单有轨迹描述：离开
条件公式可配置为
：T(com.itdida.core.utils.StringUtils).containsAny(miaoShu,'离开')2）如果描述包含“派送成功”，
将公式中的“离开”改成“派送成功”即可：
（T(com.itdida.core.utils.StringUtils).containsAny(miaoShu,'派送成功')当前位置公式、时间公式、时区公式各种自定义回传的可咨询客服提供
4、进入报价管理页面，找到对应的运单发货渠道，双击进入编辑
- 在基本tab中将轨迹回传绑定刚才配置好的轨迹回传API
5、在主页选中运单，点击下方的重推轨迹；点击确定提示弹窗；
6、重推成功后，会有小图标进行差异化标识；
- 在文件tab中，找到“轨迹回传轨迹添加”这个文件名
- 点击右侧图标进行查看
7、确认报文有请求，即表示回传完成
¶ 成功效果
¶ 封包
¶ 入口
主页面-生成包号
¶ 操作流程
1、主页面生成包号后，从菜单进入到包号页面
2、选择生成的对应包号-点击封包
| 参数名称 | 说明 |
| 包号条码 | 不选，按照默认选项即可 |
| 封包API设置 | 选择对应菜鸟打单出单的转单api |
¶ 成功效果
