- Created by Former user , last modified by Joseph Ioannou (Unlicensed) on May 30, 2019
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 27 Next »
This method creates a accounts receivable. Single accounts receivable can be created by each call. Only customer accounts receivable can be created through this method. Accounts receivable are created in an ACTIVE state
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
name (mandatory on conditions) | String | The name of the account receivable. The account name is mandatory unless the system is configured to generate the name automatically | ||||||||||||
description (optional) | String | The description of the retrieved accounts receivable | ||||||||||||
notes (optional) | String | The notes of the retrieved accounts receivable | ||||||||||||
vat_number (optional) | String | The VAT number of the retrieved accounts receivable Deprecated from CRM.COM R15.0.0 | ||||||||||||
credit_limit (optional) | Number | Is the maximum amount of credit that can be provided to the specific accounts receivable, or in other words the maximum balance that the accounts receivable can ever reach. Deprecated from CRM.COM R11.0.0 | ||||||||||||
credit_period_operator (optional) | String | The credit period operator. The supported values are the following:
Deprecated from CRM.COM R14.0.0 | ||||||||||||
credit_period (optional) | Number | Credit period is the length of time for which a customer is allowed to settle any given debit Deprecated from CRM.COM R14.0.0 | ||||||||||||
classification_identifier (optional) | Accounts Receivable Classification Identifier | The accounts receivable classification identifier. The allowed classification identifier fields are the following:
| ||||||||||||
credit_rating_code (optional) | String | The code of the credit rating. The supported codes are the following: AAA, AA, A, BAA, BA, B, CAA, CA, C | ||||||||||||
owned_by_group_identifier (optional) | Group identifier | The group owning the accounts receivable. The allowed group identifier fields are the following:
| ||||||||||||
privacy_level_identifier (optional) | Privacy level identifier | The privacy level of the accounts receivable. The allowed privacy level identifier fields are the following:
| ||||||||||||
currency_identifier (optional) | Currency identifier | The accounts receivable currency. If not specified, then CRM.COM's default currency is defined as the accounts receivable currency. The allowed currency identifier fields are the following:
Available from CRM.COM R10.0.0 | ||||||||||||
account_manager (optional) | User Identifier | The identifier of the user that should be set as the Account Manager. The allowed user identifier fields are the following:
Assigning an Account Manager is only applicable for Accounts Receivables that are owned by a COMPANY Available from CRM.COM R14.0.0 | ||||||||||||
is_tax_exempt (optional) | Boolean | Defines whether the account owner is Tax Exempt or not Available from CRM.COM R17.0.0 | ||||||||||||
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 | ||||||||||||
custom_field_set (optional) | Set of Custom Fields | The custom fields that are associated with the accounts receivable If no records are specified in the set then nothing will be updated. To add or update a value on a custom field use the custom field name as configured in CRM.COM along with the respective value. To remove a value from a custom field use the custom field name as configured in CRM.COM along with an empty value "set": [ "field_name_1" : "value_1", "field_name_2" : "value_2" ] Available from CRM.COM R16.2.0 | ||||||||||||
(mandatory) | Contact information object | The contact information of the accounts receivable owner. | ||||||||||||
(mandatory) | Billing Address Object | The accounts receivable billing address. From CRM.COM R14.3.0, billing_address is mandatory based on the accounts receivable definitions' billing address rules | ||||||||||||
(optional) | Wallet Top Up Rules Object | The accounts receivable wallet top up rules. Applicable only if the account owner owns a wallet and has opt in to recurring payments through payment preferences. Available from CRM.COM R14.2.0 | ||||||||||||
(optional) | Set of Presentment Preferences Object | The presentment preferences of the retrieved accounts receivable | ||||||||||||
(optional) | Set of Payment Preferences Object | The payment preferences of the retrieved accounts receivable | ||||||||||||
(mandatory on conditions) | Set of Access Token Objects | The access tokens that will be associated with the accounts receivable. This information is mandatory if the active access token definition is set up to require at least one access token for each accounts receivable Available from CRM.COM R8.0.0 | ||||||||||||
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 Available from CRM.COM R10.0.0 |
Referred Parameter Objects Data
Name | Type | Description | |||||||||||||||||||||
action (mandatory) | String | Defines if a new or existing contact information should be used. The supported values are the following: NEW, EXISTING | |||||||||||||||||||||
contact_information_identifier (mandatory on conditions) | Contact information identifier | An existing contact information that should be used. This is applicable and mandatory if the action is set to EXISTING. The allowed contact information identifier fields are the following:
| |||||||||||||||||||||
type (mandatory on conditions) | String | The type of the contact information which can be PERSON or COMPANY. Applicable and mandatory if the action is set to NEW | |||||||||||||||||||||
title (optional) | String | The title of the contact information. Applicable only if the type is PERSON and the action is set to NEW | |||||||||||||||||||||
first_name (mandatory on conditions) | String | The first name of the contact information. Applicable and mandatory only if the type is PERSON and the action is set to NEW | |||||||||||||||||||||
middle_name (optional) | String | The middle name of the contact information. Applicable only if the type is PERSON and the action is set to NEW | |||||||||||||||||||||
last_name (mandatory on conditions) | String | The last name of the contact information. Applicable and mandatory only if the type is PERSON and the action is set to NEW | |||||||||||||||||||||
company_name (mandatory on conditions) | Sting | The company name of the contact information. Applicable and mandatory only if the type is COMPANY and the action is set to NEW | |||||||||||||||||||||
category_identifier (optional) | Identifier | The identifier of the contact category that will be associate with the contact information. The allowed contact category identifier fields are the following:
Applicable only if the action is set to NEW | |||||||||||||||||||||
owned_by_group_identifier (optional) | Group identifier | The group owning the contact information. The allowed group identifier fields are the following:
Applicable only if the action is set to NEW Deprecated from CRM.COM R18.0.0 | |||||||||||||||||||||
owned_by_business_unit_identifier (optional) | Business Unit identifier | The business unit owning the contact information. The allowed business unit identifier fields are the following:
Applicable only if the action is set to NEW Available from CRM.COM R18.0.0 | |||||||||||||||||||||
privacy_level_identifier (optional) | Privacy level identifier | The privacy level of the contact information. The allowed privacy level identifier fields are the following:
Applicable only if the action is set to NEW Deprecated from CRM.COM R18.0.0 | |||||||||||||||||||||
send_direct_marketing_material (optional) | Boolean | The Contact Information's authorization setting for Direct Marketing Available from CRM.COM R9.0.0 | |||||||||||||||||||||
send_affiliate_marketing_material (optional) | Boolean | The Contact Information's authorization setting for Affiliate Marketing Available from CRM.COM R9.0.0 | |||||||||||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_8 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_9 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_string_16 (optional) | String | User Defined Field of type String. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_1 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_2 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_3 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_4 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_5 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_6 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_7 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_float_8 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_1 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_2 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_3 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_4 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_5 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_6 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_7 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
udf_date_8 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to NEW | |||||||||||||||||||||
custom_field_set (optional) | Set of Custom Fields | The custom fields that are associated with the contact information If no records are specified in the set then nothing will be updated. To add or update a value on a custom field use the custom field name as configured in CRM.COM along with the respective value. To remove a value from a custom field use the custom field name as configured in CRM.COM along with an empty value "custom_field_set": [ {"field_name" : "value"}, {"field_name" : "value"} ] Available from CRM.COM R16.2.0 | |||||||||||||||||||||
(optional) | Demographics object | The demographics of the contact information. Applicable only if the type is PERSON and the action is set to NEW | |||||||||||||||||||||
(optional) | Company profile object | The company profile of the contact information. Applicable only if the type is COMPANY and the action is set to NEW | |||||||||||||||||||||
(optional) | Address object | The addresses of the contact information. Applicable only if the action is set to NEW | |||||||||||||||||||||
(optional) | Phone object | The phone of the contact information. Applicable only if the action is set to NEW | |||||||||||||||||||||
(optional) | Email object | The email of the contact information. Applicable only if the action is set to NEW |
Referred Parameter Objects Data
Name | Type | Description | ||||||||||||||||||
gender (optional) | String | The gender of the contact information which can be MALE or FEMALE | ||||||||||||||||||
id_number (optional) | String | The ID number of the contact information | ||||||||||||||||||
id_number_expiration_date (optional) | Date | The expiration date of the ID number Available from CRM.COM R14.0.0 | ||||||||||||||||||
passport_number (optional) | String | The passport number of the contact information | ||||||||||||||||||
passport_number_expiration_date (optional)
| Date | The expiration date of the passport Available from CRM.COM R14.0.0 | ||||||||||||||||||
social_security_number (optional) | String | The social security number of the contact information | ||||||||||||||||||
country_of_residence_identifier (optional) | Country identifier | The country of residence of the contact information. The allowed country identifier fields are the following:
| ||||||||||||||||||
id_issued_by_country_identifier (optional) | Country identifier | The ID issued country of the contact information. The allowed country identifier fields are the following:
| ||||||||||||||||||
passport_issued_by_country_identifier (optional) | Country identifier | The passport issued country of the contact information. The allowed country identifier fields are the following:
| ||||||||||||||||||
industry_identifier (optional) | Industry identifier | The industry of the contact information. The allowed industry identifier fields are the following:
| ||||||||||||||||||
industry_sector_identifier (optional) | Industry Sector identifier | The sector of the contact information. The allowed industry sector identifier fields are the following:
| ||||||||||||||||||
(optional) | Date of Birth Object | The date of birth of the contact information | ||||||||||||||||||
(optional) | Name Day Object | The name day of the contact information |
Referred Parameter Objects Data
Name | Type | Description |
---|---|---|
day (optional) | Integer | The day of the retrieved date of birth |
month (optional) | Integer | The month of the retrieved date of birth |
year (optional) | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day (optional) | Integer | The day of the retrieved name day |
month (optional) | Integer | The month of the retrieved name day |
Name | Type | Description | ||||||||||||||||||
profile_year (optional) | Number | The profile year of the contact information | ||||||||||||||||||
annual_turnover (optional) | Number | The annual turnover of the contact information | ||||||||||||||||||
established_date (optional) | Date | The established date of the contact information | ||||||||||||||||||
number_of_employees (optional) | Number | The number of employees of the contact information | ||||||||||||||||||
registration_number (optional) | String | The registration number of the contact information | ||||||||||||||||||
vat_registration_number (optional) | String | The vat registration number of the contact information | ||||||||||||||||||
vat_registered_by (optional) | String | The vat registration by of the contact information | ||||||||||||||||||
vat_registration_date (optional) | Date | The vat registration date of the contact information | ||||||||||||||||||
tax_reference_number (optional) | String | The tax reference number of the contact information | ||||||||||||||||||
registered_in_country_identifier | Country Identifier | The country of registration of the contact information. The allowed country identifier fields are the following:
| ||||||||||||||||||
industry_identifier (optional) | Industry identifier | The industry of the contact information. The allowed industry identifier fields are the following:
| ||||||||||||||||||
industry_sector_identifier (optional) | Industry Sector identifier | The sector of the contact information. The allowed industry sector identifier fields are the following:
|
From R14.2.0, the following object is applicable for CRM.COM Address Format
Name | Type | Description | ||||||||||||||||||
type (mandatory) | String | The type of the address which can be added HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
is_primary (mandatory on conditions) | Boolean | Weather the address is the primary one Applicable from CRM.COM R16.1.0 onwards | ||||||||||||||||||
postal_code (optional) | String | The postal code of the address | ||||||||||||||||||
street_name (mandatory on conditions) | String | The street name of the address | ||||||||||||||||||
street_number (optional) | String | The street number of the address | ||||||||||||||||||
floor (optional) | Integer | The floor of the address | ||||||||||||||||||
apartment_number (optional) | String | The apartment number of the address | ||||||||||||||||||
area (optional) | String | The area of the address | ||||||||||||||||||
town_city (optional) | String | The town/city of the address | ||||||||||||||||||
district (optional) | String | The district of the address | ||||||||||||||||||
municipality (optional)
| String | The municipality of the address | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the address. The allowed country identifier fields are the following:
| ||||||||||||||||||
po_box (optional) | String | The PO box of the address | ||||||||||||||||||
po_box_postal_code (optional) | String | The PO box postal code of the address | ||||||||||||||||||
care_of (optional) | String | The care of person of the address | ||||||||||||||||||
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_string_9 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_16 (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 |
Name | Type | Description | ||||||||||||||||||
type (mandatory) | String | The type of the address which can be added HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
postal_code (optional) | String | The postal code of the address | ||||||||||||||||||
town_city (optional) | String | The town/city of the address | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the address. The allowed country identifier fields are the following:
| ||||||||||||||||||
address_line_1 (mandatory) | String | The address line 1 | ||||||||||||||||||
address_line_2 (optional) | String | The address line 2 | ||||||||||||||||||
state_province_county (optional) | String | The state or province or county of the address. | ||||||||||||||||||
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_string_9 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_16 (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 |
Name | Type | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type (mandatory) | String | The type of the phone which can be LANDLINE, MOBILE, FAX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
is_primary (mandatory on conditions) | Boolean | Weather the phone is the primary one Applicable from CRM.COM R16.1.0 onwards | ||||||||||||||||||
number (mandatory) | String | The number of the phone | ||||||||||||||||||
area_code (optional) | String | The area code of the phone | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the phone. The allowed country identifier fields are the following:
| ||||||||||||||||||
notes (optional) | String | The notes of the phone | ||||||||||||||||||
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 |
Name | Type | Description |
---|---|---|
type (mandatory) | String | The type of the retrieved email which can be PERSONAL, BUSINESS, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
is_primary (mandatory on conditions) | Boolean | Weather the email is the primary one Applicable from CRM.COM R16.1.0 onwards |
email_address (mandatory) | String | The address of the retrieved email |
notes (optional) | String | The notes of the retrieved email |
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 |
Name | Type | Description |
---|---|---|
action (mandatory) | String | Defines if a new or existing address will be used. In the case of an existing address then it also defines if the existing address should be updated or not. The supported values are the following: NEW, EXISTING, EXISTINGUPDATED |
type (mandatory on conditions) | String | The contact information address that should be set as the billing address address. This is applicable and mandatory only if the action is set to EXISTING or EXISTINGUPDATED. The supported options are the following: HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
(mandatory on conditions) | Address object | The address to be created (if action is set to NEW) or updated (if action is set to EXISTINGUPDATED). This is applicable and mandatory only if the action is set to NEW or EXISTINGUPDATED. |
Referred Objects Response Data
From R14.2.0, the following object is applicable for CRM.COM Address Format
Name | Type | Description | ||||||||||||||||||
type (mandatory) | String | The type of the address which can be added HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
is_primary (mandatory on conditions) | Boolean | Weather the address is the primary one Applicable from CRM.COM R16.1.0 onwards | ||||||||||||||||||
postal_code (optional) | String | The postal code of the address | ||||||||||||||||||
street_name (mandatory on conditions) | String | The street name of the address | ||||||||||||||||||
street_number (optional) | String | The street number of the address | ||||||||||||||||||
floor (optional) | Integer | The floor of the address | ||||||||||||||||||
apartment_number (optional) | String | The apartment number of the address | ||||||||||||||||||
area (optional) | String | The area of the address | ||||||||||||||||||
town_city (optional) | String | The town/city of the address | ||||||||||||||||||
district (optional) | String | The district of the address | ||||||||||||||||||
municipality (optional)
| String | The municipality of the address | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the address. The allowed country identifier fields are the following:
| ||||||||||||||||||
po_box (optional) | String | The PO box of the address | ||||||||||||||||||
po_box_postal_code (optional) | String | The PO box postal code of the address | ||||||||||||||||||
care_of (optional) | String | The care of person of the address | ||||||||||||||||||
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_string_9 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_16 (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 |
Name | Type | Description | ||||||||||||||||||
type (mandatory) | String | The type of the address which can be added HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
postal_code (optional) | String | The postal code of the address | ||||||||||||||||||
town_city (optional) | String | The town/city of the address | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the address. The allowed country identifier fields are the following:
| ||||||||||||||||||
address_line_1 (mandatory) | String | The address line 1 | ||||||||||||||||||
address_line_2 (optional) | String | The address line 2 | ||||||||||||||||||
state_province_county (optional) | String | The state or province or county of the address. | ||||||||||||||||||
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_string_9 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_10 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_11 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_12 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_13 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_14 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_15 (optional) | String | User Defined Field of type String | ||||||||||||||||||
udf_string_16 (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 |
Name | Type | Description |
---|---|---|
wallet_balance_threshold (mandatory) | Number | The wallet balance threshold that will trigger the automatic wallet top-up |
top_up_amount (mandatory) | Number | The amount that will top up the wallet balance |
frequency (mandatory) | Number | The minimum period (in days) between wallet top ups |
(optional) | Set of Allotment Product Conditions | A set of products that will be allowed to consume the specified top up amount If no records are specified in the set then nothing will be updated. To remove a record use action "remove". To add a record use action "add". Different actions can be used within the same set. For example: "set": [ { "action": "remove", ........... }, { "action": "add", ........... } ] |
Referred Objects Response Data
Name | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
product_identifier | Product identifier | The product related with the wallet transaction allotment. The allowed product identifier fields are the following:
|
Name | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
presentment_preference_identifier (mandatory) | Identifier | The identifier of the presentment preference to be added on account presentment preference object. The allowed presentment preference identifier fields are the following:
| ||||||||||||
state (optional) | String | Indicates if the retrieved presentment preference is active or not. The supported values are ACTIVE or INACTIVE. If not specified then it is considered as active | ||||||||||||
(mandatory on conditions) | Presentment Preference Email Object | The email that should be related with the presentment preference. The email is mandatory and applicable only if the specified presentment preference is of type Email Deprecated from CRM.COM R17.0.0 | ||||||||||||
(mandatory on conditions) | Presentment Preference Phone Object | The phone that should be related with the presentment preference. The phone is mandatory and applicable only if the specified presentment preference is of type SMS Deprecated from CRM.COM R17.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
action (mandatory) | String | Defines if a new or existing email will be used. In the case of an existing email then it also defines if the existing email should be updated or not. The supported values are the following: NEW, EXISTING, EXISTINGUPDATED |
type (mandatory on conditions) | String | The contact information email that should be used. This is applicable and mandatory only if the action is set to EXISTING or EXISTINGUPDATED. The supported options are the following: PERSONAL, BUSINESS, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
(mandatory on conditions) | Email object | The email to be created (if action is set to NEW) or updated (if action is set to EXISTINGUPDATED). This is applicable and mandatory only if the action is set to NEW or EXISTINGUPDATED. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
type (mandatory) | String | The type of the retrieved email which can be PERSONAL, BUSINESS, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
is_primary (mandatory on conditions) | Boolean | Weather the email is the primary one Applicable from CRM.COM R16.1.0 onwards |
email_address (mandatory) | String | The address of the retrieved email |
notes (optional) | String | The notes of the retrieved email |
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 |
Name | Type | Description |
---|---|---|
action (mandatory) | String | Defines if a new or existing phone will be used. In the case of an existing phone then it also defines if the existing phone should be updated or not. The supported values are the following: NEW, EXISTING, EXISTINGUPDATED |
type (mandatory on conditions) | String | The contact information phone that should be used. This is applicable and mandatory only if the action is set to EXISTING or EXISTINGUPDATED. The supported options are the following: LANDLINE, MOBILE, FAX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
(mandatory on conditions) | Email object | The email to be created (if action is set to NEW) or updated (if action is set to EXISTINGUPDATED). This is applicable and mandatory only if the action is set to NEW or EXISTINGUPDATED. |
Referred Objects Response Data
Name | Type | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
type (mandatory) | String | The type of the phone which can be LANDLINE, MOBILE, FAX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 | ||||||||||||||||||
is_primary (mandatory on conditions) | Boolean | Weather the phone is the primary one Applicable from CRM.COM R16.1.0 onwards | ||||||||||||||||||
number (mandatory) | String | The number of the phone | ||||||||||||||||||
area_code (optional) | String | The area code of the phone | ||||||||||||||||||
country_identifier (optional) | Country identifier | The country of the phone. The allowed country identifier fields are the following:
| ||||||||||||||||||
notes (optional) | String | The notes of the phone | ||||||||||||||||||
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 |
Name | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
account_holder (optional) | String | The account holder of the retrieved payment preference | ||||||||||||
bank_account_number (optional) | String | The bank account number of the retrieved payment preference | ||||||||||||
payment_preference_identifier (mandatory) | Identifier | The identifier of the payment preference to be added on account payment preference object. The allowed payment preference identifier fields are the following:
| ||||||||||||
bank_account_type_identifier (optional) | Identifier | The identifier of the bank account type to be added on account payment preference object. The allowed bank account type identifier fields are the following:
| ||||||||||||
bank_identifier (optional) | Identifier | The identifier of the bank to be added on account payment preference object. The allowed bank identifier fields are the following:
| ||||||||||||
bank_branch_identifier (optional) | Identifier | The identifier of the bank branch to be added on account payment preference object. The allowed bank branch identifier fields are the following:
| ||||||||||||
notes (optional) | String | The notes to be added on account payment preference object. Available from CRM.COM R10.1.0 | ||||||||||||
payment_medium_identifier (optional) | String | The payment medium identifier to be added on account payment preference object. Available from CRM.COM R11.0.0 | ||||||||||||
state (optional) | Boolean | Indicates if the retrieved payment preference is active or not. The supported values are ACTIVE or INACTIVE. If not specified then it is considered as active Available from CRM.COM R15.0.0 | ||||||||||||
payment_medium_type_identifier (optional) | Payment Medium Type Identifier | The payment medium type to be added on account payment preference object. The allowed payment medium type identifier fields are the following:
Available from CRM.COM R11.0.0 | ||||||||||||
payment_medium_brand_identifier (optional) | Payment Medium Brand Identifier | The payment medium brand to be added on account payment preference object. The allowed payment medium brand identifier fields are the following:
Available from CRM.COM R11.0.0 | ||||||||||||
use_for_recurring_payments (optional) | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable. Applicable only if the Payment Preference is related to a Payment Gateway Depracated from CRM.COM R16.0.0 (and replaced by opt_in_for_subscriptions). The parameter will still function but it will not be maintained | ||||||||||||
opt_in_for_subscriptions (optional) | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable, related to its subscriptions. Applicable only if the Payment Preference is related to a Payment Gateway or a Wallet Available from CRM.COM R16.0.0 Wallet as a payment preference is available from CRM.COM R17.0.0 | ||||||||||||
opt_in_for_purchases (optional) | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable, related to purchases. Applicable only if the Payment Preference is related to a Payment Gateway or a Wallet Available from CRM.COM R16.0.0 Wallet as a payment preference is available from CRM.COM R17.0.0 | ||||||||||||
iban (optional) | String | The international bank account number Applicable only for payment preferences of type DIRECT_DEBIT, GENERIC_PAYMENT_GATEWAY, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5, as specified through the configuration Available from CRM.COM R13.1.0 | ||||||||||||
business_identifier_code (optional) | String | The business identifier code that identifies the bank (supports 8 or 11 alphanumeric characters) Applicable only for payment preferences of type DIRECT_DEBIT, GENERIC_PAYMENT_GATEWAY, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5, as specified through the configuration Available from CRM.COM R13.1.0 | ||||||||||||
unique_mandate_reference (optional) | Number | The unique reference, which identifies a mandate that was signed by a Debtor for any given Creditor (supports up to 35 alphanumeric characters) Applicable only for payment preferences of type DIRECT_DEBIT, GENERIC_PAYMENT_GATEWAY, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5, as specified through the configuration Available from CRM.COM R13.1.0 | ||||||||||||
mandate_signing_date (optional) | Date | The date that the mandate was signed Applicable only for payment preferences of type DIRECT_DEBIT, GENERIC_PAYMENT_GATEWAY, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5, as specified through the configuration Available from CRM.COM R13.1.0 | ||||||||||||
mandate_termination_date (optional) | Date | The date that the mandate will be terminated. No payments should be send after that date (inclusive) Applicable only for payment preferences of type DIRECT_DEBIT, GENERIC_PAYMENT_GATEWAY, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5, as specified through the configuration Available from CRM.COM R13.1.0 | ||||||||||||
gateway_payment_method_token (optional) | String | The token of the payment gateway payment method that will be registered (defines payment methods other than cards) Available from CRM.COM R14.2.0 | ||||||||||||
(mandatory on conditions) | Set of Payment Gateway Cards Objects | The cards that are related with the Accounts Receivable Payment Preference, in case the payment preference is related with a payment gateway such as Stripe. This information is applicable only if the payment preference is related with a payment gateway. In that case it is mandatory to specify at least one card, which also needs to be set as the default card
If no records are specified in the set then nothing will be updated. To update a record use "action" : "update". To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "update", ........... }, { "action": "remove", ........... }, { "action": "add", ........... } ]
|
Referred Objects Response Data
Name | Type | Description |
number (semi-optional) | String | The card's number, which should be a 16 digits number For releases prior CRM.COM R14.2.0, this parameter is mandatory |
last_digits (semi-optional) | Number | The card last 4 digits Available from CRM.COM R14.2.0 |
expiration_month (mandatory) | Number | The card's expiration month, which can be from 1 to 12 |
expiration_year (mandatory) | Number | The card's expiration year which should be a 4 digits number |
card_security_code (optional) | Number | The security code of the card, which should be a 3 digits number From CRM.COM R14.2.0, this parameter is optional |
card_holder_name (mandatory) | String | The card holders name, as provided during the registration of the card |
brand (mandatory on conditions) | String | The card's brand, as provided by the payment gateway provider. The supported brands by the payment gateway are the following:
This attribute is mandatory for Payeezy Payment Gateway Available from CRM.COM R14.3.0 |
same_as_billing_address (optional) | Boolean | Sets the card's billing address same as the account's receivable billing address Available from CRM.COM R14.3.0 |
address_line_1 (optional) | String | Information related with the card's billing address |
address_line_2 (optional) | String | Information related with the card's billing address |
address_city (optional) | String | Information related with the card's billing address |
address_zip (optional) | String | Information related with the card's billing address |
address_state (optional) | String | Information related with the card's billing address |
address_country (optional) | String | Information related with the card's billing address |
card_token (optional) | String | The token of the card that will be registered Available from CRM.COM R14.2.0 |
consumer_token (optional) | String | The consumer token of the card that will be registered Available from CRM.COM R14.26.0 |
default (mandatory) | Boolean | It defines the default payment gateway card that should be used while automatically creating payments against that specific accounts receivable. The default card is also set on payments done using the specific payment preference, although the user can modify this information, by selecting an additional card. |
Name | Type | Description | ||||||||||||
action (mandatory) | String | Defines if a new or existing access token should be used. The supported values are the following: ADD_NEW, ADD_EXISTING The NEW option can be used only if access tokens are allowed to be created on creating reward participants, as specified in access token definitions | ||||||||||||
access_token_identifier (mandatory on conditions) | Access Token identifier | An existing access token that should be used. This is applicable and mandatory if the action is set to EXISTING. Only effective access tokens can be used. The allowed access token identifier fields are the following:
| ||||||||||||
authentication_code (mandatory on conditions) | String | The authentication code of the access token that will be created. This information is not mandatory if set to be generated automatically, in the definition or the classification. Applicable only if the action is set to ADD_NEW | ||||||||||||
identifier (mandatory on conditions) | String | The identifier of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code. Applicable only if the action is set to ADD_NEW | ||||||||||||
pass_code (mandatory on conditions) | String | The pass code of the access token that will be created. This information is not mandatory if the system is set up to allow creating access tokens with no identifier and pass code, although it is always mandatory if an identifier was specified. Applicable only if the action is set to ADD_NEW | ||||||||||||
classification_identifier (optional) | Access Token Classification Identifier | The identifier of the access token classification that will be related with the access token. The allowed access token classification identifier fields are the following:
Available from CRM.COM R10.0.0 | ||||||||||||
card_masked_number (optional) | String | The masked number of the credit card that will be related to the access token
Available from CRM.COM R16.2.0 | ||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_string_8 (optional) | String | User Defined Field of type String. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_float_1 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_float_2 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_float_3 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_float_4 (optional) | Float | User Defined Field of type Float. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_date_1 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_date_2 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_date_3 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 | ||||||||||||
udf_date_4 (optional) | Date | User Defined Field of type Date. Applicable only if the action is set to ADD_NEW Available from CRM.COM R10.1.0 |
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 accounts receivable |
type | String | The type of the retrieved accounts receivable which can be CUSTOMER or SYSTEM or ORGANISATIONAL ORGANISATIONAL type is available from CRM.COM R15.0.0 |
number | String | The number of the retrieved accounts receivable |
name | String | The name of the retrieved accounts receivable |
description | String | The description of the retrieved accounts receivable |
notes | String | The notes of the retrieved accounts receivable |
balance | Float | The aggregated amount of posted debits and credits allocated against the accounts receivable, as of a specific date. This information is calculated dynamically From CRM.COM R10.0.0, balance is calculated as the accounts receivable's opening balance plus the aggregated amount of posted debits and credits allocated against the accounts receivable and which are not related to any accounting period. |
opening_balance | Float | The opening balance of the accounts receivable for the latest and still open Accounting Period. This information is calculated during the latest Accounting Period Closing process. Available from CRM.COM R10.0.0 |
opening_balance_date | Date | The date on which the opening balance of the accounts receivable was last calculated by an Accounting Period Closing process. Available from CRM.COM R10.0.0 |
outstanding_amount | Float | The total outstanding amount which is owned by the customer, as of a specific date, which is the aggregated amount of posted debits which are not paid and are past their due date. This information is calculated dynamically |
credit_limit_status | String | Determines if the outstanding amount of the specific accounts receivable has exceeded the allowed credit limit. The supported values are NOT_EXCEEDED or EXCEEDED |
credit_limit | Number | Is the maximum amount of credit that can be provided to the specific accounts receivable,or in other words the maximum balance that the accounts receivable can ever reach. |
credit_period | Number | Credit period is the length of time for which a customer is allowed to settle any given debit Deprecated from CRM.COM R14.0.0 |
life_cycle_state | String | The life cycle state of the retrieved accounts receivable which can be ACTIVE, SUSPENDED or TERMINATED |
primary_account | Boolean | Indicates if the accounts receivable is the primary accounts receivable for the specified customer or not |
partner_account | Boolean | Indicates if the accounts receivable is owned by a partner group or a partner unit, i.e. is a partner account Available from CRM.COM R14.2.0 |
parent_account | Boolean | Indicates if the accounts receivable is a parent account in a group accounts Available from CRM.COM R14.2.0 |
is_tax_exempt | Boolean | Indicates if the account owner is tax exempt or not Available from CRM.COM R17.0.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 |
Contact Information object | The contact information related with the specified accounts receivable | |
Classification object | The classification of the retrieved accounts receivable | |
Credit Rating object | The credit rating of the retrieved accounts receivable | |
credit_period | Credit Period object | The credit period of the retrieved accounts receivable Available from CRM.COM R14.0.0 |
Address object | The billing address of the retrieved accounts receivable | |
currency | Currency object | The accounts receivable's currency Available from CRM.COM R10.0.0 |
parent_account | Accounts Receivable Object | The parent accounts receivable. Applicable only if the retrieved Accounts Receivable is a member in a group of accounts. Available from CRM.COM R13.0.0 |
accounting_period | Accounting Period Object | The latest Accounting Period for which the accounts receivable's opening balance was calculated for. Available from CRM.COM R10.0.0 |
owned_by_group | Group Object | The group that is owning the accounts receivable Deprecated from CRM.COM R18.0.0 (replaced with owned_by_business_unit) |
owned_by_business_unit | Business Unit Object | The business unit that is owning the accounts receivable Available from CRM.COM R18.0.0 |
privacy_level | Privacy Level Object | The accounts receivable privacy level Deprecated from CRM.COM R18.0.0 |
usage_allowance_limits | Usage Allowance Limits Object | The accounts receivable Usage Allowance Limits Available from CRM.COM R13.0.0 Deprecated from CRM.COM R17.0.0 |
Log Information Object | The log information related to the retrieved accounts receivable | |
account_manager | Users Object | The account manager of the retrieved accounts receivable Applicable only if the retrieved account is owned by a COMPANY Available from CRM.COM R14.0.0 |
pricing_agreement | Pricing Agreement Object | The pricing agreement of the retrieved accounts receivable Applicable only for an Accounts Receivable that is owned by a Company and a Price Plan and/or Usage Service Catalog was agreed as part of a special pricing agreement Available from CRM.COM R14.0.0 From CRM.COM R15.0.0, pricing_agreement is available for all CUSTOMER and ORGANISATIONAL accounts, for both persons and companies |
recurring_payments_preferences | Recurring Payments Preferences Object | The recurring payments preferences associated with the accounts receivable Available from CRM.COM R14.0.0. |
membership_information | Account Membership Information Object | The accounts receivable membership information in terms of funding scope and the services funded by the parent account. Applicable only if the retrieved accounts receivable is a member account of a group. Available from CRM.COM R13.1.0 |
rewards | Rewards Object | The rewards information of the accounts receivable Available from CRM.COM R17.0.0 |
Set of Accounts Receivable Presentment Preferences Objects | The presentment preferences of the retrieved accounts receivable | |
Set of Accounts Receivable Payment Preferences Objects | The payment preferences of the retrieved accounts receivable | |
access_tokens_set | Set of Access Token objects | The access tokens associated with the accounts receivable Available from CRM.COM R8.0.0 Deprecated from CRM.COM R18.0.0 |
member_accounts | Set of Accounts Receivable Objects | The member accounts of the retrieved accounts receivable. Applicable only if the retrieved account is a Parent Account. Available from CRM.COM R13.0.0 |
usage_allowance_organisational_units | Set of Usage Organisational Conditions Objects | The usage organisational conditions (communities, groups, units) that services can be used at Available from CRM.COM R14.2.0 Deprecated from CRM.COM R17.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved contact information |
type | String | The type of the retrieved contact information which can be PERSON or COMPANY |
life_cycle_state | String | The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL |
name | String | The full name of the retrieved contact information |
first_name | String | The first name of the retrieved contact information |
middle_name | String | The middle name of the retrieved contact information |
last_name | String | The last name of the retrieved contact information |
title | String | The title of the retrieved contact information |
company_name | Sting | The company name of the retrieved contact information |
Demographics Object | The demographics information of the retrieved contact information | |
Company profile object | The company profile of the retrieve contact information |
Referred Objects Response Data
Name | Type | Description |
gender | String | The gender of the retrieved contact information which can be MALE or FEMALE |
id_number | String | The ID number of the retrieved contact information |
id_number_expiration_date | Date | The ID number's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
passport_number | String | The passport number of the retrieved contact information |
passport_number_expiration_date | Date | The passport's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
social_security_number | String | The social security number of the retrieved contact information |
Date of Birth Object | The date of birth of the retrieved contact information | |
Name Day Object | The name day of the retrieved contact information | |
Country Object | The country of residence of the retrieved contact information | |
Country Object | The ID issued country of retrieved contact information | |
Country Object | The passport issued country of retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved date of birth |
month | Integer | The month of the retrieved date of birth |
year | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved name day |
month | Integer | The month of the retrieved name day |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
profile_year | Number | The profile year of the retrieved contact information |
annual_turnover | Number | The annual turnover of the retrieved contact information |
established_date | Date | The established date of the retrieved contact information |
number_of_employees | Number | The number of employees of the retrieved contact information |
registration_number | String | The registration number of the retrieved contact information |
vat_registration_number | String | The vat registration number of the retrieved contact information |
vat_registered_by | String | The vat registration by of the retrieved contact information |
vat_registration_date | Date | The vat registration date of the retrieved contact information |
tax_reference_number | String | The tax referenece number of the retrieved contact information |
Country Object | The country of residence of the retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved classification |
name | String | The name of the retrieved classification |
alternative_code | String | The alternative code of the retrieved classification |
Name | Type | Description |
---|---|---|
code | String | The code of the retrieved credit rating |
name | String | The name of the retrieved credit rating |
Name | Type | Description |
---|---|---|
credit_period_setting | String | The default Credit Period setting as this is set on the active Accounts Receivable Definition. Available values are:
|
credit_period_number_of_days | Number | Defines the number of days after a financial transaction's posting date on which the financial transaction's due date will be set. Applicable only if credit_period_setting is set to
|
credit_period_day_of_month | Number | Defines the day of month on which the financial transaction's due date will be set. Applicable only if credit_period_setting is set to
|
credit_period_after_x_months | Number | Defines the number of months after a financial transaction's posting date on which the financial transaction's due date will be set, i.e. it also defines the due date's month. Applicable only if credit_period_day_of_month is defines and credit_period_setting is set to
|
credit_period_operator | String | Defines the credit period's operator. Available values are MINUS, PLUS and PLUS/MINUS |
credit_period | Number | Credit period is the length of time for which a customer is allowed to settle any given debit. Always measured in days. From CRM.COM R14.2.0, credit period is measured in either Days or Months |
credit_period_uot | String | Defines theunit of time for the credit period. Available values are DAYS or MONTHS Available from CRM.COM R14.2.0 |
From R14.2.0, the following object is applicable for CRM.COM Address Format
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved address |
type | String | The type of the retrieved address which can be HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
postal_code | String | The postal code of the retrieved address |
street_name | String | The street name of the retrieved address |
street_number | String | The street number of the retrieved address |
floor | Integer | The floor of the retrieved address |
apartment_number | String | The apartment number of the retrieved address |
area | String | The area of the retrieved address |
town_city | String | The town / city of the retrieved address |
district | String | The district of the retrieved address |
municipality | String | The municipality of the retrieved address |
po_box | String | The PO box of the retrieved address |
po_box_postal_code | String | The PO box postal code of the retrieved address |
care_of | String | The care of person of the retrieved address |
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_string_9 | String | User Defined Field of type String |
udf_string_10 | String | User Defined Field of type String |
udf_string_11 | String | User Defined Field of type String |
udf_string_12 | String | User Defined Field of type String |
udf_string_13 | String | User Defined Field of type String |
udf_string_14 | String | User Defined Field of type String |
udf_string_15 | String | User Defined Field of type String |
udf_string_16 | 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 |
Country Object | The country of the retrieved address | |
is_primary | Boolean | Defines if the address is the contact's primary address or not. Available from CRM.COM R15 |
From R14.2.0, the following object is applicable for International Address Format
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved address |
type | String | The type of the retrieved address which can be HOME, BUSINESS, POBOX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
postal_code | String | The postal code of the retrieved address |
town_city | String | The town / city of the retrieved address |
address_line_1 | String | The address line 1 |
address_line_2 | String | The address line 2 |
state_province_county | String | The state or province or county of the address. |
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_string_9 | String | User Defined Field of type String |
udf_string_10 | String | User Defined Field of type String |
udf_string_11 | String | User Defined Field of type String |
udf_string_12 | String | User Defined Field of type String |
udf_string_13 | String | User Defined Field of type String |
udf_string_14 | String | User Defined Field of type String |
udf_string_15 | String | User Defined Field of type String |
udf_string_16 | 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 |
Country Object | The country of the retrieved address | |
is_primary | Boolean | Defines if the address is the contact's primary address or not. Available from CRM.COM R15 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency |
code | String | The code of the retrieved currency |
prefix_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
integer_part_name | String | The integer part name for the specified currency |
decimal_part_name | String | The decimal part name for the specified currency |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved accounts receivable |
number | String | The number of the retrieved accounts receivable |
name | String | The name of the retrieved accounts receivable |
life_cycle_state | String | The life cycle state of the accounts receivable. One of the following values is returned: ACTIVE, SUSPENDED, TERMINATED |
account_owner | Contact information object | The contact information owning the accounts receivable |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved contact information |
type | String | The type of the retrieved contact information which can be PERSON or COMPANY |
life_cycle_state | String | The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL |
name | String | The full name of the retrieved contact information |
first_name | String | The first name of the retrieved contact information |
middle_name | String | The middle name of the retrieved contact information |
last_name | String | The last name of the retrieved contact information |
title | String | The title of the retrieved contact information |
company_name | Sting | The company name of the retrieved contact information |
Demographics Object | The demographics information of the retrieved contact information | |
Company profile object | The company profile of the retrieve contact information |
Referred Objects Response Data
Name | Type | Description |
gender | String | The gender of the retrieved contact information which can be MALE or FEMALE |
id_number | String | The ID number of the retrieved contact information |
id_number_expiration_date | Date | The ID number's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
passport_number | String | The passport number of the retrieved contact information |
passport_number_expiration_date | Date | The passport's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
social_security_number | String | The social security number of the retrieved contact information |
Date of Birth Object | The date of birth of the retrieved contact information | |
Name Day Object | The name day of the retrieved contact information | |
Country Object | The country of residence of the retrieved contact information | |
Country Object | The ID issued country of retrieved contact information | |
Country Object | The passport issued country of retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved date of birth |
month | Integer | The month of the retrieved date of birth |
year | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved name day |
month | Integer | The month of the retrieved name day |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
profile_year | Number | The profile year of the retrieved contact information |
annual_turnover | Number | The annual turnover of the retrieved contact information |
established_date | Date | The established date of the retrieved contact information |
number_of_employees | Number | The number of employees of the retrieved contact information |
registration_number | String | The registration number of the retrieved contact information |
vat_registration_number | String | The vat registration number of the retrieved contact information |
vat_registered_by | String | The vat registration by of the retrieved contact information |
vat_registration_date | Date | The vat registration date of the retrieved contact information |
tax_reference_number | String | The tax referenece number of the retrieved contact information |
Country Object | The country of residence of the retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
---|---|---|
number | String | The Accounting Period's number |
name | String | The Accounting Period's name |
from_date | Date | The Accounting Period's from date |
to_date | Date | The Accounting Period's to date |
life_cycle_state | Sting | The Accounting Period's life cycle state. Available values are OPEN and CLOSED |
closed_date | Date | The Accounting Period's closed date. Available only for Accounting Periods in Closed life cycle state |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved group |
name | String | The name of the retrieved group |
community_name | String | The name of the community that the retrieved group belongs to |
alternative_code | String | The alternative code of the retrieved group |
unified_code | String | The unified code of the retrieved group Available from CRM.COM R16.2.2 |
description | String | The description of the retrieved group |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved privacy level |
number | String | The number of the retrieved privacy level |
name | String | The name of the retrieved privacy level |
hierarchy_level | String | The hierarchy level of the retrieved privacy level |
Name | Type | Description |
---|---|---|
block_services_not_included_in_usage_allowance_limits_settings
| Boolean | Defines if the account owner can only consume services for which a Usage Allowance Limit is specified Available from CRM.COM R13.1.0 |
percentage_of_allowed_exceeded_usage_limit
| Number | The percentage of amount that the limit can be exceeded for the related accounts receivable Available from CRM.COM R13.1.0 |
accumulated_maximum_rated_amount_per_day | Float | The accumulated maximum rated amount that the accounts receivable is allowed to use within a day. |
accumulated_maximum_rated_amount_per_month | Float | The accumulated maximum rated amount that the accounts receivable is allowed to use within a month. |
accumulated_maximum_rated_amount_per_transaction | Float | The accumulated maximum rated amount that the accounts receivable is allowed to use per transaction. |
accumulated_maximum_usage_per_day | Integer | The accumulated maximum usage amount that the accounts receivable is allowed to use within a day. |
accumulated_maximum_usage_per_month | Integer | The accumulated maximum usage amount that the accounts receivable is allowed to use within a month. |
accumulated_maximum_usage_per_transaction | Integer | The accumulated maximum usage amount that the accounts receivable is allowed to use per transaction. |
currency | Currency object | The accounts receivable's currency |
usage_services_allowance | Set of Usage Services Allowance objects | The usage allowance limits per usage service, service type or service family |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency |
code | String | The code of the retrieved currency |
prefix_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
integer_part_name | String | The integer part name for the specified currency |
decimal_part_name | String | The decimal part name for the specified currency |
Name | Type | Description |
---|---|---|
maximum_rated_amount_per_transaction | Number | The maximum rated amount that can be used per transaction on the specific usage service, service type or service family. |
maximum_rated_amount_per_day | Number | The maximum rated amount that can be used within a day on the specific usage service, service type or service family. |
maximum_rated_amount_per_billing_cycle | Number | The maximum rated amount that can be used within a billing cycle on the specific usage service, service type or service family. Available from CRM.COM R17.0.0 |
maximum_rated_amount_per_month | Number | The maximum rated amount that can be used within a month on the specific usage service, service type or service family. Deprecated in CRMCOM R17.0.0 |
maximum_usage_per_transaction | Number | The maximum usage amount that can be used per transaction on the specific usage service, service type or service family. |
maximum_usage_per_day | Number | The maximum usage amount that can be used within a day on the specific usage service, service type or service family. |
maximum_usage_per_billing_cycle | Number | The maximum usage amount that can be used within a billing cycle on the specific usage service, service type or service family. Available from CRM.COM R17.0.0 |
maximum_usage_per_month | Number | The maximum usage amount that can be used within a month on the specific usage service, service type or service family. Deprecated in CRM.COM R17.0.0 |
service | Product object | The product related with the retrieved usage allowance limit. |
service_type | Product Type object | The product type related with the retrieved usage allowance limit. |
service_family | Product Family object | The product family related with the retrieved usage allowance limit. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rate |
rate_model | String | The price plan rate model which can be one of the following:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | The time period value |
time_period_uot | String | The time period unit of time. The supported values are the following: MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product family |
name | String | The Name of the retrieved product family |
code | String | The code of the retrieved product family |
description | String | The Description of the retrieved product family |
Name | Type | Description |
created_date | Date | The date that the retrieved record was created |
updated_date | Date | The last date that the retrieved record was updated |
Unit Object | The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0 | |
Unit Object | The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Available from CRM.COM R18.0.0 | |
User Object | The user that created the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled | |
Unit Object | The last unit that updated the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0 | |
Unit Object | The last unit that updated the retrieved record Available from CRM.COM R18.0.0 | |
User Object | The last user that updated the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
price_plan | Price Plan Object | The price plan that was agreed for the specific accounts receivable |
usage_service_catalog | Usage Service Catalog Object | The usage service catalog that was agreed for the specific accounts receivable Deprecated from CRM.COM R15.0.0 |
additive_discount_definitions_set | Set of Additive Discount Definition Objects | A list of Additive discount definitions that can only be applied when the specific accounts receivable is billed. Available from CRM.COM R14.9.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved price plan |
name | String | The Name of the retrieved price plan |
code | String | The Code of the retrieved price plan |
description | String | The Description of the retrieved price plan |
type | String | The Type of the retrieved price plan which can be BASE or CONDITIONAL |
effective_date | Date | The Effective Date of the retrieved price plan |
expiration_date | Date | The Expiration Date of the retrieved price plan |
currency | Currency Object | The Currency of the retrieved price plan Available from CRM.COM R14.2.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved currency |
code | String | The code of the retrieved currency |
prefix_symbol | String | The prefix symbol for the specified currency |
suffix_symbol | String | The suffix symbol for the specified currency |
life_cycle_state | String | The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0 |
integer_part_name | String | The integer part name for the specified currency |
decimal_part_name | String | The decimal part name for the specified currency |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage service catalog |
name | String | The Name of the retrieved usage service catalog |
alternative_code | String | The Alternative Code of the retrieved usage service catalog |
description | String | The Description of the retrieved usage service catalog |
effective_date | Date | The Effective Date of the retrieved usage service catalog Available from CRM.COM R14.0.0 |
expiration_date | Date | The Expiration Date of the retrieved usage service catalog Available from CRM.COM R14.0.0 |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved additive discount definition |
alternative_code | String | The alternative code of the retrieved additive discount definition |
name | String | The name of the retrieved additive discount definition |
life_cycle_state | String | The life cycle state of the retrieved additive discount definition. The supported life cycle states are EFFECTIVE or NOT_EFFECTIVE |
classification | String | The classification of the retrieved additive discount definition which can be either SUBSCRIPTIONS, JOBS or GENERAL GENERAL classification available from CRM.COM R15.0.0 JOB classification is not available from CRM.COM R17.0.0 |
type | String | The type of the additive discount definition which can be AUTO_APPLY or AD_HOC |
Name | Type | Description |
---|---|---|
Payment Preference Object | The payment preference that will be used for recurring payments | |
Wallet Top Up Rules | The wallet top up rules for the accounts receivable |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment preference |
name | String | The name of the retrieved payment preference |
alternative_code | String | The alternative code of the retrieved payment preference |
type | Sting | The type of the payment preference, such as
BRAINTREE_PAYMENT_GATEWAY and CUSTOM_PAYMENT_GATEWAY are available from CRM.COM R14.2.0 WALLET available from CRM.COM R17.0.0 |
description | Sting | The description of the retrieved payment preference |
Name | Type | Description |
---|---|---|
wallet_balance_threshold | Number | The wallet balance threshold that will trigger the automatic wallet top-up |
top_up_amount | Number | The amount that will top up the wallet balance |
frequency | Number | The minimum period (in days) between wallet top ups |
Set of Wallet Top Up Allotment Product Condition Objects | The set of products that are allowed to consume the specified top up amount |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved allotment condition |
product | Product object | The product related with the retrieved allotment condition |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rate |
rate_model | String | The price plan rate model which can be one of the following:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | The time period value |
time_period_uot | String | The time period unit of time. The supported values are the following: MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS |
Name | Type | Description |
---|---|---|
funding_scope | String | The funding scope of the member accounts receivable. Two options are available FULLY_FUNDED and PARTIALLY_FUNDED |
funded_services | Set of Product objects | The Services / Service Types / Service Families that are funded by the Parent Account. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
product | Product object | The product related with the retrieved member account |
product_type | Product Type object | The product type related with the retrieved member account |
product_family | Product Family object | The product family related with the retrieved the retrieved member account. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rate |
rate_model | String | The price plan rate model which can be one of the following:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | The time period value |
time_period_uot | String | The time period unit of time. The supported values are the following: MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product family |
name | String | The Name of the retrieved product family |
code | String | The code of the retrieved product family |
description | String | The Description of the retrieved product family |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved presentment preference |
state | String | Indicates if the retrieved presentment preference is active or not. The supported values are ACTIVE or INACTIVE |
presentment_preference | Presentment Preference Object | The presentment method of the retrieved presentment preference |
Email Object | The email related with the presentment preference. This information is available only if the selected presentment method is of type Email | |
phone | Phone Object | The phone related with the presentment preference. This information is available only if the selected presentment method is of type SMS |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved presentment method |
name | String | The name of the retrieved presentment method |
alternative_code | String | The alternative code of the retrieved presentment method |
type | Sting | The presentment method type which can be one of the following: POST, EMAIL, SMS, F2F, OTHER, CUSTOM_1, CUSTOM_2, CUSTOM_3, CUSTOM_4, CUSTOM_5 From CRM.COM R12.0.0, value F2F is replaced by FACE_TO_FACE. |
state | String | The state of the presentment preference, which can be ACTIVE or INACTIVE |
description | String | A description of the presentment preference |
Contact Information Object | The contact information related with the retrieved presentment preference |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved contact information |
type | String | The type of the retrieved contact information which can be PERSON or COMPANY |
life_cycle_state | String | The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL |
name | String | The full name of the retrieved contact information |
first_name | String | The first name of the retrieved contact information |
middle_name | String | The middle name of the retrieved contact information |
last_name | String | The last name of the retrieved contact information |
title | String | The title of the retrieved contact information |
company_name | Sting | The company name of the retrieved contact information |
Demographics Object | The demographics information of the retrieved contact information | |
Company profile object | The company profile of the retrieve contact information |
Referred Objects Response Data
Name | Type | Description |
gender | String | The gender of the retrieved contact information which can be MALE or FEMALE |
id_number | String | The ID number of the retrieved contact information |
id_number_expiration_date | Date | The ID number's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
passport_number | String | The passport number of the retrieved contact information |
passport_number_expiration_date | Date | The passport's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
social_security_number | String | The social security number of the retrieved contact information |
Date of Birth Object | The date of birth of the retrieved contact information | |
Name Day Object | The name day of the retrieved contact information | |
Country Object | The country of residence of the retrieved contact information | |
Country Object | The ID issued country of retrieved contact information | |
Country Object | The passport issued country of retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved date of birth |
month | Integer | The month of the retrieved date of birth |
year | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved name day |
month | Integer | The month of the retrieved name day |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
profile_year | Number | The profile year of the retrieved contact information |
annual_turnover | Number | The annual turnover of the retrieved contact information |
established_date | Date | The established date of the retrieved contact information |
number_of_employees | Number | The number of employees of the retrieved contact information |
registration_number | String | The registration number of the retrieved contact information |
vat_registration_number | String | The vat registration number of the retrieved contact information |
vat_registered_by | String | The vat registration by of the retrieved contact information |
vat_registration_date | Date | The vat registration date of the retrieved contact information |
tax_reference_number | String | The tax referenece number of the retrieved contact information |
Country Object | The country of residence of the retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved email |
type | String | The type of the retrieved email which can be PERSONAL, BUSINESS, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
email_address | String | The address of the retrieved email |
notes | String | The notes of the retrieved email |
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 |
is_primary
| Boolean | Defines if the email is the contact's primary email or not. Available from CRM.COM R15 |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved phone |
type | String | The type of the retrieved phone which can be LANDLINE, MOBILE, FAX, CUSTOM1, CUSTOM2, CUSTOM3, CUSTOM4, CUSTOM5 |
number | String | The number of the retrieved phone |
area_code | String | The area code of the retrieved phone |
full_number | String | The full number of the retrieved phone |
notes | String | The notes of the retrieved phone |
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 |
Country Object | The country of the retrieved phone | |
is_primary | Boolean | Defines if the phone is the contact's primary phone or not. Available from CRM.COM R15 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved payment preference |
account_holder | String | The account holder of the retrieved payment preference |
bank_account_number | String | The bank account number of the retrieved payment preference |
default | Boolean | Indicates if the retrieved payment preference is the default for the related accounts receivable |
state | String | Indicates if the retrieved payment preference is active or not. The supported values are ACTIVE or INACTIVE Available from CRM.COM R15.0.0 |
use_for_recurring_payments | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable. Depracated from CRM.COM R16.0.0 (and replaced by opt_in_for_subscriptions). The parameter will still function but it will not be maintained |
opt_in_for_subscriptions | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable, related to its subscriptions. Available from CRM.COM R16.0.0 |
opt_in_for_purchases | Boolean | Indicates if the specific Accounts Receivable Payment Preference will be used to automatically pay any unsettled bills allocated to the related accounts receivable, related to purchases. Available from CRM.COM R16.0.0 |
notes | String | The notes of the retrieved payment preference object. Available from CRM.COM R10.1.0 |
payment_medium_identifier | String | The payment medium identifier related with the retrieved payment preference Available from CRM.COM R11.0.0 |
iban | String | The international bank account number Available from CRM.COM R13.1.0 |
business_identifier_code | String | The business identifier code that identifies the bank Available from CRM.COM R13.1.0 |
unique_mandate_reference | Number | The unique reference, which identifies a mandate that was signed by a Debtor for any given Creditor Available from CRM.COM R13.1.0 |
mandate_signing_date | Date | The date that the mandate was signed Available from CRM.COM R13.1.0 |
mandate_termination_date | Date | The date that the mandate will be terminated. No payments should be send after that date (inclusive) Available from CRM.COM R13.1.0 |
payment_preference | Payment Preference Object | The payment preference of the retrieved payment preference |
Bank Account Type Object | The bank account type related with the retrieved payment preference | |
Bank Object | The bank related with the retrieved payment preference | |
Bank Branch Object | The bank branch related with the retrieved payment preference | |
payment_medium_type | Payment Medium Type | The payment medium type related with the retrieved payment preference Available from CRM.COM R11.0.0 |
payment_medium_brand | Payment Medium Brand | The payment medium brand related with the retrieved payment preference Available from CRM.COM R11.0.0 |
default_card | Payment Gateway Card Objects | It defines the default payment gateway card that should be used while automatically creating payments against that specific accounts receivable. The default card is also set on payments done using the specific payment preference, although the user can modify this information, by selecting an additional card. |
cards_set | Set Payment Gateway Card Objects | The set of all payment gateway cards which are related with the specific accounts receivable payment preference |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment preference |
name | String | The name of the retrieved payment preference |
alternative_code | String | The alternative code of the retrieved payment preference |
type | Sting | The type of the payment preference, such as
BRAINTREE_PAYMENT_GATEWAY and CUSTOM_PAYMENT_GATEWAY are available from CRM.COM R14.2.0 WALLET available from CRM.COM R17.0.0 |
description | Sting | The description of the retrieved payment preference |
Name | Type | Description |
id | String | The id of the retrieved bank account type |
name | String | The name of the retrieved bank account type |
alternative_code | String | The alternative code of the retrieved bank account type |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved bank |
name | String | The name of the retrieved bank |
alternative_code | String | The alternative code of the retrieved bank |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved bank branch |
name | String | The name of the retrieved bank branch |
alternative_code | String | The alternative code of the retrieved bank branch |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment medium type |
name | String | The name of the retrieved payment medium type |
alternative_code | String | The alternative code of the retrieved payment medium type |
description | String | The description of the retrieved payment medium type |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment medium brand |
name | String | The name of the retrieved payment medium brand |
alternative_code | String | The alternative code of the retrieved payment medium brand |
description | String | The description of the retrieved payment medium brand |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment gateway card |
payment_gateway_reference_number | String | The card's reference number as provided by the payment gateway. This number is used to submit transactions on the payment gateway that will be processed using that card |
card_holder_name | String | The card holders name, as provided during the registration of the card |
brand | String | The card's brand, as provided by the payment gateway provider. The supported brands by the payment gateways are the following
|
expiration_month | Number | The card's expiration month, which can be from 1 to 12 |
expiration_year | Number | The card's expiration year which is a 4 digits number |
type | String | The type of the card, as provided by the payment gateway provider. The supported types by the payment gateway are the following:
|
last_digits | String | The last 4 digits of the card as provided by the payment gateway provider. Those digits are masked with 12 asterisk characters for example **** ***** ***** 4242 |
consumer_token | String | The consumer token |
Name | Type | Description |
---|---|---|
default | Boolean | Indicates if the retrieved payment gateway card is the default for the related accounts receivable payment preference |
Payment Gateway Card Object | The represented payment gateway card |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved payment gateway card |
payment_gateway_reference_number | String | The card's reference number as provided by the payment gateway. This number is used to submit transactions on the payment gateway that will be processed using that card |
card_holder_name | String | The card holders name, as provided during the registration of the card |
brand | String | The card's brand, as provided by the payment gateway provider. The supported brands by the payment gateways are the following
|
expiration_month | Number | The card's expiration month, which can be from 1 to 12 |
expiration_year | Number | The card's expiration year which is a 4 digits number |
type | String | The type of the card, as provided by the payment gateway provider. The supported types by the payment gateway are the following:
|
last_digits | String | The last 4 digits of the card as provided by the payment gateway provider. Those digits are masked with 12 asterisk characters for example **** ***** ***** 4242 |
consumer_token | String | The consumer token |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved access token |
number | String | The number of the retrieved access token |
life_cycle_state | String | The state of the retrieved access token which can be one of the following: EFFECTIVE, NOT_EFFECTIVE |
authentication_code | String | The authentication code of the retrieved access token |
identifier | String | The identifier of the retrieved access token |
card_masked_number | String | The masked number of the card as provided
Available from CRM.COM R16.2.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 |
classification | Access Token Classification Object | The classification of the access token Available from CRM.COM R10.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved classification |
name | String | The name of the retrieved classification |
alternative_code | String | The alternative code of the retrieved classification |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved accounts receivable |
number | String | The number of the retrieved accounts receivable |
name | String | The name of the retrieved accounts receivable |
life_cycle_state | String | The life cycle state of the accounts receivable. One of the following values is returned: ACTIVE, SUSPENDED, TERMINATED |
funding_scope | String | The funding scope of the member accounts receivable. Two options are available FULLY_FUNDED and PARTIALLY_FUNDED Deprecated from CRM.COM R13.1.0 |
account_owner | Contact Information Object | The contact information owning the accounts receivable |
funded_services | Set of Product objects | The Services / Service Types / Service Families that are funded by the Parent Account. Deprecated from CRM.COM R13.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved contact information |
type | String | The type of the retrieved contact information which can be PERSON or COMPANY |
life_cycle_state | String | The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL |
name | String | The full name of the retrieved contact information |
first_name | String | The first name of the retrieved contact information |
middle_name | String | The middle name of the retrieved contact information |
last_name | String | The last name of the retrieved contact information |
title | String | The title of the retrieved contact information |
company_name | Sting | The company name of the retrieved contact information |
Demographics Object | The demographics information of the retrieved contact information | |
Company profile object | The company profile of the retrieve contact information |
Referred Objects Response Data
Name | Type | Description |
gender | String | The gender of the retrieved contact information which can be MALE or FEMALE |
id_number | String | The ID number of the retrieved contact information |
id_number_expiration_date | Date | The ID number's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
passport_number | String | The passport number of the retrieved contact information |
passport_number_expiration_date | Date | The passport's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
social_security_number | String | The social security number of the retrieved contact information |
Date of Birth Object | The date of birth of the retrieved contact information | |
Name Day Object | The name day of the retrieved contact information | |
Country Object | The country of residence of the retrieved contact information | |
Country Object | The ID issued country of retrieved contact information | |
Country Object | The passport issued country of retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved date of birth |
month | Integer | The month of the retrieved date of birth |
year | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved name day |
month | Integer | The month of the retrieved name day |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
profile_year | Number | The profile year of the retrieved contact information |
annual_turnover | Number | The annual turnover of the retrieved contact information |
established_date | Date | The established date of the retrieved contact information |
number_of_employees | Number | The number of employees of the retrieved contact information |
registration_number | String | The registration number of the retrieved contact information |
vat_registration_number | String | The vat registration number of the retrieved contact information |
vat_registered_by | String | The vat registration by of the retrieved contact information |
vat_registration_date | Date | The vat registration date of the retrieved contact information |
tax_reference_number | String | The tax referenece number of the retrieved contact information |
Country Object | The country of residence of the retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
---|---|---|
product | Product object | The product related with the retrieved member account |
product_type | Product Type object | The product type related with the retrieved member account |
product_family | Product Family object | The product family related with the retrieved the retrieved member account. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the product |
code | String | The code of product |
alternative_code | String | The alternative code of product |
description | String | The description of product |
priority_level | Integer | The priority level of the product Available from CRM.COM R12.3.0 |
global_rate | Global Rate Object | The global rate of the retrieved product Available from CRM.COM R15.0.0 |
product_type | Product type object | The type of the product |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rate |
rate_model | String | The price plan rate model which can be one of the following:
From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED |
global_base_amount | Number | The base price of the product in the Global Price Plan |
base_rate_applied_per | String | The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between
|
uot | String | The 'UOT' applicable for the rate
Available for one-time services |
time_period | Time Period Object | The period and unit of time for which the base amount is applicable for. This is available only on termed services rates. |
uom | String | The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
time_period_value | Number | The time period value |
time_period_uot | String | The time period unit of time. The supported values are the following: MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product type |
name | String | The Name of the retrieved product type |
alternative_code | String | The Alternative Code of the retrieved product type |
description | String | The Description of the retrieved product type |
classification | String | The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS |
service_type | String | The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE |
physical_good_type | String | The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE |
composition_method | String | The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE |
used_for_provisioning | Boolean | The flag shows if the retrieved product type is used for provisioning |
udr_type | Usage Detail Record Type | The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE |
meter_reading_type | Meter Reading Type | The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved usage detail record type |
name | String | The Name of the retrieved usage detail record type |
alternative_code | String | The Alternative Code of the retrieved usage detail record type |
description | String | The Description of the retrieved usage detail record type |
unit_of_measurement | String | The Unit of measurement of the retrieved usage detail record type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved meter reading type |
name | String | The Name of the retrieved meter reading type |
alternative_code | String | The Alternative Code of the retrieved meter reading type |
classification | String | The Classification of the retrieved meter reading type |
description | String | The Description of the retrieved meter reading type |
unit_of_measurement | String | The Unit of measurement of the retrieved meter reading type |
Referred Objects Response Data
Name | Type | Description |
id | String | The identifier of the Unit of measurement |
name | String | The name of the Unit of measurement |
description | String | The description of the Unit of measurement |
alternative_code | String | The alternative code of the Unit of measurement |
Name | Type | Description |
---|---|---|
Id | String | The ID of the retrieved product family |
name | String | The Name of the retrieved product family |
code | String | The code of the retrieved product family |
description | String | The Description of the retrieved product family |
Name | Type | Description |
---|---|---|
sign_up_on | Date | The date that the accounts receivable signed up |
sign_up_by_unit | Unit Object | The unit that signed up the accounts receivable Deprecated from CRM.COM R18.0.0 |
sign_up_by_business_unit | Business Unit Object | The business unit that signed up the accounts receivable Available from CRM.COM R18.0.0 |
auto_spend_authorisation | Auto Spend Settings Object | The accounts receivable's automatic spend settings |
spend_blocking_state | Rewards Participant Spend Requests Blocking State Object | The accounts receivable's spend requests blocking state |
reward_tier | Rewards Tier Information Object | The Rewards Tier information for the accounts receivable |
participating_schemes_set | Set of Rewards Participant Scheme Objects | A list of reward schemes that the accounts receivable has joined |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
enabled | Boolean | Defines whether automatic spend authorisation is enabled or not for the rewards participant |
minimum_wallet_balance | Float | The minimum wallet balance that should be available in order for an automatic awards spending to be applied. If specified then automatic awards spends will be created if the rewards participant has an available wallet amount which is equal or more than the minimum amount. Available from CRM.COM R13.0.0 |
minimum_spend_amount | Float | The minimum amount that can be spend by that specific rewards participant during auto spend. If specified then automatic awards spends will be created if the rewards participant has an available amount that can be spend which is equal or more than the minimum amount. Available from CRM.COM R13.0.0 |
maximum_spend_amount | Float | The maximum amount that can be spend by that specific rewards participant during auto spend. If specified then the amount of the automatic awards spends that will be created will be up to that specified amount, even if the available amount that can be spend is more than the maximum amount. Available from CRM.COM R13.0.0 |
updated_date | Date | The last updated date on which the allow automatic spend setting was updated. |
updated_by_user | Users Object | The User who last updated the allow automatic spend setting. |
authorised_rewards_participating_merchants_set | Set of Rewards Participating Merchants | It defines the list of merchants which are authorised to perform automatic awards spending on that specific rewards participant, considering that those merchants are also allowing automatic awards spendings. If not specified then all rewards participating merchants are considered as authorised Available from CRM.COM R13.0.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rewards participating merchant |
life_cycle_state | String | The life cycle state of the retrieved rewards participating merchant that can be EFFECTIVE or NOT_EFFECTIVE |
description | String | A description of the retrieved rewards participating merchant |
business_unit | Business Unit Object | The business unit that represents the rewards participating merchant Available from CRM.COM R18.0.0 |
unit | Unit Object | The unit that represents the rewards participating merchant Deprecated from CRM.COM R18.0.0 (replaced with business_unit) |
group | Group Object | The group that the rewards participating merchant's unit belongs to Deprecated from CRM.COM R18.0.0 (replaced with business_unit) |
log_information | Log Information Object | The log information of the retrieved rewards participating merchant |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved group |
name | String | The name of the retrieved group |
community_name | String | The name of the community that the retrieved group belongs to |
alternative_code | String | The alternative code of the retrieved group |
unified_code | String | The unified code of the retrieved group Available from CRM.COM R16.2.2 |
description | String | The description of the retrieved group |
Name | Type | Description |
created_date | Date | The date that the retrieved record was created |
updated_date | Date | The last date that the retrieved record was updated |
Unit Object | The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0 | |
Unit Object | The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Available from CRM.COM R18.0.0 | |
User Object | The user that created the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled | |
Unit Object | The last unit that updated the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0 | |
Unit Object | The last unit that updated the retrieved record Available from CRM.COM R18.0.0 | |
User Object | The last user that updated the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
enabled | Boolean | Defines whether the rewards participant is blocked from submitting spend requests |
updated_date | Date | The date on which the rewards participant's blocking state was enabled/disabled |
updated_by_user | Users Object | The user who enabled/disabled the rewards participant's blocking state |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved reward tier |
name | String | The name of the retrieved reward tier |
code | String | The code of the retrieved reward tier |
marketing_information | Reward Tier Marketing Information Object | The reward tier's marketing information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
tier_color | String | The hexadecimal value of the tier's color |
Name | Type | Description |
---|---|---|
termination_reason | String | Defines the rewards participant's termination reason. Available values are CUSTOMERREQUEST, FRAUD, DUPLICATION |
termination_date | Date | The date on which the rewards participant was terminated |
terminated_by_user | Users Object | The user who terminated the rewards participant |
replaced_by_rewards_participant | Rewards Participant Object | The Rewards Participant which replaced the terminated Rewards Participant. Applicable and mandatory only when the termination reason is set to DUPLICATION. |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved user |
username | String | The user name of the retrieved user |
person_name | String | The full name of the retrieved user |
String | The email of the retrieved user |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved reward participant |
number | String | The number of the retrieved reward participant |
life_cycle_state | String | The life cycle state of the rewards participant. Available values are EFFECTIVE and TERMINATED. Available from CRM.COM R12.0.0 |
accounts_receivable | Accounts receivable object | The accounts receivable owned by the reward participant |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved accounts receivable |
number | String | The number of the retrieved accounts receivable |
name | String | The name of the retrieved accounts receivable |
life_cycle_state | String | The life cycle state of the accounts receivable. One of the following values is returned: ACTIVE, SUSPENDED, TERMINATED |
account_owner | Contact information object | The contact information owning the accounts receivable |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved contact information |
type | String | The type of the retrieved contact information which can be PERSON or COMPANY |
life_cycle_state | String | The lifecycle state of the retrieved contact information which can be MARKETING or FINANCIAL |
name | String | The full name of the retrieved contact information |
first_name | String | The first name of the retrieved contact information |
middle_name | String | The middle name of the retrieved contact information |
last_name | String | The last name of the retrieved contact information |
title | String | The title of the retrieved contact information |
company_name | Sting | The company name of the retrieved contact information |
Demographics Object | The demographics information of the retrieved contact information | |
Company profile object | The company profile of the retrieve contact information |
Referred Objects Response Data
Name | Type | Description |
gender | String | The gender of the retrieved contact information which can be MALE or FEMALE |
id_number | String | The ID number of the retrieved contact information |
id_number_expiration_date | Date | The ID number's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
passport_number | String | The passport number of the retrieved contact information |
passport_number_expiration_date | Date | The passport's expiration date of the retrieved contact information Available from CRM.COM R14.0.0 |
social_security_number | String | The social security number of the retrieved contact information |
Date of Birth Object | The date of birth of the retrieved contact information | |
Name Day Object | The name day of the retrieved contact information | |
Country Object | The country of residence of the retrieved contact information | |
Country Object | The ID issued country of retrieved contact information | |
Country Object | The passport issued country of retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved date of birth |
month | Integer | The month of the retrieved date of birth |
year | Integer | The year of the retrieved date of birth |
Name | Type | Description |
---|---|---|
day | Integer | The day of the retrieved name day |
month | Integer | The month of the retrieved name day |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
profile_year | Number | The profile year of the retrieved contact information |
annual_turnover | Number | The annual turnover of the retrieved contact information |
established_date | Date | The established date of the retrieved contact information |
number_of_employees | Number | The number of employees of the retrieved contact information |
registration_number | String | The registration number of the retrieved contact information |
vat_registration_number | String | The vat registration number of the retrieved contact information |
vat_registered_by | String | The vat registration by of the retrieved contact information |
vat_registration_date | Date | The vat registration date of the retrieved contact information |
tax_reference_number | String | The tax referenece number of the retrieved contact information |
Country Object | The country of residence of the retrieved contact information | |
Industry Object | The industry of retrieved contact information | |
Industry sector Object | The sector of retrieved contact information |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved country |
name | String | The name of the retrieved country |
alternative_code | String | The alternative code of the retrieved country |
dialing_code | String | The dialing code of the retrieved country Available from CRM.COM R15.1.0 |
two_character_code | String | The two character code of the retrieved country |
three_character_code | String | The three character code of the retrieved country |
country_flag | Image Object | The flag of the retrieved country Available from CRM.COM R15.1.0 |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved country flag |
file | File Object | The information of the attached file |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
file_name | String | The name of the file |
file_content_url | String | The url that can be used to access the actual content of the file |
file_mime_type | String | The mime type of the attached file |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry |
name | String | The name of the retrieved industry |
code | String | The code of the retrieved industry |
Name | Type | Description |
---|---|---|
id | String | The id of the retrieved industry sector |
name | String | The name of the retrieved industry sector |
alternative_code | String | The alternative code of the retrieved industry sector |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved rewards participant participating reward scheme |
sign_up_on | Date | The date that the rewards participant signed up for that specific reward scheme |
sign_off_on | Date | Available from CRM.COM R9.0.0 The date that the rewards participant signed off from that specific reward scheme |
reference_code | Sting | The unique reference code that was used while signing up to that specific reward scheme. This is available only if it is required by the specific reward scheme Available from CRM.COM R12.7.0 |
sign_up_by_unit | Unit object | The unit that signed up the rewards participant to that specific reward scheme Deprecated from CRM.COM R18.0.0 |
sign_up_by_business_unit | Business Unit object | The business unit that signed up the rewards participant to that specific reward scheme Available from CRM.COM R18.0.0 |
scheme | Reward Scheme Object | The reward scheme that the rewards participant has joint |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved reward scheme |
name | String | The name of the retrieved reward scheme |
alternative_code | String | The alternative code of the retrieved reward scheme |
description | String | A description of the retrieved reward scheme |
life_cycle_state | String | The life cycle state of the reward scheme which can be EFFECTIVE or NOT_EFFECTIVE |
Name | Type | Description |
---|---|---|
business_unit | Business Unit Object | The business unit included in the accounts receivable usage organisational condition Available from CRM.COM R18.0.0 |
unit | Unit object | The unit included in the accounts receivable usage organisational condition Deprecated from CRM.COM R18.0.0 (replaced with business_unit) |
group | Group object | The group included in the accounts receivable usage organisational condition Deprecated from CRM.COM R18.0.0 (replaced with business_unit) |
community | Community object | The community included in the accounts receivable usage organisational condition Deprecated from CRM.COM R18.0.0 (replaced with business_unit) |
Referred Objects Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved unit |
name | String | The name of the retrieved unit |
group_name | String | The name of the group that the retrieved unit belongs to |
community_name | String | The name of the community that the retrieved unit belongs to |
alternative_code | String | The alternative code of the retrieved unit |
description | String | The description of the retrieved unit |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved group |
name | String | The name of the retrieved group |
community_name | String | The name of the community that the retrieved group belongs to |
alternative_code | String | The alternative code of the retrieved group |
unified_code | String | The unified code of the retrieved group Available from CRM.COM R16.2.2 |
description | String | The description of the retrieved group |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved community |
name | String | The name of the retrieved community |
alternative_code | String | The alternative code of the retrieved community |
description | String | The description of the retrieved community |
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved business unit |
name | String | The name of the retrieved business unit |
code | String | The code of the retrieved business unit |
unified_code | String | The unified code of the retrieved business unit |
description | String | The description of the retrieved business unit |
parent_business_unit_name | String | The name of the parent business unit that the retrieved business unit belongs to |
Examples
HTTP Method: POST
Request
Body
{ "token":"1A2C10CE446847C6BDD71FB816D95A0D", "name":"Andrew Tomas2", "description":"normal account", "notes": "there are currently no notes", "vat_number":"10", "credit_limit" :10, "credit_period_operator":"PLUS", "credit_period":2, "classification_identifier":{"alternative_code":"SA"}, "credit_rating_code":"AAA", "owned_by_group_identifier":{"name":"Main Group"}, "udf_string_1":"udf string 1", "udf_string_2":"udf string 2", "udf_string_3":"udf string 3", "udf_string_4":"udf string 4", "udf_string_5":"udf string 5", "udf_string_6":"udf string 6", "udf_string_7":"udf string 7", "udf_string_8":"udf string 8", "udf_float_1":10, "udf_float_2":20, "udf_float_3":30, "udf_float_4":40, "udf_float_5":50, "udf_float_6":60, "udf_float_7":70, "udf_float_8":80, "udf_date_1":"2014-05-05T15:49:59", "udf_date_2":"2014-06-05T15:49:59", "udf_date_3":"2014-07-05T15:49:59", "udf_date_4":"2014-08-05T15:49:59", "contact_information": { "action":"NEW", "type":"PERSON", "first_name":"Andrew", "last_name":"Tomas2", "address_set": [ { "type":"HOME", "street_name":"Thomas V" } ], }, "billing_address": { "action":"EXISTING", "type":"HOME" }, "presentment_preferences_set": [ { "presentment_preference_identifier":{"name":"By Email"}, "state":"ACTIVE", "email":{"action":"NEW","email":{ "type":"BUSINESS", "email_address":"test@gmail.com"} } } ], "payment_preferences_set": [ { "account_holder": "Lucia Papapavlou", "is_default":true, "bank_account_number": "001002003", "payment_preference_identifier":{"alternative_code":"BTP"}, "bank_account_type_identifier":{"alternative_code":"SA"}, "bank_identifier":{"alternative_code":"BOC"}, "bank_branch_identifier":{"name":" BOC 1"}, } ] }
Response
{ "status": { "message": "", "description": "", "code": "OK" }, "data": { "notes": "Marios Lannister\t17/5/2016 11:33:35\tthere are currently no notes", "udf_float_1": 10, "udf_float_2": 20, "credit_period": 2, "udf_float_3": 30, "udf_float_4": 40, "number": "ACR001027", "name": "Andrew Tomas2", "udf_string_1": "udf string 1", "udf_string_2": "udf string 2", "privacy_level": null, "contact_information": { "last_name": "Tomas2", "middle_name": null, "life_cycle_state": "FINANCIAL", "company_profile": null, "title": null, "first_name": "Andrew", "type": "PERSON", "id": "786E6D78AC764BECB616D34D2D61F053", "name": "Tomas2 Andrew", "company_name": null, "demographics": { "gender": null, "passport_issued_by_country": null, "social_security_number": null, "passport_number": null, "industry_sector": null, "country_of_residence": { "three_character_code": "CYP", "two_character_code": "CY", "id": "181", "name": "CYPRUS", "alternative_code": null }, "name_day": { "month": null, "day": null }, "date_of_birth": { "month": null, "day": null, "year": null }, "id_number": null, "industry": null, "id_issued_by_country": null } }, "udf_string_3": "udf string 3", "udf_string_4": "udf string 4", "udf_string_5": "udf string 5", "udf_string_6": "udf string 6", "udf_string_7": "udf string 7", "udf_string_8": "udf string 8", "id": "0C6F60B6DE7D4853A6E41E5FE537EDEC", "credit_period_operator": "PLUS", "balance": 0, "outstanding_amount": 0, "payment_preferences_set": [ { "default": true, "payment_preference": { "type": "OTHER", "id": "0135CB827A97DC1ECDA7EEA993A8ED09", "name": "Bank Transfer Payment", "description": null, "alternative_code": "BTP" }, "bank_branch": { "id": "7559D997AD2DA661F2FC3AFE90257F79", "name": " BOC 1", "alternative_code": "B1" }, "cards_set": [], "id": "4FEEB97864804D57BDF86D4459E887DB", "bank": { "id": "A5B487FA26F43959188DB9584D2522D5", "name": "Bank of Cyprus", "alternative_code": "BOC" }, "use_for_recurring_payments": null, "account_holder": "Lucia Papapavlou", "bank_account_number": "001002003", "default_card": null, "bank_account_type": { "id": "249CEEE1901507788DF83C8758E4716E", "name": "Savings Account", "alternative_code": null } } ], "credit_rating": { "name": "key_aaa_-_subject_to_minimal_credit_risk", "code": "AAA" }, "classification": { "id": "DE3DC5FD43B51C09F7E0573B845ABE08", "name": "Standard Customer", "alternative_code": "SA" }, "udf_date_1": "2014-05-05T15:49:59", "udf_date_2": "2014-06-05T15:49:59", "udf_date_3": "2014-07-05T15:49:59", "accounting_period": null, "udf_date_4": "2014-08-05T15:49:59", "billing_address": { "udf_string_10": null, "street_number": null, "care_of": null, "udf_string_11": null, "udf_float_1": null, "street_name": "Thomas V", "udf_string_12": null, "udf_float_2": null, "udf_string_13": null, "udf_float_3": null, "udf_string_14": null, "udf_float_4": null, "udf_string_15": null, "udf_string_16": null, "po_box": null, "udf_string_1": null, "floor": null, "udf_string_2": null, "area": null, "udf_string_3": null, "district": null, "udf_string_4": null, "udf_string_5": null, "udf_string_6": null, "udf_string_7": null, "state": "Active", "udf_string_8": null, "udf_string_9": null, "country": { "three_character_code": "CYP", "two_character_code": "CY", "id": "181", "name": "CYPRUS", "alternative_code": null }, "id": "78C14BFC8BB248FFB6A86EC91464E666", "postal_code": null, "udf_date_1": null, "udf_date_2": null, "udf_date_3": null, "udf_date_4": null, "po_box_postal_code": null, "apartment_number": null, "town_city": null, "type": "HOME", "municipality": null }, "primary_account": true, "owned_by_group": { "community_name": "Internal Community", "id": "84F33366CB592BAAE7E2044D93611C6A", "name": "Main Group", "description": "Main Group", "alternative_code": "MG1" }, "log_information": { "updated_date": "2016-05-17T11:33:36", "created_date": "2016-05-17T11:33:35", "created_by_unit": { "community_name": "Internal Community", "id": "48305F8849E3C18B227C5BE3A27BA6DF", "name": "Admin Unit", "group_name": "Main Group", "description": "r1 Test Description for resource request tab.Test Description for resource request tab.", "alternative_code": "MG" }, "updated_by_unit": { "community_name": "Internal Community", "id": "48305F8849E3C18B227C5BE3A27BA6DF", "name": "Admin Unit", "group_name": "Main Group", "description": "r1 Test Description for resource request tab.Test Description for resource request tab.", "alternative_code": "MG" }, "created_by_user": { "person_name": "Marios Lannister", "username": "MPAdministrator", "id": "1" }, "updated_by_user": { "person_name": "Marios Lannister", "username": "MPAdministrator", "id": "1" } }, "presentment_preferences_set": [ { "state": "ACTIVE", "presentment_method": { "state": "ACTIVE", "type": "EMAIL", "id": "06A57761BCC28FA9687C57321F2BEB28", "name": "By Email", "description": null, "contact_information": { "last_name": "Spector", "middle_name": null, "life_cycle_state": "FINANCIAL", "company_profile": null, "title": null, "first_name": "Mathew", "type": "PERSON", "id": "95548C3522A249E6B452D20C700BA95C", "name": "Spector Mathew", "company_name": null, "demographics": { "gender": null, "passport_issued_by_country": null, "social_security_number": "1245", "passport_number": null, "industry_sector": null, "country_of_residence": { "three_character_code": "USA", "two_character_code": "US", "id": "127", "name": "UNITED STATES", "alternative_code": null }, "name_day": { "month": null, "day": null }, "date_of_birth": { "month": null, "day": null, "year": null }, "id_number": "454545", "industry": null, "id_issued_by_country": null } }, "alternative_code": "BE" }, "id": "7528AC290B9D4034907531E495752CBE", "email": { "notes": null, "udf_float_1": null, "udf_float_2": null, "udf_date_1": null, "udf_float_3": null, "udf_date_2": null, "udf_float_4": null, "udf_date_3": null, "udf_date_4": null, "udf_string_1": null, "udf_string_2": null, "udf_string_3": null, "udf_string_4": null, "udf_string_5": null, "udf_string_6": null, "state": "Active", "udf_string_7": null, "udf_string_8": null, "type": "key_business", "id": "66980E70BF9742C9A9A2E0D8EE23CED3", "email": "test@gmail.com" }, "phone": null } ], "credit_limit": 10, "opening_balance": null, "life_cycle_state": "ACTIVE", "access_tokens_set": [], "opening_balance_date": null, "type": "CUSTOMER", "credit_limit_status": "NOT_EXCEEDED", "description": "normal account" } }
HTTP Method: POST
Request
Body
{ "token":"{{token}}", "name":"Mike", "description":"normal account", "notes": "there are currently no notes", "vat_number":"10", "credit_limit" :10, "credit_period_operator":"PLUS", "credit_period":2, "classification_identifier":{"alternative_code":"SA"}, "credit_rating_code":"AAA", "owned_by_group_identifier":{"name":"Main Group"}, "contact_information": { "action":"NEW", "type":"PERSON", "first_name":"Mike", "last_name":"Peterson", "address_set": [ { "type":"HOME", "street_name":"Thomas V" } ], }, "billing_address": { "action":"EXISTING", "type":"HOME" }, "presentment_preferences_set": [ { "presentment_preference_identifier":{"name":"By Email"}, "state":"ACTIVE", "email":{"action":"NEW","email":{ "type":"BUSINESS", "email_address":"test@gmail.com"} } } ], "fields_set":"name,type,life_cycle_state,credit_limit_status,credit_limit,presentment_preferences_set,classification,email,billing_address" }
Response
{ "status": { "message": "", "description": "", "code": "OK" }, "data": { "billing_address": { "udf_string_10": null, "street_number": null, "care_of": null, "udf_string_11": null, "udf_float_1": null, "street_name": "Thomas V", "udf_string_12": null, "udf_float_2": null, "udf_string_13": null, "udf_float_3": null, "udf_string_14": null, "udf_float_4": null, "udf_string_15": null, "udf_string_16": null, "po_box": null, "udf_string_1": null, "floor": null, "udf_string_2": null, "area": null, "udf_string_3": null, "district": null, "udf_string_4": null, "udf_string_5": null, "udf_string_6": null, "udf_string_7": null, "state": "Active", "udf_string_8": null, "udf_string_9": null, "country": { "three_character_code": "CYP", "two_character_code": "CY", "id": "181", "name": "CYPRUS", "alternative_code": null }, "id": "1DC48B413E434BA88CC5133DE8218B19", "postal_code": null, "udf_date_1": null, "udf_date_2": null, "udf_date_3": null, "udf_date_4": null, "po_box_postal_code": null, "apartment_number": null, "town_city": null, "type": "HOME", "municipality": null }, "presentment_preferences_set": [ { "state": "ACTIVE", "presentment_method": { "state": "ACTIVE", "type": "EMAIL", "id": "06A57761BCC28FA9687C57321F2BEB28", "name": "By Email", "description": null, "contact_information": { "last_name": "Spector", "middle_name": null, "life_cycle_state": "FINANCIAL", "company_profile": null, "title": null, "first_name": "Mathew", "type": "PERSON", "id": "95548C3522A249E6B452D20C700BA95C", "name": "Spector Mathew", "company_name": null, "demographics": { "gender": null, "passport_issued_by_country": null, "social_security_number": "1245", "passport_number": null, "industry_sector": null, "country_of_residence": { "three_character_code": "USA", "two_character_code": "US", "id": "127", "name": "UNITED STATES", "alternative_code": null }, "name_day": { "month": null, "day": null }, "date_of_birth": { "month": null, "day": null, "year": null }, "id_number": "454545", "industry": null, "id_issued_by_country": null } }, "alternative_code": "BE" }, "id": "D5D6142208764ABC836921331DE0D6C5", "email": { "notes": null, "udf_float_1": null, "udf_float_2": null, "udf_date_1": null, "udf_float_3": null, "udf_date_2": null, "udf_float_4": null, "udf_date_3": null, "udf_date_4": null, "udf_string_1": null, "udf_string_2": null, "udf_string_3": null, "udf_string_4": null, "udf_string_5": null, "udf_string_6": null, "state": "Active", "udf_string_7": null, "udf_string_8": null, "type": "BUSINESS", "id": "A446507203C24ECE88445C09BA5C0627", "email": "test@gmail.com" }, "phone": null } ], "credit_limit": 10, "life_cycle_state": "ACTIVE", "classification": { "id": "DE3DC5FD43B51C09F7E0573B845ABE08", "name": "Standard Customer", "alternative_code": "SA" }, "type": "CUSTOMER", "name": "Mike", "credit_limit_status": "NOT_EXCEEDED" } }
HTTP Method: POST
Request
Body
{ "token":"{{token}}", "name":"Mike Tyson GBP", "description":"normal account", "notes": "there are currently no notes", "vat_number":"10", "credit_limit" :10, "credit_period_operator":"PLUS", "credit_period":2, "classification_identifier":{"alternative_code":"VC"}, "credit_rating_code":"AAA", "owned_by_group_identifier":{"name":"Main Group"}, "contact_information": { "action":"NEW", "type":"PERSON", "first_name":"Mohammed", "last_name":"Tyson J.", "address_set": [ { "type":"HOME", "street_name":"Thomas V" } ] }, "billing_address": { "action":"EXISTING", "type":"HOME" }, "presentment_preferences_set": [ { "presentment_preference_identifier":{"name":"Email"}, "state":"ACTIVE", "email":{"action":"NEW","email": { "type":"BUSINESS", "email_address":"test2@gmail.com"} } } ], "currency_identifier":{"code":"GBP"} }
Response
{ "data": { "notes": "CRM COM\t5/7/2016 10:16:22\tthere are currently no notes", "log_information": { "created_by_unit": { "alternative_code": "adminunit", "group_name": "Main Group", "community_name": "Community", "name": "Admin Unit", "description": "admin unit", "id": "1" }, "updated_by_unit": { "alternative_code": "adminunit", "group_name": "Main Group", "community_name": "Community", "name": "Admin Unit", "description": "admin unit", "id": "1" }, "created_date": "2016-07-05T07:16:22", "updated_date": "2016-07-05T07:16:22", "updated_by_user": { "person_name": "CRM COM", "id": "1", "username": "MPAdministrator" }, "created_by_user": { "person_name": "CRM COM", "id": "1", "username": "MPAdministrator" } }, "payment_preferences_set": [], "owned_by_group": { "alternative_code": "MG", "community_name": "Community", "name": "Main Group", "description": "Main Group", "id": "1" }, "description": "normal account", "contact_information": { "company_profile": null, "company_name": null, "name": "Mohammed Tyson J.", "last_name": "Tyson J.", "id": "4CBAD816231A49DBB1DAC873BECACEF3", "life_cycle_state": "FINANCIAL", "middle_name": null, "title": null, "type": "PERSON", "first_name": "Mohammed", "demographics": { "name_day": { "month": null, "day": null }, "id_number": null, "gender": null, "country_of_residence": { "alternative_code": "CYP", "three_character_code": "CYP", "name": "CYPRUS", "id": "181", "two_character_code": "CY" }, "date_of_birth": { "month": null, "year": null, "day": null }, "industry_sector": null, "passport_number": null, "industry": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } }, "billing_address": { "apartment_number": null, "care_of": null, "country": { "alternative_code": "CYP", "three_character_code": "CYP", "name": "CYPRUS", "id": "181", "two_character_code": "CY" }, "municipality": null, "type": "HOME", "udf_date_2": null, "udf_date_1": null, "street_name": "Thomas V", "udf_date_4": null, "udf_date_3": null, "udf_float_3": null, "udf_float_4": null, "po_box_postal_code": null, "udf_string_15": null, "udf_string_16": null, "udf_string_13": null, "udf_string_14": null, "udf_string_11": null, "udf_string_12": null, "id": "EC3A98D3274743D38D3BCA9A2231D158", "state": "Active", "udf_string_10": null, "floor": null, "udf_float_1": null, "udf_float_2": null, "area": null, "udf_string_2": null, "udf_string_3": null, "udf_string_4": null, "udf_string_5": null, "udf_string_1": null, "po_box": null, "town_city": null, "district": null, "street_number": null, "postal_code": null, "udf_string_6": null, "udf_string_7": null, "udf_string_8": null, "udf_string_9": null }, "primary_account": true, "type": "CUSTOMER", "udf_date_2": null, "udf_date_1": null, "udf_date_4": null, "udf_date_3": null, "number": "ACR0000000271", "udf_float_3": null, "udf_float_4": null, "balance": 0, "credit_period_operator": "PLUS", "credit_limit": 10, "credit_period": 2, "currency": { "suffix_symbol": null, "prefix_symbol": "£", "decimal_part_name": null, "code": "GBP", "integer_part_name": null, "id": "9" }, "id": "7A22F671494A41B4B712466D11CAED4F", "opening_balance": 0, "udf_float_1": null, "udf_float_2": null, "udf_string_2": null, "opening_balance_date": null, "udf_string_3": null, "udf_string_4": null, "udf_string_5": null, "privacy_level": null, "presentment_preferences_set": [ { "phone": null, "presentment_method": { "alternative_code": "E", "name": "Email", "description": null, "contact_information": { "company_profile": null, "company_name": null, "name": "michael may", "last_name": "may", "id": "7F1D15F4735C4461A2E033FD960DDB10", "life_cycle_state": "MARKETING", "middle_name": null, "title": null, "type": "PERSON", "first_name": "michael", "demographics": { "name_day": { "month": null, "day": null }, "id_number": null, "gender": null, "country_of_residence": { "alternative_code": "IRN", "three_character_code": null, "name": "IRAN (ISLAMIC REPUBLIC OF)", "id": "231", "two_character_code": null }, "date_of_birth": { "month": null, "year": null, "day": null }, "industry_sector": null, "passport_number": null, "industry": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } }, "id": "67EC7B4252DA209B59733125FB248CED", "state": "ACTIVE", "type": "EMAIL" }, "id": "16FFC3147A8843B5A7DE0AA47B8F9595", "state": "ACTIVE", "email": { "udf_string_2": null, "udf_string_3": null, "udf_string_4": null, "notes": null, "udf_string_5": null, "udf_string_1": null, "type": "BUSINESS", "udf_date_2": null, "udf_date_1": null, "udf_date_4": null, "udf_date_3": null, "udf_float_3": null, "udf_float_4": null, "id": "B347786A138F49B6B33B4B2522F60713", "state": "Active", "udf_string_6": null, "udf_float_1": null, "udf_string_7": null, "udf_float_2": null, "email": "test2@gmail.com", "udf_string_8": null } } ], "udf_string_1": null, "life_cycle_state": "ACTIVE", "classification": { "alternative_code": "VC", "name": "VIP Customer", "id": "F36179059928D40AC42DF66A67364021" }, "credit_limit_status": "NOT_EXCEEDED", "credit_rating": { "code": "AAA", "name": "key_aaa_-_subject_to_minimal_credit_risk" }, "name": "Mike Tyson GBP", "outstanding_amount": 0, "udf_string_6": null, "udf_string_7": null, "accounting_period": null, "access_tokens_set": [], "udf_string_8": null }, "status": { "code": "OK", "description": "", "message": "" } }
- No labels