Search Service Agreement

post

/rest/apis/customer/v-model/serviceAgreements/search

The operation retrieves service agreements with premise information based on search criteria.

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
Nested Schema : filters
Type: object
Show Source
  • Maximum Length: 10
    Account ID 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
  • Allowed Values: [ "C ", "N ", "Y " ]
    Status of Service Agreement with values as C - Closed Only N - All Y - Active * `C ` - Closed Only, * `N ` - All, * `Y ` - Active
  • Allowed Values: [ "N ", "Y " ]
    Flag for Premise LatLong Geo Type * `N ` - No, * `Y ` - Yes
    Example: Y
  • Maximum Length: 10
    Premise ID is a system-assigned, unique identifier that shows the primary premise associated with the service agreement.
    Example: 7735910061
  • Maximum Length: 10
    Service Point ID The identity of the service point. The type and location of the service point is displayed adjacent.
  • Maximum Length: 80
    Service Type defines the type of service associated with the SA type.
    Example: E
  • Date filter field which is used only with active flag values of N & C. This date represents the earliest date of interest for inactive contracts.
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : filters
Type: object
Show Source
  • Maximum Length: 10
    Account ID 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
  • Allowed Values: [ "C ", "N ", "Y " ]
    Status of Service Agreement with values as C - Closed Only N - All Y - Active * `C ` - Closed Only, * `N ` - All, * `Y ` - Active
  • Allowed Values: [ "N ", "Y " ]
    Flag for Premise LatLong Geo Type * `N ` - No, * `Y ` - Yes
    Example: Y
  • Maximum Length: 10
    Premise ID is a system-assigned, unique identifier that shows the primary premise associated with the service agreement.
    Example: 7735910061
  • Maximum Length: 10
    Service Point ID The identity of the service point. The type and location of the service point is displayed adjacent.
  • Maximum Length: 80
    Service Type defines the type of service associated with the SA type.
    Example: E
  • Date filter field which is used only with active flag values of N & C. This date represents the earliest date of interest for inactive contracts.
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1SASearhSer
Type: object
Show Source
Nested Schema : serviceAgreements
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : effectiveRateSchedule
Type: object
Show Source
  • Effective Date Indicate the effective date of the characteristic type and value. The service point's install date defaults.
    Example: 2018-02-25
  • 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.
  • Maximum Length: 60
    A short description for the rate schedule.
    Example: Electric Residential Plan 1
Nested Schema : premiseDetails
Type: object
Show Source
Nested Schema : serviceAgreementDetails
Type: object
Show Source
  • account
  • 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: Ohio
  • Maximum Length: 1
    Description for CIS Division. CIS Division defines the jurisdiction that governs the account.
    Example: California
  • The End Date defines when the financial relationship terminates.
    Example: 2018-02-25
  • IsActive flag to show active SAs for account
    Example: false
  • Allowed Values: [ "05 ", "10 ", "20 ", "30 ", "40 ", "50 ", "60 ", "70 " ]
    SA Status defines the state of the service agreement. * `05 ` - Incomplete, * `10 ` - Pending Start, * `20 ` - Active, * `30 ` - Pending Stop, * `40 ` - Stopped, * `50 ` - Reactivated, * `60 ` - Closed, * `70 ` - Canceled
    Example: 20
  • Maximum Length: 60
    Description for SA Status
    Example: Canceled
  • 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: CHARITY (Ohio / Charitable contribution)
  • Maximum Length: 30
    Description for Service Agreement Type
    Example: Electric commercial
  • serviceAgreement
  • Maximum Length: 80
    Service Type defines the type of service associated with the SA type.
    Example: E
  • The Start Date defines when the financial relationship begins.
Nested Schema : servicePoints
Type: array
Show Source
Nested Schema : premise
Type: object
Show Source
  • Maximum Length: 10
    Premise ID is a system-assigned, unique identifier that shows the primary premise associated with the service agreement.
    Example: 7735910061
Nested Schema : account
Type: object
Show Source
Nested Schema : serviceAgreement
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : premise
Type: object
Show Source
  • Maximum Length: 10
    Premise ID is a system-assigned, unique identifier that shows the primary premise associated with the service agreement.
    Example: 7735910061
Nested Schema : servicePoint
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