Zoho crm Logo

更新财年设置

目的

更新您组织的财年设置详情。

端点

  • 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"
    }
}