# Koreksi Presensi

Riwayat dan pengajuan koreksi presensi oleh karyawan: lupa presensi masuk, lupa presensi pulang, atau
jam presensi yang tercatat salah. Koreksi yang disetujui seluruh tahap langsung diterapkan ke rekap
presensi harian. Konvensi umum (envelope, waktu UTC, upload) ada di [README.md](README.md); objek
presensi ada di [attendance.md](attendance.md).

| Atribut | Nilai |
|---|---|
| Endpoint | `GET /attendance/corrections`, `POST /attendance/corrections` |
| Sumber kode | `AttendanceCorrectionController`, `StoreAttendanceCorrectionRequest`, `AttendanceCorrectionResource`, `AttendanceCorrectionService`, `AttendanceScheduleResolver`, `OvertimeLookup` |
| Contoh direkam | 2026-10-22, direkam ulang 2026-10-23 setelah perubahan alur persetujuan, HTTP kernel Laravel, basis data SQLite sekali pakai berisi dua perusahaan (`nusantara-logistik` WIB, `borneo-retail` WITA), `APP_LOCALE=id` seperti server. Jam server dipasang per skenario; setiap contoh mencantumkan waktunya |
| Data uji | Citra Satu: jam tetap 08:00–17:00 (jendela presensi 06:30–19:00). Alur persetujuan Citra: Tahap 1 Anton Satu (atasan langsung) → Tahap 2 Budi Satu (Kepala Departemen unit Anton, karena Anton tanpa atasan langsung). Budi Satu tanpa atasan langsung dan unitnya tanpa Kepala Departemen, sehingga pengajuannya diputuskan Admin HR. Periode rekap 21 Agu–20 Sep 2026 dikunci |

**Tidak ada** endpoint detail (`GET /attendance/corrections/{id}`) dan **tidak ada** endpoint
pembatalan. Pengajuan yang keliru diselesaikan atasan dengan menolaknya.

---

## Enum

### `CorrectionType` (`type`)

| Nilai | `type_label` | Jam yang wajib dikirim |
|---|---|---|
| `MISSING_CHECK_IN` | Tidak Sempat Presensi Masuk | `requested_check_in_at` |
| `MISSING_CHECK_OUT` | Tidak Sempat Presensi Pulang | `requested_check_out_at` |
| `WRONG_TIME` | Jam Presensi Tidak Sesuai | `requested_check_in_at` **dan** `requested_check_out_at` |
| `OTHER` | Lainnya | tidak ada; jam boleh dikirim bila relevan |

### `ApprovalStatus` (`status`, `approvals[].status`)

| Nilai | `status_label` | Arti |
|---|---|---|
| `PENDING` | Menunggu Persetujuan | belum diputuskan seluruh tahap |
| `APPROVED` | Disetujui | seluruh tahap menyetujui; koreksi sudah diterapkan ke rekap presensi |
| `REJECTED` | Ditolak | salah satu tahap menolak; tahap berikutnya otomatis `CANCELLED` |
| `CANCELLED` | Dibatalkan | pada `approvals[]`: tahap yang tidak perlu diputuskan lagi |

---

## Objek `correction`

Dipakai `GET /attendance/corrections` (`data[]`) dan respons `POST` (`data`). Sumber:
`AttendanceCorrectionResource`.

| Field | Tipe | Null | Keterangan |
|---|---|---|---|
| `id` | integer | tidak | ID pengajuan |
| `work_date` | string (`YYYY-MM-DD`) | tidak | tanggal kerja yang dikoreksi (tanggal mulai shift) |
| `type` | string (enum) | tidak | `CorrectionType` |
| `type_label` | string | tidak | label tampilan |
| `requested_check_in_at` | string (ISO 8601 UTC) | ya | jam masuk yang diajukan |
| `requested_check_out_at` | string (ISO 8601 UTC) | ya | jam pulang yang diajukan |
| `reason` | string | tidak | alasan dari karyawan |
| `status` | string (enum) | tidak | `ApprovalStatus` |
| `status_label` | string | tidak | label tampilan |
| `submitted_at` | string (ISO 8601 UTC) | tidak | waktu pengajuan diterima server |
| `decided_at` | string (ISO 8601 UTC) | ya | waktu keputusan akhir; `null` selama `PENDING` |
| `decision_notes` | string | ya | catatan keputusan akhir dari penyetuju |
| `approvals` | array objek | tidak | tahap persetujuan berurutan, lihat tabel di bawah |

**`approvals[]`** (sama di seluruh modul pengajuan: koreksi, cuti, lembur, perjalanan bisnis,
reimbursement)

| Field | Tipe | Null | Keterangan |
|---|---|---|---|
| `sequence` | integer | tidak | urutan tahap, mulai 1 |
| `stage_name` | string | tidak | `Tahap 1`, `Tahap 2`, atau `Admin HR`. Pengajuan yang dibuat sebelum 2026-10-23 dapat memuat nama lama, mis. `Atasan Langsung` |
| `approver` | string | ya | nama penyetuju yang ditetapkan saat pengajuan dibuat; `null` pada tahap `Admin HR` |
| `status` | string (enum) | tidak | `ApprovalStatus` tahap ini |
| `status_label` | string | tidak | label tampilan |
| `decided_at` | string (ISO 8601 UTC) | ya | waktu tahap diputuskan |
| `decided_by` | string | ya | **baru 2026-10-23.** Nama yang memutuskan tahap ini. Berbeda dari `approver` bila Admin HR memutuskan menggantikan penyetuju; `null` selama belum diputuskan atau bila tahap `CANCELLED` |
| `notes` | string | ya | catatan penyetuju tahap ini |

### Alur persetujuan

Berlaku sama untuk koreksi presensi, cuti, lembur, perjalanan bisnis, dan reimbursement. Server
menyusun penyetuju saat pengajuan dibuat; client tidak pernah mengirim penyetuju.

1. **Tahap 1** = Atasan Langsung pemohon bila terisi dan aktif. Bila tidak, Kepala Departemen
   pertama yang terisi dan aktif, mulai dari unit pemohon lalu naik ke unit induknya. Pemohon
   sendiri dilewati.
2. **Tahap 2** = penyetuju Tahap 1 untuk orang yang menjadi Tahap 1, dengan pemohon dan penyetuju
   Tahap 1 dilewati. Bila tidak ada, alur cukup satu tahap dan persetujuan Tahap 1 langsung final.
3. Bila Tahap 1 tidak ada (mis. pimpinan tertinggi), `approvals` berisi satu tahap `Admin HR`
   dengan `approver` `null`; keputusan diambil Admin HR lewat panel.
4. Tahap 2 baru dapat memutuskan setelah Tahap 1 menyetujui. Penolakan di tahap mana pun langsung
   final dan tahap berikutnya menjadi `CANCELLED`.
5. Admin HR dapat memutuskan tahap yang sedang berjalan lewat panel. Keputusannya final:
   `decided_by` berisi nama Admin HR dan tahap berikutnya menjadi `CANCELLED`.
6. Penyetuju disimpan saat pengajuan dibuat. Perubahan struktur organisasi tidak mengubah pengajuan
   yang berjalan, kecuali Admin HR menjalankan **Hitung Ulang Penyetuju** untuk pengajuan yang
   belum diputuskan sama sekali.

Lampiran yang diunggah **tidak** dikembalikan (tidak ada field berkas atau URL).

---

## Riwayat koreksi

**`GET /attendance/corrections`**

Deskripsi: daftar pengajuan koreksi milik karyawan login, **50 terbaru** urut `submitted_at` terbaru
di atas. Tanpa pagination dan tanpa filter.

| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | `auth:sanctum`, `EnsureSubscriptionActive` |
| Route name | `api.v1.attendance.corrections.index` |

**Header:** `Accept: application/json`, `Authorization: Bearer <token>`

**Parameter:** tidak ada.

**Contoh Request**

```http
GET /api/v1/attendance/corrections HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
```

**Contoh Response Sukses** (`200`, 2026-10-26 10:05 WIB). Satu pengajuan ditolak di tahap pertama, satu
disetujui dua tahap, satu masih menunggu; dipotong menjadi 3 dari 4 item:

```json
{
  "success": true,
  "message": "Riwayat pengajuan koreksi berhasil diambil.",
  "data": [
    {
      "id": 4,
      "work_date": "2026-10-24",
      "type": "MISSING_CHECK_OUT",
      "type_label": "Tidak Sempat Presensi Pulang",
      "requested_check_in_at": null,
      "requested_check_out_at": "2026-10-24T06:05:00+00:00",
      "reason": "Lembur stock opname selesai 13.05, aplikasi tertutup sebelum presensi pulang.",
      "status": "REJECTED",
      "status_label": "Ditolak",
      "submitted_at": "2026-10-25T02:08:00+00:00",
      "decided_at": "2026-10-26T03:00:00+00:00",
      "decision_notes": "Jam pulang di CCTV gudang 12.40, ajukan ulang sesuai jam sebenarnya.",
      "approvals": [
        {
          "sequence": 1,
          "stage_name": "Tahap 1",
          "approver": "Anton Satu",
          "status": "REJECTED",
          "status_label": "Ditolak",
          "decided_at": "2026-10-26T03:00:00+00:00",
          "decided_by": "Anton Satu",
          "notes": "Jam pulang di CCTV gudang 12.40, ajukan ulang sesuai jam sebenarnya."
        },
        {
          "sequence": 2,
          "stage_name": "Tahap 2",
          "approver": "Budi Satu",
          "status": "CANCELLED",
          "status_label": "Dibatalkan",
          "decided_at": null,
          "decided_by": null,
          "notes": null
        }
      ]
    },
    {
      "id": 3,
      "work_date": "2026-10-19",
      "type": "WRONG_TIME",
      "type_label": "Jam Presensi Tidak Sesuai",
      "requested_check_in_at": "2026-10-19T00:55:00+00:00",
      "requested_check_out_at": "2026-10-19T10:02:00+00:00",
      "reason": "Jam presensi tercatat salah karena sinyal GPS hilang di gudang.",
      "status": "APPROVED",
      "status_label": "Disetujui",
      "submitted_at": "2026-10-25T02:06:00+00:00",
      "decided_at": "2026-10-26T03:00:00+00:00",
      "decision_notes": "Disetujui.",
      "approvals": [
        {
          "sequence": 1,
          "stage_name": "Tahap 1",
          "approver": "Anton Satu",
          "status": "APPROVED",
          "status_label": "Disetujui",
          "decided_at": "2026-10-26T03:00:00+00:00",
          "decided_by": "Anton Satu",
          "notes": "Disetujui, sesuai kebutuhan operasional."
        },
        {
          "sequence": 2,
          "stage_name": "Tahap 2",
          "approver": "Budi Satu",
          "status": "APPROVED",
          "status_label": "Disetujui",
          "decided_at": "2026-10-26T03:00:00+00:00",
          "decided_by": "Budi Satu",
          "notes": "Disetujui."
        }
      ]
    },
    {
      "id": 2,
      "work_date": "2026-10-20",
      "type": "MISSING_CHECK_OUT",
      "type_label": "Tidak Sempat Presensi Pulang",
      "requested_check_in_at": null,
      "requested_check_out_at": "2026-10-20T13:05:00+00:00",
      "reason": "Lembur sesudah jam kerja selesai pukul 20.05, lupa presensi pulang.",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "submitted_at": "2026-10-25T02:04:00+00:00",
      "decided_at": null,
      "decision_notes": null,
      "approvals": [
        {
          "sequence": 1,
          "stage_name": "Tahap 1",
          "approver": "Anton Satu",
          "status": "PENDING",
          "status_label": "Menunggu Persetujuan",
          "decided_at": null,
          "decided_by": null,
          "notes": null
        },
        {
          "sequence": 2,
          "stage_name": "Tahap 2",
          "approver": "Budi Satu",
          "status": "PENDING",
          "status_label": "Menunggu Persetujuan",
          "decided_at": null,
          "decided_by": null,
          "notes": null
        }
      ]
    }
  ]
}
```

Belum ada pengajuan (juga karyawan perusahaan lain yang tidak pernah melihat data perusahaan ini):

```json
{
  "success": true,
  "message": "Riwayat pengajuan koreksi berhasil diambil.",
  "data": []
}
```

**Field `data[]`:** [objek `correction`](#objek-correction).

**Contoh Response Error**

| Kondisi | HTTP | `message` |
|---|---|---|
| Token tidak sah | 401 | `Token tidak sah atau sudah kedaluwarsa. Silakan masuk kembali.` |
| Langganan terkunci | 402 | `Masa langganan perusahaan sudah berakhir dan tagihan belum dibayar. Aplikasi dikunci sampai admin perusahaan melunasi tagihan.` |

**Catatan**

- Urutan: `submitted_at` menurun. Batas 50 item, tanpa `meta`/`links`.
- Idempotency: tidak relevan (GET).
- Rate limit: tidak ada.
- FeatureGate / modul: `module_attendance_correction`. Server **tidak** memblokir endpoint berdasarkan
  saklar ini; client menyembunyikan menu bila `false`.
- Status langganan: terkunci → 402.

---

## Ajukan koreksi

**`POST /attendance/corrections`**

Deskripsi: mengajukan koreksi untuk satu tanggal kerja. Server memeriksa periode rekap, jadwal,
pengajuan ganda, kelengkapan jam, dan jendela jam, lalu menyusun penyetuju sesuai [alur
persetujuan](#alur-persetujuan).

| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | `auth:sanctum`, `EnsureSubscriptionActive` |
| Route name | `api.v1.attendance.corrections.store` |

**Header:** `Accept: application/json`, `Authorization: Bearer <token>`, `Content-Type:
application/json` atau `multipart/form-data` (wajib multipart bila mengirim `attachment`)

**Parameter** (`StoreAttendanceCorrectionRequest`)

| Nama | Lokasi | Tipe | Wajib | Aturan validasi (FormRequest) |
|---|---|---|---|---|
| `work_date` | body | string (`YYYY-MM-DD`) | ya | `required`, `date`. Tanggal kerja (tanggal mulai shift) yang dikoreksi. Kirim `YYYY-MM-DD`; format lain yang terbaca `strtotime` ikut diterima, tetapi tidak dijamin |
| `type` | body | string (enum) | ya | `required`, salah satu `CorrectionType` |
| `requested_check_in_at` | body | string (ISO 8601) | bila `type` `MISSING_CHECK_IN`/`WRONG_TIME` | `nullable`, `date`. **Wajib dengan offset** (`2026-10-19T07:55:00+07:00`); server menyimpan UTC. Kewajiban per jenis diperiksa aturan bisnis, bukan FormRequest |
| `requested_check_out_at` | body | string (ISO 8601) | bila `type` `MISSING_CHECK_OUT`/`WRONG_TIME` | `nullable`, `date`. Wajib dengan offset |
| `reason` | body | string | ya | `required`, `string`, `min:10`, `max:1000` |
| `attachment` | body (part berkas) | berkas gambar | tidak | `nullable`, `image` (jpg, jpeg, png, bmp, gif, webp; **PDF ditolak**), `max:2048` KB |

**Jendela jam koreksi.** Setiap jam yang diajukan wajib berada di dalam jendela presensi jadwal
tanggal itu, sama dengan jendela yang ditegakkan saat presensi:

- Hari kerja: dari `check_in_opens_at` sampai `check_out_closes_at` shift (contoh: jam tetap
  08:00–17:00 → 06:30–19:00).
- Bila pada tanggal itu ada lembur `BEFORE_SHIFT`/`AFTER_SHIFT` yang disetujui, jendela diperlebar ke
  **kedua arah** sebesar durasi lembur terpanjang + Kelonggaran Jendela Presensi Lembur (bawaan 30
  menit). Contoh: lembur 17:00–20:00 (180 menit) → jendela 03:00–22:30.
- Hari libur dengan lembur hari libur disetujui: jendela jam lembur ± kelonggaran (lembur 09:00–13:00
  → 08:30–13:30). Di luar itu message berbunyi `...di luar rentang jam lembur...`.
- `WRONG_TIME`: jam pulang wajib lebih akhir daripada jam masuk.

**Contoh Request** (JSON, 2026-10-25 09:06 WIB)

```http
POST /api/v1/attendance/corrections HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Content-Type: application/json

{
  "work_date": "2026-10-19",
  "type": "WRONG_TIME",
  "requested_check_in_at": "2026-10-19T07:55:00+07:00",
  "requested_check_out_at": "2026-10-19T17:02:00+07:00",
  "reason": "Jam presensi tercatat salah karena sinyal GPS hilang di gudang."
}
```

**Contoh Request** (multipart dengan lampiran, 2026-10-25 09:00 WIB)

```http
POST /api/v1/attendance/corrections HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Content-Type: multipart/form-data; boundary=absenova

--absenova
Content-Disposition: form-data; name="work_date"

2026-10-21
--absenova
Content-Disposition: form-data; name="type"

MISSING_CHECK_OUT
--absenova
Content-Disposition: form-data; name="requested_check_out_at"

2026-10-21T17:05:00+07:00
--absenova
Content-Disposition: form-data; name="reason"

Baterai ponsel habis saat jam pulang, sudah lapor ke supervisor gudang.
--absenova
Content-Disposition: form-data; name="attachment"; filename="bukti-absen-manual.jpg"
Content-Type: image/jpeg

(berkas JPEG 480×640, 240 KB)
--absenova--
```

**Contoh Response Sukses** (`201`)

```json
{
  "success": true,
  "message": "Pengajuan koreksi presensi terkirim dan menunggu persetujuan Anton Satu.",
  "data": {
    "id": 1,
    "work_date": "2026-10-21",
    "type": "MISSING_CHECK_OUT",
    "type_label": "Tidak Sempat Presensi Pulang",
    "requested_check_in_at": null,
    "requested_check_out_at": "2026-10-21T10:05:00+00:00",
    "reason": "Baterai ponsel habis saat jam pulang, sudah lapor ke supervisor gudang.",
    "status": "PENDING",
    "status_label": "Menunggu Persetujuan",
    "submitted_at": "2026-10-25T02:00:00+00:00",
    "decided_at": null,
    "decision_notes": null,
    "approvals": [
      {
        "sequence": 1,
        "stage_name": "Tahap 1",
        "approver": "Anton Satu",
        "status": "PENDING",
        "status_label": "Menunggu Persetujuan",
        "decided_at": null,
        "decided_by": null,
        "notes": null
      },
      {
        "sequence": 2,
        "stage_name": "Tahap 2",
        "approver": "Budi Satu",
        "status": "PENDING",
        "status_label": "Menunggu Persetujuan",
        "decided_at": null,
        "decided_by": null,
        "notes": null
      }
    ]
  }
}
```

Variasi sukses yang direkam (isi `message` dan `data` saja):

Pulang 20:05 pada hari kerja dengan lembur `AFTER_SHIFT` 17:00–20:00 yang disetujui. Diterima karena
jendela diperlebar walau melewati 19:00:

```json
"message": "Pengajuan koreksi presensi terkirim dan menunggu persetujuan Anton Satu.",
"data": {
  "id": 2,
  "work_date": "2026-10-20",
  "type": "MISSING_CHECK_OUT",
  "type_label": "Tidak Sempat Presensi Pulang",
  "requested_check_in_at": null,
  "requested_check_out_at": "2026-10-20T13:05:00+00:00",
  "reason": "Lembur sesudah jam kerja selesai pukul 20.05, lupa presensi pulang.",
  "status": "PENDING",
  "status_label": "Menunggu Persetujuan",
  "submitted_at": "2026-10-25T02:04:00+00:00",
  "decided_at": null,
  "decision_notes": null,
  "approvals": [
    {
      "sequence": 1,
      "stage_name": "Tahap 1",
      "approver": "Anton Satu",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null
    },
    {
      "sequence": 2,
      "stage_name": "Tahap 2",
      "approver": "Budi Satu",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null
    }
  ]
}
```

Lembur hari libur Sabtu 2026-10-24 09:00–13:00, pulang 13:05:

```json
"message": "Pengajuan koreksi presensi terkirim dan menunggu persetujuan Anton Satu.",
"data": {
  "id": 4,
  "work_date": "2026-10-24",
  "type": "MISSING_CHECK_OUT",
  "type_label": "Tidak Sempat Presensi Pulang",
  "requested_check_in_at": null,
  "requested_check_out_at": "2026-10-24T06:05:00+00:00",
  "reason": "Lembur stock opname selesai 13.05, aplikasi tertutup sebelum presensi pulang.",
  "status": "PENDING",
  "status_label": "Menunggu Persetujuan",
  "submitted_at": "2026-10-25T02:08:00+00:00",
  "decided_at": null,
  "decision_notes": null,
  "approvals": [
    {
      "sequence": 1,
      "stage_name": "Tahap 1",
      "approver": "Anton Satu",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null
    },
    {
      "sequence": 2,
      "stage_name": "Tahap 2",
      "approver": "Budi Satu",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null
    }
  ]
}
```

Karyawan tanpa penyetuju berjenjang (tanpa atasan langsung, dan unitnya maupun unit induknya tanpa
Kepala Departemen). Pengajuan **tetap tersimpan** (`201`) dengan satu tahap `Admin HR` yang
`approver`-nya `null`:

```json
"message": "Pengajuan koreksi presensi terkirim dan menunggu persetujuan Admin HR.",
"data": {
  "id": 5,
  "work_date": "2026-10-21",
  "type": "MISSING_CHECK_IN",
  "type_label": "Tidak Sempat Presensi Masuk",
  "requested_check_in_at": "2026-10-21T00:58:00+00:00",
  "requested_check_out_at": null,
  "reason": "Ponsel tertinggal di rumah sehingga tidak presensi masuk.",
  "status": "PENDING",
  "status_label": "Menunggu Persetujuan",
  "submitted_at": "2026-10-25T02:10:00+00:00",
  "decided_at": null,
  "decision_notes": null,
  "approvals": [
    {
      "sequence": 1,
      "stage_name": "Admin HR",
      "approver": null,
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null
    }
  ]
}
```

**Field `data`:** [objek `correction`](#objek-correction).

**Penolakan dan urutan pemeriksaan**

Server memeriksa berurutan dan berhenti pada penolakan pertama. Penolakan aturan bisnis dijawab
**422** dengan `errors.correction`.

| # | HTTP | `message` (direkam bila bertanda ✓) |
|---|---|---|
| 1 | 401 | `Token tidak sah atau sudah kedaluwarsa. Silakan masuk kembali.` |
| 2 | 402 | `Masa langganan perusahaan sudah berakhir dan tagihan belum dibayar. Aplikasi dikunci sampai admin perusahaan melunasi tagihan.` |
| 3 | 422 | ✓ `Data yang dikirim tidak lolos pemeriksaan.` (validasi FormRequest, `errors` per field) |
| 4 | 422 | ✓ `Periode rekap untuk tanggal tersebut sudah dikunci sehingga tidak dapat dikoreksi lagi.` |
| 5 | 422 | ✓ `Tanggal tersebut bukan jadwal masuk Anda, sehingga tidak ada presensi yang perlu dikoreksi.` (hari libur tanpa lembur hari libur disetujui, atau jadwal belum lengkap) |
| 6 | 422 | ✓ `Sudah ada pengajuan koreksi yang menunggu persetujuan untuk tanggal tersebut.` |
| 7 | 422 | ✓ `Jam masuk yang diajukan wajib diisi untuk jenis koreksi ini.` |
| 8 | 422 | `Jam pulang yang diajukan wajib diisi untuk jenis koreksi ini.` |
| 9 | 422 | ✓ `Jam yang diajukan berada di luar rentang shift pada tanggal tersebut.` / `Jam yang diajukan berada di luar rentang jam lembur pada tanggal tersebut.` |
| 10 | 422 | ✓ `Jam pulang harus lebih akhir daripada jam masuk.` |

Validasi (multipart, `work_date: "21-10-2026"`, `type: "LUPA_PULANG"`, `requested_check_out_at: "jam
lima"`, `reason: "Lupa"`, lampiran PDF). `work_date` format `DD-MM-YYYY` lolos validasi `date`:

```json
{
  "success": false,
  "message": "Data yang dikirim tidak lolos pemeriksaan.",
  "errors": {
    "type": [
      "Pilihan pada kolom jenis koreksi tidak sah."
    ],
    "requested_check_out_at": [
      "Kolom jam pulang yang diajukan bukan tanggal yang sah."
    ],
    "reason": [
      "Kolom alasan minimal 10 karakter."
    ],
    "attachment": [
      "Kolom lampiran harus berupa gambar."
    ]
  }
}
```

Penolakan aturan bisnis (Minggu 2026-10-25, tidak dijadwalkan masuk):

```json
{
  "success": false,
  "message": "Tanggal tersebut bukan jadwal masuk Anda, sehingga tidak ada presensi yang perlu dikoreksi.",
  "errors": {
    "correction": [
      "Tanggal tersebut bukan jadwal masuk Anda, sehingga tidak ada presensi yang perlu dikoreksi."
    ]
  }
}
```

Jam masuk 05:00 di luar jendela 06:30–19:00:

```json
{
  "success": false,
  "message": "Jam yang diajukan berada di luar rentang shift pada tanggal tersebut.",
  "errors": {
    "correction": [
      "Jam yang diajukan berada di luar rentang shift pada tanggal tersebut."
    ]
  }
}
```

**Catatan**

- **Satu pengajuan menunggu per tanggal.** Selama ada pengajuan `PENDING` untuk `work_date` yang sama,
  pengajuan baru ditolak (nomor 6). Pengajuan yang sudah `APPROVED`/`REJECTED` tidak menghalangi.
- **Idempotency:** tidak ada kunci idempotency. Aturan nomor 6 mencegah data ganda untuk tanggal yang
  sama, tetapi client tetap wajib menonaktifkan tombol kirim selama request berjalan.
- **Efek persetujuan:** setelah tahap terakhir menyetujui, jam yang diajukan diterapkan ke rekap
  presensi dan status presensi dihitung ulang (terlambat, pulang cepat, lembur hari libur). Lihat
  `GET /attendance/history`.
- **Waktu:** kirim `requested_*_at` dengan offset zona perusahaan (`policy.timezone` di `me/config`).
  Respons selalu UTC.
- Rate limit: tidak ada.
- FeatureGate / modul: `module_attendance_correction` (server tidak memblokir).
- Status langganan: terkunci → 402.
