首页 > 其他分享 >重新下单

重新下单

时间:2025-01-15 09:23:44浏览次数:1  
标签:shop goods 配送 string order 重新 下单 id

重新下单

调试工具

接口应在服务器端调用,详细说明参见服务端API

接口说明

接口英文名

reOrder

功能描述

  • 在调用下配送单接口、订单被取消、过期或者投递异常的情况下,可调用此接口,重新下单,需要保持orderid一致。
  • 备注:美团不支持重新下单接口,如果订单被取消商家需要重新下单,请修改orderid之后,调用下配送单接口下单。

调用方式

HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/express/local/business/order/readd?access_token=ACCESS_TOKEN 

第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同
  • 该接口所属的权限集id为:51、71
  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token
shopid string 商家id,由配送公司分配的appkey
shop_order_id string 唯一标识订单的 ID,由商户生成, 不超过128字节
delivery_id string 配送公司ID
openid string 下单用户的openid
sender object 发件人信息,顺丰同城急送必须填写,美团配送、达达、闪送,若传了shop_no的值可不填该字段
属性类型必填说明namestring是姓名,最长不超过256个字符citystring是城市名称,如广州市addressstring是地址(街道、小区、大厦等,用于定位)address_detailstring是地址详情(楼号、单元号、层号)phonestring是电话/手机号,最长不超过64个字符lngnumber是经度(火星坐标或百度坐标,和 coordinate_type 字段配合使用,确到小数点后6位latnumber是纬度(火星坐标或百度坐标,和 coordinate_type 字段配合使用,精确到小数点后6位)coordinate_typenumber否坐标类型,0:火星坐标(高德,腾讯地图均采用火星坐标) 1:百度坐标
receiver object 收件人信息
属性类型必填说明namestring是姓名,最长不超过256个字符citystring是城市名称,如广州市addressstring是地址(街道、小区、大厦等,用于定位)address_detailstring是地址详情(楼号、单元号、层号)phonestring是电话/手机号,最长不超过64个字符lngnumber是经度(火星坐标或百度坐标,和 coordinate_type 字段配合使用,确到小数点后6位latnumber是纬度(火星坐标或百度坐标,和 coordinate_type 字段配合使用,精确到小数点后6位)coordinate_typenumber否坐标类型,0:火星坐标(高德,腾讯地图均采用火星坐标) 1:百度坐标
cargo object 货物信息
属性类型必填说明goods_valuenumber是货物价格,单位为元,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-5000]goods_heightnumber否货物高度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-45]goods_widthnumber否货物宽度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-50]goods_lengthnumber否货物长度,单位为cm,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-65]goods_weightnumber是货物重量,单位为kg,精确到小数点后两位(如果小数点后位数多于两位,则四舍五入保留两位小数),范围为(0-50]goods_detailobject否货物详情,最长不超过10240个字符属性类型必填说明goodsarray
order_info object 订单信息
属性类型必填说明delivery_service_codestring否配送服务代码 不同配送公司自定义, 顺丰和达达不填expected_delivery_timenumber否期望派单时间(达达支持,表示达达系统调度时间, 到那个时间才会有状态更新的回调通知),unix-timestamp, 比如1586342180order_typenumber否订单类型, 0: 即时单 1 预约单,如预约单,需要设置expected_delivery_time或expected_finish_time或expected_pick_timepoi_seqstring否门店订单流水号,建议提供,方便骑手门店取货,最长不超过32个字符notestring否备注,最长不超过200个字符order_timenumber否用户下单付款时间, 顺丰必填, 比如1555220757is_insurednumber否是否保价,0,非保价,1.保价declared_valuenumber否保价金额,单位为元,精确到分tipsnumber否小费,单位为元, 下单一般不加小费is_direct_deliverynumber否是否选择直拿直送(0:不需要;1:需要。选择直拿直送后,同一时间骑手只能配送此订单至完成,配送费用也相应高一些,闪送必须选1,达达可选0或1,其余配送公司不支持直拿直送)cash_on_deliverynumber否骑手应付金额,单位为元,精确到分cash_on_pickupnumber否骑手应收金额,单位为元,精确到分rider_pick_methodnumber否物流流向,1:从门店取件送至用户;2:从用户取件送至门店is_finish_code_needednumber否收货码(0:不需要;1:需要。收货码的作用是:骑手必须输入收货码才能完成订单妥投)is_pickup_code_needednumber否取货码(0:不需要;1:需要。取货码的作用是:骑手必须输入取货码才能从商家取货)expected_finish_timenumber否期望送达时间(美团、顺丰同城急送支持),unix-timestamp, 比如1586342180expected_pick_timenumber否期望取件时间(闪送、顺丰同城急送支持,闪送需要设置两个小时后的时间,顺丰同城急送只需传expected_finish_time或expected_pick_time其中之一即可,同时都传则以expected_finish_time为准),unix-timestamp, 比如1586342180
shop object 商品信息,会展示到物流通知消息中
属性类型必填说明wxa_pathstring否商家小程序的路径,建议为订单页面img_urlstring否商品缩略图 url;shop.detail_list为空则必传,shop.detail_list非空可不传。goods_namestring否商品名称, 不超过128字节;shop.detail_list为空则必传,shop.detail_list非空可不传。goods_countnumber否商品数量;shop.detail_list为空则必传。shop.detail_list非空可不传,默认取shop.detail_list的sizewxa_appidstring否该参数在【即使配送】的addOrder接口才生效。若结算方式为:第三方向配送公司统一结算,商户后续和第三方结算,则该参数必填;在该结算模式下,第三方用自己的开发小程序替授权商户发起下单,并将授权小程序的appid给平台,后续配送通知中可回流授权商户小程序。detail_listarray
delivery_token string 预下单接口返回的参数,配送公司可保证在一段时间内运费不变
delivery_sign string 用配送公司提供的appSecret加密的校验串说明
shop_no string 商家门店编号,在配送公司登记,如果只有一个门店,美团闪送必填, 值为店铺id
sub_biz_id string 子商户id,区分小程序内部多个子商户
order_source string
order_sequence string

返回参数

属性 类型 说明
resultcode number 运力返回的错误码
resultmsg string 运力返回的错误描述
fee number 实际运费(单位:元),运费减去优惠券费用
deliverfee number 运费(单位:元)
couponfee number 优惠券费用(单位:元)
tips number 小费(单位:元)
insurancfee number 保价费(单位:元)
distance number 配送距离(整数单位:米)
waybill_id string 配送单号
order_status number 配送状态。详见order_status 枚举值
finish_code number 收货码
pickup_code number 取货码
dispatch_duration number 预计骑手接单时间,单位秒,比如5分钟,就填300, 无法预计填0

调用示例

示例说明: HTTPS调用成功示例

请求数据示例

{
   "cargo": {
       "cargo_first_class": "美食夜宵",
       "cargo_second_class": "零食小吃",
       "goods_detail": {
           "goods": [
               {
                   "good_count": 1,
                   "good_name": "水果",
                   "good_price": 10,
                   "good_unit": "元"
               },
               {
                   "good_count": 2,
                   "good_name": "蔬菜",
                   "good_price": 20,
                   "good_unit": "元"
               }
           ]
       },
       "goods_height": 1,
       "goods_length": 3,
       "goods_value": 5,
       "goods_weight": 1,
       "goods_width": 2
   },
   "delivery_id": "SFTC",
   "delivery_sign": "01234567890123456789",
   "openid": "oABC123456",
   "order_info": {
       "delivery_service_code": "",
       "expected_delivery_time": 0,
       "is_direct_delivery": 0,
       "is_finish_code_needed": 1,
       "is_insured": 0,
       "is_pickup_code_needed": 1,
       "note": "test_note",
       "order_time": 1555220757,
       "order_type": 0,
       "poi_seq": "1111",
       "tips": 0
   },
   "receiver": {
       "address": "xxx地铁站",
       "address_detail": "2号楼202",
       "city": "北京市",
       "coordinate_type": 0,
       "lat": 40.1529600000,
       "lng": 116.5060300000,
       "name": "老王",
       "phone": "18512345678"
   },
   "sender": {
       "address": "xx大厦",
       "address_detail": "1号楼101",
       "city": "北京市",
       "coordinate_type": 0,
       "lat": 40.4486120000,
       "lng": 116.3830750000,
       "name": "刘一",
       "phone": "13712345678"
   },
   "shop": {
       "goods_count": 2,
       "goods_name": "宝贝",
       "img_url": "https://mmbiz.qpic.cn/mmbiz_png/xxxxxxxxx/0?wx_fmt=png",
       "wxa_path": "/page/index/index"
   },
   "shop_no": "12345678",
   "sub_biz_id": "sub_biz_id_1",
   "shop_order_id": "SFTC_001",
   "shopid": "122222222",
   "delivery_token": "xxxxxxxx"
} 

返回数据示例

{
  "resultcode": 0,
  "resultmsg": "ok",
  "fee": 10,
  "deliverfee": 10,
  "couponfee": 0,
  "tips": 0,
  "insurancfee": 0,
  "distance": 1000,
  "waybill_id": "123456789",
  "order_status": 101,
  "finish_code": 1024,
  "pickup_code": 2048,
  "dispatch_duration": 300
} 

示例说明: HTTPS调用失败示例

请求数据示例

同上 

返回数据示例

{
  "resultcode": 1010,
  "resultmsg": "收件人信息不正确"
} 

错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试

标签:shop,goods,配送,string,order,重新,下单,id
From: https://www.cnblogs.com/AtlasLapetos/p/18641437

相关文章

  • 知识图谱与大模型融合,重新定义设备故障诊断
    在现代工业与制造领域,设备运行的稳定性和可靠性对生产效率和安全至关重要。然而,随着设备的复杂性日益提升,传统的故障诊断方法面临以下挑战:1.复杂的故障模式:设备的多部件、多工况、多故障模式使传统方法难以全面覆盖。2.数据爆炸与不均:海量的传感器数据与日志记录需要高效处......
  • 使用VoyageAI进行高效文本嵌入与重新排序
    在自然语言处理(NLP)任务中,文本嵌入和重新排序是两项关键技术。VoyageAI提供了针对特定领域和公司的定制化嵌入模型,以提高检索质量。本文将详细讲解如何使用VoyageAI进行文本嵌入和重新排序。技术背景介绍文本嵌入是一种将文本转换为数值向量的方法,使其能够在机器学习模型......
  • 重新定义数据分析:LLM如何让人专注真正的思考
    重新定义数据分析:LLM如何让人专注真正的思考LLM重塑智能数据分析:从DIKW到智能Agent的演进智能数据分析的技术突破智能数据分析的未来图景还记得第一次用Excel做数据分析的场景吗?选数据、找公式、画图表…每一步都像在破解密码。现在,大语言模型(LLM)的出现让数据分析......
  • CES Asia 2025:精神焕发,重新想象
    在科技飞速发展的时代浪潮中,CES Asia 2025(赛逸展)即将以全新的姿态盛大开启,在4.6万平米的广阔空间里,打造一场小而精致的消费电子精品展,为全球科技行业带来一场别开生面的盛宴。自2015年诞生以来,CES Asia凭借独特理念与专业运营在消费电子领域脱颖而出,连续五年的辉煌历史奠......
  • Java 8系列之重新认识HashMap14
     摘要HashMap是Java程序员使用频率最高的用于映射(键值对)处理的数据类型。随着JDK(JavaDevelopmetKit)版本的更新,JDK1.8对HashMap底层的实现进行了优化,例如引入红黑树的数据结构和扩容的优化等。本文结合JDK1.7和JDK1.8的区别,深入探讨HashMap的结构实现和功能原理。简介Ja......
  • Java 8系列之重新认识HashMap13
     摘要HashMap是Java程序员使用频率最高的用于映射(键值对)处理的数据类型。随着JDK(JavaDevelopmetKit)版本的更新,JDK1.8对HashMap底层的实现进行了优化,例如引入红黑树的数据结构和扩容的优化等。本文结合JDK1.7和JDK1.8的区别,深入探讨HashMap的结构实现和功能原理。简介Ja......
  • Java 8系列之重新认识HashMap11
     摘要HashMap是Java程序员使用频率最高的用于映射(键值对)处理的数据类型。随着JDK(JavaDevelopmetKit)版本的更新,JDK1.8对HashMap底层的实现进行了优化,例如引入红黑树的数据结构和扩容的优化等。本文结合JDK1.7和JDK1.8的区别,深入探讨HashMap的结构实现和功能原理。简介Ja......
  • 重新创建缺少的 VMware 虚拟机磁盘描述符文件 (.vmdk)
    重新创建缺少的VMware虚拟机磁盘描述符文件(.vmdk)原文 为增量磁盘重新创建缺少的虚拟磁盘(VMDK)描述符文件文章ID:321422calendar_today更新于: 10-25-2024产品VMwarevSphereESXi的问题/介绍本文提供了重新创建丢失的虚拟磁盘描述符文件(.vmdk)的步骤......
  • 为增量磁盘重新创建缺少的虚拟磁盘 (VMDK) 描述符文件
    为增量磁盘重新创建缺少的虚拟磁盘(VMDK)描述符文件书文章ID:327862calendar_today更新于: 11-11-2024产品VMwarevSphereESXi的问题/介绍本文提供了基于vmfsSparse磁盘格式重新创建增量虚拟磁盘描述符文件的步骤。这种磁盘格式通常由虚拟机快照功能、......
  • cgroup与systemd: 通过src rpm获取systemd源代码,添加日志并使用rpmbuild重新打包
    问题起源服务跑在富容器中。容器使用init进程作为一号进程,然后用systemd管理所有service。在做一次升级时,nginx启动脚本有更新,原来是root拉起,现在进行了去root改造,使用nginx用户拉起。升级过程中,发现nginx进程无法被拉起,报错:"RefusingtoacceptPIDoutsideofservicecon......