快递100 API
  1. 同城配送下单
快递100 API
  • 入门指南
    • 如何注册企业账号
    • 如何开通产品服务
    • 如何联系工作人员
    • 企业版和基础版的区别
  • 产品文档
    • 快递查询
      • 实时快递查询
        • 产品介绍
        • 接口文档
          • 实时快递查询接口
      • 快递信息推送服务
        • 产品介绍
        • 接口文档
          • 快递订阅查询快递api接口技术文档
          • 推送接口
      • 快递查询地图轨迹
        • 产品介绍
        • 接口文档
          • 快递查询地图轨迹技术文档
      • 地图轨迹推送服务
        • 产品介绍
        • 接口文档
          • 订阅接口
          • 推送接口
    • 电子面单与云打印
      • 电子面单
        • 产品介绍
        • 电子面单参数
        • 第三方平台账号授权
          • 第三方授权回调
          • 第三方平台网点&面单余额接口
          • 电子面单账号授权
        • 电子面单接口
          • 打印状态回调
          • 电子面单下单接口
          • 电子面单复打接口
        • 电子面单取消接口
      • 订单导入
        • 产品介绍
        • 接口文档
          • 提交售后(退货)订单获取任务接口
          • 售后(退货)订单获取结果推送接口
          • 快递单号回传及订单发货接口
          • 获取店铺授权超链接接口
          • 提交订单获取任务接口
          • 订单获取结果推送接口
      • 自定义打印
        • 产品介绍
        • 自定义模板打印
          • 自定义模板打印接口
          • 自定义模板打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 附件打印
          • 附件打印接口
          • 附件打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 指令打印
          • 指令打印接口
          • 指令打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
      • 发货单
        • 产品介绍
        • 接口文档
          • 发货单接口
          • 打印回调接口
    • 物流服务
      • 商家寄件
        • 产品介绍
        • 接口文档
          • 快递公司编码
          • 商家寄件下单接口
          • 下单回调接口
          • 商家寄件下单取消接口
          • 商家寄件下单价格接口
          • 快递信息推送接口
          • 商家寄件订单详情查询接口
          • 电子面单复打接口
      • 同城配送
        • 产品介绍
        • 参数字典
        • 同城配送接账号授权
          • 授权回调接口
          • 同城配送账号授权接口
        • 同城配送下单
          • 下单回调接口
          • 同城配送下单
            POST
        • 同城配送查询订单
          POST
        • 同城配送取消下单接口
          POST
      • C端寄件
        • 产品文档
        • 接口文档
          • C端寄件下单接口
          • 下单回调接口
          • C端寄件下单取消接口
          • C端寄件价格查询接口
          • 快递信息推送接口
    • 跨境服务
      • 国际电子面单API
        • 产品介绍
        • 参考数字典
        • 接口文档
          • 国际电子面单下单API
          • 预约取件API
          • 取消预约PI
    • 增值服务
      • 短信提醒发送
        • 产品介绍
        • 接口文档
          • 快递100短信回调请求
          • 快递100短信发送接口
      • 智能单号识别
        • 产品介绍
        • 智能识别接口说明
      • 快递面单OCR识别
        • 产品介绍
        • 快递面单OCR识别接口
      • 快递可用性查询
        • 产品介绍
        • 快递可用性接口
  • 常见问题
    • 查询类问题
      • 实时快递查询
      • 快递信息推送服务
      • 智能单号识别
      • 短信提醒发送
      • Excel表格批量查询
    • 电子面单类问题
      • 电子面单
      • 快递面单模板
      • 参数配置
      • 云打印机/云盒
    • 地图轨迹类问题
      • 快递查询地图轨迹
    • 物流类服务
      • 同城配送
      • 商家寄件
      • 个人寄件
    • 云打印类问题
      • 自定义打印
      • 云打印
      • 发货单
    • 申请与审核
      • 企业版
      • 基础版
    • 支付与支票
      • 产品价格
      • 账单与充值
      • 发票问题
    • 政策与规范
      • 商家寄件服务协议
      • 用户协议
      • 授权声明
      • 隐私政策
      • 增值服务
      • 服务协议
      • 保密协议
    • 账号与密码
      • 账号密码
      • 授权问题
    • 快递公司入驻
      • 入驻资料及审核
      • 电子面单接口示例
      • 快递公司接入快递100实时查询接口
      • 快递公司接入快递100订阅推送接口
      • 手机app快递查询接口
  1. 同城配送下单

同城配送下单

POST
https://order.kuaidi100.com/sameCity/order
选择快递公司进行下单。
param数据结构:
参数名是否必填类型说明
com是string快递公司的编码,一律用小写字母,见《快递公司编码》
recManName是string收件人姓名
recManMobile是string收件人的手机号,手机号和电话号二者其一必填
recManPrintAddr是string收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName是string寄件人姓名
sendManMobile是string寄件人的手机号,手机号和电话号二者其一必填
sendManPrintAddr是string寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
callbackUrl是stringcallBackUrl订单信息回调
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加密,加密后字符串转大写
601key已过期没有可用单量,账号需要充值使用
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://order.kuaidi100.com/sameCity/order' \
--data-urlencode 'method=' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 't=' \
--data-urlencode 'param='
响应示例响应示例
{
    "returnCode": "200",
    "result": true,
    "message": "提交成功",
    "data": {
        "taskId": "13F873760DCB4CF28D666A13FDE6B31A",
        "com": "kfw",
        "orderId": "1000090",
        "fee": 5000,
        "distance": 1000,
        "kuaidiNum": "KFWZS1476131277"
    }
}

请求参数

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

返回响应

🟢200成功
application/json
Body

【快递100】API开发者 微信交流群

用微信扫右侧二维码,加入【快递100】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2021-12-27 09:31:03
上一页
下单回调接口
下一页
同城配送查询订单
Built with