第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
数据与智能专区
订单管理接口
下单购买
下单购买
最后更新:2024/11/20

服务商可通过该接口下单购买「数据与智能专区」中的会话内容数据接口。

 

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/advanced_api/create_order?provider_access_token=ACCESS_TOKEN

请求包体:

{
	"advanced_api_type":1,
	"custom_corpid" : "wwxxx",
	"buyer_userid":"xxxx",
	"order_type":1,
	"chat_archive_api":{
		"edition":3,
		"old_edition":2,
		"purchase_count":100,
		"take_effect_time":1704038400
	}
}

参数说明:

参数是否必须说明
provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
advanced_api_type购买的高级接口类型。1:会话内容数据接口,目前仅支持1,且默认值为1
custom_corpid客户企业id。
buyer_userid下单人。服务商企业内成员的明文userid。必须为服务商企业内具有“购买高级接口”或者“高级接口管理”权限的成员。最终也支持由其他人支付
order_type订单类型。0-新购、1-增购、2-续期、3-升级。企业未购买过,默认新购。
chat_archive_api当advanced_api_type为1是,必填,会话内容数据接口订单相关信息,参考ChatArchiveApi结构说明

 

ChatArchiveApi结构说明:

参数是否必须说明
edition2-内外部会话,3-内外部会话及语音通话。仅未到期版本可增购;仅版本到期前60天起可续期;仅未到期版本、内外部会话版本可升级。当订单类型为升级时,editon字段填的是目标升级的版本
old_edition2-内外部会话。订单类型为升级订单时,需要升级的旧版本。目前仅支持2。默认值为2
purchase_count新购、增购、升级订单需指定人数,范围为[1,1000000](升级人数不可超出原版本已购人数);续期订单默认为当前版本已购人数,指定人数无效
take_effect_time新购、续期过期版本支持指定生效时间戳,若未指定则默认当天;其他情况下默认生效日期。
默认生效日期说明:
增购:默认为当天;
续期:未过期版本默认为到期日期;
升级:目标版本已购未生效 为 目标版本生效日期,目标版本已购已生效 或 未购买或者购买已过期 为 当天)。
有默认日期的,指定日期无效,若填了该字段,则该字段必须大于等于当天0点并且在90天内(以当天0点为起始点往后推90天,包含90天)。注:指定的时间如果非0点,实际生效时间为指定日期的0点生效,如果为当天,则为当天0点生效

下单限制说明:

新购:当前企业已经购买过版本(包含已过期版本),不能再新购。
增购:已购买版本已过期不能增购。
续期:仅支持版本过期前60天开始下单,已过期的版本也支持续期
升级:仅支持内外部会话版本升级为内外部会话及语音通话版本。升级的人数必须小于等于旧版本的人数。如果已经存在目标版本,目前也允许升级当前版本。已购版本已过期不支持升级

返回结果:

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

参数说明:

参数说明
errcode错误码
errmsg错误码说明
order_id订单号

下单人权限说明:
下单人需要具备“购买高级接口”或者“高级接口管理”权限。

enter image description here

errcode说明 待补充

错误码说明分类
701140已经购买过此版本,不能再新购,只能续期、增购、升级企业原因
701141未购买此版本或已经过期,不能增购、升级企业原因
701142购买信息已被其他请求更新,请重试企业原因
701143存在未支付或申请退款中的订单,不能下单企业原因
701146海外企业不能购买会话存档企业原因
701149过期前60天开始才可以续期企业原因
701163不合法的生效时间企业原因
701164非法的目标升级版本,目前仅支持升级为内外部会话及语音通话企业原因
84077订单价格过大,无法受理(目前不能超过500万)企业原因
上一篇概述
下一篇取消订单
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们