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

事業所取得

GET
/stores/{store_id}

事業所詳細を取得します

対象

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

対象ユーザー権限

  • 事業所管理閲覧

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
store_id
required
string

事業所ID

Example
1

Responses

Section titled “ Responses ”

200

Section titled “200 ”

取得成功

object
storeId

事業所ID

string
storeName

事業所名

string
storeAbbr

事業所名略称

string
storeKana

事業所名フリガナ

string
postCode

郵便番号

string
address

住所

string
prefectureCode

都道府県コード

string
phone

電話番号

string
mail

メールアドレス

string
autoBreakTimeDivision

休憩時間自動設定区分

  • 1: 時間指定
  • 2: 条件指定
string
Allowed values: 1 2
autoBreakStartTime1

自動休憩（時間指定） 休憩1 開始時刻 [hh:mm:ss]

string format: time
autoBreakEndTime1

自動休憩（時間指定） 休憩1 終了時刻 [hh:mm:ss]

string format: time
autoBreakStartTime2

自動休憩（時間指定） 休憩2 開始時刻 [hh:mm:ss]

string format: time
autoBreakEndTime2

自動休憩（時間指定） 休憩2 終了時刻 [hh:mm:ss]

string format: time
autoBreakCondition1Division

自動休憩（条件指定） 設定方法1

  • 1: 出勤後に追加
  • 2: 退勤前に追加
  • 3: 中央に追加
  • 4: 通常労働優先
  • 5: 深夜労働優先
string
Allowed values: 1 2 3 4 5
autoBreakCondition1ConditionTime

自動休憩（条件指定） 勤務時間条件1（分以上）

string
autoBreakCondition1SettingTime

自動休憩（条件指定） 休憩時間1（分）

string
autoBreakCondition2Division

自動休憩（条件指定） 設定方法2

  • 1: 出勤後に追加
  • 2: 退勤前に追加
  • 3: 中央に追加
  • 4: 通常労働優先
  • 5: 深夜労働優先
string
Allowed values: 1 2 3 4 5
autoBreakCondition2ConditionTime

自動休憩（条件指定） 勤務時間条件2（分以上）

string
autoBreakCondition2SettingTime

自動休憩（条件指定） 休憩時間2（分）

string
autoBreakCondition3Division

自動休憩（条件指定） 設定方法3

  • 1: 出勤後に追加
  • 2: 退勤前に追加
  • 3: 中央に追加
  • 4: 通常労働優先
  • 5: 深夜労働優先
string
Allowed values: 1 2 3 4 5
autoBreakCondition3ConditionTime

自動休憩（条件指定） 勤務時間条件3（分以上）

string
autoBreakCondition3SettingTime

自動休憩（条件指定） 休憩時間3（分）

string
roundSetting

シフト管理単位設定

  • 0: かんたん設定
  • 1: 詳細設定

従業員が打刻を行なった際に、打刻した時刻を設定した範囲で丸めを行なうための設定です。

string
Allowed values: 0 1
attendanceScheduleRoundDivision

シフト丸め設定（出勤）

  • 0: 丸めない
  • 1: 丸める
  • 2: 打刻実績のみ丸める
string
Allowed values: 0 1 2
attendanceScheduleRoundUnit

シフト丸め単位（出勤）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
attendanceShiftUnit

シフト管理単位（詳細設定）
状態: 出勤 管理単位（分）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
attendanceRound

シフト管理単位（詳細設定）
状態: 出勤 計算方法

  • 0: 切上げ
  • 1: 切捨て
string
Allowed values: 0 1
leavingScheduleRoundDivision

シフト丸め設定（退勤）

  • 0: 丸めない
  • 1: 丸める
  • 2: 打刻実績のみ丸める
string
Allowed values: 0 1 2
leavingScheduleRoundUnit

シフト丸め単位（退勤）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
leavingShiftUnit

シフト管理単位（詳細設定）
状態: 退勤 管理単位（分）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
leavingRound

シフト管理単位（詳細設定）
状態: 退勤 計算方法

  • 0: 切上げ
  • 1: 切捨て
string
Allowed values: 0 1
breakStartShiftUnit

シフト管理単位（詳細設定）
状態: 休憩開始 管理単位（分）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
breakStartRound

シフト管理単位（詳細設定）
状態: 休憩開始 計算方法

  • 0: 切上げ
  • 1: 切捨て
string
Allowed values: 0 1
breakEndShiftUnit

シフト管理単位（詳細設定）
状態: 休憩終了 管理単位（分）

  • 1: 1分
  • 5: 5分
  • 10: 10分
  • 15: 15分
  • 20: 20分
  • 30: 30分
  • 60: 60分
string
Allowed values: 1 5 10 15 20 30 60
breakEndRound

シフト管理単位（詳細設定）
状態: 休憩終了 計算方法

  • 0: 切上げ
  • 1: 切捨て
string
Allowed values: 0 1
businessDayStart

日付変更時間 [hh:mm:ss]

string format: time
closingDay

締め日

string
displaySequence

表示順

string
displayFlag

事業所表示設定

  • 0: 表示しない
  • 1: 表示する
string
Allowed values: 0 1
passCodeSetting

出退勤パスコード設定

  • 0: 使用しない
  • 1: 使用する
string
Allowed values: 0 1
requireLocation

位置情報必須設定（Web出退勤画面）

  • 0: 任意
  • 1: 必須
string
Allowed values: 0 1
requireLocationApp

位置情報必須設定（アプリ）

  • 0: 任意
  • 1: 必須
string
Allowed values: 0 1
geoFencingEnabled

ジオフェンシング打刻設定
※契約中のプランがジオフェンシング打刻を利用できない場合は値によらずジオフェンシング打刻は無効です。

  • 0: 使用しない
  • 1: 使用する
string
Allowed values: 0 1
geoFencingLatitude

ジオフェンシング打刻緯度

number format: double
>= -90 <= 90
geoFencingLongitude

ジオフェンシング打刻経度

number format: double
>= -180 <= 180
geoFencingRadius

ジオフェンシング打刻半径(m)

number format: integer
>= 1 <= 500
requirePicture

写真撮影必須設定（Web出退勤画面）

  • 0: 任意
  • 1: 必須
string
Allowed values: 0 1
requirePictureApp

写真撮影必須設定（アプリ）

  • 0: 任意
  • 1: 必須
string
Allowed values: 0 1
businessHour

営業時間帯リスト

Array<object>
object
businessHourId

営業時間帯ID

string
1
businessHourName

営業時間帯名前

string
朝勤
timeFrom

開始時刻 [hh:mm:ss]

string format: time 
00:00:00
timeTo

終了時刻 [hh:mm:ss]

string format: time 
12:00:00
Example
{
  "storeId": "1",
  "storeName": "スマレジ事業所",
  "storeAbbr": "スマレジ",
  "storeKana": "スマレジ",
  "postCode": "000-0000",
  "address": "大阪府大阪市中央区本町",
  "prefectureCode": "04",
  "phone": "000-0000-0000",
  "mail": "smaregi@example.jp",
  "autoBreakTimeDivision": "1",
  "autoBreakStartTime1": "11:00:00",
  "autoBreakEndTime1": "12:00:00",
  "autoBreakStartTime2": "14:00:00",
  "autoBreakEndTime2": "15:00:00",
  "autoBreakCondition1Division": "1",
  "autoBreakCondition1ConditionTime": "0",
  "autoBreakCondition1SettingTime": "0",
  "autoBreakCondition2Division": "1",
  "autoBreakCondition2ConditionTime": "0",
  "autoBreakCondition2SettingTime": "0",
  "autoBreakCondition3Division": "1",
  "autoBreakCondition3ConditionTime": "0",
  "autoBreakCondition3SettingTime": "0",
  "roundSetting": "0",
  "attendanceScheduleRoundDivision": "0",
  "attendanceScheduleRoundUnit": "30",
  "attendanceShiftUnit": "5",
  "attendanceRound": "0",
  "leavingScheduleRoundDivision": "0",
  "leavingScheduleRoundUnit": "30",
  "leavingShiftUnit": "5",
  "leavingRound": "1",
  "breakStartShiftUnit": "5",
  "breakStartRound": "1",
  "breakEndShiftUnit": "5",
  "breakEndRound": "0",
  "businessDayStart": "00:00:00",
  "closingDay": "20",
  "displaySequence": "1",
  "displayFlag": "1",
  "passCodeSetting": "1",
  "requireLocation": "1",
  "requireLocationApp": "1",
  "geoFencingEnabled": "1",
  "geoFencingLatitude": 34.684206,
  "geoFencingLongitude": 135.507926,
  "geoFencingRadius": 30,
  "requirePicture": "1",
  "requirePictureApp": "1",
  "businessHour": [
    {
      "businessHourId": "1",
      "businessHourName": "朝勤",
      "timeFrom": "07:00:00",
      "timeTo": "12:00:00"
    },
    {
      "businessHourId": "2",
      "businessHourName": "夜勤",
      "timeFrom": "18:00:00",
      "timeTo": "24:00:00"
    }
  ]
}

404

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

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

string
title

エラーの概要

string
detail

エラーの詳細

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