Bill Segment Search
post
/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:
0Maximum Value:999999999.999999Page Limit -
offset: number
Minimum Value:
0Maximum Value:999999999.999999Page 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:
12Bill 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:
30Service 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:
12Bill 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:
30Service Type defines the type of service associated with the SA type.Example:E -
textSearch: string
Maximum Length:
200Search text
Root Schema : schema
Type:
Show Source
object-
filters: object
filters
-
hasMore: boolean
Has MoreExample:
false -
limit: number
Minimum Value:
0Maximum Value:999999999.999999Page Limit -
offset: number
Minimum Value:
0Maximum Value:999999999.999999Page 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:
12Bill 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:
30Service 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:
12Bill 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:
30Service Type defines the type of service associated with the SA type.Example:E -
textSearch: string
Maximum Length:
200Search 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:
0Maximum Value:99999Number of Bill Segments for serviceType in bill segment status.Example:8 -
hasMore: boolean
Has MoreExample:
false -
limit: number
Minimum Value:
0Maximum Value:999999999.999999Page Limit -
offset: number
Minimum Value:
0Maximum Value:999999999.999999Page Offset -
totalNumberOfRecords: number
Minimum Value:
0Maximum Value:99999Total Number Of RecordsExample:8
Nested Schema : bill
Type:
Show Source
object-
_link: string
_link
-
billId: string
Maximum Length:
12Bill 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:
60Description for Bill Segment StatusExample:Pending Cancel -
currency: string
Maximum Length:
3Currency Code -
currentAmount: number
Current Amount
-
endingRatePlan: string
Maximum Length:
8Rate 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:
254Premise 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:
12Bill 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:
10Premise 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:
10SA 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:
1The 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:
1The 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:
8The 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:
30The 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:
objectService Type defines the type of service associated with the SA type.
Show Source
-
_link: string
_link
-
serviceType: string
Maximum Length:
80Service 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:
-1000000000000Maximum Value:1000000000000Billable Service Quantity -
unitOfMeasure: string
Maximum Length:
30Unit of Measure
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully 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:
60URL 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:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully 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:
60URL 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:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.