GET accounts_receivable/favorite_items/list
- George Rossides (Unlicensed)
- Marios Michael
- Former user (Deleted)
- Christina Georgiou (Unlicensed)
Available from CRM.COM R14.4.0
This method returns the favorite items of a specific accounts receivable. Multiple favorite items are retrieved by this call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
accounts_receivable_identifier (mandatory) | Accounts Receivable Identifier | The identifier of the accounts receivable which owns the list of favorite items. The allowed accounts receivable identifier fields are the following:
| ||||||||||||
number_of_results (optional) | Number | The number of results that can be retrieved through each call | ||||||||||||
offset (optional) | Number | Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number | ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved favorite item |
number | String | The number of the retrieved favorite Item |
notes | String | The notes of the retrieved favorite item Available from CRM.COM R14.10 onwards |
accounts_receivable | Accounts Receivable Object | The related accounts receivable |
Product Object | The product that is included as a favorite item | |
components_set | Set of Products Object | The product components that are included in the specified product. This information is available only if the specified product is a flexible product bundle |
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 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 |
Examples
HTTP Method: GET
Request
Response
{ "data": [ { "number": null, "product": { "code": "1234", "product_type": { "meter_reading_type": { "unit_of_measurement": { "alternative_code": "K", "name": "Kilos", "description": null, "id": "42CACE552A58408F8143884E1C181057" }, "alternative_code": "MTT", "name": "MT TYPES", "description": null, "id": "4E951AFF3513471883161CF5E9029C3A", "classification": "ONE_TIME_READING" }, "service_type": null, "used_for_provisioning": true, "alternative_code": "test", "udr_type": null, "composition_method": "FLAT", "name": "SMARTCARD", "description": "SMARTCARD", "id": "D6BE0209EC0149989A89972CE889DF8B", "classification": "PHYSICALGOODS", "physical_good_type": "TRACEABLE" }, "alternative_code": "Smartcard 1", "description": "1234", "id": "923C101369EE4F45A1A73446BB74F198", "priority_level": null }, "components_set": [], "accounts_receivable": { "number": "ACR0000000025", "name": "ACR0000000025 Ramy M", "id": "4C13FA60560B42F7939113BD699A9E71", "life_cycle_state": "ACTIVE", "account_owner": { "company_profile": null, "company_name": null, "name": null, "last_name": "M", "id": "51DDE9E46B9F4F5EB0E01F909F18FE39", "life_cycle_state": "FINANCIAL", "middle_name": null, "title": null, "type": "PERSON", "first_name": "Ramy", "demographics": { "id_number": "126598", "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, "industry": null, "name_day": { "month": null, "day": null }, "passport_number_expiration_date": null, "id_number_expiration_date": null, "passport_number": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } } }, "id": "93506C0DF81C4AF3902BBB07793A85EA" }, { "number": null, "product": { "code": "Caffe Latte", "product_type": { "meter_reading_type": null, "service_type": null, "used_for_provisioning": false, "alternative_code": "Z", "udr_type": null, "composition_method": "FLEXIBLEBUNDLE", "name": "Zorbas", "description": null, "id": "A8F22AD71E9C4A818A5CA853E628CA4A", "classification": "PHYSICALGOODS", "physical_good_type": "NONTRACEABLE" }, "alternative_code": "CL", "description": "Caffe Latte", "id": "847DAF8938094DC7B9542991D0A2916A", "priority_level": null }, "components_set": [ { "product": { "code": "Extra Shot", "product_type": { "meter_reading_type": null, "service_type": null, "used_for_provisioning": false, "alternative_code": "ZC", "udr_type": null, "composition_method": "FLAT", "name": "Zorbas Component", "description": null, "id": "8EED05CC65A54147B1B6CFD0F80063C4", "classification": "PHYSICALGOODS", "physical_good_type": "NONTRACEABLE" }, "alternative_code": "ES_1", "description": "Extra Shot", "id": "DA6C0E1F5BA34E2EA15B191CAA4FBCDB", "priority_level": null }, "id": "639AB6570244472FAA5F9E03A6BEF214" } ], "accounts_receivable": { "number": "ACR0000000025", "name": "ACR0000000025 Ramy M", "id": "4C13FA60560B42F7939113BD699A9E71", "life_cycle_state": "ACTIVE", "account_owner": { "company_profile": null, "company_name": null, "name": null, "last_name": "M", "id": "51DDE9E46B9F4F5EB0E01F909F18FE39", "life_cycle_state": "FINANCIAL", "middle_name": null, "title": null, "type": "PERSON", "first_name": "Ramy", "demographics": { "id_number": "126598", "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, "industry": null, "name_day": { "month": null, "day": null }, "passport_number_expiration_date": null, "id_number_expiration_date": null, "passport_number": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } } }, "id": "FE6F026B69284100B6E1176521B7B7F3" } ], "status": { "code": "OK", "description": "", "message": "" } }
HTTP Method: GET
Request
Response
{ "data": [ { "number": "10", "product": { "code": "TestProduct", "product_type": { "meter_reading_type": null, "service_type": null, "used_for_provisioning": false, "alternative_code": "CRM_ProdType", "udr_type": null, "composition_method": "FLAT", "name": "CRM_ProdType", "description": null, "id": "2A102A5FEECB43B2A8778CC4FCECE73C", "classification": "PHYSICALGOODS", "physical_good_type": "TRACEABLE" }, "alternative_code": "TestProduct", "description": "TestProduct", "id": "757EDF7B9F914096A5AEDF01EA55C679", "priority_level": null }, "notes": "Test_2", "components_set": [], "accounts_receivable": { "number": "ACR0000002969", "name": "ACR0000002969 Test 16052019_01", "id": "207F6A3347244BAC9036CC8B3A1C87B5", "life_cycle_state": "ACTIVE", "account_owner": { "company_profile": null, "company_name": null, "name": null, "last_name": "16052019_01", "id": "DAE94BD8C0EB4C63A3A19318F74A5DD9", "life_cycle_state": "FINANCIAL", "middle_name": null, "title": null, "type": "PERSON", "first_name": "Test", "demographics": { "id_number": "16052019_01", "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, "industry": null, "name_day": { "month": null, "day": null }, "passport_number_expiration_date": null, "id_number_expiration_date": null, "passport_number": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } } }, "id": "B05C26011C3B4D8AA27885B8CD52FFD2" }, { "number": "11", "product": { "code": "10584_01", "product_type": { "meter_reading_type": null, "service_type": null, "used_for_provisioning": false, "alternative_code": "CRM_ProdType", "udr_type": null, "composition_method": "FLAT", "name": "CRM_ProdType", "description": null, "id": "2A102A5FEECB43B2A8778CC4FCECE73C", "classification": "PHYSICALGOODS", "physical_good_type": "TRACEABLE" }, "alternative_code": "1_1", "description": "Product Description 10584_A01", "id": "78E58334893C4ABE8CFAF170856D20C3", "priority_level": null }, "notes": "10584_01 for me", "components_set": [], "accounts_receivable": { "number": "ACR0000002969", "name": "ACR0000002969 Test 16052019_01", "id": "207F6A3347244BAC9036CC8B3A1C87B5", "life_cycle_state": "ACTIVE", "account_owner": { "company_profile": null, "company_name": null, "name": null, "last_name": "16052019_01", "id": "DAE94BD8C0EB4C63A3A19318F74A5DD9", "life_cycle_state": "FINANCIAL", "middle_name": null, "title": null, "type": "PERSON", "first_name": "Test", "demographics": { "id_number": "16052019_01", "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, "industry": null, "name_day": { "month": null, "day": null }, "passport_number_expiration_date": null, "id_number_expiration_date": null, "passport_number": null, "social_security_number": null, "id_issued_by_country": null, "passport_issued_by_country": null } } }, "id": "542A111695FC4FBBAD0D9ED2A73B1ED7" } ], "status": { "code": "OK", "description": "", "message": "" } }