# 上传合单购物详情

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

# 接口说明

# 接口英文名

uploadCombinedShoppingInfo

# 功能描述

上传合单购物详情
该接口用于商户接入购物订单业务。商户接入后，可帮助用户查看/管理微信内购物的订单，追踪订单进展、获取售后服务等。用户后续可以从微信「我」-「服务」-「钱包」-「账单」中进入，也可以从支付凭证消息进入账单详情页回溯已购物的订单。
具体业务介绍及完整接入指南可参见购物订单。

# 注意事项

根据指定的订单单号类型，采用不同参数给指定订单上传订单信息
- 商户侧单号形式（枚举值1），通过下单商户号和商户侧单号确定一笔订单
- 微信支付单号形式（枚举值2），通过微信支付单号确定一笔订单
商户交易订单详情页链接类型为小程序时，appid需要为调用api的appid，如果是第三方调用，则为第三方代上传商家的appid
子单和主单的订单单号类型必须一致
链接类型为小程序（枚举值1）时，链接的appid和path必填，链接类型为url（枚举值2）时URL必填
上传时间，用于标识请求的先后顺序，如果要更新订单信息，上传时间必须比之前的请求更新，请按照Rfc3399格式填写
在订单支付完成关联订单信息成功后不可以修改订单信息
物流形式根据自身物流发货形式填写
- 实体物流配送（枚举值1），采用快递公司进行实体物流配送形式
- 同城配送（枚举值2）
- 虚拟商品（枚举值3），虚拟商品，例如话费充值，点卡等，无实体配送形式

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/user-order/combine-orders?access_token=ACCESS_TOKEN

# 第三方调用

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

# 请求参数

属性

类型

必填

说明

access_token

string

是

接口调用凭证，该参数为 URL 参数，非 Body 参数。使用getAccessToken 或者 authorizer_access_token

order_key

object

是

合单订单，需要上传购物详情的合单订单，根据订单类型二选一

属性	类型	必填	说明
order_number_type	number	否	订单单号类型，用于确认需要上传详情的订单
transaction_id	string	否	原支付交易对应的微信订单号
mchid	string	否	支付下单商户的商户号，由微信支付生成并下发。
out_trade_no	string	否	商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一

sub_orders

array<object>

否

子单购物详情

属性

类型

必填

说明

order_key

object

是

订单，需要上传购物详情的订单，根据订单类型二选一

属性	类型	必填	说明
order_number_type	number	否	订单单号类型，用于确认需要上传详情的订单
transaction_id	string	否	原支付交易对应的微信订单号
mchid	string	否	支付下单商户的商户号，由微信支付生成并下发。
out_trade_no	string	否	商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一

merchant_order_no

string

是

商户侧的交易订单详情页向用户展示的订单编号

示例值: 2343454667633 字符字节限制: [1, 64]

order_detail_jump_link

object

是

子单详情页链接，支持H5和小程序两种类型

属性	类型	必填	说明
url	string	否	链接地址（链接类型为H5时必填）示例值: https://www.weixin.qq.com/wxpay/pay.php 字符字节限制: [1, 1024] 匹配正则表达式: ^https?😕/([^\s/?#[]@]+@)?([^\s/?#@:]+)(?::\d{2,5})?([^[]]*)$
appid	string	否	小程序appid（链接类型为MINIAPP时必填）示例值: wxd678efh567hg6787 字符字节限制: [1, 32]
path	string	否	小程序path（链接类型为MINIAPP时必填）示例值: /path/index/index 字符字节限制: [1, 512]
type	number	是	链接类型枚举值：1、URL；2、MINI_PROGRAM 示例值: MINI_PROGRAM

item_list

array<object>

否

子单购买的商品列表，用户在订单中购买的全部商品明细的列表

多重性: [1, 50]

属性	类型	必填	说明
merchant_item_id	string	否	商户侧商品ID，商户系统内部商品编码，用于标识不同的商品。请注意，当发货模式选择“分拆发货”时，需要使用商户侧商品ID来标记各物流单中包含的具体商品示例值: 1246464644 字符字节限制: [1, 64]
name	string	是	商品名称示例值: iPhoneX 256G 字符长度限制: [1, 256]
description	string	否	商品描述示例值: Image形象店-深圳腾大-QQ公仔字符长度限制: [1, 512]
unit_price	number	是	商品单价（单位：分）示例值: 828800
quantity	number	是	购买数量示例值: 2
image_url	array<string>	否	商品图片链接示例值: https://qpic.cn/xxx 多重性: [1, 3] 字符字节限制: [1, 1024] 匹配正则表达式: ^https?😕/([^\s/?#[]@]+@)?([^\s/?#@:]+)(?::\d{2,5})?([^[]]*)$

logistics_type

number

否

订单商品配送的物流形式，默认为实体物流

payer

object

否

支付者，支付者信息

	属性	类型	必填	说明
	openid	string	是	用户标识，用户在商户appid下的唯一标识。下单前需获取到用户的Openid 示例值: oUpF8uMuAJO_M2pxb1Q9zNjWeS6o 字符字节限制: [1, 128]

upload_time

string

否

上传时间，用于标识请求的先后顺序

示例值: 2021-05-20T13:29:35.120+08:00

# 返回参数

属性	类型	说明
errcode	number	错误码
errmsg	string	错误原因

# 调用示例

示例说明: JS Fetch API

# 请求数据示例


// 拼装URL
let url = `https://api.weixin.qq.com/user-order/combine-orders`;


// Json包体
let jsonBody = {};
jsonBody["order_key"] = {
   "order_number_type": "WXPAY_TRADE_NUMBER",
   "transaction_id": "9876d",
   "mchid": "z9lp9",
   "out_trade_no": "j1zv6"
};
jsonBody["sub_orders"] = [
   {
      "order_key": {
         "order_number_type": "MERCHANT_TRADE_NUMBER",
         "transaction_id": "zlt49",
         "mchid": "uqlxl",
         "out_trade_no": "pzlfp"
      },
      "merchant_order_no": "2343454667633",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "MINI_PROGRAM"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         }
      ],
      "logistics_type": "VIRTUAL_GOODS"
   },
   {
      "order_key": {
         "order_number_type": "WXPAY_TRADE_NUMBER",
         "transaction_id": "27kd6",
         "mchid": "44anx",
         "out_trade_no": "pj396"
      },
      "merchant_order_no": "2343454667633",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "URL"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         }
      ],
      "logistics_type": "VIRTUAL_GOODS"
   },
   {
      "order_key": {
         "order_number_type": "WXPAY_TRADE_NUMBER",
         "transaction_id": "0jo3k",
         "mchid": "6rcmv",
         "out_trade_no": "yld2x"
      },
      "merchant_order_no": "2343454667633",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "MINI_PROGRAM"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         }
      ],
      "logistics_type": "LOCATION_BASED_LOGISTICS"
   }
];
jsonBody["payer"] = {
   "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
};
jsonBody["upload_time"] = "2021-05-20T13:29:35.120 08:00";

// 设置包头
let headers = {"Content-Type": "application/json"};


// 发送请求
fetch(url, {
  body: JSON.stringify(jsonBody),
  headers: headers,
  method: "POST"
})
  .then(response => response.json())
  .then(response => console.log("Success:", JSON.stringify(response)))
  .catch(error => console.error("Error:", error));

# 返回数据示例


{ 
"errcode":0, 
"errmsg":"ok"
}

# 错误码

错误码	错误码取值	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
268435461	参数错误	根据错误原因描述修改参数
268485192	用户标识openid为空	用户标识openid必须填写
268485214	上传时间必须设置	上传时间必须填写
268485253	上传的合单购物详情主单的订单单号类型与子单的单号类型不一致	上传的合单购物详情主单的订单单号类型与子单的单号类型必须一致
268485201	商户交易订单编号为空	商户侧订单号形式下商户交易订单必须填写
268485195	微信支付单号形式下transaction_id字段必须设置	微信支付单号形式下transaction_id字段必须设置
268485196	商户侧单号形式下mchid字段必须设置	商户侧单号形式下mchid字段必须设置
268485197	商户侧单号形式out_trade_no字段必须设置	商户侧单号形式下out_trade_no字段必须设置
268485194	订单单号类型非法	按照文档中订单类型枚举填写该字段
268485202	链接类型非法	链接类型必须是小程序或URL
268485204	链接类型为小程序时，appid不能为空	链接类型为小程序必须设置appid
268485205	链接类型为小程序时，path不能为空	链接类型为小程序必须设置path
268485206	链接类型为URL时，需要设置url	链接类型为URL必须设置url
268485211	订单购买的商品列表不能为空	订单购买的商品列表不能为空
268485213	订单购买的商品列表中的商户侧商品ID必须全部设置	订单购买的商品列表中的商户侧商品ID必须全部设置或不设置
268485207	商品名称不能为空	商品名称必须填写
268485208	商品单价不能为空	商品单价必须填写
268485209	购买数量不能为空	购买数量必须填写
268485210	商品图片链接不能为空	商品图片链接至少填写一个
268485272	商品详情链接不能为空	商品详情链接必须设置
268457013	解码openid失败	openid不合法，请确认后重试
268457014	openid解码后为0	openid不合法，请确认后重试
268485216	上传时间非法，请按照Rfc3399格式填写	上传时间必须满足Rfc3399格式，如2021-05-20T13:29:35.120+08:00
268485217	商户号不合法，请确认后重试	商户号不合法，请确认后重试