BlueAI 勤怠 データ構造
勤怠 API で返却される主要オブジェクトのフィールド定義です。
|
ID 形式
各リソースは prefix 付き public ID（例: deal_..., inv_..., form_..., ak_...）を利用します。
全プロダクト共通の ID 規約Punch object
出退勤の打刻を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 打刻 ID |
object | string | 必須 | オブジェクト種別（`attendance.punch`） |
organization_id | string | 必須 | 組織 ID |
user_id | string | 必須 | ユーザー ID |
type | "clock_in" | "clock_out" | 必須 | 打刻種別 |
punched_at | string | 必須 | 打刻日時 (ISO 8601) |
note | string | null | 任意 | メモ |
created_at | string | 必須 | 作成日時 (ISO 8601) |
{
"id": "punch_01JQ3KXYZ",
"object": "attendance.punch",
"organization_id": "org_01HZXYZ",
"user_id": "usr_01HZABC",
"type": "clock_in",
"punched_at": "2026-02-22T09:00:00Z",
"note": null,
"created_at": "2026-02-22T09:00:00Z"
}Correction object
勤怠修正申請を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 修正申請 ID |
object | string | 必須 | オブジェクト種別（`attendance.correction`） |
organization_id | string | 必須 | 組織 ID |
user_id | string | 必須 | 申請者 ID |
date | string | 必須 | 対象日 (YYYY-MM-DD) |
reason | string | 必須 | 修正理由 |
status | "pending" | "approved" | "rejected" | 必須 | ステータス |
approved_by | string | null | 任意 | 承認者 ID |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "corr_01JQ3KDEF",
"object": "attendance.correction",
"organization_id": "org_01HZXYZ",
"user_id": "usr_01HZABC",
"date": "2026-02-21",
"reason": "Forgot to clock out",
"status": "pending",
"approved_by": null,
"created_at": "2026-02-22T10:00:00Z",
"updated_at": "2026-02-22T10:00:00Z"
}LeaveRequest object
休暇申請を表すオブジェクトです。
フィールド
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 休暇申請 ID |
object | string | 必須 | オブジェクト種別（`attendance.leave_request`） |
organization_id | string | 必須 | 組織 ID |
user_id | string | 必須 | 申請者 ID |
leave_type | string | 必須 | 休暇種別 |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
reason | string | null | 任意 | 理由 |
status | "pending" | "approved" | "rejected" | 必須 | ステータス |
created_at | string | 必須 | 作成日時 (ISO 8601) |
updated_at | string | 必須 | 更新日時 (ISO 8601) |
{
"id": "leave_01JQ3KGHI",
"object": "attendance.leave_request",
"organization_id": "org_01HZXYZ",
"user_id": "usr_01HZABC",
"leave_type": "paid_leave",
"start_date": "2026-03-01",
"end_date": "2026-03-01",
"reason": "Personal errands",
"status": "approved",
"created_at": "2026-02-20T11:00:00Z",
"updated_at": "2026-02-21T09:00:00Z"
}