本页说明“同步转单API和异步转单API的区别”的配置或排查方法。请先向代理、承运商或平台确认接口参数，再在易抵达系统中配置并测试。
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途：打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单，先测试成功后再用于正式批量操作。
- 进入菜单：报价管理，打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口，按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签，按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后，用测试运单执行打单、查价、抓轨迹或取消订单。
- 打单应返回转单号和面单；如失败，应能在接口日志中看到明确原因。
- 如果没有成功，请先查看接口日志中的请求报文和返回报错。
- 常见原因包括：账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
| 同步转单API |
异步转单API |
|
点击获取转单号或者打单界面勾选获取转单号保存，点击一次就会去请求一次，
如果第一次报错了，后续也需要重新点击，才会重新去请求单号
|
点击获取转单号之后，系统会立即抓取一次，
后续隔一段时间自动抓取一次，不需要再手动请求
|
| 同步转单API |
异步转单API |
| 点击获取转单号就会推送订单信息 |
不会推送订单信息，只会拿系统的单号去服务商系统查询这个单号的转单号 |
| 同步转单API |
异步转单API |
|
一般在一分钟以内，部分接口可能时间长一点（3-5分钟），
如果没获取到就会报错，注意日志中的报文信息
|
主要取决于服务商那边
- 如服务商已经获取到了单号，立即获取就可以获取到
- 如服务商未获取到，则隔一段时间重新获取，整体时效较长，可能在服务商获取单号之后的3-8个小时内去更新到
|