更新财年设置
目的
更新您组织的财年设置详情。
端点
- PUT /settings/fiscal_year
请求详情
请求 URL
{api-domain}/crm/{version}/settings/fiscal_year
标题
授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.settings.fiscal_year.UPDATE
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/fiscal_year
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X PUT
-d "@updatefiscalyear.json"在请求中,"@updatefiscalyear.json" 包含示例输入数据。
请求 JSON
- fiscal_year JSON Object, mandatory
要更新财年设置,您必须在此 JSON 对象中指定有效的 start_month 或 display_based_on 值,或两者都指定。
- start_month string, optional
表示年份的开始月份,允许的值是有效的月份名称(例如:一月,二月)
- display_based_on string, optional
此值表示财年名称是基于财务期的开始月份还是结束月份。例如,假设您的财年从2023年4月开始,到2024年3月结束。如果您选择基于开始月份(四月)命名年份,则财年为2023年;如果您选择基于结束月份(四月)命名年份,则财年为2024年
示例输入
Copied{
"fiscal_year": {
"start_month": "April",
"display_based_on": "end_month"
}
}可能的错误
- INVALID_DATAHTTP 400
start_month 或 display_based_on 键的值不正确。
解决方法:为键提供正确的值 - INVALID_DATAHTTP 400
请提供有效的开始月份或 display_based_on 值。
解决方案:提供有效的开始月份或 display_based_on 值,或两者都提供。 - INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决方法:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅上面的端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限读取财年设置
解决方案:用户没有权限检索财年设置。请联系您的系统管理员。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方法: 请求的URL不正确。请指定一个有效的请求URL。请参阅上面的请求URL部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未经授权
解决方案:客户端没有ZohoCRM.settings.fiscal_year.UPDATE权限。创建一个具有有效权限的新客户端。请参阅上面的权限部分。 - NO_PERMISSIONHTTP 403
没有权限读取
解决方案:用户没有权限更新财年设置。请联系系统管理员。 - NOT_ALLOWEDHTTP 403
财政年度设置只能通过预测设置进行修改
解决方案:如果启用了预测,财政年度设置只能通过预测设置进行修改。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方法:服务器中出现意外且未处理的异常。请联系支持团队。
示例响应
Copied{
"fiscal_year": {
"code": "SUCCESS",
"details": {},
"message": "Updated Successfully",
"status": "success"
}
}