分享好友 最新动态首页 最新动态分类 切换频道
# 同城配送开发文档
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
最新文章
百度怎么开户投放广告
百度怎么开户投放广告?作为中国最大的搜索引擎,百度每天都要处理数以亿计的搜索请求,这也为广告主们提供了一个广阔的广告投放平台。如何在百度上开户并投放广告,让自己的品牌和产品得到更好的曝光和推广,是许多广告主关注的问题。本文
高清美女写真生成:超简单的AI绘图工具推荐与使用指南
限时免费,点击体验最近超火的AI生图神器,坐拥3000美女的大男主就是你! https://ai.sohu.com/pc/generate/textToImg?_trans_=030001_yljdaimn 宝子们,想象一下,你在家里随便拍拍,竟能产生出超逼真的美女写真,这不是电影里的情节,而
sem竞价代运营公司主要负责哪些工作?揭秘sem代运营的核心职责!
在数字营销这片浩瀚的海洋中,SEM竞价代运营公司就像那艘稳健的航船,载着企业在波涛汹涌的市场中破浪前行。那么,这些代运营公司究竟负责哪些工作?他们又是如何助力企业实现营销目标的呢?今天,咱们就来揭秘SEM代运营的核心职责,让您对
以图搜图
点击详情进入查看更多搜图工具网站服务:常用搜索,以图搜图,识图,以图搜图,图像检索,图像识别,图片识别,图片搜索,图像搜索,识图,搜图,找图,拍图,拍照,常用推荐,常用搜索,以图搜图。百度图像搜索-领先的图像识别技术连接人
长沙NOIP信息学奥赛集训营咨询热线:   在线咨询: 点击交谈
长沙NOIP信息学奥赛信息 长沙NOIP信息学奥赛集训营是长沙青少儿教育品牌,形成了以乐高创意启蒙课程、人工智能编程、智能机器人编程、信息学奥赛编程等课程体系为核心,集国内外大型权威科技赛事、少儿资格认证考试、科技主题的国内外游学
微信小程序如何获取链接
微信小程序的链接获取是开发者在开发过程中需要注意的一个重要问题。链接是小程序中不可或缺的元素,它可以在不同页面之间进行导航和跳转,为用户提供丰富的交互体验。这篇文章将介绍如何在微信小程序中获取链接,并提供一些实用的技巧和注
阅读与写作兴趣班教学计划
阅读与写作兴趣班教学计划(通用12篇)  时间就如同白驹过隙般的流逝,前方等待着我们的是新的机遇和挑战,现在就让我们好好地规划一下吧。计划到底怎么拟定才合适呢?以下是小编为大家收集的阅读与写作兴趣班教学计划,希望对大家有所帮
【C8600360清理大师下载】华为C8600360清理大师8.4.2免费下载
清理大师:更简单,更畅快!6亿用户信赖的手机清理!清理大师是一款完全免费的手机加速与空间清理软件,强力加速使手机运行更流畅,一键清理快速解决空间不足问题。【一键清理】一键搞定无用垃圾,手机清理更省心【手机加速】瞬间释放手机
《时代》专访ChatGPT之父:人工智能影响经济还需要很多年
划重点:① OpenAI的首席执行官山姆·奥特曼(Sam Altman)曾表示,如果使用不当,人工智能会让所有人都消亡。② 在倡导人工智能可能性的同时,奥特曼敦促政策制定者制定规则和通过监管来减轻人工智能可能带来的危险。奥特曼倡导用普世的基
抖音直播突围:封闭外链中的外链建设策略169
## 网站外链规划师:抖音直播封闭外链外链建设方案 #### ## 一、背景分析抖音平台对外部链接的限制日益严格,使得传统的外链建设方式难以奏效。为了突破这一限制,需要制定针对性的外链建设策略。## 二、目标设定* 增加高质量的反向链接*
相关文章
推荐文章
发表评论
0评