コンテンツにスキップ
スマレジ・プラットフォームAPI 仕様書

日別勤怠（従業員別）取得

GET
/shifts/staffs/{staff_id}/daily

日別勤怠（従業員別）データを取得します

対象

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

対象ユーザー権限

  • シフト閲覧
  • 実績閲覧

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
staff_id
required
string

従業員ID

Example
1

Query Parameters

Section titled “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
01
store_id
string

事業所ID（カンマ区切りで複数指定可）

Example
1,2

Responses

Section titled “ Responses ”

200

Section titled “200 ”

取得成功

object
year

集計年 [YYYY]

string
/^\d{4}$/
month

集計月 [MM]

string
/^\d{2}$/
staffId

従業員ID

string
shiftDaily

日別勤怠データリスト

object
key
additional properties

勤怠データ（キー day: 日付 [YYYY-MM-DD]）

object
key
additional properties

事業所データリスト（キー storeId: 事業所ID）

object
key
additional properties

インデックス（キー index: 0始まりの添字 [n]）

object
shiftResultId

シフト実績ID

string
storeId

事業所ID

string
storeName

事業所名

string
storeAbbr

事業所名略称

string
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
tardyFlag

遅刻の有無

  • "": 遅刻なし
  • 1: 遅刻あり
string
Allowed values: "" 1
earlyLeavingFlag

早退の有無

  • "": 早退なし
  • 1: 早退あり
string
Allowed values: "" 1
shiftDateYm

年月日 [YYYY-MM-DD]

string format: date
dutyHour

勤務時間（小数）

number
dutyMinute

勤務時間（分）

number
personnelExpenses

給与概算

number
Example
{
  "year": "2020",
  "month": "01",
  "staffId": "1",
  "shiftDaily": {
    "2020-01-01": {
      "1": {
        "0": {
          "shiftResultId": "1",
          "storeId": "1",
          "storeName": "スマレジ本店",
          "storeAbbr": "本店",
          "attendance": "2020-01-01T09:00:00+09:00",
          "leaving": "2020-01-01T18:00:00+09:00",
          "breakStartTime1": "2020-01-01T12:00:00+09:00",
          "breakEndTime1": "2020-01-01T13:00:00+09:00",
          "breakStartTime2": "",
          "breakEndTime2": "",
          "tardyFlag": "",
          "earlyLeavingFlag": "",
          "shiftDateYm": "2020-01-01",
          "dutyHour": 8,
          "dutyMinute": 480,
          "personnelExpenses": 8000
        }
      }
    },
    "2020-01-02": {
      "1": {
        "0": {
          "shiftResultId": "2",
          "storeId": "1",
          "storeName": "スマレジ本店",
          "storeAbbr": "本店",
          "attendance": "2020-01-02T09:00:00+09:00",
          "leaving": "2020-01-02T13:00:00+09:00",
          "breakStartTime1": "",
          "breakEndTime1": "",
          "breakStartTime2": "",
          "breakEndTime2": "",
          "tardyFlag": "",
          "earlyLeavingFlag": "",
          "shiftDateYm": "2020-01-02",
          "dutyHour": 4,
          "dutyMinute": 240,
          "personnelExpenses": 4000
        }
      },
      "2": {
        "0": {
          "shiftResultId": "3",
          "storeId": "2",
          "storeName": "スマレジ渋谷店",
          "storeAbbr": "渋谷店",
          "attendance": "2020-01-02T14:00:00+09:00",
          "leaving": "2020-01-02T17:00:00+09:00",
          "breakStartTime1": "",
          "breakEndTime1": "",
          "breakStartTime2": "",
          "breakEndTime2": "",
          "tardyFlag": "1",
          "earlyLeavingFlag": "",
          "shiftDateYm": "2020-01-02",
          "dutyHour": 3,
          "dutyMinute": 180,
          "personnelExpenses": 3000
        },
        "1": {
          "shiftResultId": "4",
          "storeId": "2",
          "storeName": "スマレジ渋谷店",
          "storeAbbr": "渋谷店",
          "attendance": "2020-01-02T18:00:00+09:00",
          "leaving": "2020-01-02T22:00:00+09:00",
          "breakStartTime1": "",
          "breakEndTime1": "",
          "breakStartTime2": "",
          "breakEndTime2": "",
          "tardyFlag": "",
          "earlyLeavingFlag": "",
          "shiftDateYm": "2020-01-02",
          "dutyHour": 4,
          "dutyMinute": 240,
          "personnelExpenses": 5000
        }
      }
    },
    "2020-01-03": {
      "2": {
        "0": {
          "shiftResultId": "5",
          "storeId": "2",
          "storeName": "スマレジ渋谷店",
          "storeAbbr": "渋谷店",
          "attendance": "2020-01-03T10:00:00+09:00",
          "leaving": "2020-01-03T19:00:00+09:00",
          "breakStartTime1": "2020-01-03T12:00:00+09:00",
          "breakEndTime1": "2020-01-03T13:00:00+09:00",
          "breakStartTime2": "2020-01-03T15:00:00+09:00",
          "breakEndTime2": "2020-01-03T15:30:00+09:00",
          "tardyFlag": "",
          "earlyLeavingFlag": "1",
          "shiftDateYm": "2020-01-03",
          "dutyHour": 7.5,
          "dutyMinute": 450,
          "personnelExpenses": 7500
        }
      }
    }
  }
}

400

Section titled “400 ”

パラメータに誤りがある場合

object
type

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

string
title

エラーの概要

string
detail

エラーの詳細

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

404

Section titled “404 ”
  • 指定したIDのデータが存在しない場合
object
type

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

string
title

エラーの概要

string
detail

エラーの詳細

string
Example
{
  "type": "about:blank",
  "title": "Not Found",
  "detail": "データが確認できませんでした。従業員ID: 9999"
}