Billed Usage for SA
post
https://server:port/spl/rest/apis/customer/usage/usageData/
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
Nested Schema : items
Type:
Show Source
object
-
endDate: string
(date)
SA end date
-
serviceAgreementId: string
Maximum Length:
10
SA ID is the bill segment's service agreement. -
startDate: string
(date)
SA start date
Nested Schema : items
Type:
Show Source
object
-
endDate: string
(date)
SA end date
-
serviceAgreementId: string
Maximum Length:
10
SA ID is the bill segment's service agreement. -
startDate: string
(date)
SA start date
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Nested Schema : serviceAgreementDetails
Type:
Show Source
object
-
billSegments: array
billSegments
-
graphUnitOfMeasure: string
Maximum Length:
30
Unit of MeasureExample:KWH
-
saEndDate: string
(date)
SA end date
-
saId: string
Maximum Length:
10
SA ID is the bill segment's service agreement. -
saStartDate: string
(date)
SA start date
-
serviceTypeCode: string
Maximum Length:
80
Service Type defines the type of service associated with the SA type.Example:W
Nested Schema : items
Type:
Show Source
object
-
billDate: string
(date)
The business date that was used when the bill batch generated the bill.
-
billSegmentId: string
Maximum Length:
12
Bill Segment ID is the system-assigned unique identifier of the bill segment. -
endDate: string
(date)
The end of the period of time covered by the bill segment's charges. The bill period is exclusive of this datetime value.Example:
2021-01-01
-
estimated: boolean
A flag to indicate whether or not this value was estimated.
-
startDate: string
(date)
The start of the period of time covered by the bill segment's charges. The bill period is inclusive of this datetime value.Example:
2020-01-01
-
totalAmount: number
Sum of amounts from financial transactions for the bill's non-canceled segments.
-
usage: array
usage
Nested Schema : items
Type:
Show Source
object
-
serviceQuantityIdentifer: string
Maximum Length:
30
SQI is the service quantity identifier of the bill segments's service quantity.Example:DAMT (Daily Amount)
-
timeOfUse: string
Maximum Length:
30
Time of Use is the time-of-use of the bill segment's service quantity.Example:OFF
-
unitOfMeasure: string
Maximum Length:
30
Unit of Measure is the unit of measure of the bill segments's service quantity.Example:KWH
-
usageIdentifier: string
Maximum Length:
12
Usage Identifier (combination of UOM/TOU/SQI)Example:KWH/-/-
-
usageValue: number
Minimum Value:
0
Maximum Value:999999
Usage ValueExample:31743.8
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60
URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60
URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.