自定义订单数据(增量)
定义
置灰字段和规范整体介绍请参考 上级文档 介绍,本文档只介绍追加字段
数据规范
名称 | 类型 | 描述 |
---|---|---|
order 必填 | object |
订单数据 |
order_id 必填 | string |
商户侧订单号,在商户系统内订单的唯一标识符 |
order_time 必填 | datetime |
订单下单时间(下单可能不支付),出于计算方便的考虑,在处理订单数据的时候会统一使用下单时间作为重要的时间戳,所以order_time在任何情况下都是必填 |
pay_time | datetime |
订单支付时间,只在支付行为发生时才会生成 |
cancel_time | datetime |
订单取消时间,只在取消订单行为发生时才会生成 |
refund_time | datetime |
订单退款时间,只在退款行为发生时才会生成 |
order_status 必填 | string |
订单状态当前的最新变化
|
sub_orders | object[] |
子订单的每个对象需要按sub_order_id合入上级接口 |
sub_order_id | string |
子订单单号,唯一标识符,可按规则计算 |
order_amt | float |
子订单金额(元) |
pay_amt | float |
子订单实付金额(元) |
extra | object |
子订单的额外属性 |
chan | object |
各个子订单渠道,标识拆分订单的渠道归因 |
chan_wxapp_scene 必填 | int |
小程序场景值,必填 例1037 |
chan_id | string |
引流渠道的标识符 |
chan_refer_app_id | string |
来源小程序或公众号appid 例wx9d6f5f6gea059654 |
chan_shop_id | string |
门店ID,若需要计算门店业务则必填 |
chan_shop_name | string |
门店名称,展示字段,若chan_shop_id存在则必填 |
chan_custom | object |
自定义渠道 |
chan_custom_id 必填 | string |
4级自定义渠道的标识符,4级是自定义渠道的最小粒度 例mp-article-12375 |
chan_custom_id_desc 必填 | string |
4级自定义渠道的描述 例公众号文章(id=12375) |
chan_custom_cat_3 | string |
3级自定义渠道的标识符,3级是针对4级的分类,要求4级数据必须存在 例mp-article |
chan_custom_cat_3_desc | string |
3级自定义渠道的描述,若chan_custom_cat_3存在则必须存在 例公众号文章 |
chan_custom_cat_2 | string |
2级自定义渠道的标识符,2级是针对3级的分类,要求34级数据必须存在 例media |
chan_custom_cat_2_desc | string |
2级自定义渠道的描述,若chan_custom_cat_2存在则必须存在 例媒体 |
chan_custom_cat_1 | string |
1级自定义渠道的标识符,1级是针对2级的分类,要求234级数据必须存在 例wechat |
chan_custom_cat_1_desc | string |
1级自定义渠道的描述,若chan_custom_cat_1存在则必须存在 例微信 |
sku | object |
商品 |
sku_id 必填 | string |
商品唯一标识符 例AKDFie8-1 |
sku_name 必填 | string |
商品名称 例妃子笑荔枝礼盒装(2KG) |
spu | object |
是商品信息聚合的一个单元 |
spu_id 必填 | string |
标准化产品单元的唯一标识符 例AKDFie8 |
spu_name 必填 | string |
标准化产品单元的名称 例妃子笑荔枝 |
sku_category | object[] |
商品类目路径 |
sku_cat_id 必填 | string |
商品类目ID,唯一标识符 |
sku_cat_name 必填 | string |
商品类目名称 |
sku_parent_cat_id 必填 | string |
商品父级类目ID,若已经是顶级类目,则填 |
sale | object |
销售信息 |
original_price 必填 | float |
商品当前原价单价(元),一般是划线价 例49.9 |
current_price 必填 | float |
商品当前现价(元) 例30.0 |
sku_num | float |
购买商品件数 |
chan | object |
订单行为产生的渠道 |
chan_wxapp_scene 必填 | int |
小程序场景值,必填 例1037 |
chan_id | string |
引流渠道的标识符 |
chan_refer_app_id | string |
来源小程序或公众号appid 例wx9d6f5f6gea059654 |
chan_shop_id | string |
门店ID,若需要计算门店业务则必填 |
chan_shop_name | string |
门店名称,展示字段,若chan_shop_id存在则必填 |
chan_custom | object |
自定义渠道 |
chan_custom_id 必填 | string |
4级自定义渠道的标识符,4级是自定义渠道的最小粒度 例mp-article-12375 |
chan_custom_id_desc 必填 | string |
4级自定义渠道的描述 例公众号文章(id=12375) |
chan_custom_cat_3 | string |
3级自定义渠道的标识符,3级是针对4级的分类,要求4级数据必须存在 例mp-article |
chan_custom_cat_3_desc | string |
3级自定义渠道的描述,若chan_custom_cat_3存在则必须存在 例公众号文章 |
chan_custom_cat_2 | string |
2级自定义渠道的标识符,2级是针对3级的分类,要求34级数据必须存在 例media |
chan_custom_cat_2_desc | string |
2级自定义渠道的描述,若chan_custom_cat_2存在则必须存在 例媒体 |
chan_custom_cat_1 | string |
1级自定义渠道的标识符,1级是针对2级的分类,要求234级数据必须存在 例wechat |
chan_custom_cat_1_desc | string |
1级自定义渠道的描述,若chan_custom_cat_1存在则必须存在 例微信 |
page 必填 | string |
行为发生的小程序页面路径,开头不要加 |
page_title 必填 | string |
行为发生的小程序页面标题 例商品详情、商城首页 |
wx_user 必填 | object |
用户相关属性 |
app_id 必填 | string |
公众号或小程序唯一标识 例wx9d4f5f22pa099f82 |
open_id 必填 | string |
微信用户在小程序下的唯一标识符 例ogN6X0T-ilsH-XmIdzXtuR1f1r3Q |
union_id | string |
微信用户在开放平台账号下的唯一标识符 例o6_bmlsdaXds8d6_sgVt7hM3OPfL |
tag | object[] |
用户的个性化标签 |
tag_id 必填 | string |
标签ID,唯一标识符 例游客 |
tag_name 必填 | string |
标签名称 例游客 |
component | object |
组件是视图上的一个区块元素 |
component_id | string |
组件ID |
component_name | string |
组件名称 |
请求示例
let body = {
"type": "custom_order_product",
"props": {
"order": {
"order_id": "1347895",
"order_time": 1557813400369,
"order_status": "give_order"
},
"sub_orders": [
{
"sub_order_id": "so_001",
"order_amt": 150,
"pay_amt": 100,
"chan": {
"chan_wxapp_scene": 1001,
"chan_id": "ad_001",
"chan_shop_id": "aHDFO",
"chan_shop_name": "滨海小卖部"
},
"sku": {
"sku_id": "sku_001"
},
"spu": {
"spu_id": "spu_001"
}
},
{
"sub_order_id": "1347895_002",
"order_amt": 100,
"pay_amt": 50,
"chan": {
"chan_wxapp_scene": 1002,
"chan_id": "ad_001",
"chan_shop_id": "aHDFO",
"chan_shop_name": "滨海小卖部"
}
}
],
"chan": {
"chan_wxapp_scene": 1001,
"chan_id": "ad_001",
"chan_shop_id": "aHDFO",
"chan_shop_name": "滨海小卖部"
},
"wx_user": {
"app_id": "xxx",
"open_id": "yyy"
}
}
}
wx.request({
url: "https://zhls.qq.com/api/report?app_id=APPID×tamp=TIMESTAMP&nonce=NONCE",
data: body,
success(res) {
console.log(res)
}
})