Get Service Agreement

get

https://server:port/spl/rest/apis/customer/v-model/serviceAgreements/{serviceAgreementId}

This Operation handles the Integration Suite API to Get Service Agreement.

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 : C1-ServiceAg
Type: object
Show Source
Nested Schema : account
Type: object
Show Source
  • Maximum Length: 10
    Account ID defines the account that is financially responsible for the service agreement. If you change a service agreement's Account ID, you are effectively transferring this service agreement, and its debt, to the new account.
    Example: 1589809012
Nested Schema : billMessages
Type: object
Show Source
Nested Schema : characteristics
Type: object
Show Source
Nested Schema : consumerContractProducts
Type: object
Show Source
Nested Schema : contractOptions
Type: object
Show Source
Nested Schema : contractQuantities
Type: object
Show Source
Nested Schema : contractTerms
Type: object
Show Source
Nested Schema : currency
Type: object
Currency Code defines the currency in which the rate's prices are expressed.
Show Source
Nested Schema : division
Type: object
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.
Show Source
  • Maximum Length: 5
    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: Ohio
Nested Schema : order
Type: object
Show Source
Nested Schema : premise
Type: object
Show Source
  • Maximum Length: 10
    If the service agreement's rate uses premise-based characteristics for taxation and other purposes, Characteristic Premise ID defines the premise that supplies these characteristics. This field also defines the premise under which the service agreement's bill segments are classified and is used to identify where the service agreement's service is located.
    Example: 8614900960
Nested Schema : rateScheduleHistory
Type: object
Show Source
Nested Schema : recurringChargeHistory
Type: object
Show Source
Nested Schema : serviceAgreementRelationship
Type: object
Show Source
Nested Schema : serviceAgreementType
Type: object
Show Source
Nested Schema : servicePoints
Type: object
Show Source
Nested Schema : sicCode
Type: object
Select the SIC Code associated with the customer. This is typically only used for commercial and industrial customers.
Show Source
  • Maximum Length: 8
    Select the SIC Code associated with the customer. This is typically only used for commercial and industrial customers.
    Example: 4800 (Transportation)
Nested Schema : termsAndConditions
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • billMessage
  • Allowed Values: [ "P ", "T " ]
    For Bill Message Type, use Temporary to indicate the message should only be linked to the next bill produced for the account. Use Permanent if the message should appear on every bill. Temporary is the default value.
    Example: T
  • Minimum Value: -99999
    Maximum Value: 99999
    Version
    Example: 2
Nested Schema : billMessage
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : characteristicType
Type: object
Show Source
Nested Schema : characteristicValue
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : consumerContractProduct
Type: object
Show Source
Nested Schema : consumerContractRule
Type: object
Show Source
Nested Schema : consumerProductComponent
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : contractOption
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : contractQuantityType
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • billFactor
  • Allowed Values: [ "R ", "T ", "V " ]
    Billing uses Contract Term information when it calculates a bill segment for the service agreement. The Contract Rider type contains the contract riders that are in effect for the service agreement. The Contract Value type contains the contract values that are in effect for the service agreement. The Tax Exemptions type contains the taxes from which the service agreement is all or partially exempt.
    Example: R
  • End Date defines the date on which the contract rider expires.
    Example: 2018-02-25
  • Minimum Value: -999.9999
    Maximum Value: 999.9999
    Percent Exempt defines the customer tax exemption percent. For example, 90 means the customer is 90% exempt and will only pay 10% of the normal tax rate.
    Example: 0.0000
  • Start Date defines the date on which the contract rider becomes effective. The service agreement's start date acts as the default value.
  • Maximum Length: 35
    Tax Certification defines whether the customer has a tax exemption certificate.
  • taxExemptType
  • Maximum Length: 30
    Indicate the TOU Group that corresponds with the TOU group on the service agreement's TOU Map. Once entered, the collection of TOU codes linked to this TOU group will display.
  • Minimum Value: -1.0E11
    Maximum Value: 1.0E11
    Defines the time of use code value.
  • Minimum Value: -99999
    Maximum Value: 99999
    Version
    Example: 2
Nested Schema : billFactor
Type: object
Show Source
Nested Schema : taxExemptType
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : rateSchedule
Type: object
Show Source
  • Maximum Length: 8
    Rate Schedule defines the rate used to calculate the service agreement's bill segments. Note, you can only choose rates defined as permissible on the service agreement's SA type.
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : currency
Type: object
Show Source
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : servicePoint
Type: object
Show Source
Nested Schema : startMeterRead
Type: object
Show Source
Nested Schema : stopMeterRead
Type: object
Show Source
  • Maximum Length: 12
    Stop Meter Read is the meter read that records the register values as they appeared when the service point was unlinked from the service agreement.
Nested Schema : _data
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : termsAndCondition
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