快递100 API

C端寄件下单接口

POSThttps://order.kuaidi100.com/order/corderapi.do

选择快递公司进行下单。

param数据结构：

参数名	是否必填	类型	说明
kuaidicom	是	string	快递公司的编码，一律用小写字母，见《快递公司编码》
recManName	是	string	收件人姓名
recManMobile	是	string	收件人的手机号，手机号和电话号二者其一必填
recManPrintAddr	是	string	收件人所在完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName	是	string	寄件人姓名
sendManMobile	是	string	寄件人的手机号，手机号和电话号二者其一必填
sendManPrintAddr	是	string	寄件人所在的完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
callBackUrl	是	string	callBackUrl订单信息回调
cargo	否	string	物品名称,例：文件
payment	否	string	支付方式，SHIPPER: 寄方付（默认），CONSIGNEE: 到付
weight	否	string	物品总重量KG，不需带单位，例：1.5
remark	否	string	备注
dayType	否	string	预约日期，例如：今天/明天/后天
pickupStartTime	否	string	预约起始时间，24小时制（HH:mm），例如：09:00
pickupEndTime	否	string	预约截止时间，24小时制（HH:mm），例如：10:00
salt	否	string	签名用随机字符串
op	否	string	是否开启订阅功能 0：不开启(默认) 1：开启说明开启订阅功能时：pollCallBackUrl必须填入此功能只针对有快递单号的单
pollCallBackUrl	否	string	如果op设置为1时，pollCallBackUrl必须填入，用于跟踪回调。此为免费服务，回调内容通过五、快递信息推送接口返回（免费服务）
resultv2	否	string	添加此字段表示开通行政区域解析功能。 0：关闭（默认） 1：开通行政区域解析功能以及物流轨迹增加物流状态名称 4：开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息(详见：快递信息推送接口文档)

1.5 信息代码含义

信息代码	信息内容描述	原因及建议处理方式
200	提交成功	提交成功
400	参数错误	请根据技术文档请求，注意参数类型及是否必填。
500	服务器错误	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误
501	重复提交
503	签名认证失败	请检查加密方式，param + t + key + secret 的顺序进行MD5加密，加密后字符串转大写,不用加上“+”号
600	您不是合法的用户（即授权Key出错）	检查KEY是否填写正确或账号无可用单量，需要充值
601	KEY已过期	账号无可用单量，需要充值
700	错误的回调地址	检查回调地址，或者联系快递100工作人员

请求参数

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

method

string

必需

业务类型（默认：cOrder）

key

string

必需

授权码，请申请企业版获取

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号，secret在企业管理后台查看

string

必需

时间戳如：1576123932000

param

string

由其他字段拼接

必需

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

result

boolean

提交结果

必需

true提交成功，false失败

returnCode

string

返回编码

必需

message

string

返回报文描述

必需

data

object

必需

taskId

string

任务ID

必需

orderId

string

订单ID

必需

{
  "result": true,
  "returnCode": "200",
  "message": "提交成功",
  "data": {
    "taskId": "****",
    "orderId ": "****"
  }
}

最后修改时间： 2 年前