获取分享员订单列表 | 微信开放文档

# 获取分享员订单列表

# 接口说明

该接口用于获取分享员订单列表

# 注意事项

只有分享视频号相关场景（如橱窗、直播间、视频号主页和短视频）成交的订单才会带上视频号场景信息。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/sharer/get_sharer_order_list?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
openid	string	否	分享员openid
share_scene	number	否	分享场景，枚举值详情请参考ShareScene
page	number	是	分页参数，页数
page_size	number	否	分页参数，每页订单数（不超过100）
start_time	number	否	订单创建开始时间
end_time	number	否	订单创建结束时间

# 请求参数示例

{
  "openid": "XXXXXX",
  "share_scene": 3,
  "page": 1,
  "page_size": 10,
  "start_time": 1658505600,
  "end_time": 1658509200
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
order_list	array object SharerOrder	分享员订单，结构体详情请参考SharerOrder

# 返回参数示例

{
  "errcode": 0,
  "errmsg": "ok",
  "order_list": [
    {
      "order_id": "3704612354559743232",
      "share_scene": 3,
      "sharer_openid": "SHAHER_OPENID",
      "sharer_type": 1,
      "sku_id": "1251651",
      "product_id": "124124123121",
      "from_wecom": false,
      "finder_scene_info": {
        "promoter_id": "PROMOTER_ID",
        "finder_nickname": "FINDER_NICKNAME",
        "live_export_id": "",
        "video_export_id": "export/UzFfAgtgekIEAQAAAAAA6ycVwRPnFgAAAAstQy6ubaLX4KHWvLEZgBPE-4MsDn4MarGBzNPgMIo75qdR2YgQS2eoy7YeFsRJ",
        "video_title": "TITLE",
      }
    }
  ]
}

# 错误码

错误码	错误描述
公共错误码	-
10070004	openid非法
10070006	参数错误，请开发人员检查传递参数是否正确

# 结构体

# SharerOrder

分享员订单

参数	类型	描述
order_id	string	订单号
sharer_scene	number	分享场景，枚举值详情请参考ShareScene
sharer_openid	string	分享员openid
sharer_type	number	分享员类型，枚举值详情请参考SharerType
product_id	string	商品唯一id
sku_id	string	商品sku_id
from_wecom	bool	是否从企微分享
finder_scene_info	object FinderSceneInfo	视频号场景信息，结构体详情请参考FinderSceneInfo

# FinderSceneInfo

视频号场景信息

参数	类型	描述
promoter_id	string	视频号唯一标识
finder_nickname	string	视频号昵称
live_export_id	string	直播间唯一标识
video_export_id	string	短视频唯一标识
video_title	string	短视频标题

# 枚举值

# ShareScene

分享场景

枚举值	描述
1	直播间
2	橱窗
3	短视频
4	视频号主页
5	商品详情页
6	带商品的公众号文章
7	商品链接
8	商品二维码
9	商品口令
12	视频号橱窗链接
13	视频号橱窗二维码

# SharerType

分享员类型

枚举值	描述
0	普通分享员
1	店铺分享员