Action Bill
patch
https://server:port/spl/rest/apis/customer/financials/bills/{billId}/lifecycle
This operation updates the Bill and Bill Segments status for the provided Bill id.
Request
Path Parameters
Supported Media Types
- application/xml
- application/json
Root Schema : schema
Type:
Show Source
object
-
accountingDate: string
(date)
Accounting Date defines the financial period to which the canceled and new bill segments' financial transactions are booked.Example:
2021-10-05
-
action: string
Allowed Values:
[ "C1CF", "C1CO", "C1CR", "C1DE", "C1FR", "C1GN", "C1RO" ]
ACTION * `C1CF` - CancelFrozen, * `C1CO` - Complete, * `C1CR` - Credit Note, * `C1DE` - Delete, * `C1FR` - Freeze, * `C1GN` - Generate, * `C1RO` - ReOpenExample:cancelFrozen
-
areEstimatesAllowed: boolean
Allow Estimates is defined as true if the system is allowed to estimate consumption when a meter read cannot be retrieved.Example:
false
-
billDate: string
(date)
Bill Date is the business date that was used when the bill was completed.
-
cancelReason: string
Maximum Length:
4
Cancel Reason defines why bill segments are being canceled. -
creditNoteDate: string
(date)
Credit Note date is the date on which all bill segments are cancelled and a new bill gets generated which contains the cancellation details.
-
cutOffDate: string
(date)
Cutoff Date is the last possible day of each bill period for a bill segment.Example:
2021-10-05
-
hasBillingOption: boolean
Billing Option defines how the system looks for meter reads.Example:
false
Root Schema : schema
Type:
Show Source
object
-
accountingDate: string
(date)
Accounting Date defines the financial period to which the canceled and new bill segments' financial transactions are booked.Example:
2021-10-05
-
action: string
Allowed Values:
[ "C1CF", "C1CO", "C1CR", "C1DE", "C1FR", "C1GN", "C1RO" ]
ACTION * `C1CF` - CancelFrozen, * `C1CO` - Complete, * `C1CR` - Credit Note, * `C1DE` - Delete, * `C1FR` - Freeze, * `C1GN` - Generate, * `C1RO` - ReOpenExample:cancelFrozen
-
areEstimatesAllowed: boolean
Allow Estimates is defined as true if the system is allowed to estimate consumption when a meter read cannot be retrieved.Example:
false
-
billDate: string
(date)
Bill Date is the business date that was used when the bill was completed.
-
cancelReason: string
Maximum Length:
4
Cancel Reason defines why bill segments are being canceled. -
creditNoteDate: string
(date)
Credit Note date is the date on which all bill segments are cancelled and a new bill gets generated which contains the cancellation details.
-
cutOffDate: string
(date)
Cutoff Date is the last possible day of each bill period for a bill segment.Example:
2021-10-05
-
hasBillingOption: boolean
Billing Option defines how the system looks for meter reads.Example:
false
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1ActionBill
Type:
Show Source
object
-
action: string
Allowed Values:
[ "C1CF", "C1CO", "C1CR", "C1DE", "C1FR", "C1GN", "C1RO" ]
ACTION * `C1CF` - CancelFrozen, * `C1CO` - Complete, * `C1CR` - Credit Note, * `C1DE` - Delete, * `C1FR` - Freeze, * `C1GN` - Generate, * `C1RO` - ReOpenExample:cancelFrozen
-
bill: object
bill
-
billStatus: string
Allowed Values:
[ "C ", "P " ]
Bill Status is the bill's status. A bill is initially saved in the Pending state. One or more bill segments can be created for the account's service agreements at this point. A bill becomes Complete when it is ready to be sent to the customer. * `C ` - Complete, * `P ` - PendingExample:C
-
nextActions: array
nextActions
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.Example:549133128888
Nested Schema : items
Type:
Show Source
object
-
action: string
Allowed Values:
[ "C1CF", "C1CO", "C1CR", "C1DE", "C1FR", "C1GN", "C1RO" ]
ACTION * `C1CF` - CancelFrozen, * `C1CO` - Complete, * `C1CR` - Credit Note, * `C1DE` - Delete, * `C1FR` - Freeze, * `C1GN` - Generate, * `C1RO` - ReOpenExample:cancelFrozen
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.