# 查询收支明细-ListPartnerAccountChangeRecords #### 功能介绍 伙伴在伙伴销售平台上查询自身的收支明细情况。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 查询时间跨度最大限制为一年。 #### 接口约束 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ListPartnerAccountChangeRecords)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。 接口对应的权限项如下： | 权限项 | 权限项名称 | |:---|:---| | BPC_ITEM_FINANCE_030100 | 销售-账务-资金管理-收支明细-查看收支明细 | #### URI GET /v2/accounts/partner-accounts/account-change-records 表1查询参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | balance_type | 是 | String | \[BALANCE_TYPE_DEBIT\|BALANCE_TYPE_CREDIT\] | 账户类型。 - BALANCE_TYPE_DEBIT：现金账户 - BALANCE_TYPE_CREDIT：信用账户 | | trade_type | 否 | String | \[RECHARGE\|DEDEUCT\|REFUND\|RFROZEN\|TRANS\|ADJUST\|BEADJUST\|BERETRIEVE\|BEUNBIND\|BONUSCONVERT\|TRADE_MODE_TRANSFER\] | 交易类型。 - RECHARGE：充值 - DEDEUCT：消费 - REFUND：退款 - RFROZEN：冻结 - TRANS：转账，余额和保证金互换（老商务模式，当前已无保证金账户） - ADJUST：调账（华为核销等） - BEADJUST：经销商拨款 - BERETRIEVE：经销商回收 - BEUNBIND：解绑/关联模式切换导致的回收 - BONUSCONVERT：奖励金转换（老商务模式，当前已无奖励金账户） - TRADE_MODE_TRANSFER：交易模式变更 此参数不携带或携带值为空时，不作为筛选条件。 | | trade_time_begin | 否 | String | 最大长度：10 | 查询收支明细的开始日期。 说明： - 东八区时间，格式为YYYY-MM-DD，如"2017-10-21"。 - 默认值为一年前的当天日期。 | | trade_time_end | 否 | String | 最大长度：10 | 查询收支明细的结束日期。 说明： - 东八区时间，格式为YYYY-MM-DD，如"2017-12-21"。 - 默认值为当前日期。 | | offset | 否 | Integer | \[0-最大整数\] | 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2\~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 | | limit | 否 | Integer | \[1-100\] | 每次查询的数量，默认值为10。 | | indirect_partner_id | 否 | String | 最大长度：64 | 云经销商ID。获取方法请参见[查询云经销商列表](https://support.huaweicloud.com/api-bpconsole/espp_00003.html)。 说明： 华为云总经销商（一级经销商）查询云经销商（二级经销商）的收支明细时，需携带此参数；除此之外，此参数不做处理。否则只能查询自身的收支明细。 | #### 请求消息 **请求参数** 无 **请求示例** ``` GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/account-change-records?balance_type=BALANCE_TYPE_DEBIT&trade_type=RECHARGE&trade_time_begin=2020-10-20&trade_time_end=2021-10-20&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` #### 响应消息 **响应参数** | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | error_code | String | 最大长度：20 | 状态码。具体参见[状态码]。只有失败才会返回这个参数。 | | error_msg | String | 最大长度：2000 | 错误描述信息。只有失败才会返回这个参数。 | | total_count | Integer | - | 返回总条数。 | | currency | String | 最大长度：4 | 币种。 CNY：人民币。 | | records | List\ | - | 调账记录列表。 具体请参见[表2]。 | 表2AccountChangeRecord | 参数 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---| | account_change_id | String | 最大长度：128 | 收支明细流水号。 | | trade_detail_type | String | 最大长度：128 | 交易详细类型。 - SOURCE_OPERAIION_ADJUST_CREDIT：调账(信用额度调整) - SOURCE_OPERAIION_RECHARGE：充值 - SOURCE_OPERAIION_DEDEUCT：消费(包年/包月) - SOURCE_OPERAIION_MANUALFROZE：冻结(人工冻结) - SOURCE_OPERAIION_MANUALUNFROZE：冻结(人工解冻) - SOURCE_OPERAIION_MANUALCLEARFROZEN：冻结(人工清零) - SOURCE_OPERAIION_TRANS_TO_BALANCE：转账(保证金转余额) - SOURCE_OPERATION_BEADJUST：伙伴拨款 - SOURCE_OPERATION_BEUNBIND：交易模式变更(切换/解除关联回收) - SOURCE_OPERAIION_EXPIRECLEAR：过期清零 - SOURCE_OPERAIION_ONETIME：消费(一次性扣费) - SOURCE_OPERAIION_REFUND：退款 - SOURCE_OPERAIION_UNFROZEN：退款(退款解冻) - SOURCE_OPERAIION_CLEARFROZEN：退款(退款清零) - SOURCE_OPERAIION_ADJUST：调账(余额调整) - SOURCE_OPERAIION_USAGE：消费(按需) - SOURCE_OPERAIION_WRITEOFF：消费(欠费还款) - SOURCE_OPERAIION_UNSUBSCRIBE：退款 - SOURCE_OPERAIION_RFROZEN：退款(退款冻结) - SOURCE_OPERAIION_TRANS_TO_FOREGIFT：转账(余额转保证金) - SOURCE_OPERAIION_PRIZE：调账(赠送) - SOURCE_OPERATION_BERETRIEVE：伙伴回收 - SOURCE_OPERAIION_PRECISIONCOMP：消费(精度补扣) - SOURCE_OPERAIION_FREERESDEDUCT：消费(免费资源扣减) - SOURCE_OPERAIION_MERGE：奖励金转换(合并) - SOURCE_OPERAIION_CONVERT_BONUS：奖励金转换 - SOURCE_OPERAIION_RECHARGE_REBATE：充值(激励返点) - SOURCE_OPERATION_COUPONCANCEL：优惠券回收 - SOURCE_OPERAIION_BILLREFUND：调账(华为核销) - SOURCE_OPERATION_TRADEMODE_TRANSFER：交易模式变更(和伙伴关联) - SOURCE_OPERATION_SYSTEM_FROZEN：调账（余额调整） - SOURCE_OPERATION_SYSTEM_UNFROZEN：调账（余额调整） - SOURCE_OPERATION_COUPON_QUOTA_TRANSFER：调账(兑换现金券额度) - SOURCE_OPERATION_COUPON_QUOTA_RECLAIM：代金券回收 - SOURCE_OPERAIION_SAVINGS_PLANS：消费（节省计划） - SOURCE_OPERAIION_WRITEOFF_CREDIT：消费(信用还款) | | trade_time | String | 最大长度：20 | 交易时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2016-03-28T14:45:38Z"。 | | trade_id | String | 最大长度：128 | 交易ID/订单ID。 | | change_amount | String | 最大长度：64 | 变更金额，单位为元。 | | balance_after_change | String | 最大长度：64 | 变更后余额，单位为元。 | | type | String | 最大长度：64 | 收支类型。 - 1：收入 - 2：支出 | | customer_id | String | 最大长度：64 | 客户账号ID。 说明：交易详细类型取值为如下值时，该字段不为空 - SOURCE_OPERATION_BEADJUST：伙伴拨款 - SOURCE_OPERATION_BEUNBIND：交易模式变更(切换/解除关联回收) - SOURCE_OPERATION_BERETRIEVE：伙伴回收 | | account_name | String | 最大长度：128 | 客户登录名称。 说明：客户账号ID不为空时，该字段不为空 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "total_count": 1, "currency": "CNY", "records": [ { "account_change_id": "AC-8500000373-0", "trade_detail_type": "SOURCE_OPERAIION_RECHARGE", "trade_time": "2021-04-02T06:05:38Z", "trade_id": "CB123456", "change_amount": "1053.35", "balance_after_change": "0.00", "type": "1", "customer_id": "0666********d5c80f6dc01a9a3598a0", "account_name": "betahc_kehu107" } ] } ``` #### 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 400 | CBC.0100 | 参数错误。 | | 400 | CBC.99000037 | 您没有操作该云经销商的权限。 | | 400 | CBC.80021021 | 查询时间跨度最大限制为一年。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |