Bill Segment Search
post
https://server:port/spl/rest/apis/customer/financials/billSegments/search
This operation retrieves all bill Segments information for the provided Bill Id.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
Root Schema : schema
Type:
Show Source
object
-
filters: object
filters
-
hasMore: boolean
Has MoreExample:
false
-
limit: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Limit -
offset: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Offset
Nested Schema : filters
Type:
Show Source
object
-
billSearch: object
billSearch
-
billTextSearch: object
billTextSearch
-
queryOption: string
Allowed Values:
[ "C1BI", "C1BT" ]
Bill Segment Query Option: * `C1BI` - Bill Search, * `C1BT` - Bill Text Search
Nested Schema : billSearch
Type:
Show Source
object
-
billId: string
Maximum Length:
12
Bill ID is the system-assigned unique identifier of the bill on which the bill segment appears. A concatenation of its bill date, status, due date and amount is displayed.Example:211122345678
-
serviceType: string
Maximum Length:
30
Service Type defines the type of service associated with the SA type.Example:E
-
status: string
Allowed Values:
[ "10 ", "20 ", "30 ", "40 ", "50 ", "60 ", "70 " ]
Bill Segment Status: * `10 ` - Incomplete, * `20 ` - Error, * `30 ` - Freezable, * `40 ` - Pending Cancel, * `50 ` - Frozen, * `60 ` - Canceled, * `70 ` - OK
Nested Schema : billTextSearch
Type:
Show Source
object
-
billId: string
Maximum Length:
12
Bill ID is the system-assigned unique identifier of the bill on which the bill segment appears. A concatenation of its bill date, status, due date and amount is displayed.Example:211122345678
-
serviceType: string
Maximum Length:
30
Service Type defines the type of service associated with the SA type.Example:E
-
textSearch: string
Maximum Length:
200
Search text
Root Schema : schema
Type:
Show Source
object
-
filters: object
filters
-
hasMore: boolean
Has MoreExample:
false
-
limit: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Limit -
offset: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Offset
Nested Schema : filters
Type:
Show Source
object
-
billSearch: object
billSearch
-
billTextSearch: object
billTextSearch
-
queryOption: string
Allowed Values:
[ "C1BI", "C1BT" ]
Bill Segment Query Option: * `C1BI` - Bill Search, * `C1BT` - Bill Text Search
Nested Schema : billSearch
Type:
Show Source
object
-
billId: string
Maximum Length:
12
Bill ID is the system-assigned unique identifier of the bill on which the bill segment appears. A concatenation of its bill date, status, due date and amount is displayed.Example:211122345678
-
serviceType: string
Maximum Length:
30
Service Type defines the type of service associated with the SA type.Example:E
-
status: string
Allowed Values:
[ "10 ", "20 ", "30 ", "40 ", "50 ", "60 ", "70 " ]
Bill Segment Status: * `10 ` - Incomplete, * `20 ` - Error, * `30 ` - Freezable, * `40 ` - Pending Cancel, * `50 ` - Frozen, * `60 ` - Canceled, * `70 ` - OK
Nested Schema : billTextSearch
Type:
Show Source
object
-
billId: string
Maximum Length:
12
Bill ID is the system-assigned unique identifier of the bill on which the bill segment appears. A concatenation of its bill date, status, due date and amount is displayed.Example:211122345678
-
serviceType: string
Maximum Length:
30
Service Type defines the type of service associated with the SA type.Example:E
-
textSearch: string
Maximum Length:
200
Search text
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1BilSegSrch
Type:
Show Source
object
-
bill: object
bill
-
billSegments: array
billSegments
-
count: number
Minimum Value:
0
Maximum Value:99999
Number of Bill Segments for serviceType in bill segment status.Example:8
-
hasMore: boolean
Has MoreExample:
false
-
limit: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Limit -
offset: number
Minimum Value:
0
Maximum Value:9.99999999999999E8
Page Offset -
totalNumberOfRecords: number
Minimum Value:
0
Maximum Value:99999
Total Number Of RecordsExample:8
Nested Schema : bill
Type:
Show Source
object
-
_link: string
_link
-
billId: string
Maximum Length:
12
Bill ID is the system-assigned unique identifier of the bill on which the bill segment appears. A concatenation of its bill date, status, due date and amount is displayed.Example:211122345678
Nested Schema : items
Type:
Show Source
object
-
billSegment: object
billSegment
-
billSegmentStatus: string
Allowed Values:
[ "10 ", "20 ", "30 ", "40 ", "50 ", "60 ", "70 " ]
Bill Segment Status: * `10 ` - Incomplete, * `20 ` - Error, * `30 ` - Freezable, * `40 ` - Pending Cancel, * `50 ` - Frozen, * `60 ` - Canceled, * `70 ` - OK -
billSegmentStatusDescription: string
Maximum Length:
60
Description for Bill Segment StatusExample:Pending Cancel
-
currency: string
Maximum Length:
3
Currency Code -
currentAmount: number
Current Amount
-
endingRatePlan: string
Maximum Length:
8
Rate Schedule -
hasMultipleLineGroup: boolean
Has Multiple Line GroupExample:
true
-
isClosingBillSegment: boolean
If the Closing switch is on, this is the final bill segment for the service agreement (i.e., the service agreement has been stopped and this is the final bill segment).Example:
true
-
isEstimate: boolean
If the Estimate switch is on, consumption on this bill segment has been estimated by the system.Example:
true
-
isItemOverridden: boolean
Item Override
-
isServiceQuantityOverridden: boolean
SQ Override
-
periodEndDate: string
(date)
Maximum of the Bill Segment bill period end datesExample:
2010-07-01
-
periodStartDate: string
(date)
Start Date
-
premise: object
premise
-
premiseInfo: string
Maximum Length:
254
Premise Info -
serviceAgreement: object
serviceAgreement
-
serviceAgreementType: object
serviceAgreementType
-
serviceType: object
serviceType
Service Type defines the type of service associated with the SA type.
-
totalQuantity: object
totalQuantity
Nested Schema : billSegment
Type:
Show Source
object
-
_link: string
_link
-
billSegmentId: string
Maximum Length:
12
Bill Segment ID is the system-assigned unique identifier of the bill segment.Example:211366855400
Nested Schema : premise
Type:
Show Source
object
-
_link: string
_link
-
premiseId: string
Maximum Length:
10
Premise ID defines the address on bills for persons who have their bill sent to the account's mailing premise.
Nested Schema : serviceAgreement
Type:
Show Source
object
-
_link: string
_link
-
serviceAgreementId: string
Maximum Length:
10
SA ID contains information about the bill segment's service agreement.Example:0340281111
Nested Schema : serviceAgreementType
Type:
Show Source
object
-
_link: string
_link
-
cisDivision: string
Maximum Length:
1
The CIS division for service agreements is part of the service agreement's SA type. The SA type controls many business rules, and thus all business rules that are on the SA type are defined for a given jurisdiction and SA type combination.Example:OH
-
cisDivisionDescription: string
Maximum Length:
1
The CIS division for service agreements is part of the service agreement's SA type. The SA type controls many business rules, and thus all business rules that are on the SA type are defined for a given jurisdiction and SA type combination.Example:OH
-
saType: string
Maximum Length:
8
The CIS division for service agreements is part of the service agreement's SA type. The SA type controls many business rules, and thus all business rules that are on the SA type are defined for a given jurisdiction and SA type combination.Example:OH
-
serviceAgreementTypeDescription: string
Maximum Length:
30
The CIS division for service agreements is part of the service agreement's SA type. The SA type controls many business rules, and thus all business rules that are on the SA type are defined for a given jurisdiction and SA type combination.Example:OH
Nested Schema : serviceType
Type:
object
Service Type defines the type of service associated with the SA type.
Show Source
-
_link: string
_link
-
serviceType: string
Maximum Length:
80
Service Type defines the type of service associated with the SA type.Example:E
Nested Schema : totalQuantity
Type:
Show Source
object
-
totalFoundIndicator: boolean
Total Found Indicator flag is true when SA's SA Type UOM matches UOM from the Bill Segment's Service Quantity collection.Example:
true
-
totalServiceQuantity: number
Minimum Value:
-1.0E12
Maximum Value:1.0E12
Billable Service Quantity -
unitOfMeasure: string
Maximum Length:
30
Unit of Measure
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.