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

2、点击转单 API-添加

1、模板选择ICCE,获取方式选择同步
- 支持自拟模板名称,便于后续查找
- 支持指定公司权限
- 支持最大并发数量限制,避免数据过载状态,详情可见打单接口的并发控制

2、切换至参数设置
- 填入ICCE的API域名、用户id、用户账号密码等信息
- 填入产品代码(两种维度区分:磅内和磅上 支持SCAN FORM和非SCAN FORM)、仓库代码、操作中心编码、目的地代码、交接地代码、交接地仓库代码等可以根据需要咨询代理获取(根据产品代码是否支持SCAN FORM来判断)
- 是否需要scanform:如果客户需要获取SCAN FORM则必须选择是,否则无法成功获取
- 预报时机:下单后预报(下单后自动预报推送给usps对应系统中直接打单即可),封包后预报(下单后不会自动预报,需要组成大包封包后才会自动预报)
- 是否将预约送仓时间作为shipdate:需要SCAN FORM的就需要封包,那么封包时间必须和包内所有运单下单时指定的shipdate(美国东部时间)一致才能封包成功
- 在批量修改中指定预约送仓时间,并且在运单时间栏中查看,也可在表头设置列表展示

3、切换至发件人信息
- 如果需要获取SCAN FORM,代理要求包内所有运单的发件人信息必须要统一(会打印在SCAN FORM上),收件人信息代理会自动根据各个运单下单时信息去获取,因此我们只需要保证发件人信息一致即可

4、建立打单接口之后,绑定打单接口进行打单,将会出转单面单。(非SCAN FROM到这一步就算结束了)

1、创建大包---生成包号

2、菜单-进入包号页面

3、封包
- 代理面单选择ICCE,即可正常得到SCAN FORM

1、新建运单回传

2、绑定运单回传

3、选中运单,点击清除转单号按钮

Q1 :打单出现"客户[xxxx]针对产品[xxxx]的报价明细未设置?
A1: 说明重量与产品代码不一致,需检查当前使用的是磅内(1磅以内)还是磅上的产品代码,如图,当前运单重量为1,但是产品代码选择的是磅内,就会出现该错误

Q2:封包时出现指定时间不对?
A2 当前美国东部时间与下单时指定的交货时间不一致,可以查看运单报文中的shipdate参数查看下单时指定的交货时间

Q3 :创建大包出现[code=-1]PkgBarcode(s) specified with EntryZip code(s) that do not match EntryFacility (32218) in the SCAN request.错误?
A3: 说明邮编与仓库代码不一致
- 如仓库代码为USPS_YKM_90052_90640_HK,那么正确的邮编应该是90640