登录
基础
连接微信
办公
第三方应用开发 服务端API 接口调用许可 订单管理 获取多企业订单详情
获取多企业订单详情
最后更新：2023/05/18
查询某个多企业订单的详情，包括订单的状态、购买的企业、基础账号个数、互通账号个数、账号购买时长等。如需每个企业的账号列表，请使用该接口返回的 sub_order_id 调用获取订单中的账号列表接口以获取账号列表。
请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/license/get_union_order?provider_access_token=ACCESS_TOKEN
请求包体：
{
"order_id": "ORDERID",
"limit": 1000,
"cursor": "CURSOR"
}参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| provider_access_token | 是 | 应用服务商的接口调用凭证，获取方法参见服务商的凭证 |
| order_id | 是 | 订单id |
| limit | 否 | 返回的最大记录数，整型，最大值1000，默认值500 |
| cursor | 否 | 用于分页查询的游标，字符串类型，填写上一次调用返回的 next_cursor，首次调用可不填 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"order":{
"order_id":"ORDERID",
"order_type":1,
"order_status":1,
"price":10000,
"create_time":150000000,
"pay_time":1550000000
},
"has_more": 1,
"next_cursor": "CURSOR",
"buy_list": [{
"sub_order_id": "SUBORDERID",
"corpid":"CORPID",
"account_count": {
"base_count":100,
"external_contact_count":100
},
"account_duration": {
"months": 2,
"days": 20
}
}]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误码说明 |
| order | 订单详情，详见OrderInfo |
| has_more | 是否有更多。 0: 没有， 1: 有 |
| next_cursor | 分页游标，下次请求时填写到 cursor 以获取之后分页的记录 |
| buy_list | 多企业购买信息列表，详见BuyInfo |
OrderInfo 说明
| 参数 | 说明 |
|---|---|
| order_id | 订单号 |
| order_type | 订单类型 8：多企业新购订单 |
| order_status | 订单状态 0：待支付 1：已支付 2：已取消（未支付，订单已关闭） 3：未支付，订单已过期 |
| price | 订单金额，单位分 |
| create_time | 创建时间，Unix时间戳 |
| pay_time | 支付时间，Unix时间戳 |
BuyInfo 说明
| 参数 | 说明 |
|---|---|
| sub_order_id | 子订单id，可以调用获取订单中的账号列表接口以获取账号列表 |
| corpid | 客户企业id，返回加密的corpid |
| account_count | 订单的账号数详情 |
| account_count.base_count | 基础账号个数 |
| account_count.external_contact_count | 互通账号个数 |
| account_duration | 账号购买时长 |
| account_duration.months | 购买的月数，每个月按照31天计算 |
| account_duration.days | 购买的天数 |
- 获取多企业订单详情
本节内容
