文档
测试

多件下单

POST
http://jk.qingguan.wang/Api/v1

接口描述

提交订单并获取快递单号,必须是一票多件的,会返回多个快递单号。 (测试登录账号:test 登录密码:test 上线时联系业务员获取正式账号) 。请求参数组合成JSON后传输到body,组合格式请看下面的请求参数示例。

请求参数

application/json
参数名
类型
描述
必填
appcode
string
平台编码,固定传 YUNYOU
必填
useraccount
string
登录账号。注册系统的登录账号
必填
requesttype
string
固定传1006
必填
requestdata
string
请求报文,报文为JSON字符串。最终需将JSON字符串url编码。例如: {"cargolist": [{"cname": "测试"}]},编码为 %20%7B%22cargolist%22%3A%20%5B%7B%22cname%22%3A%20%22%E6%B5%8B%E8%AF%95%22%7D%5D%7D
必填
p_mode
string
渠道名称。可通过【获取渠道】接口查看,取获取渠道接口中的 p_mode字段
必填
wlcode
string
快递编码。可通过【获取渠道】接口查看,取获取渠道接口中的 wlcode 字段。快递编码是属于渠道的下级,所以渠道名称和快递编码是需要对应的,对应关系在【获取渠道】接口已列明
必填
sender
object
寄件人信息
必填
ctname
string
寄件人姓名
必填
ctphone
string
寄件人电话
必填
ctcountry
string
寄件人国家代码
必填
ctdetailaddr
string
寄件人详细地址
必填
ctcity
string
寄件人城市
必填
ctprovince
string
寄件人省份/州 代码。示例 AL
必填
ctpostcode
string
寄件人邮编。示例:10002
必填
receiver
object
收件人信息
必填
cgname
string
收件人姓名
必填
cgphone
string
收件人电话
必填
cgcountry
string
收件人国家代码 二字;比如美国是 US
必填
cgdetailaddr
string
收件地址。示例:30 ALLEN ST
必填
cgcity
string
收件城市。示例:New York City
必填
cgprovince
string
收件省份/州(代码)。 示例:NY--表示New York
必填
cgpostcode
string
收件邮编。示例:10002
必填
cargolist
array
申报商品明细
必填
cname
string
申报品名。示例:shoes
必填
price
float
申报单价。示例:56.09
必填
num
int
申报数量。示例:2
必填
ename
string
英文品名。示例:shoes
必填
factweight
float
净重。
必填
orderlist
array
包裹详情。总包裹数必须是一个以上的,即包裹详情中的packagenum总和必须是大于1。
必填
packageinfo
object
同样的包裹详情可作为一个packageinfo传入。
必填
baginfo
object
包裹重量、尺寸详情。
必填
grossweight
float
包裹重量
必填
p_length
float
包裹长度
必填
p_width
float
包裹宽度
必填
p_height
float
包裹高度
必填
packagenum
int
包裹件数。件数是几个,就会返回几个快递单号。表示相同尺寸的包裹有几个
必填
insured_fee
保价金额
可选
sign
string
签名。签名方法请看签名规则
必填

响应参数

application/json
参数名
类型
描述
必填
state
int
1-成功 0-失败
必填
message
string
结果描述
必填
orderlist
string
必填
p_pkval
string
订单号(由系统生成)
必填
expressid
string
快递单号
必填

说明 / 示例

requestdata 原文示例: { "p_mode": "UPS", "wlcode": "wl-004", "sender": { "ctname": "TEST11", "ctphone": "1111111112", "ctcountry": "US", "ctdetailaddr": "845 58TH st", "ctcity": "Birmingham", "ctprovince": "AL", "ctpostcode": "35246" }, "receiver": { "cgname": "DONG", "cgphone": "1111111111", "cgcountry": "US", "cgdetailaddr": "30 ALLEN ST", "cgcity": "New York City", "cgprovince": "NY", "cgpostcode": "10002" }, "orderlist": [{ "packageinfo": { "baginfo": { "grossweight": "35", "p_length": "2", "p_width": "20", "p_height": "10", "insured_fee": "", "packagenum":2 } } } }], "cargolist": [{ "ename": "bag", "num": 10, "price": 23.6, "factweight":2.63 }] } 将上面的 requestdata 内容url编码之后,组合到下面的参数中 请求参数示例: { "appcode":"YUNYOU", "useraccount":"test", "sign":"ZjlkYTg0MDM5Mjc5MTliNGYwZjQzMzk1ZmQxOGE3NjU=", "requesttype":"1006", "requestdata":"%7B%22p_mode%22%3A%20%22UPS%22%2C%22wlcode%22%3A%20%22wl-004%22%2C%22sender%22%3A%20%7B%22ctname%22%3A%20%22Test%22%2C%22ctphone%22%3A%20%221111111112%22%2C%22ctcountry%22%3A%20%22US%22%2C%22ctdetailaddr%22%3A%20%22845%2058TH%20st%22%2C%22ctcity%22%3A%20%22Birmingham%22%2C%22ctprovince%22%3A%20%22AL%22%2C%22ctpostcode%22%3A%20%2235246%22%7D%2C%22receiver%22%3A%20%7B%22cgname%22%3A%20%22DONG%22%2C%22cgphone%22%3A%20%221111111111%22%2C%22cgcountry%22%3A%20%22US%22%2C%22cgdetailaddr%22%3A%20%2230%20ALLEN%20ST%22%2C%22cgcity%22%3A%20%22New%20York%20City%22%2C%22cgprovince%22%3A%20%22NY%22%2C%22cgpostcode%22%3A%20%2210002%22%7D%2C%22orderlist%22%3A%20%5B%7B%22packageinfo%22%3A%20%7B%22baginfo%22%3A%20%7B%22grossweight%22%3A%20%2230%22%2C%22p_length%22%3A%20%222%22%2C%22p_width%22%3A%20%2220%22%2C%22p_height%22%3A%20%2210%22%2C%22insured_fee%22%3A%20%22%22%2C%22packagenum%22%3A%20%222%22%7D%7D%7D%5D%2C%22cargolist%22%3A%20%5B%7B%22ename%22%3A%20%22bag%22%2C%22num%22%3A%2010%2C%22price%22%3A%2023.6%2C%22factweight%22%3A%202.63%7D%5D%7D" } 响应示例: 成功返回: { "state": "1", "message": "下单成功", "orderlist":"[{\"p_pkval\":\"SYS000923221\",\"expressid\":\"20773475734504\"},{\"p_pkval\":\"SYS000923222\",\"expressid\":\"20773475734506\"}]" } 失败返回: { "state":0, "message":"下单失败。账户余额不足" }