Riwayat, detail, pengajuan, dan pembatalan lembur oleh karyawan. Jenis lembur ditentukan server dari jadwal tanggal kerja; client hanya mengirim tanggal dan jam. Konvensi umum ada di README.md; presensi pada hari lembur ada di attendance.md.
| Atribut | Nilai |
|---|---|
| Endpoint | GET /overtimes, POST /overtimes, GET /overtimes/{overtime}, POST /overtimes/{overtime}/cancel |
| Sumber kode | OvertimeController, StoreOvertimeRequest, OvertimeResource, OvertimeService, OvertimeCalculator, OvertimeQuota, OvertimeRealizer, OvertimePricer |
| 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. Jam server dipasang per skenario |
| Data uji | Citra Satu: jam tetap 08:00–17:00 Senin–Jumat, Sabtu–Minggu libur, 2026-10-30 libur perusahaan di Jadwal Kerja. Pengaturan lembur bawaan: minimal 30 menit, pembulatan 15 menit, maks. 4 jam/hari, 18 jam/minggu, mundur maks. 3 hari. Tarif Standar: Rp32.000/jam hari kerja, Rp48.000 libur mingguan, Rp64.000 libur nasional. Alur persetujuan Citra: Tahap 1 Anton Satu (atasan langsung) → Tahap 2 Budi Satu (Kepala Departemen unit Anton, karena Anton tanpa atasan langsung) |
Enum
OvertimeType (overtime_type)
| Nilai | overtime_type_label |
Ditentukan server bila |
|---|---|---|
BEFORE_SHIFT |
Sebelum Jam Kerja | tanggal kerja berjadwal masuk dan jam lembur berakhir paling lambat jam mulai shift |
AFTER_SHIFT |
Sesudah Jam Kerja | tanggal kerja berjadwal masuk dan jam lembur dimulai paling cepat jam selesai shift |
REST_DAY |
Hari Libur Mingguan | Jadwal Kerja tanggal itu berstatus libur (OFF_DUTY) |
HOLIDAY |
Hari Libur Nasional | tanggal itu hari libur (kalender libur atau Jadwal Kerja berstatus HOLIDAY, termasuk libur perusahaan) |
Pada hari kerja, jam yang beririsan dengan jam shift ditolak. Untuk shift malam server mencoba tanggal sebelum/sesudah dan memilih celah terdekat dengan shift.
ApprovalStatus (status)
| Nilai | status_label |
Dapat dibatalkan karyawan |
|---|---|---|
PENDING |
Menunggu Persetujuan | ya |
APPROVED |
Disetujui | ya, hanya sebelum planned_start_at |
REJECTED |
Ditolak | tidak |
CANCELLED |
Dibatalkan | tidak |
Objek overtime
Dipakai seluruh endpoint modul ini. Sumber: OvertimeResource.
| Field | Tipe | Null | Keterangan |
|---|---|---|---|
id |
integer | tidak | ID lembur |
work_date |
string (YYYY-MM-DD) |
tidak | tanggal kerja yang diajukan |
overtime_type |
string (enum) | tidak | OvertimeType, ditentukan server |
overtime_type_label |
string | tidak | label tampilan |
planned_start_at |
string (ISO 8601 UTC) | tidak | jam mulai rencana |
planned_end_at |
string (ISO 8601 UTC) | tidak | jam selesai rencana; bisa tanggal berikutnya bila melewati tengah malam |
planned_minutes |
integer | tidak | durasi rencana dalam menit |
actual_start_at |
string (ISO 8601 UTC) | ya | jam mulai realisasi; null sebelum direalisasi |
actual_end_at |
string (ISO 8601 UTC) | ya | jam selesai realisasi |
actual_minutes |
integer | ya | menit realisasi; null sebelum direalisasi, 0 setelah dibatalkan |
payable_minutes |
integer | ya | menit dibayar = realisasi dibulatkan ke bawah kelipatan policy.overtime.rounding_minutes, tidak melebihi planned_minutes, dan tidak melewati sisa batas harian/mingguan |
hourly_rate |
integer | ya | tarif per jam dalam rupiah bilangan bulat sesuai jenis lembur; null sebelum direalisasi atau bila perusahaan belum mengatur tarif |
amount |
integer | ya | nominal lembur rupiah bilangan bulat = round(payable_minutes × hourly_rate / 60); null bila hourly_rate null |
realized_at |
string (ISO 8601 UTC) | ya | waktu realisasi dicatat |
realization_notes |
string | ya | catatan realisasi |
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 |
decided_at |
string (ISO 8601 UTC) | ya | waktu keputusan akhir |
cancelled_at |
string (ISO 8601 UTC) | ya | waktu pembatalan |
decision_notes |
string | ya | catatan keputusan akhir |
approvals |
array objek | tidak | tahap persetujuan, struktur sama dengan koreksi presensi |
Realisasi dicatat Admin HR (Catat Realisasi) atau dihitung dari presensi oleh perintah
overtime:realize. Sampai realisasi tercatat, field actual_*, payable_minutes, hourly_rate, dan
amount bernilai null. Nominal dibekukan saat realisasi; perubahan tarif sesudahnya tidak mengubah
nominal kecuali Admin HR menjalankan Terapkan ke Lembur.
Riwayat lembur
GET /overtimes
Deskripsi: daftar lembur milik karyawan login, 50 terbaru urut work_date terbaru di atas. Tanpa
pagination dan tanpa filter. Lembur dengan work_date sama tidak dijamin urutannya.
| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | auth:sanctum, EnsureSubscriptionActive |
| Route name | api.v1.overtimes.index |
Header: Accept: application/json, Authorization: Bearer <token>
Parameter: tidak ada.
Contoh Request
GET /api/v1/overtimes HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Contoh Response Sukses (200, 2026-10-24 10:00 WIB, dipotong menjadi 2 dari 6 item)
{
"success": true,
"message": "Riwayat lembur berhasil diambil.",
"data": [
{
"id": 6,
"work_date": "2026-10-30",
"overtime_type": "HOLIDAY",
"overtime_type_label": "Hari Libur Nasional",
"planned_start_at": "2026-10-30T02:00:00+00:00",
"planned_end_at": "2026-10-30T05:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": 0,
"payable_minutes": 0,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Jaga gudang saat libur ulang tahun perusahaan.",
"status": "PENDING",
"status_label": "Menunggu Persetujuan",
"submitted_at": "2026-10-22T03:06:00+00:00",
"decided_at": null,
"cancelled_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
}
]
},
{
"id": 5,
"work_date": "2026-10-25",
"overtime_type": "REST_DAY",
"overtime_type_label": "Hari Libur Mingguan",
"planned_start_at": "2026-10-25T01:00:00+00:00",
"planned_end_at": "2026-10-25T04:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": 0,
"payable_minutes": 0,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Pindahan rak gudang ke area baru.",
"status": "CANCELLED",
"status_label": "Dibatalkan",
"submitted_at": "2026-10-22T03:04:00+00:00",
"decided_at": "2026-10-22T03:20:00+00:00",
"cancelled_at": "2026-10-22T03:25: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-22T03:20: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-22T03:20:00+00:00",
"decided_by": "Budi Satu",
"notes": "Disetujui."
}
]
}
]
}
Field data[]: objek overtime.
Catatan
- Urutan
work_datemenurun, batas 50, tanpameta/links. - Rate limit: tidak ada. Idempotency: tidak relevan.
- FeatureGate / modul:
module_overtime(server tidak memblokir). - Status langganan: terkunci → 402.
Detail lembur
GET /overtimes/{overtime}
Deskripsi: satu lembur milik karyawan login.
| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | auth:sanctum, EnsureSubscriptionActive |
| Route name | api.v1.overtimes.show |
Parameter
| Nama | Lokasi | Tipe | Wajib | Aturan |
|---|---|---|---|---|
overtime |
path | integer | ya | ID lembur |
Contoh Request
GET /api/v1/overtimes/1 HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Contoh Response Sukses (200). Lembur AFTER_SHIFT yang sudah direalisasi: realisasi 185 menit,
dibulatkan 180 menit, tarif hari kerja Rp32.000 → Rp96.000:
{
"success": true,
"message": "Detail lembur berhasil diambil.",
"data": {
"id": 1,
"work_date": "2026-10-20",
"overtime_type": "AFTER_SHIFT",
"overtime_type_label": "Sesudah Jam Kerja",
"planned_start_at": "2026-10-20T10:00:00+00:00",
"planned_end_at": "2026-10-20T13:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": "2026-10-20T10:00:00+00:00",
"actual_end_at": "2026-10-20T13:05:00+00:00",
"actual_minutes": 185,
"payable_minutes": 180,
"hourly_rate": 32000,
"amount": 96000,
"realized_at": "2026-10-22T03:20:00+00:00",
"realization_notes": "Realisasi sesuai catatan supervisor gudang.",
"reason": "Bongkar muat kiriman tambahan dari pelabuhan",
"status": "APPROVED",
"status_label": "Disetujui",
"submitted_at": "2026-10-19T03:00:00+00:00",
"decided_at": "2026-10-19T08:00:00+00:00",
"cancelled_at": null,
"decision_notes": null,
"approvals": []
}
}
Contoh Response Error
| Kondisi | HTTP | message |
|---|---|---|
| Lembur milik karyawan lain di perusahaan yang sama | 403 | Pengajuan lembur ini bukan milik Anda. |
| ID tidak ada atau milik perusahaan lain | 404 | Sumber daya tidak ditemukan. |
| Token tidak sah | 401 | Token tidak sah atau sudah kedaluwarsa. Silakan masuk kembali. |
{
"success": false,
"message": "Pengajuan lembur ini bukan milik Anda.",
"errors": {}
}
Ajukan lembur
POST /overtimes
Deskripsi: mengajukan lembur untuk satu tanggal kerja. Server menentukan jenis, menghitung durasi, memeriksa batas dan irisan, lalu menyusun penyetuju sesuai alur persetujuan.
| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | auth:sanctum, EnsureSubscriptionActive |
| Route name | api.v1.overtimes.store |
Header: Accept: application/json, Authorization: Bearer <token>, Content-Type: application/json
Parameter (StoreOvertimeRequest)
| Nama | Lokasi | Tipe | Wajib | Aturan validasi (FormRequest) |
|---|---|---|---|---|
work_date |
body | string (YYYY-MM-DD) |
ya | required, date. Tanggal kerja; untuk lembur sesudah shift malam, tanggal mulai shift |
start_time |
body | string (HH:mm) |
ya | required, date_format:H:i, 24 jam (17:00, bukan 17.00). Jam lokal zona perusahaan |
end_time |
body | string (HH:mm) |
ya | required, date_format:H:i. Bila tidak lebih akhir dari start_time, dianggap hari berikutnya (22:00–02:00) |
reason |
body | string | ya | required, string, min:10, max:1000 |
overtime_type, planned_minutes, dan nominal tidak dikirim client; nilainya dihitung server.
Contoh Request (2026-10-22 10:00 WIB)
POST /api/v1/overtimes HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Content-Type: application/json
{
"work_date": "2026-10-23",
"start_time": "17:00",
"end_time": "19:00",
"reason": "Menyelesaikan rekap pengiriman akhir pekan."
}
Contoh Response Sukses (201)
{
"success": true,
"message": "Pengajuan lembur terkirim dan menunggu persetujuan Anton Satu.",
"data": {
"id": 3,
"work_date": "2026-10-23",
"overtime_type": "AFTER_SHIFT",
"overtime_type_label": "Sesudah Jam Kerja",
"planned_start_at": "2026-10-23T10:00:00+00:00",
"planned_end_at": "2026-10-23T12:00:00+00:00",
"planned_minutes": 120,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": null,
"payable_minutes": null,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Menyelesaikan rekap pengiriman akhir pekan.",
"status": "PENDING",
"status_label": "Menunggu Persetujuan",
"submitted_at": "2026-10-22T03:00:00+00:00",
"decided_at": null,
"cancelled_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, approvals sama dengan contoh di atas):
Sebelum jam kerja, 06:00–07:30:
"message": "Pengajuan lembur terkirim dan menunggu persetujuan Anton Satu.",
"data": {
"id": 4,
"work_date": "2026-10-23",
"overtime_type": "BEFORE_SHIFT",
"overtime_type_label": "Sebelum Jam Kerja",
"planned_start_at": "2026-10-22T23:00:00+00:00",
"planned_end_at": "2026-10-23T00:30:00+00:00",
"planned_minutes": 90,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": null,
"payable_minutes": null,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Menyiapkan muatan armada pagi sebelum jam kerja.",
"status": "PENDING",
"status_label": "Menunggu Persetujuan",
"submitted_at": "2026-10-22T03:02:00+00:00",
"decided_at": null,
"cancelled_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
}
]
}
Hari Libur Mingguan, Minggu 2026-10-25 08:00–11:00:
"message": "Pengajuan lembur terkirim dan menunggu persetujuan Anton Satu.",
"data": {
"id": 5,
"work_date": "2026-10-25",
"overtime_type": "REST_DAY",
"overtime_type_label": "Hari Libur Mingguan",
"planned_start_at": "2026-10-25T01:00:00+00:00",
"planned_end_at": "2026-10-25T04:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": null,
"payable_minutes": null,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Pindahan rak gudang ke area baru.",
"status": "PENDING",
"status_label": "Menunggu Persetujuan",
"submitted_at": "2026-10-22T03:04:00+00:00",
"decided_at": null,
"cancelled_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
}
]
}
Libur perusahaan di Jadwal Kerja (Jumat 2026-10-30), tercatat HOLIDAY:
"message": "Pengajuan lembur terkirim dan menunggu persetujuan Anton Satu.",
"data": {
"id": 6,
"work_date": "2026-10-30",
"overtime_type": "HOLIDAY",
"overtime_type_label": "Hari Libur Nasional",
"planned_start_at": "2026-10-30T02:00:00+00:00",
"planned_end_at": "2026-10-30T05:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": null,
"payable_minutes": null,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Jaga gudang saat libur ulang tahun perusahaan.",
"status": "PENDING",
"status_label": "Menunggu Persetujuan",
"submitted_at": "2026-10-22T03:06:00+00:00",
"decided_at": null,
"cancelled_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
}
]
}
Field data: objek overtime.
Penolakan dan urutan pemeriksaan
Seluruh penolakan aturan bisnis dijawab 422 dengan errors.overtime.
| # | HTTP | message (direkam bila bertanda ✓) |
|---|---|---|
| 1 | 401 / 402 | token tidak sah / langganan terkunci |
| 2 | 422 | ✓ Data yang dikirim tidak lolos pemeriksaan. (validasi FormRequest) |
| 3 | 422 | schedule_message tanggal itu bila jadwal tidak dapat ditentukan, mis. Karyawan belum memiliki pola shift. Hubungi Admin HR. |
| 4 | 422 | ✓ Jam lembur beririsan dengan jam kerja terjadwal 08:00–17:00. Lembur hanya dihitung di luar jam kerja. |
| 5 | 422 | Jam lembur beririsan dengan shift {nama} pada {tanggal} ({jam mulai}–{jam selesai}). (irisan dengan shift tanggal sebelum/sesudah) |
| 6 | 422 | ✓ Durasi lembur minimal 30 menit, sedangkan pengajuan ini 20 menit. |
| 7 | 422 | ✓ Batas lembur harian 4 jam terlampaui. Pada tanggal 2026-10-23 sudah tercatat 3 jam 30 menit dan pengajuan ini menambah 2 jam. |
| 8 | 422 | Batas lembur mingguan 18 jam terlampaui. Pada minggu tanggal {tanggal} sudah tercatat {durasi}. |
| 9 | 422 | ✓ Sudah ada pengajuan lembur lain yang beririsan jamnya dan belum dibatalkan. |
| 10 | 422 | Tanggal tersebut beririsan dengan pengajuan cuti yang masih berlaku. |
| 11 | 422 | ✓ Periode rekap untuk tanggal tersebut sudah dikunci sehingga tidak dapat diajukan lagi. |
| 12 | 422 | ✓ Lembur hanya dapat diajukan mundur paling lama 3 hari. Ajukan lewat Admin HR untuk tanggal yang lebih lama. |
Batas harian dan mingguan menghitung lembur PENDING dan APPROVED (rencana), bukan yang ditolak
atau dibatalkan. Angka batas mengikuti policy.overtime di me/config.
Validasi (start_time: "17.00", end_time: "7 malam", reason: "Lembur"):
{
"success": false,
"message": "Data yang dikirim tidak lolos pemeriksaan.",
"errors": {
"start_time": [
"Kolom jam mulai tidak sesuai format H:i."
],
"end_time": [
"Kolom jam selesai tidak sesuai format H:i."
],
"reason": [
"Kolom alasan lembur minimal 10 karakter."
]
}
}
Penolakan aturan bisnis (16:00–18:00 pada hari kerja 08:00–17:00):
{
"success": false,
"message": "Jam lembur beririsan dengan jam kerja terjadwal 08:00–17:00. Lembur hanya dihitung di luar jam kerja.",
"errors": {
"overtime": [
"Jam lembur beririsan dengan jam kerja terjadwal 08:00–17:00. Lembur hanya dihitung di luar jam kerja."
]
}
}
Catatan
- Idempotency: tidak ada kunci. Pengajuan kedua untuk jam yang sama ditolak oleh aturan irisan (nomor 9), tetapi client tetap wajib menonaktifkan tombol selama request berjalan.
- Penyetuju disusun server saat pengajuan dibuat dan disimpan pada
approvals; lihat alur persetujuan.messagesukses menyebut penyetuju Tahap 1, atauAdmin HRbila karyawan tidak memiliki penyetuju berjenjang. - Lembur
REST_DAY/HOLIDAYyang disetujui membuka presensi pada hari libur itu; lihat attendance.md. - Rate limit: tidak ada.
- FeatureGate / modul:
module_overtime(server tidak memblokir). - Status langganan: terkunci → 402.
Batalkan lembur
POST /overtimes/{overtime}/cancel
Deskripsi: karyawan membatalkan lembur miliknya. Tahap persetujuan yang belum diputuskan ikut dibatalkan.
| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | auth:sanctum, EnsureSubscriptionActive |
| Route name | api.v1.overtimes.cancel |
Parameter: overtime (path, integer). Tanpa body.
Status yang dapat dibatalkan: PENDING kapan saja; APPROVED hanya selama planned_start_at
belum lewat. REJECTED dan CANCELLED tidak dapat dibatalkan.
Contoh Request
POST /api/v1/overtimes/3/cancel HTTP/1.1
Accept: application/json
Authorization: Bearer <token>
Contoh Response Sukses (200, lembur PENDING)
{
"success": true,
"message": "Pengajuan lembur dibatalkan.",
"data": {
"id": 3,
"work_date": "2026-10-23",
"overtime_type": "AFTER_SHIFT",
"overtime_type_label": "Sesudah Jam Kerja",
"planned_start_at": "2026-10-23T10:00:00+00:00",
"planned_end_at": "2026-10-23T12:00:00+00:00",
"planned_minutes": 120,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": 0,
"payable_minutes": 0,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Menyelesaikan rekap pengiriman akhir pekan.",
"status": "CANCELLED",
"status_label": "Dibatalkan",
"submitted_at": "2026-10-22T03:00:00+00:00",
"decided_at": null,
"cancelled_at": "2026-10-22T03:25:00+00:00",
"decision_notes": null,
"approvals": [
{
"sequence": 1,
"stage_name": "Tahap 1",
"approver": "Anton Satu",
"status": "CANCELLED",
"status_label": "Dibatalkan",
"decided_at": null,
"decided_by": null,
"notes": null
},
{
"sequence": 2,
"stage_name": "Tahap 2",
"approver": "Budi Satu",
"status": "CANCELLED",
"status_label": "Dibatalkan",
"decided_at": null,
"decided_by": null,
"notes": null
}
]
}
}
Lembur APPROVED yang belum dimulai (200, isi message dan data saja):
"message": "Pengajuan lembur dibatalkan.",
"data": {
"id": 5,
"work_date": "2026-10-25",
"overtime_type": "REST_DAY",
"overtime_type_label": "Hari Libur Mingguan",
"planned_start_at": "2026-10-25T01:00:00+00:00",
"planned_end_at": "2026-10-25T04:00:00+00:00",
"planned_minutes": 180,
"actual_start_at": null,
"actual_end_at": null,
"actual_minutes": 0,
"payable_minutes": 0,
"hourly_rate": null,
"amount": null,
"realized_at": null,
"realization_notes": null,
"reason": "Pindahan rak gudang ke area baru.",
"status": "CANCELLED",
"status_label": "Dibatalkan",
"submitted_at": "2026-10-22T03:04:00+00:00",
"decided_at": "2026-10-22T03:20:00+00:00",
"cancelled_at": "2026-10-22T03:25: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-22T03:20: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-22T03:20:00+00:00",
"decided_by": "Budi Satu",
"notes": "Disetujui."
}
]
}
Contoh Response Error (422, errors.overtime)
| Kondisi | message |
|---|---|
Sudah CANCELLED atau REJECTED |
✓ Pengajuan lembur ini sudah berstatus Dibatalkan. |
APPROVED dan planned_start_at sudah lewat |
✓ Lembur yang sudah berjalan atau selesai tidak dapat dibatalkan karyawan. Hubungi Admin HR. |
| Milik karyawan lain (403) | Pengajuan lembur ini bukan milik Anda. |
{
"success": false,
"message": "Lembur yang sudah berjalan atau selesai tidak dapat dibatalkan karyawan. Hubungi Admin HR.",
"errors": {
"overtime": [
"Lembur yang sudah berjalan atau selesai tidak dapat dibatalkan karyawan. Hubungi Admin HR."
]
}
}
Catatan
- Idempotency: memanggil ulang pembatalan dijawab 422
...sudah berstatus Dibatalkan.; anggap sukses di client bila status lokal sudahCANCELLED. - Rate limit: tidak ada. FeatureGate:
module_overtime. Status langganan: terkunci → 402.