Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Available from CRM.COM R10.0.0

Table of Contents
maxLevel2

...

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:

Include Page
V4:currency_identifier
V4:currency_identifier

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

...

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

...

Parameters

Name

Type

Description

token

(mandatory)

String

The token retrieved from the login method

value

(mandatory)

NumberThe value that will be converted into CRM.COM default currency value

currency_identifier

(mandatory)

Currency IdentifierThe identifier of the provided value's related currency. The allowed currency identifier fields are the following:

Include Page
V4:currency_identifier
V4:currency_identifier

...

Expand
titleExample 1

HTTP Method: GET

Request:

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
   

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)

...

currency_identifier

(mandatory)

...

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. 

Response Data

...

Name

...

Type

...

Description

value

...

Examples

Expand
titleExample 1

HTTP Method: GET

Request:

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
     {
  "data": {
    "converted_value": 0.46000000834465027,
    "currency_period_rate": {
      "from_date": "C7D7ED57F21B47028144967E015DCBE5",
      "to_date": 2.3,
      "rate": 2.3,
      "inverse_rate": 0.23000000417232513,
      "currency": {
        "decimal_part_name": null,
        "code": "GBP",
        "integer_part_name": null,
        "prefix": "£",
        "id": "9",
        "suffix": null
      },
      "id": "C7D7ED57F21B47028144967E015DCBE5"
    },
    "default_currency": {
      "decimal_part_name": null,
      "code": "EUR",
      "integer_part_name": null,
      "prefix": "€",
      "id": "2",
      "suffix": null
    },
    "value": "2"
  },
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}

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)

NumberThe value in CRM.COM's default currency that will be converted into another currency's value

currency_identifier

(mandatory)

Currency IdentifierThe identifier of the currency to which value will be converted to. The allowed currency identifier fields are the following:

Include Page
V4:currency_identifier
V4:currency_identifier

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. 

Response Data

Name

Type

Description

value


NumberThe value in the default currency
converted_valueNumberThe converted value into the required currency
default_currencyCurrency ObjectCRM.COM's default currency as this is defined in General Settings
currency_period_rateCurrency Period Rate ObjectThe Currency Rate Period of the Currency to which the value in the default currency was converted

Anchor
converted currency values referred objects
converted currency values referred objects
Referred Objects Response Data

Include Page
V4:currency_short
V4:currency_short

Include Page
V4:currency_rate_period_short
V4:currency_rate_period_short

Examples

Expand
titleExample 1

HTTP Method: GET

Request:

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
   {
  "data": {
    "converted_value": 0.46000000834465027,
    "currency_period_rate": {
      "from_date": "C7D7ED57F21B47028144967E015DCBE5",
      "to_date": 2.3,
      "rate": 2.3,
      "inverse_rate": 0.23000000417232513,
      "currency": {
        "decimal_part_name": null,
        "code": "GBP",
        "integer_part_name": null,
        "prefix": "£",
        "id": "9",
        "suffix": null
      },
      "id": "C7D7ED57F21B47028144967E015DCBE5"
    },
    "default_currency": {
      "decimal_part_name": null,
      "code": "EUR",
      "integer_part_name": null,
      "prefix": "€",
      "id": "2",
      "suffix": null
    },
    "value": "2"
  },
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}