文档
测试

单件下单

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

接口描述

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

请求参数

application/json
参数名
类型
描述
必填
appcode
string
平台编码,固定传 YUNYOU
必填
useraccount
string
登录账号。注册系统的登录账号
必填
requesttype
string
固定传1003
必填
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_pkval
string
客户订单号
必填
p_mode
string
渠道名称。可通过【获取渠道】接口查看,取获取渠道接口中的 p_mode字段
必填
wlcode
string
快递编码。可通过【获取渠道】接口查看,取获取渠道接口中的 wlcode 字段。快递编码是属于渠道的下级,所以渠道名称和快递编码是需要对应的,对应关系在【获取渠道】接口已列明
必填
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
必填
baginfo
object
数据字典
必填
grossweight
string
包裹重量。示例:1
必填
cargolist
array
申报商品明细
必填
cname
string
申报品名。示例:shoes
必填
price
float
申报单价。示例:56.09
必填
num
int
申报数量。示例:2
必填
sign
string
签名。签名方法请看签名规则
必填

响应参数

application/json
参数名
类型
描述
必填
state
int
1-成功 0-失败
必填
message
string
结果描述
必填
pkval
string
订单号。state为1时有返回
必填
expressid
string
联邦快递单号。示例:285077012293 。state为1时有返回
必填
markdestination
string
大头笔 。state为1时有返回
可选

说明 / 示例

requestdata 原文示例: { "p_pkval": "TEST9999", "p_mode": "FedEx", "wlcode": "wl-002", "receiver": { "cgname": "TEST", "cgphone": "1111111111", "cgcountry": "US", "cgdetailaddr": "30 ALLEN ST", "cgcity": "New York City", "cgprovince": "NY", "cgpostcode": "10002" }, "baginfo": { "grossweight": "1" }, "cargolist": [{ "cname": "shoes", "price": 56.09, "num": 2 }] } 将上面的 requestdata 内容url编码之后,组合到下面的参数中 请求参数示例: { "appcode":"YUNYOU", "useraccount":"test", "sign":"ZjlkYTg0MDM5Mjc5MTliNGYwZjQzMzk1ZmQxOGE3NjU=", "requesttype":"1003", "requestdata":"%7B%22p_pkval%22%3A%22TEST9999%22%2C%22servicetype%22%3A%22%22%2C%22p_mode%22%3A%22FedEx%22%2C%22wlcode%22%3A%22wl-002%22%2C%22sender%22%3A%7B%22ctcompany%22%3A%22%22%2C%22ctname%22%3A%22%22%2C%22ctphone%22%3A%22%22%2C%22ctcountry%22%3A%22%22%2C%22ctdetailaddr%22%3A%22%22%2C%22ctcity%22%3A%22%22%2C%22ctprovince%22%3A%22%22%2C%22ctpostcode%22%3A%22%22%7D%2C%22receiver%22%3A%7B%22cgcompany%22%3A%22TEST%22%2C%22cgname%22%3A%22TEST%22%2C%22cgphone%22%3A%221111111111%22%2C%22cgcountry%22%3A%22United%20States%20(the)%22%2C%22cgdetailaddr%22%3A%2230%20ALLEN%20ST%22%2C%22cgcity%22%3A%22New%20York%20City%22%2C%22cgprovince%22%3A%22NY(New%20York)%22%2C%22cgpostcode%22%3A%2210002%22%7D%2C%22baginfo%22%3A%7B%22grossweight%22%3A%221%22%2C%22p_length%22%3A%221%22%2C%22p_width%22%3A%222%22%2C%22p_height%22%3A%223%22%2C%22p_isbattery%22%3A%22%22%2C%22insured_fee%22%3A%221000%22%2C%22p_sign%22%3A%221%22%7D%2C%22cargolist%22%3A%5B%7B%22cname%22%3A%22shoes%22%2C%22price%22%3A56.09%2C%22num%22%3A2%7D%5D%7D" } 响应示例: 成功返回: { "state": "1", "message": "下单成功", "pkval": "TEST9999", "expressid": "285077012293", "markdestination": "test9999" } 失败返回: { "state":0, "message":"下单失败。账户余额不足" }