Zoho crm Logo

组织中的多币种

Zoho CRM 中的多币种支持可帮助您轻松在全球市场处理业务和交易。借助多币种功能,您可以:

  • 以您的本国货币以及客户的本地货币估算交易金额
  • 以您的本币生成并查看任何报表(包括以其他货币计价的金额)
  • Import 包含多种货币金额的报告。

使用多种货币

贵组织的Admin 管理员需为 CRM 账户添加本位币和其他货币,并在其他配置文件的用户开始使用这些货币之前完成。系统会将输入 JSON 中指定的货币存储为您的本位币。尽管您可以编辑本位币的属性,但您无法更改它。要了解如何Update 货币,请参阅 Update 货币。

目的

要为您的组织启用多币种。

端点

  • POST /org/currencies/actions/enable

请求详情

请求 URL

{api-domain}/crm/{version}/org/currencies/actions/enable

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.设置.货币.创建

样本请求

Copiedcurl "https://www.zohoapis.com/crm/v8/org/currencies/actions/enable"
-X POST
-d "input.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
CopiedformatMap = Map();
formatMap.put("decimal_separator", "Period");
formatMap.put("thousand_separator", "Comma");
formatMap.put("decimal_places", "2");

currencyMap = Map();
currencyMap.put("format", formatMap);
currencyMap.put("prefix_symbol", true);
currencyMap.put("name", "Algerian Dinar-ADN");
currencyMap.put("iso_code", "DZD");
currencyMap.put("symbol", "DA");
currencyMap.put("exchange_rate", "1.0000000");

params = Map();
params.put("base_currency", currencyMap);


response = invokeurl
[
	url :"https://www.zohoapis.com/crm/v8/org/currencies/actions/enable"
	type :POST
	parameters: params.toString()
	connection:"crm_oauth_connection"
];
info response;

在请求中,"@input.json"包含示例输入数据。

请求 JSON 键

  • namestring,必填

    表示货币的名称。您可以在 CRM 界面的 设置 > 通用 > 公司设置 > 货币 中获取可用货币。

  • iso_codestring,必填

    表示货币的 ISO 代码。您可以在 CRM 界面的 设置 > 通用 > 公司设置 > 货币 中获取该货币代码。

  • exchange_ratestring,必填

    表示将该货币兑换为本币的汇率。接受正的小数,整数部分最多9位,小数部分最多9位。示例:123456789.123456789。

  • prefix_symbolBoolean,可选

    表示 ISO 代码在金额中的位置。

    可能的取值:

    • true - 在金额前显示 ISO 代码。这是默认值。
    • false - 在金额后显示 ISO 代码。
  • 符号字符串,可选

    表示货币的符号。

  • is_activeBoolean,可选

    表示货币的状态。
    可能的取值:

    • true - 该货币为启用状态。这是默认值。
    • false - 该货币为停用状态。
  • formatJSON object,可选

    表示基础货币的格式,包含诸如 decimal_separator、thousand_separator 和 decimal_places 等详细信息。

"format" JSON 对象中的键

  • decimal_separatorstring,可选

    小数分隔符用于将货币的整数部分与其小数部分分开。它可以是句点或逗号,具体取决于所用货币。

  • thousand_separator字符串,可选

    千位分隔符用于将货币金额中的千位分组隔开。它可以是句点、逗号或空格,具体取决于货币。

  • decimal_places 整数,可选

    表示该货币允许的小数位数。可以是 0、2 或 3。

样本输入

Copied{
  "base_currency": {
    "format": {
      "decimal_separator": "Period",
      "thousand_separator": "Comma",
      "decimal_places": "2"
    },
    "prefix_symbol": true,
    "name": "Algerian Dinar - DZD",
    "iso_code": "DZD",
    "symbol": "DA",
    "exchange_rate": "1.0000000"
  }
}

可能的错误

  • ALREADY_ENABLEDHTTP 400

    多币种功能已启用
    解决方案: 您的组织已启用多币种功能。无法再次启用。

  • INVALID_DATAHTTP 400

    您指定了无效的货币名称或 ISO 代码。
    解决方案: 前往 设置 > 常规 > 公司详细信息> 货币 > 点击 添加。货币下拉列表将包含有效的货币名称和 ISO 代码。

  • INVALID_DATAHTTP 400

    您指定了无效的货币符号。
    解决方案:输入有效的货币符号。

  • MANDATORY_NOT_FOUNDHTTP 400

    您在输入中未指定一个或多个必填字段。
    解决方案:请参阅请求 JSON以了解输入中所有必填键。

  • INVALID_REQUEST_METHOD HTTP 400

    请求方法不正确。
    解决方法:使用 HTTP POST 方法来进行此 API 调用。使用任何其他请求方法都会导致此错误。

  • AUTHORIZATION_FAILED HTTP 400

    您没有足够的权限添加货币。
    解决方法:请联系系统管理员。

  • OAUTH_SCOPE_MISMATCH HTTP 401

    您用于发起此 API 调用的访问令牌不具有所需的作用域。
    解决方案: 生成一个包含作用域 ZohoCRM.settings.currencies.CREATE 的新访问令牌。

  • NO_PERMISSION HTTP 403

    您没有权限启用多币种。
    解决方法:请联系您的系统管理员。

  • FEATURE_NOT_SUPPORTEDHTTP 403

    多币种功能仅适用于企业版及更高版本。
    解决方法:升级您的版本或联系系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求 URL 不正确。
    解决方法:请指定有效的请求 URL。请参阅 请求 URL 部分以获取正确的 URL。

  • INTERNAL_ERROR HTTP 500

    服务器出现意外且未处理的异常。 
    解决方案:请通过 support@zohocrm.com 联系支持团队。

示例回应

Copied{
  "base_currency": {
    "code": "SUCCESS",
    "details" {
      "id": "111113000000038990"
    },
    "message": "The multi-currency feature is enabled and given currency is created as the base currency.",
    "status": "success"
  }
}