文档首页/ 云空间服务 KooDrive/ API参考(运营商)/ API/ 运营商对账/ 查询对账差异列表 - GetReconciliationDiffList
更新时间:2026-04-16 GMT+08:00

查询对账差异列表 - GetReconciliationDiffList

功能介绍

查询对账差异列表,根据数据核对接口返回的对账批次号进行查询

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/reconciliation/diff/getList

表1 Query参数

参数

是否必选

参数类型

描述

batchNo

String

参数解释:

对账批次号

约束限制:

使用数据核对接口返回的对账批次号

取值范围:

不涉及

默认值:

不涉及

pageSize

String

参数解释:

每页数量

约束限制:

不涉及

取值范围:

1-1000

默认值:

100

pageCursor

String

参数解释:

起始分页游标

约束限制:

游标为空时从第一页开始查询

取值范围:

不涉及

默认值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

参数解释:

该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token}

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

x-traceid

String

参数解释:

业务跟踪id(必须58位)

约束限制:

不涉及

取值范围:

长度为58位

默认值:

不涉及

X-Date

String

参数解释:

日期,用于app鉴权

约束限制:

日期格式:yyyyMMDD'T'HHmmss'Z' ; 例如20251103T070140Z

取值范围:

距当前时间15分钟以内,不能晚于当前时间

默认值:

不涉及

X-User-Id

String

参数解释:

KooDrive侧用户id,用于app鉴权

约束限制:

不涉及

取值范围:

不涉及

默认值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

diffList

Array of DiffBill objects

差异账单列表

total

Integer

总数

nextPageCursor

String

下次查询游标

表4 DiffBill

参数

参数类型

描述

carrierOrderId

String

运营商订单ID

kdOrderId

String

KooDrive侧订单ID

carrierUserId

String

运营商用户ID

carrierOrderTime

String

运营商侧用户下单时间

kdUserId

String

KooDrive用户ID

userStatus

String

KooDrive用户状态

diffType

String

差异类型 1运营商侧无订购记录 2华为侧无订购记录 3权益不一致 4分账金额不一致

diffReason

String

差异原因

skuCode

String

sku编码

skuPrice

Double

sku单价

billingCycle

String

归属账期

carrierSale

String

运营商收入

carrierSaleToKd

String

运营商给华为分成

thisMouthBilling

String

华为本月出账金额

nextMouthBilling

String

华为次月出账金额

channel

String

渠道值

carrierActiveTime

String

运营商侧生效时间

carrierEndTime

String

运营商侧结束时间

carrierPackageId

String

运营商侧记录的套餐ID

kdActiveTime

String

KooDrive侧生效时间

kdEndTime

String

KooDrive侧结束时间

kdOrderTime

String

KooDrive侧订购时间

kdPackageId

String

KooDrive侧记录的套餐ID

kdSaleTotal

Double

KooDrive侧该订单的收入(如果是分成模式,则为应该分成金额)

请求示例

查询对账差异列表请求

/koodrive/ose/v1/reconciliation/diff/getList

batchNo=20251021_1801572310432403201&pageSize=100

响应示例

状态码:200

查询对账差异列表响应

{
  "diffList": [
    {
      "carrierOrderId": "123124444435355",
      "kdOrderId": "133556565222323",
      "carrierUserId": "4565523231",
      "carrierOrderTime": "2025-10-27T11:47:46.977Z",
      "kdUserId": "111114152",
      "userStatus": "1",
      "diffType": "1",
      "diffReason": "activeTime is different",
      "skuCode": "1p500g",
      "skuPrice": 0.00012,
      "billingCycle": "2025-08",
      "carrierSale": "10",
      "carrierSaleToKd": "0.5",
      "thisMouthBilling": "3",
      "nextMouthBilling": "7",
      "channel": "0",
      "carrierActiveTime": "2025-10-27T11:47:46.977Z",
      "carrierEndTime": "2025-10-27T11:47:46.977Z",
      "carrierPackageId": "1235666",
      "kdActiveTime": "2025-10-27T11:47:46.977Z",
      "kdEndTime": "2025-10-27T11:47:46.977Z",
      "kdOrderTime": "2025-10-27T11:47:46.977Z",
      "kdPackageId": "1235666",
      "kdSaleTotal": 0
    }
  ],
  "total": 0,
  "nextPageCursor": "121333"
  "code":0,
  "msg": "success"
}

状态码

状态码

描述

200

查询对账差异列表响应