# 同城配送开发文档

   日期:2024-12-26    作者:ktshfw 移动:http://ljhr2012.riyuangf.com/mobile/quote/55194.html

微信同城配送是整合了多家运力公司后提供的聚合配送服务。商家通过微信充值并对接同城配送接口后即可下配送单,解决外卖配送需求。

  1. 充值即可拥有多家运力公司的服务。
  2. 配送价格优惠,1公里起送价¥4.32起。
  3. 配送状态通过微信服务通知实时下发给用户,提升收货体验。

4.1 小程序MP后台开通服务(小程序MP后台-功能-物流服务-同城配送)

4.2 查看详情并签署协议

4.3 添加门店(门店名称/电话/地址)

4.4 充值门店运费(支持API充值)

如选择接口充值,则需商家传入门店id、运力、金额,平台返回充值url。 充值后有效期30天,到期未使用余额自动原路退回。 充值运力后可设置运力偏好:价格优先(优先下单低价运力);运力优先(优先下单某个运力)。

4.5 查看门店列表(门店名称/地址/运力余额)

4.6 管理门店信息(门店/配送偏好/运力余额/交易记录)

文档所有接口请求方式均为HTTPS-POST,小程序调用后台接口需要获取access_token授权;服务商代商家调用接口需要获取接口权限集授权,本文档中所列举的接口权限集ID为51,服务商调用接口使用authorizer_access_token授权。

UTF-8编码,请求和响应参数仅支持JSON数据格式,请_st设置HTTP Header的Content-Type为application/json

同城配送支持以服务商/小程序/门店维度进行充值,充值后名下所有门店都可以统一使充值的运费。

  1. 服务商:小程序服务商。
  2. 小程序:商家或品牌。
  3. 门店:商家或品牌在不同地区的线下门店。该主体也是配送单发单主体。

接口简介:

在使用门店相关接口前需要先开通门店权限,开通门店权限前可以使用页面或者使用下面的API开通门店(无加密,可直接调用)。

接口地址:[https://api.weixin.qq.com/cgi-bin/express/intracity/apply?access_token={ACCESS_TOKEN}]

请求参数:(不需要请求参数)

返回参数:

请求示例:

返回参数:

接口简介:

创建门店时需要传入自定义的门店编号,自定义的门店编号需要唯一,确保不重复创建 门店创建后系统生成全局唯一门店编号wx_store_id,后续创建运力订单时需要该门店编号

接口地址: https://api.weixin.qq.com/cgi-bin/express/intracity/createstore?access_token={ACCESS_TOKEN}

请求参数:

AddressInfo

返回参数:

请求示例:

返回示例:

接口简介: 获取本小程序所创建的门店,不传wx_store_id和out_store_id则返回本小程序所有门店信息

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/querystore?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

StoreInfo

请求示例:

返回示例:

接口简介:更新门店信息

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/updatestore?access_token={ACCESS_TOKEN}

请求参数:

KeyInfo

UpdateContent

返回参数:

请求示例:

返回示例:

接口简介: 返回微信服务市场的充值页面地址,通过该页面可以为门店充值指定运力的运费,充值后运费有使用有效期,默认有效期为1个月,超期未使用的运费降原路退回。

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/storecharge?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

请求示例:

返回示例:

接口简介: 该接口可以将门店指定运力的运费余额退还,如果门店有在途的配送订单,需要等配送完成或者取消配送订单之后才可以操作退款;操作退款后,退款金额五分钟内到账。

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/storerefund?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

请求参数示例:

返回参数示例:

接口简介:查询门店运力资金流水

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/queryflow?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

FlowRecordInfo-充值流水

FlowRecordInfo-退款流水

FlowRecordInfo-消费流水

请求示例

返回示例:

接口简介:查询门店运力余额

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/balancequery?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

BalanceDetail:

OrderDetail

请求示例:

返回示例:

接口简介:商家通过该接口传入配送单的相关信息,同城配送后台将根据配送信息向运力查询并返回实时的运费和配送距离。同城配送会根据门店设置的运力偏好(价格优先/运力优先)进行预下单,如果没有设置偏好,则默认返回低价运力的预下单结果,商家可以根据该接口的返回价格作为配送的预估价格。 (注意:接口返回实时计价结果,可能存在预下单和下单价格不一致的情况,具体费用应以下单接口为准。以达达为例,询价结果一般3分钟内有效,顺丰平台没有做说明)

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/preaddorder?access_token={ACCESS_TOKEN}

CargoInfo

返回参数:

请求参数示例:

返回参数示例:

接口简介:创建同城配送单,会根据门店设置的运力偏好来选择运力公司下单。如果没有设置偏好,则默认优先下单低价运力。

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/addorder?access_token={ACCESS_TOKEN}

请求参数:

Cargo

ItemDetail

返回参数:

请求参数示例:

返回参数示例:

注意:

接口简介:通过该接口查询订单是否创建成功,以及订单创建后的状态更新

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/queryorder?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

TranspoterInfo

StoreInfo

ReceiverInfo

CargoInfo

ItemDetail

请求参数示例:

返回参数示例:

接口简介:通过该接口可以取消已创建的订单,取消配送中的订单需要扣减违约金。顺丰配送员接单后2分钟取消订单,收取¥2违约金;达达配送员接单后1分钟取消订单,收取¥2违约金。

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/cancelorder?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

请求参数示例:

返回参数示例:

接口简介:默认扣费主体和充值主体都是门店,该接口可以让开发者设置门店的扣费主体,接口调用成功后,小程序的管理员会收到模板消息,点击模板消息确认更改门店扣费主体后,修改生效。目前支持的扣费主体有:服务商,小程序和门店,详细说明见2.0节

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/setpaymode?access_token={ACCESS_TOKEN}

接口参数:

返回参数:

请求参数示例:

返回参数示例:

接口简介:查询小程序的扣费主体。

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/getpaymode?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

请求参数示例:

返回参数示例:

接口简介:用于查询全国可以使用微信同城配送的城市

接口地址:https://api.weixin.qq.com/cgi-bin/express/intracity/getcity?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

TransCity:

CityInfo:

请求示例:

返回示例:

当订单状态发生变更时,会由微信服回调接入方的回调地址进行状态变更的通知,回调接口地址需要接入方在下单时传入,详见2.8节。

回调报文示例:

签名步骤: 1.对报文的数据做预处理用=连接key和value组成键值对,按key的ascii码升序排列键值对用&链接,示例如下:

2.拼接小程序的安全token,安全token需要在下单小程序管理后台设置和获取,设置路径:开发管理->开发设置->消息推送->Token

3.对第二步中的字符串计算MD5,得到十六进制结果取小写。

签名值:a85489d9444bdd382e0de0ddca67a8ee 商家需要回复报文:

表示应答成功,如果没有接收到正确的请求应答,微信会重试回调。

接口简介:由于测试订单没有快递员接单,不会自动推送订单状态变化回调,为了方便开发者在沙箱环境联调,我们提供了模拟回调接口,针对测试订单开发者可以通过该接口触发3.1的回调。

接口地址:

https://api.weixin.qq.com/cgi-bin/express/intracity/mocknotify?access_token={ACCESS_TOKEN}

请求参数:

返回参数:

请求参数示例:

返回参数示例:

  • 接口返回48001

原因是小程序没有获得同城配送接口权限,在小程序管理后台开通【同城配送】后即可

  • 接口返回61007

此小程序没有授权当前服务商调用接口权限,服务商需获得小程序的51接口权限集

  • 接口返回934011

特别提示:本信息由相关用户自行提供,真实性未证实,仅供参考。请谨慎采用,风险自负。


举报收藏 0评论 0
0相关评论
相关最新动态
推荐最新动态
点击排行
{
网站首页  |  关于我们  |  联系方式  |  使用协议  |  隐私政策  |  版权隐私  |  网站地图  |  排名推广  |  广告服务  |  积分换礼  |  网站留言  |  RSS订阅  |  违规举报  |  鄂ICP备2020018471号