文档中心 > 常见问题

线上发货对接

更新时间:2020/05/07 访问次数:5224

AE物流API对接说明文档

线上发货基本流程

 

线上发货(预报)--> 声明发货(标记发货)--> 打印标签/面单(实际发货)

 

标记发货和打印发货标签可根据实际情况先后进行

平台线路模型

 

卖家声明发货时使用物流服务service_name,例如无忧标准的物流服务名称为CAINIAO_STANDARD

创建线上物流订单时使用的是物流服务仓库编码warehouse_carrier_service,例如无忧标准-燕文郑州仓的仓库编码为CAINIAO_STANDARD_TS_12350032

 

部分关键参数说明

  • 1、发货接口入参service_name,即获取平台支持的物流服务名称,

方式一:使用接口aliexpress.logistics.redefining.listlogisticsservice,返回结果中的result_list.service_name即为声明发货接口时需使用的service_name。

方式二:从平台给的公开文档中获取service_name,注意值要区分大小写。

文档链接:https://sale.aliexpress.com/zh/__pc/seller/shipping_methods_list.htm?spm=5261.8115697.2341.1.3085489bCV5scO

  • 2、获取仓库编码,即线上发货接口中的入参warehouse_carrier_service

目前平台没有给出一次获取所有仓库编码的接口,只能通过交易订单去获取当前订单可用的物流服务仓库编码列表。

接口名称:aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid( 根据交易订单获取线上发货物流服务列表 ),返回结果中的result_list.logistics_service_id即为线上发货接口中的入参logistic_carrier_service(注意两个字段名称不一样,但值是对应的)。

  • 3、国内快递参数与揽收地址id
场景

国内快递id

domestic_logistics_company_id

国内快递单号

domestic_tracking_no

国内快递公司

domestic_logistics_company

揽收地址pickup.address_id
上门揽收 -1 None 上门揽收 必填,345251
自寄到仓库 505 YT000011111 中通快递 不要传
自送到仓库 -1 None 自送 不要传
 

 

国内快递公司代码查询查询接口:

aliexpress.logistics.redefining.qureywlbdomesticlogisticscompany( 获取开展国内物流业务的物流公司 )

对应字段为:result_list.result.company_id

国内快递单号:是商家从商家货仓将商品寄送到发货物流仓库时用的快递单号,由商家自行与国内物流对接获取到的单号。

 

  • 4、trade_order_from,交易订单来源,一般默认传值ESCROW
  • 5、地址参数

sender发货地址参数必填,sender.address_id为后台设置的英文发货地址id,

refund退回地址参数必填,refund_address_id为后台设置的中文退回地址id,且地址为中国大陆地址。

pickup揽收地址参数根据物流订单是否由物流商揽收,若是揽收则必传pickup.address_id,否则不能传。

卖家地址id可使用接口查询:

接口名称:aliexpress.logistics.redefining.getlogisticsselleraddresses( 获取卖家地址 )

 

receiver收件地址,address_id不用穿,收件地址可从交易订单物流收件信息接口查询。

接口名称:aliexpress.trade.redefining.findorderreceiptinfo( 订单收货信息查询 ),其中,需注意收件地址中的street为街道(省市区街道里的街道,一般海外地址没有街道,不需要传street),收件地址详细信息应传到street_address.

 

打印发货标签或面单

发货标签和云打印的区别:

发货标签是旧式格式,尺寸为10cm X 10cm,发货标签中不包含收件人信息,需仓库换单后发出;云打印面单为升级面单格式,尺寸要求为10cm X 15cm,无需换单可直接发出。目前两种面单形式卖家选择其中一种打印发货即可。

获取发货标签相关接口:

aliexpress.logistics.redefining.getprintinfo( 获取线上发货标签 )

aliexpress.logistics.redefining.getprintinfos( 批量获取线上发货标签 )

标签样例:

 

 

商家物流常见问题

打印面单:

aliexpress.logistics.getpdfsbycloudprint( 面单云打印 )***需要对接菜鸟云打印组件***

面单样例:

 

 

 

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部