1. Oracle Utilities REST API for Metering and Customer Information
  2. Tasks
  3. V-Model
  4. Communications Preferences

Patch Notification Preferences

patch

/rest/apis/customer/v-model/communicationsPreferences/{accountId}/{personId}

This operation updates notification preferences for an account.

Request

Path Parameters
Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
  • Maximum Length: 10
    The Account ID is a system-assigned random number that stays with an account for life.
    Example: 0833559999
  • Allowed Values: [ "DELT", "GET ", "POST", "PTCH", "PUT " ]
    HTTP Method * `DELT` - Delete, * `GET ` - Get, * `POST` - Post, * `PTCH` - Patch, * `PUT ` - Put
    Example: GET
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • notificationTypeList
  • Maximum Length: 10
    Person ID is a system-assigned random number that stays with a person for the life of the system.
    Example: 3903069999
Nested Schema : notificationTypeList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • isOptedOut is defined as true if a customer opts out of the notifications preferences.
    Example: true
  • isOptOutAllowed allows customer to opt out of notification preferences when defined as true.
    Example: true
  • notificationOption
    If the notification type is a subscription, an optional list of notification option extension fields to capture
  • notificationPreferenceList
    A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • Maximum Length: 100
    Notification Type displays the description for the notification preferences for the customer in context.
    Example: Test for Bug 23605115
  • Maximum Length: 14
    When opt out is supported, the preference to opt out is also stored in the communication preference entity as Communication Preference Id.
    Example: 74703875639999
  • Allowed Values: [ "C1PU", "C1SU" ]
    Subscription/Push defines if a notification is a push or a subscription type notification. * `C1PU` - Push, * `C1SU` - Subscription
    Example: C1PU
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : notificationPreferenceList
Type: array
A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 106
    Data type lookup field for the option value.
    Example: NUMB
  • Maximum Length: 60
    Label of the option if allowed for the subscription notification type.
    Example: Days Before
  • Minimum Value: -9999999999
    Maximum Value: 9999999999
    Precision, if numeric
    Example: 1
  • Allowed Values: [ "N ", "Y " ]
    Required Y or N flag * `N ` - No, * `Y ` - Yes
    Example: N
  • Minimum Value: -999
    Maximum Value: 999
    Scale, if numeric
    Example: 0
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Sign, if numeric
    Example: false
  • Maximum Length: 4000
    Path to the option value being stored.
    Example: dueInfo/numberOfDaysBeforeDue
  • validValue
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : validValue
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 10
    Label of the notification option parameter value that can be provided as a setting.
    Example: Account Balance
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : items
Type: object
Show Source
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : items
Type: object
Show Source
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Maximum Length: 10
    The Account ID is a system-assigned random number that stays with an account for life.
    Example: 0833559999
  • Allowed Values: [ "DELT", "GET ", "POST", "PTCH", "PUT " ]
    HTTP Method * `DELT` - Delete, * `GET ` - Get, * `POST` - Post, * `PTCH` - Patch, * `PUT ` - Put
    Example: GET
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • notificationTypeList
  • Maximum Length: 10
    Person ID is a system-assigned random number that stays with a person for the life of the system.
    Example: 3903069999
Nested Schema : notificationTypeList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • isOptedOut is defined as true if a customer opts out of the notifications preferences.
    Example: true
  • isOptOutAllowed allows customer to opt out of notification preferences when defined as true.
    Example: true
  • notificationOption
    If the notification type is a subscription, an optional list of notification option extension fields to capture
  • notificationPreferenceList
    A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • Maximum Length: 100
    Notification Type displays the description for the notification preferences for the customer in context.
    Example: Test for Bug 23605115
  • Maximum Length: 14
    When opt out is supported, the preference to opt out is also stored in the communication preference entity as Communication Preference Id.
    Example: 74703875639999
  • Allowed Values: [ "C1PU", "C1SU" ]
    Subscription/Push defines if a notification is a push or a subscription type notification. * `C1PU` - Push, * `C1SU` - Subscription
    Example: C1PU
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : notificationPreferenceList
Type: array
A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 106
    Data type lookup field for the option value.
    Example: NUMB
  • Maximum Length: 60
    Label of the option if allowed for the subscription notification type.
    Example: Days Before
  • Minimum Value: -9999999999
    Maximum Value: 9999999999
    Precision, if numeric
    Example: 1
  • Allowed Values: [ "N ", "Y " ]
    Required Y or N flag * `N ` - No, * `Y ` - Yes
    Example: N
  • Minimum Value: -999
    Maximum Value: 999
    Scale, if numeric
    Example: 0
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Sign, if numeric
    Example: false
  • Maximum Length: 4000
    Path to the option value being stored.
    Example: dueInfo/numberOfDaysBeforeDue
  • validValue
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : validValue
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 10
    Label of the notification option parameter value that can be provided as a setting.
    Example: Account Balance
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : items
Type: object
Show Source
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : items
Type: object
Show Source
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1ComPrefer
Type: object
Show Source
  • Maximum Length: 10
    The Account ID is a system-assigned random number that stays with an account for life.
    Example: 0833559999
  • Allowed Values: [ "DELT", "GET ", "POST", "PTCH", "PUT " ]
    HTTP Method * `DELT` - Delete, * `GET ` - Get, * `POST` - Post, * `PTCH` - Patch, * `PUT ` - Put
    Example: GET
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • notificationTypeList
  • Maximum Length: 10
    Person ID is a system-assigned random number that stays with a person for the life of the system.
    Example: 3903069999
Nested Schema : notificationTypeList
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • isOptedOut is defined as true if a customer opts out of the notifications preferences.
    Example: true
  • isOptOutAllowed allows customer to opt out of notification preferences when defined as true.
    Example: true
  • notificationOption
    If the notification type is a subscription, an optional list of notification option extension fields to capture
  • notificationPreferenceList
    A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
  • Maximum Length: 30
    Notification Type displays the code for the notification preferences for the customer in context.
    Example: ZZBUG23605115
  • Maximum Length: 100
    Notification Type displays the description for the notification preferences for the customer in context.
    Example: Test for Bug 23605115
  • Maximum Length: 14
    When opt out is supported, the preference to opt out is also stored in the communication preference entity as Communication Preference Id.
    Example: 74703875639999
  • Minimum Value: 0
    Maximum Value: 99999
    The Count tallies additional active push preferences for the account and any other related persons. If no other persons have an active preference for the parent notification type, the system uses its default notification method.
    Example: 1
  • Allowed Values: [ "C1PU", "C1SU" ]
    Subscription/Push defines if a notification is a push or a subscription type notification. * `C1PU` - Push, * `C1SU` - Subscription
    Example: C1PU
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : notificationPreferenceList
Type: array
A list of eligible contact preferences. This list includes all valid contact details for the person that are valid for the notification type and delivery type. If a contact reference is valid for multiple delivery types then it appears as multiple types
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 106
    Data type lookup field for the option value.
    Example: NUMB
  • Maximum Length: 60
    Label of the option if allowed for the subscription notification type.
    Example: Days Before
  • Minimum Value: -9999999999
    Maximum Value: 9999999999
    Precision, if numeric
    Example: 1
  • Allowed Values: [ "N ", "Y " ]
    Required Y or N flag * `N ` - No, * `Y ` - Yes
    Example: N
  • Minimum Value: -999
    Maximum Value: 999
    Scale, if numeric
    Example: 0
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Sign, if numeric
    Example: false
  • Maximum Length: 4000
    Path to the option value being stored.
    Example: dueInfo/numberOfDaysBeforeDue
  • validValue
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : validValue
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 10
    Label of the notification option parameter value that can be provided as a setting.
    Example: Account Balance
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3
Nested Schema : items
Type: object
Show Source
Nested Schema : notificationOption
Type: array
If the notification type is a subscription, an optional list of notification option extension fields to capture
Show Source
Nested Schema : items
Type: object
Show Source
  • Minimum Value: -999
    Maximum Value: 999
    Sequence if the notification type is a subscription that allows for an option to be set.
    Example: 10
  • Maximum Length: 254
    Value of the option that is set for the customer subscription.
    Example: 3

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