Zoho crm Logo

添加货币

目的

向您的组织添加新的货币。

端点

  • POST /org/currencies

Request 详情

Request URL

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

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.currencies.{operation_type}

可能的操作类型

创建 - 创建货币

样本请求

在请求中,“@input.json”包含了样本输入数据。

Request JSON 键

  • 名称字符串,必填

    代表货币的名称。您可以从CRM用户界面获取可用的货币,路径为 设置 > 通用 > 公司设置 > 货币。

  • iso_code字符串,必填

    代表货币的ISO代码。您可以在CRM UI中获取货币代码,路径为:设置 > 通用 > 公司设置 > 货币。

  • exchange_rate字符串,必填

    代表货币与本币的兑换率。接受最多九位数和九位小数的正十进制数。示例:123456789.123456789。

  • prefix_symbol布尔值,可选

    代表货币中ISO代码的位置。

    可能的值:

    • true - 在货币值之前显示ISO代码。这是默认值。
    • false - 在货币值之后显示ISO代码。
  • symbol字符串,可选

    代表货币的符号。

  • is_active布尔值,可选

    代表货币的状态。
    可能的值:

    • true - 货币处于活动状态。这是默认值。
    • false - 货币处于非活动状态。
  • 格式JSON 对象,可选

    表示基础货币的格式,包括如小数分隔符,千位分隔符和小数位数等详细信息。

"format" JSON 对象中的键

  • decimal_separator字符串,可选

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

  • thousand_separator字符串,可选

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

  • decimal_places整数,可选

    表示货币允许的小数位数。它可以是0,2,和3。

样本输入

可能的错误

  • ACTIVE_STATE_LIMIT_EXCEEDEDHTTP 400

    您已达到允许的活动货币限制,即10个。 
    解决方案:停用任何一个现有的活动货币以创建此货币。

  • INVALID_DATAHTTP 400

    您指定的货币名称或ISO代码无效。
    解决方案:转到设置 > 通用 > 公司详情> 货币 > 点击添加。货币下拉列表将有有效的货币名称和ISO代码。

  • INVALID_DATAHTTP 400

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

  • DUPLICATE_DATAHTTP 400

    您为ISO代码提供了重复的值。
    解决方案:输入JSON中指定的货币已经存在。即使货币的状态是无效的,它仍然会出现在列表中。

  • MANDATORY_NOT_FOUNDHTTP 400

    您没有在输入中指定一个或多个必填字段。
    解决方案:参考Request JSON中所有的必填键。

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成一个新的访问令牌,其范围在范围部分中有所提及。

  • NO_PERMISSIONHTTP 403

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

  • FEATURE_NOT_SUPPORTEDHTTP 403

    多货币功能仅在企业版和更高版本中可用。
    解决方案:升级您的版本或联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    Request URL不正确。
    解决方案:指定一个有效的Request URL。请参考Request URL部分以获取正确的URL。

  • INTERNAL_ERRORHTTP 500

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

样本回应