Get Budget

get

/rest/apis/customer/financials/budgets/{accountId}

Request

Path Parameters

There's no request body for this operation.

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.
  • currency
    Currency Code defines the currency in which the account's financial transactions are expressed.
  • 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 : currency
Type: object
Currency Code defines the currency in which the account's financial transactions are expressed.
Show Source
  • Maximum Length: 3
    Currency Code defines the currency in which the account's financial transactions are expressed.
    Example: USD
Nested Schema : serviceAgreementsList
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Budget Amount This is the existing budget amount, also referred to as the recurring charge amount, for the service agreement.
    Example: 232.00
  • Maximum Length: 5
    The CIS division on SA is actually part of the SA's SA type. Because SA type controls many business rules, all business rules that are on the SA type can be thought of as being defined for a given jurisdiction and SA type combination.
    Example: CA
  • Maximum Length: 1
    Description for CIS Division. CIS Division defines the jurisdiction that governs the account.
    Example: California
  • Last Changed Date is the date when the service agreement's budget amount, also referred to as the recurring charge amount, was last changed.
    Example: 2021-12-15
  • For an account with a small number of service agreements, the user may click the Recommend Budget button to generate a New Budget for each service agreement. The system will calculate the recommended budget and update the Budget Amount on all the eligible service agreements. Click Cancel Budget to have the system set the New Budget amount to zero for all the account's service agreements on budget.
  • serviceAgreement
  • serviceAgreementType
  • Maximum Length: 30
    Description for Service Agreement Type
    Example: Electric residential
  • Maximum Length: 30
    Service Type defines the type of service associated with the SA type.
    Example: E
Nested Schema : serviceAgreement
Type: object
Show Source
  • Maximum Length: 10
    Service agreement linked to the account that is eligible to participate in a budget billing plan
    Example: 9999999999
Nested Schema : serviceAgreementType
Type: object
Show Source
  • Maximum Length: 8
    SATYPE is Service Agreement 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: E-RES

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