登录  /  注册
博主信息
博文 60
粉丝 0
评论 0
访问量 96266
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
快递100集成多家快递公司同城配送下单API接口代码
快递100API
原创
1362人浏览过

一、同城配送下单

选择快递公司进行下单。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://order.kuaidi100.com/sameCity/order

请求参数:

参数名 是否必填 类型 说明
method string 业务类型(默认:order)
key string 授权码, 请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号secret在授权邮件里面有
t string 时间戳如:1576123932000
param param 由其他字段拼接

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 商品单位

1.3 返回结果

字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data

data数据结构

字段 类型 说明 备注
taskId string 任务ID
orderId string 订单ID
fee int 费用,单位分
distance int 距离,单位公里
kuaidiNum string 快递公司订单号

1.4 提供数据内容

param例子

  1. {
  2. "com": "kfw",
  3. "recManName": "测试",
  4. "recManMobile": "13542651579",
  5. "recManPrintAddr": "深圳市南山区伟易达大夏",
  6. "sendManName": "小张",
  7. "sendManMobile": "13542651579",
  8. "sendManPrintAddr": "深圳市南山区高新南地铁站b口",
  9. "serviceType": "火锅",
  10. "weight": 1.00,
  11. "remark": "测试订单,待会取消",
  12. "salt": "123",
  13. "callBackUrl": "http://www.baiud.com",
  14. "pickupTime": "",
  15. "orderSourceNo": "168168168",
  16. "orderSourceType": "美团",
  17. "storeId": "106396",
  18. "additionFee": 1000,
  19. "partnerId": "155555555",
  20. "partnerKey": "1111111111"
  21. }

返回结果例子

  1. {
  2. "returnCode": "200",
  3. "result": true,
  4. "message": "提交成功",
  5. "data": {
  6. "taskId": "13F873760DCB4CF28D666A13FDE6B31A",
  7. "com": "kfw",
  8. "orderId": "1000090",
  9. "fee": 5000,
  10. "distance": 1000,
  11. "kuaidiNum": "KFWZS1476131277"
  12. }
  13. }

1.5 信息代码含义

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

二、下单回调接口

订单有状态变更是会触发回调,回调后如果没有得到合作方正确返回,会重复回调多2次,即最多回调3次。间隔30分钟。

2.1 接口格式

提供统一格式的HTTP POST,并返回统一格式JSON数据。

请求报头:Content-Type=application/x-www-form-urlencoded;charset=UTF-8

2.2 请求地址

授权时贵司填入的callbackUrl

请求参数:

字段 类型 说明 备注
taskId String 任务id
sign String 签名 下单时填写了salt时会带sign md5(param+salt)
param param 参数主体

param数据结构:

参数名 是否必填 类型 说明
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》,选填。
kuaidinum string 快递单号,单号的最大长度是32个字符。
message string 状态描述
orderId string 平台订单ID
status string 订单状态0-下单成功 1-已接单 10-已取货 13-已签收 9-用户主动取消 99-订单已取消
courierName string 快递员姓名
courierMobile string 快递员电话
weight string 重量
freight string 运费

2.3 返回结果

字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述

2.4 提供数据内容

入参param例子

  1. {
  2. "courierMobile":"15010033036",
  3. "courierName":"G师傅",
  4. "kuaidiCom":"kfw",
  5. "kuaidiNum":"KFWZS1476130507",
  6. "message":"订单已取消",
  7. "orderId":"1000086",
  8. "status":99
  9. }

要求返回结果

  1. {
  2. "returnCode": "200",
  3. "result": true,
  4. "message": "成功"
  5. }

2.4 推送响应报文及错误码解释

字段名称 字段含义
result true表示成功,false表示失败。如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃
returnCode 200: 提交成功 500: 服务器错误 其他错误请自行定义
message 返回的提示
本博文版权归博主所有,转载请注明地址!如有侵权、违法,请联系admin@php.cn举报处理!
全部评论 文明上网理性发言,请遵守新闻评论服务协议
0条评论
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2024 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号

  • 登录PHP中文网,和优秀的人一起学习!
    全站2000+教程免费学