Available from CRM.COM R4.0.0
GET notifications/show
This method returns information related with a notification. A single notification is returned by each call
Resource URL
Parameters
Name | Type | Description | |||||||||
token | String | The token retrieved from the login method | |||||||||
notifications_identifier (semi-optional) | Notification identifier | The identifier of the notification that should be returned as a result. The allowed notification identifier fields are the following:
| |||||||||
communication_identifier (semi-optional) | Communication identifier | The identifier of the communication that was created for the notification that should be returned as a result. The allowed communication identifier fields are the following:
| |||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved notification |
number | String | The number of the retrieved notification |
life_cycle_state | String | The life cycle state of the retrieved notification which can be PENDING, REJECTED or COMPLETED and is calculated dynamically based on the related communication queue entry life cycle state |
total_notified_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total initial notified amount for each subscription or job or bill included in the notification |
total_outstanding_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still outstanding for each subscription or bill or job included in the notification |
unsettled_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still unsettled for each subscription or bill or job included in the notification |
expiration_date | Date | The expiration date of the notification as provided through the Notification Type Available from R14.2.0 |
upcoming_bill_amount | Number | Additional information which is populated if the notification type is classified as financial and if the notified information is set to Bills, having the "Calculate upcoming bill" option enabled. It defines the total upcoming bill amount to be paid of each accounts receivable included in the notification Available from R14.5.0 |
upcoming_bill_as_of_date | Date | The as of date of the upcoming bill calculated Available from R14.5.0 |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
type | Notification Type object | The type of the specific notification |
notification_run | Notification Run object | The notification run that generated the specific notification |
contact_information | Contact Information object | The contact information related with the specific notification |
accounts_receivable | Accounts Receivable object | The accounts receivable related with the specific notification |
communication_queue | Communication Queue Object | The communication queue entry that was created for the specific notification |
currency_rate_period | Currency Rate Period Object | The notification's currency rate period |
Log Information Object | The log information related with the retrieved notification | |
items_set | Set of Notification Item objects | The information for which the customer will be notified about by the specific notification. That information differentiates based on the notification type classification |
Referred Objects Response Data
Examples
GET notifications/list
This method returns information related with notifications. Multiple notifications are returned by each call.
Resource URL
Parameters
Name | Type | Description | |||||||||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||||||||
type_identifier | Notification type identifier | The identifier of the notification type related with the notification that should be returned as a result. The allowed notification type identifier fields are the following:
| |||||||||||||||||||||
notification_run_identifier (semi-optional) | Notification run identifier | The identifier of the notification run that created the notifications that should be returned as a result. The allowed notification run identifier fields are the following:
| |||||||||||||||||||||
contact_information_identifier (optional) | Contact Information identifier | The identifier of the contact information notified by the notifications that should be returned as a result. The allowed contact information identifier fields are the following:
| |||||||||||||||||||||
accounts_receivable_identifier (optional) | Accounts receivable identifier | The identifier of the accounts receivable notified by the notifications that should be returned as a result. The allowed contact information identifier fields are the following:
| |||||||||||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved notification |
number | String | The number of the retrieved notification |
life_cycle_state | String | The life cycle state of the retrieved notification which can be PENDING, REJECTED or COMPLETED and is calculated dynamically based on the related communication queue entry life cycle state |
total_notified_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total initial notified amount for each subscription or job or bill included in the notification |
total_outstanding_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still outstanding for each subscription or bill or job included in the notification |
unsettled_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still unsettled for each subscription or bill or job included in the notification |
expiration_date | Date | The expiration date of the notification as provided through the Notification Type Available from R14.2.0 |
upcoming_bill_amount | Number | Additional information which is populated if the notification type is classified as financial and if the notified information is set to Bills, having the "Calculate upcoming bill" option enabled. It defines the total upcoming bill amount to be paid of each accounts receivable included in the notification Available from R14.5.0 |
upcoming_bill_as_of_date | Date | The as of date of the upcoming bill calculated Available from R14.5.0 |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
type | Notification Type object | The type of the specific notification |
notification_run | Notification Run object | The notification run that generated the specific notification |
contact_information | Contact Information object | The contact information related with the specific notification |
accounts_receivable | Accounts Receivable object | The accounts receivable related with the specific notification |
communication_queue | Communication Queue Object | The communication queue entry that was created for the specific notification |
currency_rate_period | Currency Rate Period Object | The notification's currency rate period |
Log Information Object | The log information related with the retrieved notification | |
items_set | Set of Notification Item objects | The information for which the customer will be notified about by the specific notification. That information differentiates based on the notification type classification |
Referred Objects Response Data
Examples
GET notifications/get_latest_in_queue
This method returns the latest notifications having a communication created and also pending in the communication queue. Multiple notifications are returned by each call.
Resource URL
Parameters
Name | Type | Description | |||||||||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||||||||
type_identifier | Notification type identifier | The identifier of the notification type related with the notification that should be returned as a result. The allowed notification type identifier fields are the following:
| |||||||||||||||||||||
notification_run_identifier (semi-optional) | Notification run identifier | The identifier of the notification run that created the notifications that should be returned as a result. The allowed notification run identifier fields are the following:
| |||||||||||||||||||||
communication_queue_external_system_identifier (optional) | Communication Queue External System Identifier | The identifier of the external system that should process the notification communication through the communication queue. The allowed communication queue external system identifier fields are the following:
| |||||||||||||||||||||
contact_information_identifier (optional) | Contact Information identifier | The identifier of the contact information notified by the notifications that should be returned as a result. The allowed contact information identifier fields are the following:
| |||||||||||||||||||||
accounts_receivable_identifier (optional) | Accounts receivable identifier | The identifier of the accounts receivable notified by the notifications that should be returned as a result. The allowed contact information identifier fields are the following:
| |||||||||||||||||||||
number (mandatory) | Number | The number of notifications to be retrieved, starting from the latest one | |||||||||||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved notification |
number | String | The number of the retrieved notification |
life_cycle_state | String | The life cycle state of the retrieved notification which can be PENDING, REJECTED or COMPLETED and is calculated dynamically based on the related communication queue entry life cycle state |
total_notified_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total initial notified amount for each subscription or job or bill included in the notification |
total_outstanding_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still outstanding for each subscription or bill or job included in the notification |
unsettled_amount | Number | Additional information which is populated if the notification type is classified as financial, and if the notified information is set to Subscriptions, Bills or Jobs. It defines the total amount which is still unsettled for each subscription or bill or job included in the notification |
expiration_date | Date | The expiration date of the notification as provided through the Notification Type Available from R14.2.0 |
upcoming_bill_amount | Number | Additional information which is populated if the notification type is classified as financial and if the notified information is set to Bills, having the "Calculate upcoming bill" option enabled. It defines the total upcoming bill amount to be paid of each accounts receivable included in the notification Available from R14.5.0 |
upcoming_bill_as_of_date | Date | The as of date of the upcoming bill calculated Available from R14.5.0 |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
type | Notification Type object | The type of the specific notification |
notification_run | Notification Run object | The notification run that generated the specific notification |
contact_information | Contact Information object | The contact information related with the specific notification |
accounts_receivable | Accounts Receivable object | The accounts receivable related with the specific notification |
communication_queue | Communication Queue Object | The communication queue entry that was created for the specific notification |
currency_rate_period | Currency Rate Period Object | The notification's currency rate period |
Log Information Object | The log information related with the retrieved notification | |
items_set | Set of Notification Item objects | The information for which the customer will be notified about by the specific notification. That information differentiates based on the notification type classification |
Referred Objects Response Data