本页说明“对接AnnShip操作指引”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
¶ 适用场景
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
¶ 操作前准备
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
¶ 操作步骤
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
¶ 检查结果
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
¶ 原操作截图和补充说明
¶ 查价
¶ 入口
菜单-报价管理-进入报价列表页面
¶ 操作流程
1、进入报价管理页面，点击运费API，点击新增运费API
2、选择类型，并填写API名称
| 参数名称 | 说明 |
| 类型 | AnnShip |
| 名称 | 自拟，以便后续对接查找 |
3、切换至参数tab，填写API配置参数-保存运费API
| 参数名称 | 说明 |
|
API域名、apitoken、nickname、ownername、 maitype、owner、serviceprovider、servicelevel、signatureconfirmation、uspsUserld |
请咨询代理后填写 |
4、进入查价界面查价
菜单-价格查询-进入查价页面
5、代理-运费API查价-选择创建的运费API
6、填写收发件人信息
7、填写单件尺寸重量卡板信息-点击查询
- 支持在查询前勾选：返回失败结果（当查价结果没有返回的时候会提示查价失败原因）
¶ 成功效果
¶ 打单
¶ 入口
菜单-报价管理-转单API
¶ 操作流程
1、菜单-报价管理-进入报价列表页面-点击转单API-添加
2、填写基本参数
| 参数名称 | 说明 |
| 模板名称 | 自拟，以便后续对接查找 |
| 模板 | AnnShip |
| 获取模式 | 选择 同步 |
3、切换至参数设置-询问代理填写对应参数
- 所有选项均需要代理提供
| 参数名称 | 说明 |
|
域名、token、nickname、owner、ownername labelfiletype、mailitype、serviceprovider、servicelevel |
请咨询代理后填写 |
¶ 打单成功效果
- 当用户完成操作后，将会自动生成对应文件
¶ 取消订单
¶ 入口
菜单-报价管理-进入报价列表页面
¶ 操作流程
1、菜单-报价管理-点击转单API进入运单回传页面-添加
2、
| 参数名称 | 说明 |
| 模板名称 | 自拟，以便后续对接查找 |
| API名称 | 搜索并选择 AnnShip |
- 创建成功后，将会在运单回传列表生成新的对接参数，记住编号/模板名，便于下步对接
3、双击该代理的发货渠道-基本-绑定运单回传
4、选中已经打出单了然后需要取消运单的订单，点击清除转单号
¶ 成功效果
- 日志查看运单推送成功，事件：清除转单号，代表取消订单成功
另外：AnnShip取消运单还有另一种方式可以取消运单：
客户对接我们系统的api下单调用删除运单接口的时候也会触发AnnShip代理取消运单接口，但这个取消运单方式想要看到效果只能去看代理系统有没有取消，我们系统里没有取消报文可看的，并且这个方式是少部分人业务需要的针对性功能操作，详情可咨询客服。
