This method is used to create multiple web customer events within a single Web API method call. Note that the maximum number of web customer events that can be created is 1000
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
web_customer_events_set (mandatory) | Set of Web Customer Event Objects | The set of web customer events that will be created by this Web API method Note that the maximum number of web customer events that can be specified within a single Web API call is 1000 |
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 |
Referred Parameter Objects
bulk web customer event parameter object data
Name | Type | Description |
request_unique_identifier (mandatory) | String | A unique identifier of the request, provided by the caller, in order to identify the successful or failed results. Note that this information should be unique and is not stored within CRM.COM |
accounts_receivable_identifier (semi-optional) | Accounts receivable Identifier | The related accounts receivable. The allowed accounts receivable identifier fields are the following: Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the accounts receivable | number (semi-optional) | String | The number of the accounts receivable | name (semi-optional) | String | The name of the accounts receivable |
|
rewards_participant_identifier (semi-optional) | Rewards Participant Identifier | The related rewards participant. The allowed rewards participant identifier fields are the following:
Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the rewards participant | number (semi-optional) | String | The number of the rewards participant | access_token_identifier (semi-optional) | Access Token Identifier | The identifier of the access token which is related with the rewards participant. Only effective access tokens can be used to identify a rewards participant. The allowed access token identifier fields are the following: Name | Type | Description |
|---|
authentication_code (semi-optional) | String | The authentication code of the access token | identifier (semi-optional) | String | The identifier of the access token. If the identifier is specified then it will be validated against the specified pass code | pass_code (mandatory on conditions) | String | The pass code of the access token, which is applicable and mandatory if the identifier is specified | one_time_password (semi-optional) | Integer | The one-time password (OTP) of the access token |
|
|
classification_identifier (optional) | Customer Event Classification Identifier | The classification of the customer event. The allowed customer event classification identifier fields are the following:
Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the customer event classification | name (semi-optional) | String | The name of the customer event classification | alternative_code (semi-optional) | String | The alternative code of the customer event classification |
|
performed_by_unit_identifier (mandatory) | Unit Identifier | The unit that initiated the customer event. The allowed unit identifier fields are the following:
Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the Unit | name (semi-optional) | String | The name of the Unit | alternative_code (semi-optional) | String | The alternative code of the Unit |
|
performed_on (mandatory) | Date | The date that the customer event was actually performed |
description (optional) | String | A description of the customer event |
website (mandatory) | String | The website URL related with the customer event |
external_system (optional) | String | The third party system that generates the customer event |
external_system_reference_number (optional) | String | The unique reference number of the customer event in the external system |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_string_5 (optional) | String | User Defined Field of type String |
udf_string_6 (optional) | String | User Defined Field of type String |
udf_string_7 (optional) | String | User Defined Field of type String |
udf_string_8 (optional) | String | User Defined Field of type String |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
Response Data
Name | Type | Description |
|---|
processed_customer_events_set | Set of Processed customer Events Objects | A set that contains the ID and the number of the customer events that were created |
| unprocessed_customer_events_set | Set of Unprocessed customer Events Objects | A set that contains the customer events that were not created due to an error. Each row includes the unique request identifier , as provided by the caller, along with an error code and error description. |
Referred Objects Response Data
processed customer event object response data
Name | Type | Description |
|---|
| request_unique_identifier | String | A unique identifier of the request, as provided by the caller, in order to identify the successful results. |
id | String | The ID of the customer event that was created |
| number | String | The number of the customer event that was created |
unprocessed customer event object response data
Name | Type | Description |
|---|
| request_unique_identifier | String | A unique identifier of the request, as provided by the caller, in order to identify the failed results. |
| error_code | String | The code of the error that was raised |
| error_description | String | The description of the error that was raised |
Examples
Example 1
HTTP Method: POST
Request:
Body:
{
"token":"{{token}}",
"web_customer_events_set":
[
{
"request_unique_identifier":"06",
"accounts_receivable_identifier":{"number":"ACR0000000020"},
"performed_by_unit_identifier":{"name":"Admin Unit"},
"performed_on":"2016-06-22T15:00:00",
"website":"www.crm.com"
},
{
"request_unique_identifier":"07",
"accounts_receivable_identifier":{"number":"ACR0000000077"},
"performed_by_unit_identifier":{"name":"Admin Unit"},
"performed_on":"2016-06-22T15:05:02",
"website":"www.crm.com"
},
{
"request_unique_identifier":"08",
"accounts_receivable_identifier":{"number":"ACR00045000"},
"performed_by_unit_identifier":{"name":"Admin Unit"},
"performed_on":"2016-06-22T15:19:22",
"website":"www.crm.com"
},
{
"request_unique_identifier":"09",
"accounts_receivable_identifier":{"number":"ACR00670040"},
"performed_by_unit_identifier":{"name":"Admin Unit"},
"performed_on":"2016-06-22T15:15:42",
"website":"www.crm.com"
}
]
}
Response:
{
"data": {
"unprocessed_customer_events_set": [
{
"error_description": "Error:Account (ACR00045000) Not Found. - Description:The specified API value was not found.",
"error_code": "NotFoundAPIValueException",
"request_unique_identifier": "08"
},
{
"error_description": "Error:Account (ACR00670040) Not Found. - Description:The specified API value was not found.",
"error_code": "NotFoundAPIValueException",
"request_unique_identifier": "09"
}
],
"processed_customer_events_set": [
{
"number": "4",
"id": "B50A2C66D9934BF1AC92FB0F963B5654",
"request_unique_identifier": "06"
},
{
"number": "5",
"id": "F85AFE4F8FF64CB4A6C35F234684C8FF",
"request_unique_identifier": "07"
}
]
},
"status": {
"code": "OK",
"description": "",
"message": ""
}
}