出勤中の従業員取得

GET

/shifts/{store_id}/duty

• サンドボックス
• 本番

指定時刻に出勤している従業員を取得します

対象

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

対象ユーザー権限

• シフト閲覧
• 実績閲覧

Authorizations

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

Parameters

Path Parameters

store_id

required

string

事業所ID

Example

1

Query Parameters

duty_time

string format: date-time

指定時刻 [YYYY-MM-DDThh:mm:ssTZD]
（未指定の場合、サーバーの現在時刻が指定されます）

Example

2020-05-01T10:00:00+09:00

Responses

200

取得成功

object

dutyTime

指定時刻 [YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

storeId

事業所ID

string

storeName

事業所名

string

dutyStaffs

出勤中の従業員データリスト

Array<object>

object

staffId

従業員ID

string

staffName

従業員名

string

shiftResultId

シフト実績ID

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

Example

{
  "dutyTime": "2020-05-01T14:30:00+09:00",
  "storeId": "1",
  "storeName": "スマレジ本店",
  "dutyStaffs": [
    {
      "staffId": "1",
      "staffName": "山田太郎",
      "shiftResultId": "101",
      "attendance": "2020-05-01T09:00:00+09:00",
      "leaving": "2020-05-01T18:00:00+09:00",
      "breakStartTime1": "2020-05-01T12:00:00+09:00",
      "breakEndTime1": "2020-05-01T13:00:00+09:00",
      "breakStartTime2": "",
      "breakEndTime2": ""
    },
    {
      "staffId": "2",
      "staffName": "佐藤花子",
      "shiftResultId": "102",
      "attendance": "2020-05-01T10:00:00+09:00",
      "leaving": "2020-05-01T19:00:00+09:00",
      "breakStartTime1": "2020-05-01T13:00:00+09:00",
      "breakEndTime1": "2020-05-01T14:00:00+09:00",
      "breakStartTime2": "2020-05-01T16:00:00+09:00",
      "breakEndTime2": "2020-05-01T16:30:00+09:00"
    },
    {
      "staffId": "3",
      "staffName": "鈴木一郎",
      "shiftResultId": "103",
      "attendance": "2020-05-01T13:00:00+09:00",
      "leaving": "2020-05-01T22:00:00+09:00",
      "breakStartTime1": "2020-05-01T17:00:00+09:00",
      "breakEndTime1": "2020-05-01T18:00:00+09:00",
      "breakStartTime2": "",
      "breakEndTime2": ""
    },
    {
      "staffId": "4",
      "staffName": "田中美咲",
      "shiftResultId": "104",
      "attendance": "2020-05-01T08:00:00+09:00",
      "leaving": "2020-05-01T17:00:00+09:00",
      "breakStartTime1": "2020-05-01T12:00:00+09:00",
      "breakEndTime1": "2020-05-01T13:00:00+09:00",
      "breakStartTime2": "",
      "breakEndTime2": ""
    }
  ]
}

400

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

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "指定時刻はyyyy-MM-ddTHH:mm:ssTZDで送信してください。"
}

404

指定したIDのデータが存在しない場合

object

type

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

string

title

エラーの概要

string

detail

エラーの詳細

string

Example

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