电子面单

第三方服务商
价格:会员免费  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

支持电子面单的快递公司:顺丰、邮政快递包裹、中铁快运、邮政国内标快、全一

创建订单信息


接口地址:http://route.showapi.com/1625-8 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。 
文件上传的POST时,enctype=multipart/form-data。 

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起 

参数名称类型默认值示例值必须描述
memberIDString  ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识,用于区分其用户
monthCodeString  顺丰月结卡号(选填)
customAreaString  商家自定义区域
wareHouseIDString  发货仓编码
transTypeString1 运输方式 1- 陆运 2- 空运
comString  快递公司编码
nuString  快递单号(仅宅急送可用)
thrOrderCodeString  第三方订单号 (com为jingdong且expType为1时必填)
orderCodeString  订单编号(自定义,不可重复)
payTypeString  邮费支付方式:1-现付,2-到付,3-月结,4-第三方支付(仅shunfeng支持)
expTypeString  快递类型:1-标准快件 ,详细快递类型参考《快递公司快递业务类型.xlsx》
isReturnSignBillString  是否要求签回单 1- 要求 0-不要求
operateRequireString  签回单操作要求(如:签名、盖章、身份证复印件等)
costString  快递运费
otherCostString  其他费用
receiver_CompanyString  收件人公司
receiver_NameString  收件人
receiver_TelString  (电话)电话与手机,必填一个
receiver_MobileString  (手机)电话与手机,必填一个
receiver_PostCodeString  收件人邮编
receiver_ProvinceNameString  收件省 (如广东省,不要缺少“省”;如是直辖市,请直接传北京、上海等; 如是自治区,请直接传广西壮族自治区等)
receiver_CityNameString  收件市(如深圳市,不要缺少“市”; 如果是市辖区,请直接传北京市、上海市等)
receiver_ExpAreaNameString  收件区/县(如福田区,不要缺少“区”或“县”)
receiver_AddressString  收件人详细地址
sender_CompanyString  发件人公司
sender_NameString  发件人
sender_TelString  (电话)电话与手机,必填一个
sender_MobileString  (手机)电话与手机,必填一个
sender_PostCodeString  发件地邮编(com为youzhengguonei、gnxb时必填)
sender_ProvinceNameString  发件省 (如广东省,不要缺少“省”; 如是直辖市,请直接传北京、上海等; 如是自治区,请直接传广西壮族自治区等)
sender_CityNameString  发件市(如深圳市,不要缺少“市; 如是市辖区,请直接传北京市、上海市等”)
sender_ExpAreaNameString  发件区/县(如福田区,不要缺少“区”或“县”)
sender_AddressString  发件人详细地址
isNoticeString1 是否通知快递员上门揽件 
0-通知 1-不通知
startDateString  上门取货开始时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同
endDateString  上门取货结束时间段:"yyyy-MM-dd HH:mm:ss"格式化,本文中所有时间格式相同
weightString  包裹总重量kg 当为快运的订单时必填,不填时将根据各个快运公司要求传对应的默认值
quantityString  包裹数(最多支持30件) 一个包裹对应一个运单号,如果是大于1个包裹,返回则按照子母件的方式返回母运单号和子运单号
volumeString  包裹总体积m3 当为快运的订单时必填,不填时将根据各个快运公司要求传对应的默认值
remarkString  备注
addServicesString [{"name":"增值服务名称(数组形式,可以有多个增值服务)","value":"增值服务值",customerID:" 客户标识(选填)"},{……多个增值同上……},{……}]增值服务
[{"name":"增值服务名称(数组形式,可以有多个增值服务)","value":"增值服务值",customerID:" 客户标识(选填)"},{……多个增值同上……},{……}]
commoditysString [{"goodsName":"商品名称" ,"goodsCode":"商品编码" ,"goodsquantity":"商品数量" ,"goodsPrice":"商品价格" ,"goodsWeight":"商品重量kg" ,"goodsDesc":"商品描述" ,"goodsVol","商品体积m3"},{……多个商品同上……},{……}]商品信息
[{"goodsName":"商品名称" ,"goodsCode":"商品编码" ,"goodsquantity":"商品数量" ,"goodsPrice":"商品价格" ,"goodsWeight":"商品重量kg" ,"goodsDesc":"商品描述" ,"goodsVol","商品体积m3"},{……多个商品同上……},{……}]
isReturnPrintTemplateString  返回电子面单模板:0-不需要;1-需要
isSendMessageString  是否订阅短信:0-不需要;1-需要
templateSizeString  模板规格(默认的模板无需传值,非默认模板传对应模板尺寸)
packingTypeString  包装类型(快运字段)默认为0; 0- 纸 1- 纤 2- 木 3- 托膜 4- 木托 99-其他
deliveryMethodString0 送货方式(快运字段):0- 自提 1- 送货上门(不含上楼) 2- 送货上楼
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1625-8","my_appId","my_appSecret") .addTextPara("memberID","") .addTextPara("monthCode","") .addTextPara("customArea","") .addTextPara("wareHouseID","") .addTextPara("transType","") .addTextPara("com","") .addTextPara("nu","") .addTextPara("thrOrderCode","") .addTextPara("orderCode","") .addTextPara("payType","") .addTextPara("expType","") .addTextPara("isReturnSignBill","") .addTextPara("operateRequire","") .addTextPara("cost","") .addTextPara("otherCost","") .addTextPara("receiver_Company","") .addTextPara("receiver_Name","") .addTextPara("receiver_Tel","") .addTextPara("receiver_Mobile","") .addTextPara("receiver_PostCode","") .addTextPara("receiver_ProvinceName","") .addTextPara("receiver_CityName","") .addTextPara("receiver_ExpAreaName","") .addTextPara("receiver_Address","") .addTextPara("sender_Company","") .addTextPara("sender_Name","") .addTextPara("sender_Tel","") .addTextPara("sender_Mobile","") .addTextPara("sender_PostCode","") .addTextPara("sender_ProvinceName","") .addTextPara("sender_CityName","") .addTextPara("sender_ExpAreaName","") .addTextPara("sender_Address","") .addTextPara("isNotice","") .addTextPara("startDate","") .addTextPara("endDate","") .addTextPara("weight","") .addTextPara("quantity","") .addTextPara("volume","") .addTextPara("remark","") .addTextPara("addServices","[{\"name\":\"增值服务名称(数组形式,可以有多个增值服务)\",\"value\":\"增值服务值\",customerID:\"\t客户标识(选填)\"},{……多个增值同上……},{……}]") .addTextPara("commoditys","[{\"goodsName\":\"商品名称\" ,\"goodsCode\":\"商品编码\" ,\"goodsquantity\":\"商品数量\" ,\"goodsPrice\":\"商品价格\" ,\"goodsWeight\":\"商品重量kg\" ,\"goodsDesc\":\"商品描述\" ,\"goodsVol\",\"商品体积m3\"},{……多个商品同上……},{……}]") .addTextPara("isReturnPrintTemplate","") .addTextPara("isSendMessage","") .addTextPara("templateSize","") .addTextPara("packingType","") .addTextPara("deliveryMethod","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口 
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
ret_code String 接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
ebusinessID String 用户ID
order Object[] 订单信息
-  orderCode String 订单编号
-  com String 快递公司编码
-  nu String 快递单号
-  markDestination String 大头笔
-  originCode String 始发地区域编码
-  originName String 始发地/始发网点
-  destinatioCode String 目的地区域编码
-  destinatioName String 目的地/到达网点
-  sortingCode String 分拣编码
-  packageCode String 集包编码
-  packageName String 集包地
-  destinationAllocationCentre String 目的地分类
success String 成功与否(true/false)
signWaybillCode String 签回单单号
resultCode String 返回编码
reason String 失败原因
uniquerRequestNumber String 唯一标识
printTemplate String 面单打印模板内容(html格式)
estimatedDeliveryTime String 订单预计到货时间yyyy-mm-dd
subCount String 子单数量
subOrders String 子单单号
subPrintTemplates String 子单模板内容(html格式)
signBillPrintTemplate String 签回单模板内容(html格式)
receiverSafePhone String 收件人安全电话
senderSafePhone String 寄件人安全电话
dialPage String 拨号页面网址(转换成二维码可扫描拨号)
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "", "ebusinessID": "", "order": "[]", "success": "", "signWaybillCode": "", "resultCode": "", "reason": "", "uniquerRequestNumber": "", "printTemplate": "", "estimatedDeliveryTime": "", "subCount": "", "subOrders": "", "subPrintTemplates": "", "signBillPrintTemplate": "", "receiverSafePhone": "", "senderSafePhone": "", "dialPage": "" } }

取消订单信息


接口地址:http://route.showapi.com/1625-9 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
com String
快递公司编码
orderCode String
订单编号
nu String
快递单号
customerName String
电子面单客户号
customerPwd String
电子面单密码
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1625-9","my_appId","my_appSecret") .addTextPara("com","") .addTextPara("orderCode","") .addTextPara("nu","") .addTextPara("customerName","") .addTextPara("customerPwd","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
eBusinessID String
用户ID
success String
成功与否(true/false)
resultCode String
返回编码
reason String
失败原因
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "", "eBusinessID": "", "success": "", "resultCode": "", "reason": "" } }

订单跟踪


接口地址:http://route.showapi.com/1625-10 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
orderCode String
订单号
com String
快递编码
nu String
快递单号
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1625-10","my_appId","my_appSecret") .addTextPara("orderCode","") .addTextPara("com","") .addTextPara("nu","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
orderCode String
订单号
com String
快递公司
nu String
单号
data String
跟踪数据
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "", "orderCode": "", "com": "", "nu": "", "data": "" } }

记录查询


接口地址:http://route.showapi.com/1625-11 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
orderCode String
订单号
reqDate String
请求参数
retDate String
返回参数
type String
类型
ct String
创建时间
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1625-11","my_appId","my_appSecret") .addTextPara("orderCode","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
ret_code String
接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
orderCode String
订单号
reqDate String
请求参数
retDate String
返回参数
type String
类型
ct String
创建时间
...
返回示例:{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "ret_code": "", "orderCode": "", "reqDate": "", "retDate": "", "type": "", "ct": "" } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐