Update Currencies

Purpose

To update the details of the currencies other than home currency.

Endpoints

Request Details

Request URL

https://www.zohoapis.com/crm/v2/org/currencies

To update a specific currency:
https://www.zohoapis.com/crm/v2/org/currencies/{currency_ID}

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.settings.currencies.{operation_type}

Possible operation types

UPDATE - Update currencies data

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v2/org/currencies"
-X PUT
-d input.json
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

3.0.08.0

Copied//Get instance of CurrenciesOperations Class
CurrenciesOperations currenciesOperations = new CurrenciesOperations();

//Get instance of BodyWrapper Class that will contain the request body
BodyWrapper bodyWrapper = new BodyWrapper();

//List of Currency instances
List<com.zoho.crm.api.currencies.Currency> currencies = new ArrayList<com.zoho.crm.api.currencies.Currency>();

//Get instance of Currency Class
com.zoho.crm.api.currencies.Currency currency = new com.zoho.crm.api.currencies.Currency();

//To set the position of the ISO code in the currency.
//true: Display ISO code before the currency value.
//false: Display ISO code after the currency value.
currency.setPrefixSymbol(true);

//To set currency Id
currency.setId(3477061000006040001L);

//To set the rate at which the currency has to be exchanged for home currency.
currency.setExchangeRate("5.0000000");

//To set the status of the currency.
//true: The currency is active.
//false: The currency is inactive.
currency.setIsActive(true);

Format format = new Format();

//It can be a Period or Comma, depending on the currency.
format.setDecimalSeparator(new Choice<String>("Period"));
      
//It can be a Period, Comma, or Space, depending on the currency.
format.setThousandSeparator(new Choice<String>("Comma"));
      
//To set the number of decimal places allowed for the currency. It can be 0, 2, or 3.
format.setDecimalPlaces(new Choice<String>("2"));


//Add Format instance to the list
currency.setFormat(format);

//Add currency instances to the list
currencies.add(currency);

//Set the list to Currency in BodyWrapper instance
bodyWrapper.setCurrencies(currencies);

//Call updateCurrencies method that takes BodyWrapper instance as parameter 
APIResponse<ActionHandler> response = currenciesOperations.updateCurrencies(bodyWrapper);

Copiedimport javax.net.ssl.SSLContext;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpEntityEnclosingRequestBase;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.client.methods.HttpUriRequest;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.protocol.HTTP;
import org.apache.http.util.EntityUtils;
import org.json.JSONArray;
import org.json.JSONObject;
public class UpdateCurrencies 
{
        @SuppressWarnings("deprecation")
        private static void updateCurrencies()
        {
                try
                {
                        HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();
                        SSLContext sslContext = SSLContext.getDefault();
                        SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
                        CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();
                        URIBuilder uriBuilder = new URIBuilder("https://www.zohoapis.com/crm/v2/org/currencies");
                        HttpUriRequest requestObj = new HttpPut(uriBuilder.build());
                        HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
                        JSONObject requestBody = new JSONObject();
                        JSONArray recordArray = new JSONArray();
                        JSONObject recordObject = new JSONObject();
                        recordObject.put("id", "34770616008002");
                        recordObject.put("is_active", false);
                        recordArray.put(recordObject);
                        recordObject = new JSONObject();
                        recordObject.put("id", "34770616011001");
                        recordObject.put("is_active", false);
                        recordArray.put(recordObject);
                        requestBody.put("currencies", recordArray);
                        requestBase.setEntity(new StringEntity(requestBody.toString(), HTTP.UTF_8));
                        requestObj.addHeader("Authorization", "Zoho-oauthtoken 1000.xxxxxxx.xxxxxxx");
                        HttpResponse response = httpclient.execute(requestObj);
                        HttpEntity responseEntity = response.getEntity();
                        System.out.println("HTTP Status Code : " + response.getStatusLine().getStatusCode());
                        if(responseEntity != null)
                        {
                                Object responseObject = EntityUtils.toString(responseEntity);
                                String responseString = responseObject.toString();
                                System.out.println(responseString);
                        }
                }
                catch(Exception ex)
                {
                        ex.printStackTrace();
                }
        }
        @SuppressWarnings("deprecation")
        private static void updateCurrency()
        {
                try
                {
                        HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();
                        SSLContext sslContext = SSLContext.getDefault();
                        SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
                        CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();
                        URIBuilder uriBuilder = new URIBuilder("https://www.zohoapis.com/crm/v2/org/currencies/34770616008002");
                        HttpUriRequest requestObj = new HttpPut(uriBuilder.build());
                        HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
                        JSONObject requestBody = new JSONObject();
                        JSONArray recordArray = new JSONArray();
                        JSONObject recordObject = new JSONObject();
                        recordObject.put("is_active", true);
                        recordArray.put(recordObject);
                        requestBody.put("currencies", recordArray);
                        requestBase.setEntity(new StringEntity(requestBody.toString(), HTTP.UTF_8));
                        requestObj.addHeader("Authorization", "Zoho-oauthtoken 1000.xxxxxxx.xxxxxxx");
                        HttpResponse response = httpclient.execute(requestObj);
                        HttpEntity responseEntity = response.getEntity();
                        System.out.println("HTTP Status Code : " + response.getStatusLine().getStatusCode());
                        if(responseEntity != null)
                        {
                                Object responseObject = EntityUtils.toString(responseEntity);
                                String responseString = responseObject.toString();
                                System.out.println(responseString);
                        }
                }
                catch(Exception ex)
                {
                        ex.printStackTrace();
                }
        }
        public static void main(String[] args) 
        {
                updateCurrencies();
                updateCurrency();
        }
}

3.0.03.x.x

Copied"""
This method is used to update currency details.
"""

# Get instance of CurrenciesOperations Class
currencies_operations = CurrenciesOperations()

# Get instance of BodyWrapper Class that will contain the request body
request = BodyWrapper()

# List to hold Currency instances
currencies_list = []

# Get instance of Currency Class
currency = ZCRMCurrency()

# To set currency Id
currency.set_id(3409643000002293037)

# To set the position of the ISO code in the currency.
# True: Display ISO code before the currency value.
# False: Display ISO code after the currency value.
currency.set_prefix_symbol(True)

# To set the rate at which the currency has to be exchanged for home currency.
currency.set_exchange_rate("28.000000000")

# To set the status of the currency.
# True: The currency is active.
# False: The currency is inactive.
currency.set_is_active(True)

format = Format()

# It can be a Period or Comma, depending on the currency.
format.set_decimal_separator(Choice('Period'))

# It can be a Period, Comma, or Space, depending on the currency.
format.set_thousand_separator(Choice('Comma'))

# To set the number of decimal places allowed for the currency. It can be 0, 2, or 3.
format.set_decimal_places(Choice('2'))

# To set the format of the currency
currency.set_format(format)

currencies_list.append(currency)

# Set the list to Currency in BodyWrapper instance
request.set_currencies(currencies_list)

# Call update_currencies method that takes BodyWrapper instance as parameter
response = currencies_operations.update_currencies(request)

Copied def update_currencies():
    import requests
    import json

    url = 'https://www.zohoapis.com/crm/v2/org/currencies'

    headers = {
        'Authorization': 'Zoho-oauthtoken 1000.04be928e4a96XXXXXXXXXXXXX68.0b9eXXXXXXXXXXXX60396e268'
    }

    request_body = dict()
    record_list = list()
    record_object_1 = dict()
    record_object_2 = dict()

    record_object_1['id'] = '3409643000002293037'
    record_object_1['is_active'] = False

    record_list.append(record_object_1)

    record_object_2['id'] = '3409643000002296001'
    record_object_2['is_active'] = True

    record_list.append(record_object_2)

    request_body['currencies'] = record_list

    response = requests.put(url=url, headers=headers, data=json.dumps(request_body).encode('utf-8'))

    if response is not None:
        print("HTTP Status Code : " + str(response.status_code))

        print(response.json())


update_currencies()


def update_currency():
    import requests
    import json

    url = 'https://www.zohoapis.com/crm/v2/org/currencies/3409643000002293037'

    headers = {
        'Authorization': 'Zoho-oauthtoken 1000.04be928e4a96XXXXXXXXXXXXX68.0b9eXXXXXXXXXXXX60396e268'
    }

    request_body = dict()
    record_list = list()
    record_object = dict()

    record_object['is_active'] = False
    record_object['exchange_rate'] = '30.000000'

    record_list.append(record_object)

    request_body['currencies'] = record_list

    response = requests.put(url=url, headers=headers, data=json.dumps(request_body).encode('utf-8'))

    if response is not None:
        print("HTTP Status Code : " + str(response.status_code))

        print(response.json())

update_currency()

3.08.x

Copied//Get instance of CurrenciesOperations Class
CurrenciesOperations currenciesOperations = new CurrenciesOperations();
//Get instance of BodyWrapper Class that will contain the request body
BodyWrapper bodyWrapper = new BodyWrapper();
//List of Currency instances
List<Com.Zoho.Crm.API.Currencies.Currency> currencies = new List<Com.Zoho.Crm.API.Currencies.Currency>();
//Get instance of Currency Class
Com.Zoho.Crm.API.Currencies.Currency currency = new Com.Zoho.Crm.API.Currencies.Currency();
//To set the position of the ISO code in the currency.
//true: Display ISO code before the currency value.
//false: Display ISO code after the currency value.
currency.PrefixSymbol = true;
//To set currency Id
//currency.Id = 3477061000006040001;
//To set the rate at which the currency has to be exchanged for home currency.
currency.ExchangeRate = "5.0000000";
//To set the status of the currency.
//true: The currency is active.
//false: The currency is inactive.
currency.IsActive = true;
Format format = new Format();
//It can be a Period or Comma, depending on the currency.
format.DecimalSeparator = new Choice("Period");
//It can be a Period, Comma, or Space, depending on the currency.
format.ThousandSeparator = new Choice("Comma");
//To set the number of decimal places allowed for the currency. It can be 0, 2, or 3.
format.DecimalPlaces = new Choice("2");
//To set the format of the currency
currency.Format = format;
//Add Currency instance to the list
currencies.Add(currency);
//Set the list to Currency in BodyWrapper instance
bodyWrapper.Currencies = currencies;
//Call UpdateCurrencies method that takes BodyWrapper instance as parameter 
APIResponse<ActionHandler> response = currenciesOperations.UpdateCurrencies(bodyWrapper);

Copiedusing System;
using System.IO;
using System.Net;
using System.Text;
using Newtonsoft.Json.Linq;
namespace Com.Zoho.Crm.API.Sample.RestAPI.Currencies
{
    public class UpdateCurrencies
    {
        public static void UpdateCurrenciesOtherThanHomeCurrency()
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://www.zohoapis.com/crm/v2/org/currencies");

            request.Method = "PUT";

            request.Headers["Authorization"] = "Zoho-oauthtoken 1000.a7cfc3088442ff6f7bc25ad2ece9fa08.f2fb99b181038dec0575a70c057d824a";

            JObject requestBody = new JObject();

            JArray recordArray = new JArray();

            JObject recordObject = new JObject();

            recordObject.Add("id", "3477061000006008002");

            recordObject.Add("is_active", false);

            recordArray.Add(recordObject);

            recordObject = new JObject();

            recordObject.Add("id", "3477061000006011001");

            recordObject.Add("is_active", false);

            recordArray.Add(recordObject);

            requestBody.Add("currencies", recordArray);

            string dataString = requestBody.ToString();

            var data = Encoding.UTF8.GetBytes(dataString);

            int dataLength = data.Length;

            request.ContentLength = dataLength;

            using (var writer = request.GetRequestStream())
            {
                writer.Write(data, 0, dataLength);
            }

            request.KeepAlive = true;

            HttpWebResponse response;

            try
            {
                response = (HttpWebResponse)request.GetResponse();
            }
            catch (WebException e)
            {
                if (e.Response == null) { throw; }

                response = (HttpWebResponse)e.Response;
            }

            HttpWebResponse responseEntity = response;

            Console.WriteLine("HTTP Status Code : " + (int)response.StatusCode);

            string responsestring = new StreamReader(responseEntity.GetResponseStream()).ReadToEnd();

            responseEntity.Close();

            Console.WriteLine(responsestring);
        }

        public static void UpdateCurrency()
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://www.zohoapis.com/crm/v2/org/currencies/3477061000006008002");

            request.Method = "PUT";

            request.Headers["Authorization"] = "Zoho-oauthtoken 1000.a7cfc3088442ff6f7bc25ad2ece9fa08.f2fb99b181038dec0575a70c057d824a";

            JObject requestBody = new JObject();

            JArray recordArray = new JArray();

            JObject recordObject = new JObject();

            recordObject.Add("is_active", true);

            recordArray.Add(recordObject);

            requestBody.Add("currencies", recordArray);

            string dataString = requestBody.ToString();

            var data = Encoding.UTF8.GetBytes(dataString);

            int dataLength = data.Length;

            request.ContentLength = dataLength;

            using (var writer = request.GetRequestStream())
            {
                writer.Write(data, 0, dataLength);
            }

            request.KeepAlive = true;

            HttpWebResponse response;

            try
            {
                response = (HttpWebResponse)request.GetResponse();
            }
            catch (WebException e)
            {
                if (e.Response == null) { throw; }

                response = (HttpWebResponse)e.Response;
            }

            HttpWebResponse responseEntity = response;

            Console.WriteLine("HTTP Status Code : " + (int)response.StatusCode);

            string responsestring = new StreamReader(responseEntity.GetResponseStream()).ReadToEnd();

            responseEntity.Close();

            Console.WriteLine(responsestring);
        }
    }
}

1.0.010.x

Copied//Get instance of CurrenciesOperations Class
let currenciesOperations = new CurrenciesOperations();

//Get instance of BodyWrapper Class that will contain the request body
let request = new BodyWrapper();

//Array to hold Currency instances
let currencies = [];

//Get instance of Currency Class
let currency = new ZCRMCurrency();

//To set currency Id
currency.setId(3409643000002293037n);

//To set the position of the ISO code in the currency.
//true: Display ISO code before the currency value.
//false: Display ISO code after the currency value.
currency.setPrefixSymbol(true);

//To set the rate at which the currency has to be exchanged for home currency.
currency.setExchangeRate("10.000000000");

//To set the status of the currency.
//true: The currency is active.
//false: The currency is inactive.
currency.setIsActive(true);

let format = new Format();

//It can be a Period or Comma, depending on the currency.
format.setDecimalSeparator(new Choice("Period"));

//It can be a Period, Comma, or Space, depending on the currency.
format.setThousandSeparator(new Choice("Space"));

//To set the number of decimal places allowed for the currency. It can be 0, 2, or 3.
format.setDecimalPlaces(new Choice("2"));

//To set the format of the currency
currency.setFormat(format);

//Add Currency instance to the array
currencies.push(currency);

//Set the array to Currency in BodyWrapper instance
request.setCurrencies(currencies);

//Call updateCurrencies method that takes BodyWrapper instance as parameter
let response = await currenciesOperations.updateCurrencies(request);

Copiedasync function updateCurrencies() {
    const got = require("got");

    let url = 'https://www.zohoapis.com/crm/v2/org/currencies'
    let headers = {
        Authorization : "Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    }

    let requestBody = {}
    let recordArray = []
    let recordObject1 = {}
    let recordObject2 = {}

    recordObject1['id'] = '3409643000002293037'
    recordObject1['is_active'] = false
    recordArray.push(recordObject1)

    recordObject1['id'] = '3409643000002296001'
    recordObject1['is_active'] = true
    recordArray.push(recordObject2)

    requestBody['currencies'] = recordArray

    let requestDetails = {
        method : "PUT",
        headers : headers,
        body : JSON.stringify(requestBody),
        encoding: "utf8",
        throwHttpErrors : false
    };
    
    let response = await got(url, requestDetails)
    
    if(response != null) {
        console.log(response.statusCode);
        console.log(response.body);
    } 
}
updateCurrencies()

async function updateCurrency() {
    const got = require("got");

    let url = 'https://www.zohoapis.com/crm/v2/org/currencies/3409643000002293037'
    let headers = {
        Authorization : "Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    }

    let requestBody = {}
    let recordArray = []
    let recordObject = {}

    recordObject['is_active'] = false
    recordObject['exchange_rate'] = '30.000000'

    recordArray.push(recordObject)

    requestBody['currencies'] = recordArray

    let requestDetails = {
        method : "PUT",
        headers : headers,
        body : JSON.stringify(requestBody),
        encoding: "utf8",
        throwHttpErrors : false
    };
    
    let response = await got(url, requestDetails)
    
    if(response != null) {
        console.log(response.statusCode);
        console.log(response.body);
    } 
}

updateCurrency()

1.0.0ES6

Copied//Get instance of CurrenciesOperations Class
let currenciesOperations = new ZCRM.Currency.Operations();
//Get instance of BodyWrapper Class that will contain the request body
let request = new ZCRM.Currency.Model.BodyWrapper();
//Array to hold Currency instances
let currencies = [];
//Get instance of Currency Class
let currency = new ZCRM.Currency.Model.Currency();
//To set currency Id
currency.setId(3477066008002n);
//To set the position of the ISO code in the currency.
//true: Display ISO code before the currency value.
//false: Display ISO code after the currency value.
currency.setPrefixSymbol(true);
//To set the rate at which the currency has to be exchanged for home currency.
currency.setExchangeRate("10.000000000");
//To set the status of the currency.
//true: The currency is active.
//false: The currency is inactive.
currency.setIsActive(true);
let format = new ZCRM.Currency.Model.Format();
//It can be a Period or Comma, depending on the currency.
format.setDecimalSeparator(new Choice("Period"));
//It can be a Period, Comma, or Space, depending on the currency.
format.setThousandSeparator(new Choice("Space"));
//To set the number of decimal places allowed for the currency. It can be 0, 2, or 3.
format.setDecimalPlaces(new Choice("2"));
//To set the format of the currency
currency.setFormat(format);
//Add Currency instance to the array
currencies.push(currency);
//Set the array to Currency in BodyWrapper instance
request.setCurrencies(currencies);
//Call updateCurrencies method that takes BodyWrapper instance as parameter
let response = await currenciesOperations.updateCurrencies(request);

Copiedvar listener = 0;
class UpdateCurrencies{

	async updateCurrencies()	{
		var url = "https://www.zohoapis.com/crm/v2/org/currencies"
        var parameters = new Map()
        var headers = new Map()
        var token = {
            clientId:"1000.NPY9M1V0XXXXXXXXXXXXXXXXXXXF7H",
            redirectUrl:"http://127.0.0.1:5500/redirect.html",
            scope:"ZohoCRM.settings.currencies.UPDATE,ZohoCRM.settings.currencies.Read,ZohoCRM.settings.currencies.CREATE,ZohoCRM.users.ALL,ZohoCRM.bulk.read,ZohoCRM.modules.ALL,ZohoCRM.settings.ALL,Aaaserver.profile.Read,ZohoCRM.org.ALL,profile.userphoto.READ,ZohoFiles.files.ALL,ZohoCRM.bulk.ALL,ZohoCRM.settings.variable_groups.ALL"
        }
        var accesstoken = await new UpdateCurrencies().getToken(token)
        headers.set("Authorization", "Zoho-oauthtoken " + accesstoken)
        var requestMethod = "PUT"
        var reqBody = {
            "currencies":[ {
                "symbol": "Af",
                "format": {
                    "decimal_separator": "Period",
                    "thousand_separator": "Comma",
                    "decimal_places": "3"
                },
                "prefix_symbol": true,
                "id": "3477061000007368016",
                "exchange_rate": "1.0000000"
            }]
        }
        var params = "";
        parameters.forEach(function(value, key) {
            if (parameters.has(key)) {
                if (params) {
                    params = params + key + '=' + value + '&';
                }
                else {
                    params = key + '=' + value + '&';
                }
            }
        });
        var apiHeaders = {};
        if(headers) {
            headers.forEach(function(value, key) {
                apiHeaders[key] = value;
            });
        }
        if (params.length > 0){
            url = url + '?' + params.substring(0, params.length - 1);
        }
        var requestObj = {
            uri : url,
            method : requestMethod,
            headers : apiHeaders,
            body : JSON.stringify(reqBody),
            encoding: "utf8",
            allowGetBody : true,
			throwHttpErrors : false
        };
        var result = await new UpdateCurrencies().makeAPICall(requestObj);
        console.log(result.status)
        console.log(result.response)
	}
	async updateCurrency()	{
		var url = "https://www.zohoapis.com/crm/v2/org/currencies/34770617368016"
        var parameters = new Map()
        var headers = new Map()
        var token = {
            clientId:"1000.NPY9M1V0XXXXXXXXXXXXXXXXXXXF7H",
            redirectUrl:"http://127.0.0.1:5500/redirect.html",
            scope:"ZohoCRM.users.ALL,ZohoCRM.bulk.read,ZohoCRM.modules.ALL,ZohoCRM.settings.ALL,Aaaserver.profile.Read,ZohoCRM.org.ALL,profile.userphoto.READ,ZohoFiles.files.ALL,ZohoCRM.bulk.ALL,ZohoCRM.settings.variable_groups.ALL"
        }
        var accesstoken = await new UpdateCurrencies().getToken(token)
        headers.set("Authorization", "Zoho-oauthtoken " + accesstoken)
        var requestMethod = "PUT"
        var reqBody = {"currencies":[
            {
                "symbol":"\u20b9",
                "is_active":true,
                "exchange_rate":"1.000000000",
                "format":{"decimal_separator":"Period","thousand_separator":"Comma","decimal_places":"2"},
                "prefix_symbol":true,
                "is_base":true,
                "name":"Indian Rupee - INR","iso_code":"INR"}]}
        var params = "";
        parameters.forEach(function(value, key) {
            if (parameters.has(key)) {
                if (params) {
                    params = params + key + '=' + value + '&';
                }
                else {
                    params = key + '=' + value + '&';
                }
            }
        });
        var apiHeaders = {};
        if(headers) {
            headers.forEach(function(value, key) {
                apiHeaders[key] = value;
            });
        }
        if (params.length > 0){
            url = url + '?' + params.substring(0, params.length - 1);
        }
        var requestObj = {
            uri : url,
            method : requestMethod,
            headers : apiHeaders,
            body : JSON.stringify(reqBody),
            encoding: "utf8",
            allowGetBody : true,
			throwHttpErrors : false
        };
        var result = await new UpdateCurrencies().makeAPICall(requestObj);
        console.log(result.status)
        console.log(result.response)
	}
	async updateHomeCurrency()	{
		var url = "https://www.zohoapis.com/crm/v2/org/currencies/actions/enable"
        var parameters = new Map()
        var headers = new Map()
        var token = {
            clientId:"1000.NPY9M1V0XXXXXXXXXXXXXXXXXXXF7H",
            redirectUrl:"http://127.0.0.1:5500/redirect.html",
            scope:"ZohoCRM.users.ALL,ZohoCRM.bulk.read,ZohoCRM.modules.ALL,ZohoCRM.settings.ALL,Aaaserver.profile.Read,ZohoCRM.org.ALL,profile.userphoto.READ,ZohoFiles.files.ALL,ZohoCRM.bulk.ALL,ZohoCRM.settings.variable_groups.ALL"
        }
        var accesstoken = await new UpdateCurrencies().getToken(token)
        headers.set("Authorization", "Zoho-oauthtoken " + accesstoken)
        var requestMethod = "PUT"
        var reqBody = {
            "base_currency": {
                "symbol": "Af",
                "format": {
                    "decimal_separator": "Period",
                    "thousand_separator": "Comma",
                    "decimal_places": "3"
                },
                "prefix_symbol": true,
                "id": "11111338990",
                "exchange_rate": "1.0000000"
            }
        }
        var params = "";
        parameters.forEach(function(value, key) {
            if (parameters.has(key)) {
                if (params) {
                    params = params + key + '=' + value + '&';
                }
                else {
                    params = key + '=' + value + '&';
                }
            }
        });
        var apiHeaders = {};
        if(headers) {
            headers.forEach(function(value, key) {
                apiHeaders[key] = value;
            });
        }
        if (params.length > 0){
            url = url + '?' + params.substring(0, params.length - 1);
        }
        var requestObj = {
            uri : url,
            method : requestMethod,
            headers : apiHeaders,
            body : JSON.stringify(reqBody),
            encoding: "utf8",
            allowGetBody : true,
			throwHttpErrors : false
        };
        var result = await new UpdateCurrencies().makeAPICall(requestObj);
        console.log(result.status)
        console.log(result.response)
	}

    async getToken(token) {

        if(listener == 0) {

            window.addEventListener("storage", function(reponse) {
                if(reponse.key === "access_token" && (reponse.oldValue != reponse.newValue || reponse.oldValue == null)){
                    location.reload();
                }
                if(reponse.key === "access_token"){

                    sessionStorage.removeItem("__auth_process");
                }
            }, false);
            listener = 1;
            if(sessionStorage.getItem("__auth_process")) {
                sessionStorage.removeItem("__auth_process");
            }
        }
        ["granted_for_session", "access_token","expires_in","expires_in_sec","location","api_domain","state","__token_init","__auth_process"].forEach(function (k) {
            var isKeyExists = localStorage.hasOwnProperty(k);
            if(isKeyExists) {
                sessionStorage.setItem(k, localStorage[k]);
            }
            localStorage.removeItem(k);
        });
        var valueInStore = sessionStorage.getItem("access_token");
        var tokenInit = sessionStorage.getItem("__token_init");
        if(tokenInit != null && valueInStore != null && Date.now() >= parseInt(tokenInit) + 59 * 60 * 1000){ // check after 59th minute
            valueInStore = null;
            sessionStorage.removeItem("access_token");
        }

        var auth_process = sessionStorage.getItem("__auth_process");
        if ((valueInStore == null && auth_process == null) || (valueInStore == 'undefined' && (auth_process == null || auth_process == "true"))) {
            var accountsUrl = "https://accounts.zoho.com/oauth/v2/auth"
            var clientId;
            var scope;
            var redirectUrl;
            if(token != null) {
                clientId = token.clientId;
                scope = token.scope;
                redirectUrl = token.redirectUrl;
            }

            var fullGrant = sessionStorage.getItem("full_grant");
            var grantedForSession = sessionStorage.getItem("granted_for_session");
            if(sessionStorage.getItem("__token_init") != null && ((fullGrant != null && "true" == full_grant) || (grantedForSession != null && "true" == grantedForSession))) {
                accountsUrl += '/refresh';
            }
            if (clientId && scope) {
                sessionStorage.setItem("__token_init", Date.now());
                sessionStorage.removeItem("access_token");
                sessionStorage.setItem("__auth_process", "true");
                window.open(accountsUrl + "?" + "scope" + "=" + scope + "&"+ "client_id" +"=" + clientId + "&response_type=token&state=zohocrmclient&redirect_uri=" + redirectUrl);
                ["granted_for_session", "access_token","expires_in","expires_in_sec","location","api_domain","state","__token_init","__auth_process"].forEach(function (k) {
                    var isKeyExists = localStorage.hasOwnProperty(k);
                    if(isKeyExists){
                        sessionStorage.setItem(k, localStorage[k]);
                    }
                    localStorage.removeItem(k);
                });
                valueInStore = sessionStorage.getItem("access_token");
            }
        }
        if(token != null && valueInStore != 'undefined'){
            token.accessToken = valueInStore;
        }
        return token.accessToken;
    }

    async makeAPICall(requestDetails) {
        return new Promise(function (resolve, reject) {
            var body, xhr, i;
            body = requestDetails.body || null;
            xhr = new XMLHttpRequest();
            xhr.withCredentials = true;
            xhr.open(requestDetails.method, requestDetails.uri, true);
            for (i in requestDetails.headers) {
                xhr.setRequestHeader(i, requestDetails.headers[i]);
            }
            xhr.send(body);
            xhr.onreadystatechange = function() {
                if(xhr.readyState == 4) {
                    resolve(xhr);
                }
            }
        })
    }
}

Show full

Show less

In the request, "@input.json" contains the sample input data.

Note

The name and ISO code of the currencies are defined and cannot be updated.

Request JSON

idstring, mandatory
Specify the unique ID of the currency. Refer to Get Currencies API for more details.
prefix_symbolboolean, optional
Represents the position of the ISO code in the currency.
Possible values:
true: Display ISO code before the currency value.
false: Display ISO code after the currency value.
namestring, optional
Represents the name of the currency.
iso_codestring, optional
Represents the ISO code of the currency.
symbolstring, optional
Represents the symbol of the currency.
exchange_ratestring, optional
Represents the rate at which the currency has to be exchanged for home currency.
is_activeboolean, optional
Represents the status of the currency.
Possible values:
true: The currency is active.
false: The currency is inactive.
formatJSON object, optional
Represents the format of the base currency with details like decimal_separator, thousand_separator, and decimal_places.

Keys to be specified in format JSON Object

decimal_separatorstring, optional
The decimal separator separates the integer part of the currency from its fractional part. It can be a Period or Comma, depending on the currency.
thousand_separatorstring, optional
The thousand separator separates groups of thousands in a currency. It can be a Period, Comma, or Space, depending on the currency.
decimal_placesstring, mandatory
Represents the number of decimal places allowed for the currency. It can be 0, 2, or 3.

Sample Input

Copied{
    "currencies": [
        {
            "symbol": "₹",
            "format": {
                "decimal_separator": "Period",
                "thousand_separator": "Comma",
                "decimal_places": "2"
            },
            "prefix_symbol": true,
            "id": "4150868000000779003",
            "exchange_rate": "1.0000000"
        }
    ]
}

Possible Errors

INVALID_URL_PATTERNHTTP 404
Please check if the URL trying to access is a correct one
Resolution: The request URL has syntactical errors.
INVALID_DATAHTTP 400
ID is invalid
Resolution: You have specified an invalid currency ID.
INVALID_DATAHTTP 400
Currency symbol is invalid.
Resolution: You have specified an invalid currency symbol.
FEATURE_NOT_SUPPORTEDHTTP 403
The multi-currency feature is not available except the Enterprise and higher editions.
Resolution: The multi-currency feature is only available in Enterprise and Ultimate editions.
FEATURE_NOT_ENABLEDHTTP 403
The multi-currency feature is not enabled.
Resolution: You can update currencies only after enabling the multi-currency feature. Refer to Enable Multi-Currency.
NOT_ALLOWEDHTTP 400
Thousand separator and decimal separator should not be equal
Resolution: Specify different separators for thousands and decimals.
NOT_ALLOWEDHTTP 400
Base currency ID is not allowed here
Resolution: You cannot update the base currency values.
MANDATORY_NOT_FOUNDHTTP 400
Required field not found.
Resolution: Specify the unique ID of the currency in the input. Refer to Get Currencies API to get the unique ID of a currency.
OAUTH_SCOPE_MISMATCHHTTP 401
Unauthorized
Resolution: Client does not have ZohoCRM.settings.currencies.UPDATE scope. Create a new client with valid scope. Refer to scope section above.
NO_PERMISSIONHTTP 403
Permission denied to update
Resolution: The user does not have permission to update currencies. Contact your system administrator.
INTERNAL_ERRORHTTP 500
Internal Server Error
Resolution: Unexpected and unhandled exception in Server. Contact support team.
INVALID_REQUEST_METHODHTTP 400
The http request method type is not a valid one
Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to endpoints section above.
AUTHORIZATION_FAILEDHTTP 400
User does not have sufficient privilege to update currencies.
Resolution: The user does not have the permission to update currencies. Contact your system administrator.

Sample Response

Copied{
    "currencies": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "4150868000000779003"
            },
            "message": "The currency updated successfully.",
            "status": "success"
        }
    ]
}

CRM

Voice

Sign

Forms

Bigin

SalesIQ

Bookings

RouteIQ

Thrive

CRM Plus

Zakya

Campaigns

Voice

Sign

Forms

Social

Survey

SalesIQ

Sites

Backstage

PageSense

Marketing Automation

LandingPage

Webinar

LeadChain

Domains

CommunitySpaces

Thrive

Publish

Marketing Plus

Commerce

Zakya

Desk

Assist

Voice

SalesIQ

Bookings

FSM

Lens

Solo

Service Plus

Books

Expense

Sign

Inventory

Invoice

Billing

Payroll

Commerce

Checkout

Practice

Solo

Payments

Finance Plus

Mail

Voice

Sign

WorkDrive

Bookings

Cliq

Notebook

Meeting

Connect

Learn

Office Integrator

Writer

TeamInbox

ZeptoMail

Show

Tables

Sheet

Office Suite

Calendar

ToDo

PDF Editor

Workplace

Vani

Expense

Recruit

People