本页说明“对接Region Service打单接口”的配置或排查方法。请先向代理、承运商或平台确认接口参数,再在易抵达系统中配置并测试。
- 需要在系统中配置打单或转单接口。
- 需要将接口绑定到代理成本价、发货渠道、运单操作或自动抓取流程。
- 需要排查获取转单号、面单、轨迹、查价或取消订单失败的问题。
- 准备代理或平台提供的接口账号、密钥、客户代码、产品代码、渠道代码、发件人信息等参数。
- 确认接口用途:打单、查价、轨迹、取消订单、无纸化、危险品或运单回传。
- 确认代理档案、成本价、发货渠道和必要的报价参数已经维护。
- 准备一票测试运单,先测试成功后再用于正式批量操作。
- 进入菜单:报价管理,打开转单 API、运费 API、轨迹接口或对应配置页面。
- 新增或编辑接口,按代理提供的信息填写参数。
- 如果页面有参数设置、自定义功能、无纸化、危险品、发件人或渠道代码等页签,按业务要求逐项确认。
- 将接口绑定到对应代理成本价、发货渠道或业务规则。
- 保存后,用测试运单执行打单、查价、抓轨迹或取消订单。
- 打单应返回转单号和面单;如失败,应能在接口日志中看到明确原因。
- 如果没有成功,请先查看接口日志中的请求报文和返回报错。
- 常见原因包括:账号密钥错误、渠道代码不匹配、国家/邮编/重量不符合代理规则、发件人或申报信息缺失。
菜单-报价管理
1、菜单-报价管理-进行报价列表页面

2、点击转单 API-添加

3、模板选择RegionService,获取方式选择同步
- 支持自拟模板名称,便于后续查找
- 支持指定公司权限
- 支持最大并发数量限制,避免数据过载状态,详情可见打单接口的并发控制
4、切换至参数设置
- 填入RegionService的API域名、账号、税号账号
- 服务类型(Service Type)、包裹类型(Package Type)、取件方式、重量单位(默认KG)、尺寸单位(默认IN)、标签格式类型、发货原因、标签纸类型(具体支持类型可以询问代理)

5、建立打单接口之后,绑定打单接口进行打单,将会出转单面单。
面单参考样式
1、新建运单回传

2、绑定运单回传

3、清除转单号

Q1 打单出现请求参数缺失错误?
A1 收发件人的公司、人名、地址、电话、国家、城市、省/州、邮编必填。
Q2 出现如图错误?
A2 手机号长度不符,正常应该是10位数字。
Q3 出现如图错误?
A3 当前目的地不支持该服务类型,需要向代理确认当前的服务类型与是否支持当前收发件目的地
Q4 出现如图错误?
A4 当前邮编与国家不匹配,需检查 国家、城市、邮编是否正确对应