查询对账差异列表 - GetReconciliationDiffList
功能介绍
查询对账差异列表,根据数据核对接口返回的对账批次号进行查询
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/reconciliation/diff/getList
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| batchNo | 是 | String | 参数解释: 对账批次号 约束限制: 使用数据核对接口返回的对账批次号 取值范围: 不涉及 默认值: 不涉及 |
| pageSize | 否 | String | 参数解释: 每页数量 约束限制: 不涉及 取值范围: 1-1000 默认值: 100 |
| pageCursor | 否 | String | 参数解释: 起始分页游标 约束限制: 游标为空时从第一页开始查询 取值范围: 不涉及 默认值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| diffList | Array of DiffBill objects | 差异账单列表 |
| total | Integer | 总数 |
| nextPageCursor | String | 下次查询游标 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 查询对账差异列表响应 |