同城配送下单

POSThttps://order.kuaidi100.com/sameCity/order

选择快递公司进行下单。

param数据结构：

参数名	是否必填	类型	说明
com	是	string	快递公司的编码，一律用小写字母，见《快递公司编码》
recManName	是	string	收件人姓名
recManMobile	是	string	收件人的手机号，手机号和电话号二者其一必填
recManPrintAddr	是	string	收件人所在完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName	是	string	寄件人姓名
sendManMobile	是	string	寄件人的手机号，手机号和电话号二者其一必填
sendManPrintAddr	是	string	寄件人所在的完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
callbackUrl	是	string	callBackUrl订单信息回调
orderType	否	string	订单类型 0：立即单（默认） 1：预约单
pickupTime	否	string	预约取件时间（2020-02-02 22:00:00）,预约件必填
weight	是	double	物品总重量KG，不需要带单位，例：1.5
serviceType	是	string	快递业务服务类型，例：文件广告；对照参数字典
remark	否	string	备注
salt	否	string	签名用随机字符串
orderSourceNo	否	String	物品来源单号（比如美团、饿了么订单方便骑手取货）
orderSourceType	否	String	物品来源（比如美团、饿了么订单方便骑手取货）
storeId	是	String	店铺id（对应快递公司提供的店铺标识）
additionFee	否	Int	小费，单位分，不需要带单位，例：1000
price	是	Int	商品价格，单位分，不需要带单位，例：1000
partnerId	否	String	服务商授权信息，对照参数字典
partnerKey	否	String	服务商授权信息，对照参数字典
goods	否	obj	商品详情（强烈建议提供，方便骑手在取货时确认货品信息）

goods数据结构：

参数名	是否必填	类型	说明
name	是	String	商品名称
price	是	Int	商品价格
count	是	Int	商品数量
uint	是	String	商品单位

param例子

{
     "com": "kfw",
     "recManName": "测试",
     "recManMobile": "13542651579",
     "recManPrintAddr": "深圳市南山区伟易达大夏",
     "sendManName": "小张",
     "sendManMobile": "13542651579",
     "sendManPrintAddr": "深圳市南山区高新南地铁站b口",
     "serviceType": "火锅",
     "weight": 1.00,
      "remark": "测试订单，待会取消",
     "salt": "123",
     "callBackUrl": "http://www.baiud.com",
     "pickupTime": "",
     "orderSourceNo": "168168168",
     "orderSourceType": "美团",
     "storeId": "106396",
     "additionFee": 1000,
     "partnerId": "155555555",
     "partnerKey": "1111111111"
}

Copy

1.5 信息代码含义

信息代码	信息内容描述	原因及建议处理方式
200	成功	成功
400	参数错误等	提交数据不完整，检查提交的格式是否为x-www-form-urlencoded的post格式
500	服务器错误	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数没有按照文档规定填写等，也会报此错误
501	重复提交	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数没有按照文档规定填写等，也会报此错误
503	验证签名失败	请检查加密方式，param + t + key+ secret 的顺序进行MD5加密，加密后字符串转大写
601	key已过期	没有可用单量，账号需要充值使用

请求参数

Body 参数application/x-www-form-urlencoded

method

string

必需

业务类型（默认：order）

key

string

必需

授权码，请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号secret在授权邮件里面有

string

必需

时间戳如：1576123932000

param

string

由其他字段拼接

必需

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

returnCode

string

返回编码

必需

result

boolean

必需

提交结果。true提交成功，false失败

message

string

返回报文描述

必需

data

object

必需

taskId

string

任务ID

必需

com

string

必需

orderId

string

订单ID

必需

fee

integer

费用，单位分

必需

distance

integer

距离，单位公里

必需

kuaidiNum

string

快递公司订单号

必需

{
  "returnCode": "200",
  "result": true,
  "message": "提交成功",
  "data": {
    "taskId": "13F873760DCB4CF28D666A13FDE6B31A",
    "com": "kfw",
    "orderId": "1000090",
    "fee": 5000,
    "distance": 1000,
    "kuaidiNum": "KFWZS1476131277"
  }
}

最后修改时间： 3 年前