時間別勤怠（事業所別合計）取得

GET

/shifts_summary/{store_id}/hourly

サンドボックス
本番

時間別勤怠（事業所別合計）を取得します

対象

プラン
- プレミアム
- プレミアムプラス
- エンタープライズ、旧有料

対象ユーザー権限

シフト閲覧
実績閲覧

Authorizations

AppAccessToken
timecard.shifts:read
UserAccessToken
timecard.shifts:read

Parameters

Path Parameters

store_id

required

string

事業所ID

Example

Query Parameters

division

required

string

Allowed values: schedule result

シフト/実績区分

schedule: シフト
result: 実績

Example

result

year

required

string

/^\d{4}$/

集計年 [YYYY]

Example

month

required

string

/^\d{2}$/

集計月 [MM]

Example

day

required

string

/^\d{2}$/

集計日 [DD]

Example

callback_url

required

string format: uri

コールバックURL

Example

https://example.com/callback

Callbacks

`onDataReceived`

POST

{$request.query.callback_url}

Request Body

object

year

集計年 [YYYY]

string

/^\d{4}$/

month

集計月 [MM]

string

/^\d{2}$/

day

集計日 [DD]

string

/^\d{2}$/

storeId

事業所ID

string

storeName

事業所名

string

storeAbbr

事業所名略称

string

division

シフト/実績区分

schedule: シフト
result: 実績

string

Allowed values: schedule result

shiftStoreHourly

時間別勤怠データリスト

Array<object>

object

hour

時間帯

number

hourlyTotalHour

時間別合計労働時間（小数）

number format: double

hourlyTotalMinute

時間別合計労働時間（分）

number

hourlyTotalStaff

時間別合計労働人数

number

staffs

従業員データリスト

Array<object>

object

staffId

従業員ID

number

workingHour

労働時間（小数）

number format: double

workingMinute

労働時間（分）

number

personnelExpenses

給与概算（時給従業員のみ対象となります）

number

totalPersonnelExpenses

給与概算合計（時給従業員のみ対象となります）

number

Example

{
  "year": "2020",
  "month": "01",
  "day": "01",
  "storeId": "1",
  "storeName": "スマレジ事業所",
  "storeAbbr": "スマレジ",
  "division": "schedule",
  "shiftStoreHourly": [
    {
      "hour": 0,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 1,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 2,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 3,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 4,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 5,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 6,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 7,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 8,
      "hourlyTotalHour": 0.5,
      "hourlyTotalMinute": 30,
      "hourlyTotalStaff": 1,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 0.5,
          "workingMinute": 30,
          "personnelExpenses": 500.5
        }
      ],
      "totalPersonnelExpenses": 500.5
    },
    {
      "hour": 9,
      "hourlyTotalHour": 3.75861111111111,
      "hourlyTotalMinute": 225.51666666666668,
      "hourlyTotalStaff": 2,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1.25861111111111,
          "workingMinute": 75.51666666666668,
          "personnelExpenses": 1258.611111111111
        },
        {
          "staffId": 2,
          "workingHour": 2.5,
          "workingMinute": 150,
          "personnelExpenses": 2500
        }
      ],
      "totalPersonnelExpenses": 3758.6111111111113
    },
    {
      "hour": 10,
      "hourlyTotalHour": 5.25,
      "hourlyTotalMinute": 315,
      "hourlyTotalStaff": 3,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1.25,
          "workingMinute": 75,
          "personnelExpenses": 1250.75
        },
        {
          "staffId": 3,
          "workingHour": 3,
          "workingMinute": 180,
          "personnelExpenses": 2700
        }
      ],
      "totalPersonnelExpenses": 4950.75
    },
    {
      "hour": 11,
      "hourlyTotalHour": 4,
      "hourlyTotalMinute": 240,
      "hourlyTotalStaff": 3,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        },
        {
          "staffId": 3,
          "workingHour": 2,
          "workingMinute": 120,
          "personnelExpenses": 1800
        }
      ],
      "totalPersonnelExpenses": 4000
    },
    {
      "hour": 12,
      "hourlyTotalHour": 2.5,
      "hourlyTotalMinute": 150,
      "hourlyTotalStaff": 2,
      "staffs": [
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        },
        {
          "staffId": 3,
          "workingHour": 1.5,
          "workingMinute": 90,
          "personnelExpenses": 900.5
        }
      ],
      "totalPersonnelExpenses": 2100.5
    },
    {
      "hour": 13,
      "hourlyTotalHour": 3,
      "hourlyTotalMinute": 180,
      "hourlyTotalStaff": 3,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        },
        {
          "staffId": 3,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 900
        }
      ],
      "totalPersonnelExpenses": 3100
    },
    {
      "hour": 14,
      "hourlyTotalHour": 3.83333333333333,
      "hourlyTotalMinute": 230.00000000000003,
      "hourlyTotalStaff": 3,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        },
        {
          "staffId": 3,
          "workingHour": 1.83333333333333,
          "workingMinute": 110.00000000000001,
          "personnelExpenses": 1650
        }
      ],
      "totalPersonnelExpenses": 3850
    },
    {
      "hour": 15,
      "hourlyTotalHour": 2,
      "hourlyTotalMinute": 120,
      "hourlyTotalStaff": 2,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        }
      ],
      "totalPersonnelExpenses": 2200
    },
    {
      "hour": 16,
      "hourlyTotalHour": 2,
      "hourlyTotalMinute": 120,
      "hourlyTotalStaff": 2,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        },
        {
          "staffId": 2,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1200
        }
      ],
      "totalPersonnelExpenses": 2200
    },
    {
      "hour": 17,
      "hourlyTotalHour": 1,
      "hourlyTotalMinute": 60,
      "hourlyTotalStaff": 1,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 1,
          "workingMinute": 60,
          "personnelExpenses": 1000
        }
      ],
      "totalPersonnelExpenses": 1000
    },
    {
      "hour": 18,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 19,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 20,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 21,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 22,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    },
    {
      "hour": 23,
      "hourlyTotalHour": 0,
      "hourlyTotalMinute": 0,
      "hourlyTotalStaff": 0,
      "totalPersonnelExpenses": 0
    }
  ]
}

Responses

200

コールバックに成功した場合

Responses

201

リクエスト成功

object

message

メッセージ

string

Example

{
  "message": "実行中です"
}

400

パラメータが不正な場合

object

type

エラータイプを識別するURI、もしくはabout:blank

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "日は2桁で入力してください。"
}