获取分账账单

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>