获取分账账单

最近更新时间:2022-05-24 11:30:43

查看PDF

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>

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈