电子面单api接口对接攻略(菜鸟、顺丰、快递鸟、拼多多)

时间:2024-02-20 10:20:47

目前我国电子面单的接口主要有四种方式,分别是快递公司电子面单接口、快递鸟电子面单接口、菜鸟电子面单接口和拼多多电子面单接口。

关于电子面单:

       电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字,打印速度比传统针式打印速度提升4~6倍。电子面单以接口形式嵌入到自己的系统、网站上,可以在自己的平台操作打印电子面单。

电子面单的应用主要包括电子面单接口和电子面单服务等内容,通过整合平台优化服务,可减少电子面单所受限制,使电子面单的应用更广泛使用更便捷优质。电子面单的单号是卖家向合作的快递公司去购买的。快递公司会给到一个号段,然后卖家在此号段之内,可以在电脑上打单操作。

电子面单样式:

目前我国电子面单的接口主要有四种方式,分别是快递公司电子面单接口、快递鸟电子面单接口、菜鸟电子面单接口和拼多多电子面单接口:

1、快递公司接口

由各个快递公司单独开发的接口,面向商家。商家需先注册账号申请对接,快递鸟与快递公司确定相应网点及具体信息,然后快递公司进行揽件派送,但商家每联系一家快递公司就需要进行一次对接。流程简便,但应用范围稍受限制,使用不同快递公司业务,需向各家快递公司申请对接。

2、菜鸟电子面单接口

菜鸟接口在使用时可一次对接四通一达、EMS、宅急送、德邦等十五家快递公司,但不能与顺丰对接。商家在网络上向菜鸟发起对接申请,菜鸟将服务申请转移到相应的快递公司,然后快递公司与商家联系确认具体的合作细节,热敏打印纸由快递公司提供,打印机即可由商家自行购买也可由相应网点提供。在打印从菜鸟网络生产的面单号后完成电子面单打印,快递公司相应网点进行揽件派送。

3、快递鸟电子面单接口

快递鸟接口同样可支持30多家快递公司(四通一达、百世、邮政、顺丰、德邦等),并且可与顺丰对接,与顺丰对接时可选择使用顺丰的电子面单服务或者快递鸟的电子面单服务。快递鸟为独立电商、仓储和物流等系统平台提供电子面单接口,客户在快递鸟网络上选择快递公司并进行在线发货。快递鸟在接收由快递公司得到的数据之后,通知相应快递公司的合适网点进行揽收派送。在下单成功后,快递鸟还可进行快递路径的监控,方便客户查看。

4、拼多多电子面单接口

拼多多接口是拼多多2019年新开发的物流业务(主要针对拼多多商家),目前已经接入了三通一达(圆通、申通、中通、韵达)、百世、邮政。商家在网络上向拼多多发起对接申请,拼多多将服务申请转移到相应的快递公司,然后快递公司与商家联系确认具体的合作细节。

菜鸟快递鸟的电子面单接口平台的适用范围广泛,免去了商家使用各家快递公司的电子面单时分别对接各个快递公司的繁琐,他们的业务既有重叠又有各自突出的特点和适用性,为不同需求的客户提供相应的快递服务。

接口定义及说明

由于,当前快递鸟支持的电子面单接口相对于其他家的有一定优势;所以以下主要以快递鸟为例进行展开阐述一一说明。 Api接口请求地址:快递鸟

请求方式:POST 

编码:UTF-8

系统级参数(公共参数)

请求示例:

{
                          "OrderCode": "012657018199",
                          "ShipperCode": "SF",
                          "PayType": 1,
                          "MonthCode": "1234567890",
                          "ExpType": 1,
                          "Cost": 1.0,
                          "OtherCost": 1.0,
                          "Sender": {
                            "Company": "LV",
                            "Name": "Taylor",
                            "Mobile": "15018442396",
                            "ProvinceName": "上海",
                            "CityName": "上海市",
                            "ExpAreaName": "青浦区",
                            "Address": "明珠路"
                          },
                          "Receiver": {
                            "Company": "GCCUI",
                            "Name": "Yann",
                            "Mobile": "15018442396",
                            "ProvinceName": "北京",
                            "CityName": "北京市",
                            "ExpAreaName": "朝阳区",
                            "Address": "三里屯街道"
                          },
                          "Commodity": [
                            {
                              "GoodsName": "鞋子",
                              "GoodsQuantity": 1,
                              "GoodsWeight": 1.0
                        },
                        {
                           "GoodsName": "衣服",
                           "GoodsQuantity": 1,
                           "GoodsWeight": 1.0
                        },
                          ],
                          "AddService": [
                            {
                              "Name": " INSURE ",
                              "Value": "1000"
                        },
                            {
                              "Name": "COD",
                              "Value": "1020"
                        " CustomerID ": "1234567890"
                            }
                          ],
                          "Weight": 1.0,
                          "Quantity": 1,
                          "Volume": 0.0,
                          "Remark": "小心轻放"
                        }

  返回示例:

失败:
                           {
                              "EBusinessID": "1237100",
                              "ResultCode": "106",
                              "Reason": "该订单号已下单成功",
                              "UniquerRequestNumber":"5e66486b-8fbc-4131-b875-9b13d2ad1354"
                          }

                  成功:
                         {
                            "EBusinessID": "1237100",
                            "Order": {
                              "OrderCode": "012657700387",
                              "ShipperCode": "HTKY",
                              "LogisticCode": "50002498503427",
                              "MarkDestination": "京-朝阳(京-1)",
                              "OriginCode": "200000",
                              "OriginName": "上海分拨中心",
                              "PackageCode": "北京"
                            },
                            "PrintTemplate":"此处省略打印模板HTML内容",
                            "EstimatedDeliveryTime":"2016-03-06",
                            "Success": true,
                            "ResultCode": "100",
                            "Reason": "成功"
                          }

  更多demo可登录快递鸟查询