You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
Version 1
Next »
GET currencies/show
This method returns information related with a currency. A single currency is returned by each call
Resource URL
Parameters
Name | Type | Description |
token (mandatory) | String | The token retrieved from the login method |
currency_identifier (mandatory) | Currency Identifier | The identifier of the currency that should be returned as a result. The allowed currency identifier fields are the following: Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the currency | code (semi-optional) | String | The code of the currency |
|
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.
Response Data
Name | Type | Description |
|---|
| id | String | The ID of the retrieved currency |
code | String | The code of the currency |
| prefix | String | The prefix symbol for the specified currency |
| suffix | String | The suffix symbol for the specified currency |
| life_cycle_state | String | The life cycle state of the retrieved currency which can be EFFECTIVE or NOT_EFFECTIVE |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
log_information | Log Information Object | The log information related with the retrieved currency |
Referred Objects Response Data
log_information object response data
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 |
created_by_unit | Unit Object | The unit that created the retrieved record |
created_by_business_unit | Unit Object | The unit that created the retrieved record |
created_by_user | User Object | The user that created the retrieved record |
updated_by_unit | Unit Object | The last unit that updated the retrieved record |
updated_by_business_unit | Unit Object | The last unit that updated the retrieved record |
updated_by_user | User Object | The last user that updated the retrieved record |
Referred Objects Response Data
unit object 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 |
business unit object response data
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 |
user object 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 |
email | String | The email of the retrieved user |
Examples
Example 1
HTTP Method: GET
Request:
Response:
GET currencies/list
This method returns information regarding all Currencies which are configured in CRM.COM to be set as an accounts receivable's currency. Multiple currencies are returned by each call.
Resource URL
Parameters
Name | Type | Description |
token (mandatory) | String | The token retrieved from the login method |
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.
Response Data
Name | Type | Description |
|---|
| id | String | The ID of the retrieved currency |
code | String | The code of the currency |
| prefix | String | The prefix symbol for the specified currency |
| suffix | String | The suffix symbol for the specified currency |
| life_cycle_state | String | The life cycle state of the retrieved currency which can be EFFECTIVE or NOT_EFFECTIVE |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
log_information | Log Information Object | The log information related with the retrieved currency |
Referred Objects Response Data
log_information object response data
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 |
created_by_unit | Unit Object | The unit that created the retrieved record |
created_by_business_unit | Unit Object | The unit that created the retrieved record |
created_by_user | User Object | The user that created the retrieved record |
updated_by_unit | Unit Object | The last unit that updated the retrieved record |
updated_by_business_unit | Unit Object | The last unit that updated the retrieved record |
updated_by_user | User Object | The last user that updated the retrieved record |
Referred Objects Response Data
unit object 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 |
business unit object response data
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 |
user object 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 |
email | String | The email of the retrieved user |
Examples
Example 1
HTTP Method: GET
Request:
Response:
GET currencies/convert_to_default_currency
This method accepts a value (price rate, amount) in a currency and converts it into CRM.COM's default currency value. The method uses the effective currency period rate in order to convert the value into the default currency.
Resource URL
Parameters
Name | Type | Description |
token (mandatory) | String | The token retrieved from the login method |
value (mandatory) | Number | The value that will be converted into CRM.COM default currency value |
currency_identifier (mandatory) | Currency Identifier | The identifier of the provided value's related currency. The allowed currency identifier fields are the following:Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the currency | code (semi-optional) | String | The code of the currency |
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
Name | Type | Description |
value
| Number | The value that was converted into CRM.COM default currency value |
| converted_valu | Number | The value converted into default currency value |
| default_currency | Currency Object | CRM.COM's default currency as this is defined in General Settings |
| currency_period_rate | Currency Period Rate Object | The Currency Rate Period which was used in order to convert the provided value into default currency value. |
Referred Objects Response Data
currency object 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 |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
currency rate period object response data
Name | Type | Description |
|---|
id | String | The ID of the retrieved currency rate period |
| rate | Number | The exchange rate of the currency rate period |
| inverse_rate | Number | The inverse exchange rate of the currency rate period |
| from_date | Date | The date from which the exchange rate is valid |
| to_date | Date | The date until which the exchange rate is valid |
| currency | Currency Object | The Currency with which the returned exchange rate information refers to |
Referred Objects Response Data
currency object 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 |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
Examples
Example 1
HTTP Method: GET
Request:
Response:
GET currencies/convert_from_default_currency
This method accepts a value (price rate, amount) in CRM.COM's default currency and converts it into another currency value. The method uses the effective currency period rate in order to convert the value from the default currency to the required currency.
Resource URL
Parameters
Name | Type | Description |
token (mandatory) | String | The token retrieved from the login method |
value (mandatory) | Number | The value in CRM.COM's default currency that will be converted into another currency's value |
currency_identifier (mandatory) | Currency Identifier | The identifier of the currency to which value will be converted to. The allowed currency identifier fields are the following:Name | Type | Description |
|---|
id (semi-optional) | String | The ID of the currency | code (semi-optional) | String | The code of the currency |
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters.
Response Data
Name | Type | Description |
value
| Number | The value in the default currency |
| converted_value | Number | The converted value into the required currency |
| default_currency | Currency Object | CRM.COM's default currency as this is defined in General Settings |
| currency_period_rate | Currency Period Rate Object | The Currency Rate Period of the Currency to which the value in the default currency was converted |
Referred Objects Response Data
currency object 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 |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
currency rate period object response data
Name | Type | Description |
|---|
id | String | The ID of the retrieved currency rate period |
| rate | Number | The exchange rate of the currency rate period |
| inverse_rate | Number | The inverse exchange rate of the currency rate period |
| from_date | Date | The date from which the exchange rate is valid |
| to_date | Date | The date until which the exchange rate is valid |
| currency | Currency Object | The Currency with which the returned exchange rate information refers to |
Referred Objects Response Data
currency object 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 |
| integer_part_name | String | The integer part name for the specified currency |
| decimal_part_name | String | The decimal part name for the specified currency |
Examples
Example 1
HTTP Method: GET
Request:
Response: