# Query Special Business Hours

This endpoint retrieves a store's currently active special business hours, which temporarily override regular operating hours for specific dates (e.g., holidays, events).


1. Special business hours refer to temporarily adjusted operating schedules for stores on specific dates, such as holidays, special events, or operational changes that differ from regular weekly hours
2. When configured, these hours automatically override standard schedules during their effective period and seamlessly revert to normal hours after expiration without manual intervention, ensuring continuous and accurate operational information.


Endpoint: POST /scm/shop/special/business/hour/effective/get
Version: v.1.0.0

## Request fields (application/json):

  - `shopId` (integer, required)
    Store ID
    Example: 466663

## Response 200 fields (application/json):

  - `code` (integer, required)
    A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

  - `message` (string, required)
    Text description corresponding to the status code, explaining the operation result or error cause to users.
    Example: "Success"

  - `data` (array)

  - `data.startDate` (integer, required)
    Start date timestamp (milliseconds) for  of the day timestamp example: 1690214400000 (2023-07-24 00:00:00 UTC)
    Example: 1690214400000

  - `data.endDate` (integer, required)
    End date timestamp (milliseconds) for  of the day timestamp example: 1690646399999 (2023-07-28 23:59:59.999 UTC)
    Example: 1690646399999

  - `data.businessHour` (array, required)
    Operating hours during [startDate, endDate] period
Full-day closure: Single DTO with startTime=0 and endTime=0

  - `data.businessHour.startTime` (integer, required)
    Start time of business period in seconds:
- Range: 0 (midnight) to 86400 (next midnight)
- For full-day closure: Set to 0 along with endTime=0
- Time periods must not overlap within the same day
    Example: 27000

  - `data.businessHour.endTime` (integer, required)
    End time of business period in seconds:
- Must be >= startTime except for cross-day periods
- For full-day closure: Set to 0 along with startTime=0
    Example: 28000