添加货币
目的
向您的组织添加新的货币。
端点
- 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的支持团队。