本页说明“对接aly操作指南”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 打单操作流程
¶ 入口
菜单-报价管理-转单API
¶ 配置参数
1、进入报价页面
2、添加转单API，填写对应参数
| 参数名称 | 说明 |
| 模板名称 | 自拟；以便后续绑定查找 |
| 模板 | 选择aly |
| 获取模式 | 选择同步 |
3、切换至参数设置，填写数据
该页面所有参数会根据不同的路线进行填写，均需要咨询代理填写
4、进入报价管理主列表，双击对应的发货渠道进行编辑
- 切换至转单API设置页面，绑定新增的转单api，点击确认保存即生效
¶ 打单以及结果
- 选中对应的运单，操作获取转单号后，出现打单结果
- 成功获取到转单号
- 成功打单效果
¶ 轨迹操作流程
¶ 入口
菜单-轨迹接口
¶ 配置
1、进入轨迹接口设置页面
2、选择aly接口
| 参数名称 | 说明 |
| 接口 | 自拟；选择aly后续绑定查找 |
| 上网关键字、上网排除关键字、签收关键字、签收排除关键字 | 需更改根据抓取轨迹更改系统运单状态的话，设置以下设置： |
| 抓取条件 | 可以设置在那个运单状态下可以抓取轨迹 |
3、参数设置，咨询代理
该页面参数会根据不同的路线进行填写，均需要咨询代理填写
4、选中对应的运单，点击轨迹对接设置，选择新建的轨迹接口，单号类型选择转单号
- 完成参数保存后，点击立即抓取轨迹，即可获取对应的轨迹信息
¶ 结果以及报文
¶ 获取代理包号和面单设置流程
¶ 对接流程
1、选择运单-点击生成包号批号
2.点击包号，选择包号点击封包-选择代理面单
- 操作封包，选择对应参数后点击确认
¶ 成功效果
