# 一、应用场景介绍

购物订单收纳用户线上购物相关订单信息，可帮助用户查看/管理订单，追踪订单进展、获取售后服务等
用户可以从“我-服务-钱包-账单”中进入，也可以从支付凭证消息进入账单详情页查看购物订单

wx_order_01

# 二、接入准备

填写客户自接入模式申请接入 (opens new window)，接入场景选择”购物订单“。

# 三、接入内容

# 总览

购物订单场景需要接入的行为和接口如下。

数据类型	行为/接口名称	行为/接口描述	备注
订单接口	/data-api/v1/order/add_order	添加/更新主订单

# 细节（供评估）

# 订单

# 请求地址

域名/data-api/v1/order/add_order

# 请求方法

POST

# 请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

# 请求体类型

application/json

# 请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
orders	array	Y	订单列表数组最大长度 50
external_order_id	string	Y	商家订单号
mchid	string	Y	微信支付场景，支付下单商户的商户号，由微信支付生成并下发
appid	string	Y	微信支付场景，由微信生成的应用ID，全局唯一
sub_mchid	string		微信支付场景，服务商模式下必填，微信支付下单的子商户的商户号
sub_appid	string		微信支付场景，服务商模式下子商户申请的appid，若填写，则 open_id 为该 sub_appid 下的唯一用户标识
create_time	string	Y	订单创建时间，unix时间戳字段长度为 13 字节
order_source	string	Y	订单来源,枚举值:商家小程序：wxapp；商家app：app；商家H5：mobileweb；商家pcweb：pcweb；线下人工pos：offstore_pos_manual；线下自助收银：offstore_pos_self_help；其他：other
order_type	integer	Y	订单类型；1：普通订单；2：充值订单；3：消费订单（如停车费）；4:预售订单_预付；5：预售订单_尾款；6：商品券订单（指定商品的券，视同为购买了商品）；7：积分订单；8：代金券订单（所有商品可使用的券）普通购买商品订单传 1 即可
order_status	string	Y	主订单状态，支付订单场景传1150已支付待发货/已支付待核销，1160已发货
status_change_time	string	Y	状态变更时间，unix毫秒级时间，如 order_status状态为 1150 ，则传 1150（已支付待发货）状态变更的时间
user_info	object	Y	用户信息，json格式
open_id	string	Y	下单人 open_id，order_source = wxapp时，必填
goods_info	array	Y	主订单商品信息，数组类型，每个sku存一个数组单位
external_sku_id	string	Y	sku 编号
primary_image_url	string	Y	商品主图
sku_name_chinese	string	Y	sku 名称
payment_amount	float	Y	多件商品实付金额（分摊了优惠的金额）,单位默认为元，注：有数GMV计算使用该字段
spu_name_chinese	string	Y	spu 名称，若无 spu，传输内容请与 sku_name_chinese 保持一致
goods_num	integer	Y	商品数量
target_url	object		商品落地页信息
url_miniprogram	string	Y	微信小程序落地页 url，购物订单场景必填，字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid	string	Y	微信小程序 appid，购物订单场景必填，字段长度最小 1 字节，长度最大 100 字节
payment_info	array		主订单每种支付方式的支付信息,order_status = 1110 时 payment_info非必填，其他状态码必填
out_trade_number	string	Y	微信支付商户系统内部订单号，当 payment_type = 00009 时必填，只能是数字、大小写字母_-*且在同一个商户号下唯一
payment_type	string	Y	支付方式，见<枚举列表>页
trans_id	string		微信支付订单ID/流水号
express_info	object		快递信息
receiver_phone	string		收件人联系电话，字段长度最小 1 字节，长度最大 100 字节
express_package_info	array		包裹信息
express_company_code	string		物流公司编码，枚举类型，枚举值请参见文章后面的“物流商 code”
express_code	string		运单号
express_package_info	array		物流包裹信息
external_sku_id	string		商品sku id
is_deleted	integer		商家标记订单已删除，0：未删除；1：已删除，为空默认为 0