快递100集成多家快递公司同城配送账号授权接口案例代码

一、同城配送账号授权接口

通过第三方授权获取商家账号授权码

1.1 接口格式

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

1.2 请求地址

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

请求参数：

参数名	是否必填	类型	说明
method	是	string	业务类型（默认：auth）
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	快递公司，一律用小写字母，见参数字典
storeId	是	string	授权店铺id
callbackUrl	是	String	授权后信息的信息回调地址

1.3 返回结果

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

data数据结构

字段	类型	说明	备注
url	string	授权链接

1.4 提供数据内容

{
  "returnCode": "200",
  "result": true,
  "message": "提交成功",
  "data": {
   "url": "http://open.s.bingex.com/auth?response_type=code&client_id=ssTQhMCPkKfdz38Le&state=null&scope=shop_open_api&thirdStoreId=null&redirect_uri=http://api.kuaidi100.com/callback/ss/auth"
  }
}

说明：点击链接进入授权，登录对应服务商的账号完成授权；授权成功后会跳转页面，保存好对应的参数，用做下单；

1.5 信息代码含义

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

二、授权回调接口

授权成功后自动回调授权信息。

2.1 接口格式

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

2.2 请求地址

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

请求参数：

参数名	是否必填	类型	说明
param	是	string	参数主体

2.3 返回结果

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

data数据结构

字段	类型	说明	备注
partnerId	string	授权partnerId
partnerKey	String	授权key
com	String	快递公司编码
expireTime	String	过期时间

2.4 提供数据内容

入参例子

{
  "returnCode": "200",
  "result": true,
  "message": "提交成功",
  "data": {
    "com": "shansong",
    "partnerId": " 863B2B9A8A934014B39E1B237D2AD7D3",
    "expireTime": "2022-03-12 17:16:25"
  }
}

​

要求返回结果

{
          "returnCode": "200",
          "result": true,
          "message": "成功"
}

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

字段名称	字段含义
result	true表示成功，false表示失败。如果提交回调接口的地址失败，30分钟后重新回调，3次仍旧失败的，自动放弃
returnCode	200: 提交成功 500: 服务器错误 其他错误请自行定义
message	返回的提示

一、产品介绍

同城配送服务API是专为企业与快递公司运力提供的一套解决方案。通过接口可以满足企业、电商、微商、快递网点、代收点等经常性寄件用户，价格低廉，并可自动分配骑手取件的解决方案。

二、同城配送API应用场景

自营品牌商家，面向有开发能力的商家,可对接自己的后台系统；
平台服务商，面向独立第三方软硬件、插件等 ISV合作伙伴，提供标准化的应用；

三、同城配送API收费模式

1. 收费方式

同城配送服务使用预充值付费方式，按单收费，在<a href="https://api.kuaidi100.com/register/enterprise" target="_blank">注册API账号</a>后可<a href="https://api.kuaidi100.com/service/local" target="_blank">查看套餐</a>并购买单量。

2. 收费价格

同城配送服务收费标准请看下表：

价格/元	同城配送单量	单价/元
5000	130000	约0.038
2000	45000	约0.044
1000	18000	约0.055
500	6500	约0.076
200	2500	0.08

企业每次成功调用接口，都会扣除单量，若单量已经扣除完毕，需要重新充值购买。

3. 开具发票

快递100支持开具增值税发票，用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票，1000元以上可支持开具增值税专用发票。

官方文档：

http://api.kuaidi100.com/document/606436974344bf6fb00db217.html

http://api.kuaidi100.com/document/60643820122cae053a5f6f52.html