全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取分账账单

最近更新时间:2024-01-30 10:57:48

DescribeSplitItemBillDetails(分⻚查询分拆项账单明细)

本⽂档为您介绍查询分拆项账单明细,需确认已成功开通分账账单权限。
只支持查询开通分账账单权限当月(含)之后的数据

请求参数

名称

必选

类型

描述

Action

String

操作接口名,系统规定参数,取值:DescribeSplitItemBillDetails

Version

String

API版本,固定为2020-01-01

CustomerBillMonth

Integer

账期,格式:yyyyMM。如:202111

ProductGroupCode

String

产品线 code,目前仅支持KS3_GROUP

StatisticType

Integer

统计周期,固化传 3(代表明细)

PayType

Integer

计费类别,0(预付费),1(实时付费),2(后付费)

SubAccountId

Long

主账号所托管的账号Id

Page

Integer

第几页,默认值 1

Size

String

每页条数,默认 20,最多200

filterZero

String

ture,过滤成交价为0的数据;false或不填,不过滤成交价为0的数据。

返回元素(调用成功)

名称

类型

描述

RequestId

String

当前请求的RequestId

InstanceId

String

实例Id

InstanceName

String

实例名称

ProjectId

Long

项目 Id

ProjectName

String

项目名称

CustomerBillMonth

Integer

账期

BillMonth

Integer

账单月

productGroupName

String

产品线

productTypeName

String

产品类型

userId

Long

客户Id

UserName

String

客户名称

FinanceUnitName

String

财务单元

BillItemName

String

计费项

RegionName

String

机房

AvailabilityZone

String

可用区

BillStartTime

String

计费开始时间

BillEndTime

String

计费结束时间

ServiceBeginTime

String

服务开始时间

MeasureValue

String

用量。数值,字符串吐出。

MeasureValueUnit

String

用量单位

SplitItemName

String

分拆项名称

SplitRatio

String

分拆用量占比

Duration

String

计费时长

Price

String

原价

RealPrice

String

成交价

Cash

String

现金

Reward

String

赠送金

CloudTicketDenomination

String

云票支付

ResourceDeductValue

String

资源包抵扣用量

PriceFactorInfo

JSON数组

价格影响因子

ExtraInfo

JSON数组

附属信息

TagInfo

JSON数组

标签数组

billDetailTypeName

String

账单类型

payTypeName

String

计费类别

billTypeName

String

计费方式

CurrencyCode

String

币种

RuleRemark

String

说明

错误码(调用不成功)

错误代码(Code)

错误消息(Message)

HTTP 状态码

中文描述(语义)

InvalidParameter

There is one or more invalid parameter(%s)."

400

参数%s错误,具体参数名在%s说明

Forbidden Request

user %s forbidden request this api"

400

用户禁止请求API,用户uid在%s指名

Server unavailable

Server error

500

后端服务异常

示例(调用成功)

请求示例

https://bill-union.api.ksyun.com?Action=DescribeSplitItemBillDetails&Version=2020-01-01&ProductGroupCode=KS3_GROUP&StatisticType=3&PayType=2&Page=1&Size=2&CustomerBillMonth=202110
&公共请求参数

返回示例

json 输出样例
{
    "Status": 200,
    "RequestId": "5248af7b-f583-44f8-8ab8-cc3c735b6669",
    "Data": {
        "Page": 1,
        "Size": 2,
        "Total": 283396,
        "bills": [
            {
                "InstanceId": "55629444_KS3-CDN",
                "InstanceName": "",
                "ProjectId": 101255,
                "ProjectName": "个人版",
                "ProductGroupName": "对象存储",
                "ProductTypeName": "对象存储",
                "BillItemName": "流量",
                "BillStartTime": "2021-10-01 00:00:00",
                "BillEndTime": "2021-10-31 23:59:59",
                "ServiceBeginTime": "",
                "RegionName": "国内",
                "AvailabilityZone": "",
                "PayTypeName": "后付费",
                "BillTypeName": "按量付费(流量月结)",
                "BillDetailTypeName": "消费",
                "MeasureValue": "347.79",
                "MeasureValueUnit": "G",
                "SplitItemName": "fcheckreviewcache",
                "SplitRatio": "2.90%",
                "Price": "139.1159",
                "RealPrice": "45.21",
                "Cash": "0",
                "Reward": "0",
                "CloudTicketDenomination": "0",
                "ResourceDeductValue": "0",
                "Duration": "31天",
                "RuleRemark": "",
                "FinanceUnitName": "第一单元",
                "PriceFactorInfo": [],
                "ExtraInfo": [],
                "TagInfo": [],
                "UserId": 55629444,
                "UserName": "珠海金山办公软件有限公司",
                "BillMonth": 202110,
                "CustomerBillMonth": 202110,
                "CurrencyCode": "RMB"
            },
            {
                "InstanceId": "55629444_KS3-CDN",
                "InstanceName": "",
                "ProjectId": 101639,
                "ProjectName": "开放平台",
                "ProductGroupName": "对象存储",
                "ProductTypeName": "对象存储",
                "BillItemName": "流量",
                "BillStartTime": "2021-10-01 00:00:00",
                "BillEndTime": "2021-10-31 23:59:59",
                "ServiceBeginTime": "",
                "RegionName": "国内",
                "AvailabilityZone": "",
                "PayTypeName": "后付费",
                "BillTypeName": "按量付费(流量月结)",
                "BillDetailTypeName": "消费",
                "MeasureValue": "0",
                "MeasureValueUnit": "G",
                "SplitItemName": "test-esign-web-cdn",
                "SplitRatio": "0.00%",
                "Price": "0",
                "RealPrice": "0",
                "Cash": "0",
                "Reward": "0",
                "CloudTicketDenomination": "0",
                "ResourceDeductValue": "0",
                "Duration": "31天",
                "RuleRemark": "",
                "FinanceUnitName": "第一单元",
                "PriceFactorInfo": [],
                "ExtraInfo": [],
                "TagInfo": [],
                "UserId": 55629444,
                "UserName": "珠海金山办公软件有限公司",
                "BillMonth": 202110,
                "CustomerBillMonth": 202110,
                "CurrencyCode": "RMB"
            }
        ]
    },
    "Error": null
}
xml 输出样例
<OpenApiResponse>
    <Status>200</Status>
    <RequestId></RequestId>
    <Data>
        <Page>1</Page>
        <Size>2</Size>
        <Total>320343</Total>
        <bills>
            <bills>
                <InstanceId>55629444_KS3-CDN</InstanceId>
                <InstanceName></InstanceName>
                <ProjectId>101196</ProjectId>
                <ProjectName>稻壳</ProjectName>
                <ProductGroupName>KS3</ProductGroupName>
                <ProductTypeName>KS3</ProductTypeName>
                <BillItemName>TRANSFER</BillItemName>
                <BillStartTime>2021-09-01 00:00:00</BillStartTime>
                <BillEndTime>2021-09-30 23:59:59</BillEndTime>
                <ServiceBeginTime></ServiceBeginTime>
                <RegionName>KS3_CN</RegionName>
                <AvailabilityZone></AvailabilityZone>
                <PayTypeName>Postpaid</PayTypeName>
                <BillTypeName>Pay-By-Traffic (Monthly)</BillTypeName>
                <BillDetailTypeName>Consume</BillDetailTypeName>
                <MeasureValue>0.0279</MeasureValue>
                <MeasureValueUnit>G</MeasureValueUnit>
                <SplitItemName>test-wpsfile</SplitItemName>
                <SplitRatio>0.43%</SplitRatio>
                <Price>0.01118</Price>
                <RealPrice>0</RealPrice>
                <Cash>0</Cash>
                <Reward>0</Reward>
                <CloudTicketDenomination>0</CloudTicketDenomination>
                <ResourceDeductValue>0</ResourceDeductValue>
                <Duration>30 day </Duration>
                <RuleRemark></RuleRemark>
                <FinanceUnitName>第一单元</FinanceUnitName>
                <PriceFactorInfo/>
                <ExtraInfo/>
                <TagInfo/>
                <UserId>55629444</UserId>
                <UserName>珠海金山办公软件有限公司</UserName>
                <BillMonth>202109</BillMonth>
                <CustomerBillMonth>202109</CustomerBillMonth>
                <CurrencyCode>RMB</CurrencyCode>
            </bills>
            <bills>
                <InstanceId>55629444_KS3-CDN</InstanceId>
                <InstanceName></InstanceName>
                <ProjectId>101255</ProjectId>
                <ProjectName>个人版</ProjectName>
                <ProductGroupName>KS3</ProductGroupName>
                <ProductTypeName>KS3</ProductTypeName>
                <BillItemName>TRANSFER</BillItemName>
                <BillStartTime>2021-09-01 00:00:00</BillStartTime>
                <BillEndTime>2021-09-30 23:59:59</BillEndTime>
                <ServiceBeginTime></ServiceBeginTime>
                <RegionName>KS3_CN</RegionName>
                <AvailabilityZone></AvailabilityZone>
                <PayTypeName>Postpaid</PayTypeName>
                <BillTypeName>Pay-By-Traffic (Monthly)</BillTypeName>
                <BillDetailTypeName>Consume</BillDetailTypeName>
                <MeasureValue>0</MeasureValue>
                <MeasureValueUnit>G</MeasureValueUnit>
                <SplitItemName>wwo-cdn</SplitItemName>
                <SplitRatio>0.00%</SplitRatio>
                <Price>0</Price>
                <RealPrice>0</RealPrice>
                <Cash>0</Cash>
                <Reward>0</Reward>
                <CloudTicketDenomination>0</CloudTicketDenomination>
                <ResourceDeductValue>0</ResourceDeductValue>
                <Duration>30 day </Duration>
                <RuleRemark></RuleRemark>
                <FinanceUnitName>第一单元</FinanceUnitName>
                <PriceFactorInfo/>
                <ExtraInfo/>
                <TagInfo/>
                <UserId>55629444</UserId>
                <UserName>珠海金山办公软件有限公司</UserName>
                <BillMonth>202109</BillMonth>
                <CustomerBillMonth>202109</CustomerBillMonth>
                <CurrencyCode>RMB</CurrencyCode>
            </bills>
        </bills>
    </Data>
    <Error/>
</OpenApiResponse>

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈