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

GET

/shifts_summary/{store_id}/daily

• サンドボックス
• 本番

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

対象

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

対象ユーザー権限

• シフト閲覧
• 実績閲覧

Authorizations

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

Parameters

Path Parameters

store_id

required

string

事業所ID

Example

1

Query Parameters

division

required

string

Allowed values: schedule result

シフト/実績区分

• schedule: シフト
• result: 実績

Example

result

year

required

string

/^\d{4}$/

集計年 [YYYY]

Example

2020

month

required

string

/^\d{2}$/

集計月 [MM]

Example

06

date

string

/^\d{2}$/

集計日 [DD]

Example

15

callback_url

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}$/

storeId

事業所ID

string

storeName

事業所名

string

storeAbbr

事業所名略称

string

division

シフト/実績区分

• schedule: シフト
• result: 実績

string

Allowed values: schedule result

shiftStoreDaily

日別勤怠データ

object

key

additional properties

勤怠データ（キー day: 日付 [YYYYMMDD]）

object

dailyTotalStaff

日合計労働人数

number

dailyTotalHour

日合計労働時間（小数）

number format: double

dailyTotalMinute

日合計労働時間（分）

number

staffs

従業員データリスト

Array<object>

object

staffId

従業員ID

number

workingHour

労働時間（小数）

number format: double

workingMinute

労働時間（分）

number

personnelExpenses

給与概算

string

shifts

シフト/実績情報リスト

Array<object>

object

shiftResultId

シフト実績ID

string

staffId

従業員ID

string

staffName

従業員名

string

shiftDate

シフト/実績日

string format: date

attendance

出勤時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

leaving

退勤時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakStartTime1

休憩1 開始時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakEndTime1

休憩1 終了時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakStartTime2

休憩2 開始時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakEndTime2

休憩2 終了時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

totalPersonnelExpenses

給与概算合計

number

Example

{
  "year": "2020",
  "month": "01",
  "storeId": "1",
  "storeName": "スマレジ本社",
  "storeAbbr": "本社",
  "division": "result",
  "shiftStoreDaily": {
    "20200106": {
      "dailyTotalStaff": 3,
      "dailyTotalHour": 22.5,
      "dailyTotalMinute": 1350,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 8,
          "workingMinute": 480,
          "personnelExpenses": "12000",
          "shifts": [
            {
              "shiftResultId": "101",
              "staffId": "1",
              "staffName": "スマレジ太郎",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T09:00:00+09:00",
              "leaving": "2020-01-06T18:00:00+09:00",
              "breakStartTime1": "2020-01-06T12:00:00+09:00",
              "breakEndTime1": "2020-01-06T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 2,
          "workingHour": 7.5,
          "workingMinute": 450,
          "personnelExpenses": "9000",
          "shifts": [
            {
              "shiftResultId": "102",
              "staffId": "2",
              "staffName": "スマレジ花子",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T10:00:00+09:00",
              "leaving": "2020-01-06T18:00:00+09:00",
              "breakStartTime1": "2020-01-06T12:30:00+09:00",
              "breakEndTime1": "2020-01-06T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 3,
          "workingHour": 7,
          "workingMinute": 420,
          "personnelExpenses": "8400",
          "shifts": [
            {
              "shiftResultId": "103",
              "staffId": "3",
              "staffName": "スマレジ次郎",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T11:00:00+09:00",
              "leaving": "20250-01-06T18:30:00+09:00",
              "breakStartTime1": "2020-01-06T13:00:00+09:00",
              "breakEndTime1": "2020-01-06T13:30:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        }
      ],
      "totalPersonnelExpenses": 29400
    },
    "20200107": {
      "dailyTotalStaff": 2,
      "dailyTotalHour": 15,
      "dailyTotalMinute": 900,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 8,
          "workingMinute": 480,
          "personnelExpenses": "12000",
          "shifts": [
            {
              "shiftResultId": "104",
              "staffId": "1",
              "staffName": "スマレジ太郎",
              "shiftDate": "2020-01-07",
              "attendance": "2020-01-07T09:00:00+09:00",
              "leaving": "2020-01-07T18:00:00+09:00",
              "breakStartTime1": "2020-01-07T12:00:00+09:00",
              "breakEndTime1": "2020-01-07T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 2,
          "workingHour": 7,
          "workingMinute": 420,
          "personnelExpenses": "8400",
          "shifts": [
            {
              "shiftResultId": "105",
              "staffId": "2",
              "staffName": "スマレジ花子",
              "shiftDate": "2020-01-07",
              "attendance": "2020-01-07T10:00:00+09:00",
              "leaving": "2020-01-07T17:30:00+09:00",
              "breakStartTime1": "2020-01-07T12:30:00+09:00",
              "breakEndTime1": "2020-01-07T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        }
      ],
      "totalPersonnelExpenses": 20400
    }
  }
}

Responses

200

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

Responses

200

取得成功（コールバックURLを指定しなかった場合）

object

year

集計年 [YYYY]

string

/^\d{4}$/

month

集計月 [MM]

string

/^\d{2}$/

storeId

事業所ID

string

storeName

事業所名

string

storeAbbr

事業所名略称

string

division

シフト/実績区分

• schedule: シフト
• result: 実績

string

Allowed values: schedule result

shiftStoreDaily

日別勤怠データ

object

key

additional properties

勤怠データ（キー day: 日付 [YYYYMMDD]）

object

dailyTotalStaff

日合計労働人数

number

dailyTotalHour

日合計労働時間（小数）

number format: double

dailyTotalMinute

日合計労働時間（分）

number

staffs

従業員データリスト

Array<object>

object

staffId

従業員ID

number

workingHour

労働時間（小数）

number format: double

workingMinute

労働時間（分）

number

personnelExpenses

給与概算

string

shifts

シフト/実績情報リスト

Array<object>

object

shiftResultId

シフト実績ID

string

staffId

従業員ID

string

staffName

従業員名

string

shiftDate

シフト/実績日

string format: date

attendance

出勤時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

leaving

退勤時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakStartTime1

休憩1 開始時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakEndTime1

休憩1 終了時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakStartTime2

休憩2 開始時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

breakEndTime2

休憩2 終了時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

totalPersonnelExpenses

給与概算合計

number

Example

{
  "year": "2020",
  "month": "01",
  "storeId": "1",
  "storeName": "スマレジ本社",
  "storeAbbr": "本社",
  "division": "result",
  "shiftStoreDaily": {
    "20200106": {
      "dailyTotalStaff": 3,
      "dailyTotalHour": 22.5,
      "dailyTotalMinute": 1350,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 8,
          "workingMinute": 480,
          "personnelExpenses": "12000",
          "shifts": [
            {
              "shiftResultId": "101",
              "staffId": "1",
              "staffName": "スマレジ太郎",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T09:00:00+09:00",
              "leaving": "2020-01-06T18:00:00+09:00",
              "breakStartTime1": "2020-01-06T12:00:00+09:00",
              "breakEndTime1": "2020-01-06T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 2,
          "workingHour": 7.5,
          "workingMinute": 450,
          "personnelExpenses": "9000",
          "shifts": [
            {
              "shiftResultId": "102",
              "staffId": "2",
              "staffName": "スマレジ花子",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T10:00:00+09:00",
              "leaving": "2020-01-06T18:00:00+09:00",
              "breakStartTime1": "2020-01-06T12:30:00+09:00",
              "breakEndTime1": "2020-01-06T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 3,
          "workingHour": 7,
          "workingMinute": 420,
          "personnelExpenses": "8400",
          "shifts": [
            {
              "shiftResultId": "103",
              "staffId": "3",
              "staffName": "スマレジ次郎",
              "shiftDate": "2020-01-06",
              "attendance": "2020-01-06T11:00:00+09:00",
              "leaving": "20250-01-06T18:30:00+09:00",
              "breakStartTime1": "2020-01-06T13:00:00+09:00",
              "breakEndTime1": "2020-01-06T13:30:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        }
      ],
      "totalPersonnelExpenses": 29400
    },
    "20200107": {
      "dailyTotalStaff": 2,
      "dailyTotalHour": 15,
      "dailyTotalMinute": 900,
      "staffs": [
        {
          "staffId": 1,
          "workingHour": 8,
          "workingMinute": 480,
          "personnelExpenses": "12000",
          "shifts": [
            {
              "shiftResultId": "104",
              "staffId": "1",
              "staffName": "スマレジ太郎",
              "shiftDate": "2020-01-07",
              "attendance": "2020-01-07T09:00:00+09:00",
              "leaving": "2020-01-07T18:00:00+09:00",
              "breakStartTime1": "2020-01-07T12:00:00+09:00",
              "breakEndTime1": "2020-01-07T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        },
        {
          "staffId": 2,
          "workingHour": 7,
          "workingMinute": 420,
          "personnelExpenses": "8400",
          "shifts": [
            {
              "shiftResultId": "105",
              "staffId": "2",
              "staffName": "スマレジ花子",
              "shiftDate": "2020-01-07",
              "attendance": "2020-01-07T10:00:00+09:00",
              "leaving": "2020-01-07T17:30:00+09:00",
              "breakStartTime1": "2020-01-07T12:30:00+09:00",
              "breakEndTime1": "2020-01-07T13:00:00+09:00",
              "breakStartTime2": "",
              "breakEndTime2": ""
            }
          ]
        }
      ],
      "totalPersonnelExpenses": 20400
    }
  }
}

201

成功（コールバックURLを指定した場合）

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桁で入力してください。"
}