Action Budget

patch

https://server:port/spl/rest/apis/customer/financials/budgets/{accountId}/lifecycle

This operation perform actions like recommend, cancel, and save on budget.

Request

Path Parameters
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
  • Maximum Length: 10
    Account ID identifies the account of the customer for which the budget exists.
    Example: 1112345900
  • Allowed Values: [ "C1CN", "C1RC", "C1SV" ]
    Available action for the budget. * `C1CN` - Cancel, * `C1RC` - Recommend Budget, * `C1SV` - Save
  • budgetPlan
    Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
  • Maximum Length: 3
    Currency Code
  • Use New Budget Date to define the effective date of any changes to the customer's budget amount. This date is the effective date on the respective service agreements' recurring charge histories.
    Example: 2021-12-14
  • serviceAgreementsList
  • Total Budget Amount displays the sum of the service agreements' current budget amounts.
    Example: 252$
  • For accounts with a small number of service agreements, the system displays the sum of the service agreements' new budget amounts in Total New Budget.
    Example: 0.00$
Nested Schema : budgetPlan
Type: object
Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
Show Source
Nested Schema : serviceAgreementsList
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : serviceAgreement
Type: object
Show Source
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Maximum Length: 10
    Account ID identifies the account of the customer for which the budget exists.
    Example: 1112345900
  • Allowed Values: [ "C1CN", "C1RC", "C1SV" ]
    Available action for the budget. * `C1CN` - Cancel, * `C1RC` - Recommend Budget, * `C1SV` - Save
  • budgetPlan
    Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
  • Maximum Length: 3
    Currency Code
  • Use New Budget Date to define the effective date of any changes to the customer's budget amount. This date is the effective date on the respective service agreements' recurring charge histories.
    Example: 2021-12-14
  • serviceAgreementsList
  • Total Budget Amount displays the sum of the service agreements' current budget amounts.
    Example: 252$
  • For accounts with a small number of service agreements, the system displays the sum of the service agreements' new budget amounts in Total New Budget.
    Example: 0.00$
Nested Schema : budgetPlan
Type: object
Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
Show Source
Nested Schema : serviceAgreementsList
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : serviceAgreement
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1BudgetDeta
Type: object
Show Source
  • _self
  • Maximum Length: 10
    Account ID identifies the account of the customer for which the budget exists.
    Example: 1112345900
  • Allowed Values: [ "C1CN", "C1RC", "C1SV" ]
    Available action for the budget. * `C1CN` - Cancel, * `C1RC` - Recommend Budget, * `C1SV` - Save
  • budgetPlan
    Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
  • Maximum Length: 3
    Currency Code
  • Use New Budget Date to define the effective date of any changes to the customer's budget amount. This date is the effective date on the respective service agreements' recurring charge histories.
    Example: 2021-12-14
  • serviceAgreementsList
  • Total Budget Amount displays the sum of the service agreements' current budget amounts.
    Example: 252$
  • For accounts with a small number of service agreements, the system displays the sum of the service agreements' new budget amounts in Total New Budget.
    Example: 0.00$
Nested Schema : budgetPlan
Type: object
Budget Plan controls how the account's debt is managed for budget-related purposes. Specifically, it controls how the recommended budget amount is calculated and how or when the customer's budget is periodically changed.
Show Source
Nested Schema : serviceAgreementsList
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : serviceAgreement
Type: object
Show Source

400 Response

Bad Request
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • 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.
  • 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
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.

500 Response

Internal Server Error
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • 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.
  • 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
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.
Back to Top