Zoho crm Logo

更新营业时间

目的

更新您组织的营业时间详情。

端点

  • PUT /settings/business_hours

请求详情

请求 URL

{api-domain}/crm/{version}/settings/business_hours

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.settings.business_hours.ALL
(或)
scope=ZohoCRM.settings.business_hours.UPDATE

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/business_hours"
-X PUT
-d "@update.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-H "X-CRM-ORG:{your_org_id}"

输入JSON

  • 类型字符串,必填

    表示您希望设置的营业时间是每周五天、七天,还是自定义值。可选值为 24*7、24*5 和 custom。

  • week_starts_on字符串,必填

    您的业务一周开始的日期。可选值包括星期日至星期六。

  • business_daysJSON 数组,当你设置 type=24*5 或 custom 时为必填项

    您的企业运营的星期几。当 type=24*5 或 custom 时,此项为必填。

  • id字符串,可选

    要更新的营业时间的唯一ID。请使用 获取营业时间 API 来获取该ID。

  • same_as_everyday布尔值,可选

    表示营业时间是否每天相同。当该值为 false 时,JSON 数组 custom_timing 为必填项。当该值为 true 时,JSON 数组 daily_timing 为必填项。

  • daily_timingJSON 数组,当 same_as_everyday 为 true 时为必填项

    表示一周内营业时间,格式为 HH:mm。例如:"daily_timing":["10:00","17:00"]。

  • custom_timingJSON 数组,当 same_as_everyday 为false时为必填项

    在数组的每个 JSON 对象中包含以下键值:

    • _delete - 用于删除某个营业日的自定义时间。此键的值为 null。
    • days - string,必填 - 有自定义营业时间的星期几。例如:"days":"Monday"。
    • business_timing - JSON 数组,必填 - 该天的营业时间,格式为 HH:MM。例如:"business_timing":["10:00","17:00"]。

请提供您要翻译的英文内容或HTML代码,我将为您进行翻译。

Copied{
    "business_hours": {
        "id":"3652397000001438001",
        "business_days": [
            "Monday",
            "Tuesday",
            "Wednesday",
            "Thursday"
        ],
        "week_starts_on": "Monday",
        "custom_timing": [
            {
                "days": "Monday",
                "business_timing": [
                    "10:00",
                    "17:00"
                ]
            },
            {
                "days": "Tuesday",
                "business_timing": [
                    "10:30",
                    "17:00"
                ]
            },
            {
                "days": "Wednesday",
                "business_timing": [
                    "11:00",
                    "17:00"
                ]
            },
            {
                "days": "Thursday",
                "business_timing": [
                    "09:00",
                    "18:30"
                ]
            },
            {
                "days": "Friday",
                "business_timing": [
                    "11:30",
                    "18:30"
                ],
                "_delete":null
            }
        ],
        "same_as_everyday": false,
        "type": "custom"
    }
}

可能的错误

  • MANDATORY_NOT_FOUNDHTTP 400
    • 您没有在输入中指定 type 或 week_starts_on 键。
      解决方法:type 和 week_starts_on 键在输入中是必填项。请参考响应中的 details 键以查找缺失的键。
    • 一个或多个必填键缺失
      解决方法:请填写所有必填键。查阅 输入 JSON,以确认所需的键。
  • DEPENDENT_FIELD_MISSINGHTTP 400

    您尚未指定一个或多个依赖字段。
    解决方法:

    • 对于 type=24*5 或 custom,business_days 为必填项。
    • 对于 type=custom,same_as_everyday 为必填项。
    • 当 same_as_everyday=true 时,daily_timing 为必填项。
    • 当 same_as_everyday=false 时,custom_timing 为必填项。

    请参阅 输入 JSON 部分以了解这些键的结构。

  • INVALID_DATA HTTP 400

    原因与解决方法:

    • 对于 type=24*5,您已指定的工作日数多于或少于五天。您必须准确输入五个工作日。
    • type 的值无效。可选值为 24*7、24*5 和 custom。
    • 您为business_days指定了无效的值。可用的值有:星期日、星期一、星期二、星期三、星期四、星期五和星期六。
    • 您为 week_starts_on 指定了无效的值。可选值为 星期天、星期一、星期二、星期三、星期四、星期五 或 星期六。
    • 您为 business_timing 或 daily_timing 指定了无效的值。格式应为 HH:mm。
    • custom_timing 或 daily_timing 其中之一超出了您组织的营业时间。如果您组织的营业时间是上午10点到下午5点,则任意一天的营业时间都必须在此时间段内。
    • business_days 键在输入中有超过七个值。此数组中的最大值数量只能为七。请检查你的输入是否有重复或无效的值。
    • "business_days" 键中给出的数值超出了 "type" 键中指定的数值。请在允许的范围内指定数值。
    • 输入正文中提供了无效的数据。请指定有效的值。有关如何提供正确数值的详细信息,请参阅输入JSON,或查看上文列出的错误情况及其相应的解决方法。如果这些方法无法解决您的问题,请通过发送邮件至support@zohocrm.com告诉我们您的期望。 
  • NOT_ALLOWEDHTTP 400

    您正在尝试在创建组织之前设置营业时间。
    解决方法:只有在创建组织后,您才能添加营业时间。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方法:请求的URL不正确。请指定有效的请求URL。详情请参见请求URL部分。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您没有访问此 API 的正确权限范围。
    解决方法:使用 ZohoCRM.settings.business_hours.ALL 或 ZohoCRM.settings.business_hours.UPDATE 权限范围创建新的令牌。

  • MINIMUM_DATA_NOT_FOUNDHTTP 400

    给定的值少于在“type”键中指定的所需值
    解决方法:请根据“type”字段中给定的值指定相应的数值。更多详情请参考输入JSON。

  • DEPENDENT_MISMATCHHTTP 400

    “结束时间”被错误地放在了“开始时间”之前
    解决方案:请确保“结束时间”设置在“开始时间”之后。

  • ALREADY_USEDHTTP 400

    “bUSiness_days” JSON 数组中提供了重复的日期
    解决方法:"bUSiness_days" 数组中不能包含重复的值。例如,“Monday”不应出现多次。

示例回复

Copied{
    "business_hours": {
        "code": "SUCCESS",
        "details": {
            "id": "3652397000001438001"
        },
        "message": "Business Hours saved successfully",
        "status": "success"
    }
}