分享好友 最新动态首页 最新动态分类 切换频道
# 同城配送开发文档
2024-12-26 23:07

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

  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
最新文章
网易云音乐电脑网页版登录(网易云音乐电脑版怎么退出登录)
作为一款专注于发现与分享的音乐产品,网易云音乐为用户打造全新的音乐生活。在享受这一平台带来的丰富音乐资源之前,我们首先需要进行登录。要登录网易云音乐电脑网页版,我们可以按照以下步骤进行:在浏览器中打开网易云音乐的官方ink">
来了!金普新闻早班车!(12.17)
今日天气金州城区晴间多云,偏北风5到6级、阵风7级,-8~2℃开发区城区晴间多云,偏北风5到6级、阵风7级,-8~2℃渤海片区晴间多云,偏北风5到6级、阵风7级,-10~-1℃金石滩片区晴间多云,偏北风5到6级、阵风7级,-8~0℃中北部片区晴间多
影视行业网络推广策划
影视行业网络推广策划方案影视行业的网络推广策划,需要结合行业特性、目标受众以及最新的推广渠道与技术手段。以下是一个全面的策划思路:--- 1. 目标定位1. 明确推广目标: - 提升影片知名度 - 增加观影人群 - 强化品牌效应(导演、制作
网络推广工作室
网络推广工作室致力于为客户提供全方位的在线营销服务。该工作室拥有专业的团队和丰富的经验,能够根据客户需求制定个性化的推广方案。服务内容包括但不限于搜索引擎优化、社交媒体营销、内容营销等,旨在提高客户的品牌知名度和业务转化率
安兔兔发布:5月份Android手机好评排行TOP10
就5月安兔兔Android手机好评榜TOP10机型来说,变动比较大,有新机强势入榜。目前,好评率最高的机型为索尼Xperia XZ Premium,该机是2017年的旗舰机型,最大亮点是采用了“MOTION EYE”后置相机系统,能够提供超强慢动作拍摄。同时,内置的
淘宝部分卖家仍可使用微信二维码
通过微信端扫码进入后,发现该微信账号虽然名为微信群,用作该店铺用户之间交流互动,以及客服售后等,但实际上是一个个人账号。不仅可以在朋友圈晒各种商品图片,而且在亿邦动力网的再三询问下,店主也承认相中的商品可以通过银行汇款的方
谷歌购物广告、展示广告、视频广告、应用广告有什么区别
除了搜索广告,谷歌广告还有购物广告、展示广告、视频广告、应用广告,本文介绍了这几种广告的区别,一起来了解下吧。购物广告(Shopping)用户在线搜索通常是希望找到零售商提供的最适合自己的产品。投放 Google Ads 购物广告系列时,用户
相关文章
推荐文章
发表评论
0评