# Persetujuan Pengajuan

Daftar dan keputusan pengajuan bagi karyawan yang menjadi **penyetuju** pada alur persetujuan
(atasan langsung atau kepala departemen). Satu item adalah satu **tahap** persetujuan, yaitu satu
baris `approvals[]` pada pengajuan. Aturan siapa menjadi penyetuju ada di
[alur persetujuan](attendance-corrections.md#alur-persetujuan); konvensi umum ada di
[README.md](README.md).

| Atribut | Nilai |
|---|---|
| Endpoint | `GET /approvals`, `GET /approvals/{approval}`, `POST /approvals/{approval}/approve`, `POST /approvals/{approval}/reject` |
| Sumber kode | `ApprovalController`, `IndexApprovalRequest`, `ApproveApprovalRequest`, `RejectApprovalRequest`, `ApprovalTaskResource`, `ApprovalInbox`, `ApprovalService`, service kelima modul pengajuan |
| Contoh direkam | 2026-10-23, HTTP kernel Laravel, basis data SQLite sekali pakai berisi dua perusahaan (`nusantara-logistik` WIB, `borneo-retail` WITA), `APP_LOCALE=id`. Jam server dipasang 2 Des 2026; setiap contoh mencantumkan waktunya |
| Data uji | Pemohon Citra Satu. Alur persetujuan Citra: Tahap 1 Anton Satu → Tahap 2 Budi Satu. Anton Dua dari `borneo-retail` untuk uji perusahaan lain. Klaim komunikasi Rp150.000 dan klaim transportasi Rp95.000 diajukan 2 Des 2026 |

Endpoint ini dipakai **semua karyawan bertoken**, tanpa akun panel. Karyawan yang tidak menjadi
penyetuju mendapat daftar kosong. Keputusan **sebagai Admin HR** (memutuskan tahap milik orang lain)
hanya tersedia di panel, tidak lewat API.

---

## Enum

### `ApprovalFlow` (`type`)

| Nilai | `type_label` | Objek `request` |
|---|---|---|
| `ATTENDANCE_CORRECTION` | Koreksi Presensi | [objek `correction`](attendance-corrections.md#objek-correction) |
| `LEAVE` | Cuti | [objek `leave`](leaves.md#objek-leave) |
| `OVERTIME` | Lembur | [objek `overtime`](overtimes.md#objek-overtime) |
| `BUSINESS_TRIP` | Perjalanan Bisnis | [objek `business_trip`](business-trips.md#objek-business_trip) |
| `REIMBURSEMENT` | Reimbursement | [objek `reimbursement`](reimbursements.md#objek-reimbursement) |

### `ApprovalStatus` (`status`)

Sama dengan [koreksi presensi](attendance-corrections.md#enum):
`PENDING`, `APPROVED`, `REJECTED`, `CANCELLED`.

---

## Objek `task`

| Field | Tipe | Null | Keterangan |
|---|---|---|---|
| `id` | integer | tidak | ID tahap; dipakai pada path `/approvals/{approval}` |
| `type` | string (enum) | tidak | `ApprovalFlow` |
| `type_label` | string | tidak | label tampilan |
| `sequence` | integer | tidak | urutan tahap, mulai 1 |
| `stage_name` | string | tidak | `Tahap 1`, `Tahap 2`, atau nama lama pada pengajuan sebelum 2026-10-23 |
| `status` | string (enum) | tidak | `ApprovalStatus` tahap ini |
| `status_label` | string | tidak | label tampilan |
| `decided_at` | string (ISO 8601 UTC) | ya | waktu tahap ini diputuskan |
| `decided_by` | string | ya | nama yang memutuskan tahap ini |
| `notes` | string | ya | catatan keputusan tahap ini |
| `can_decide` | boolean | tidak | `true` bila karyawan login boleh memutuskan tahap ini **sekarang**: ia penyetujunya, tahap sebelumnya sudah disetujui, dan pengajuan masih menunggu. Tampilkan tombol Setujui/Tolak hanya bila `true` |
| `requester` | objek | tidak | pemohon, lihat tabel di bawah |
| `request` | objek | tidak | pengajuan lengkap sesuai `type`, bentuknya sama dengan endpoint modulnya, termasuk seluruh `approvals[]` |

**`requester`**

| Field | Tipe | Null | Keterangan |
|---|---|---|---|
| `id` | integer | tidak | ID karyawan pemohon |
| `name` | string | tidak | nama |
| `employee_number` | string | ya | nomor karyawan |
| `department` | string | ya | nama departemen |
| `position` | string | ya | nama jabatan |

Lampiran pengajuan (surat dokter, bukti reimbursement, lampiran perjalanan) **tidak** dikembalikan,
sama seperti endpoint modulnya. Penyetuju yang perlu memeriksa lampiran membukanya di panel.

---

## Daftar persetujuan

**`GET /approvals`**

Deskripsi: tahap yang **menunggu keputusan karyawan login** (bawaan), atau riwayat tahap yang sudah
ia putuskan.

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

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

**Parameter**

| Nama | Lokasi | Tipe | Wajib | Aturan |
|---|---|---|---|---|
| `status` | query | string | tidak | `pending` (bawaan) atau `decided` |
| `type` | query | string | tidak | salah satu `ApprovalFlow`; kosong berarti semua jenis |

| `status` | Isi | Urutan |
|---|---|---|
| `pending` | tahap yang penyetujunya karyawan login, berstatus `PENDING`, tahap sebelumnya sudah disetujui, dan pengajuannya masih `PENDING` | paling lama dibuat di atas, maks. 50 |
| `decided` | tahap yang `decided_by`-nya karyawan login (disetujui atau ditolak) | paling baru diputuskan di atas, maks. 50 |

Tahap 2 **tidak** muncul pada daftar `pending` selama Tahap 1 belum menyetujui.

**Contoh Request**

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

**Contoh Response Sukses** (`200`, 2026-12-02 09:00 WIB, Anton Satu sebagai Tahap 1; dipotong menjadi 1 dari 6 item)

```json
{
  "success": true,
  "message": "Daftar pengajuan yang menunggu persetujuan Anda berhasil diambil.",
  "data": [
    {
      "id": 12,
      "type": "OVERTIME",
      "type_label": "Lembur",
      "sequence": 1,
      "stage_name": "Tahap 1",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null,
      "can_decide": true,
      "requester": {
        "id": 3,
        "name": "Citra Satu",
        "employee_number": "EMP-0007",
        "department": "Divisi Operasional",
        "position": "Spesialis"
      },
      "request": {
        "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": 0,
        "payable_minutes": 0,
        "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
          }
        ]
      }
    }
  ]
}
```

Budi Satu (Tahap 2) dengan `type=REIMBURSEMENT` sebelum Anton menyetujui: daftar kosong.

```json
{
  "success": true,
  "message": "Daftar pengajuan yang menunggu persetujuan Anda berhasil diambil.",
  "data": []
}
```

Setelah Anton menyetujui Tahap 1 (2026-12-02 09:10 WIB):

```json
{
  "success": true,
  "message": "Daftar pengajuan yang menunggu persetujuan Anda berhasil diambil.",
  "data": [
    {
      "id": 31,
      "type": "REIMBURSEMENT",
      "type_label": "Reimbursement",
      "sequence": 2,
      "stage_name": "Tahap 2",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "decided_at": null,
      "decided_by": null,
      "notes": null,
      "can_decide": true,
      "requester": {
        "id": 3,
        "name": "Citra Satu",
        "employee_number": "EMP-0007",
        "department": "Divisi Operasional",
        "position": "Spesialis"
      },
      "request": {
        "id": 3,
        "number": "RMB-202612-0001",
        "category": {
          "id": 5,
          "name": "Komunikasi",
          "category_type": "COMMUNICATION"
        },
        "business_trip_id": null,
        "expense_date": "2026-12-01",
        "amount": 150000,
        "approved_amount": 0,
        "description": "Paket data seluler bulan Desember untuk koordinasi lapangan.",
        "status": "PENDING",
        "status_label": "Menunggu Persetujuan",
        "is_paid": false,
        "paid_at": null,
        "payment_reference": null,
        "submitted_at": "2026-12-02T01:00:00+00:00",
        "decided_at": null,
        "cancelled_at": null,
        "decision_notes": null,
        "approvals": [
          {
            "sequence": 1,
            "stage_name": "Tahap 1",
            "approver": "Anton Satu",
            "status": "APPROVED",
            "status_label": "Disetujui",
            "decided_at": "2026-12-02T02:10:00+00:00",
            "decided_by": "Anton Satu",
            "notes": "Sesuai paket data perusahaan."
          },
          {
            "sequence": 2,
            "stage_name": "Tahap 2",
            "approver": "Budi Satu",
            "status": "PENDING",
            "status_label": "Menunggu Persetujuan",
            "decided_at": null,
            "decided_by": null,
            "notes": null
          }
        ]
      }
    }
  ]
}
```

Riwayat keputusan Anton (`status=decided&type=REIMBURSEMENT`, 2026-12-02 10:05 WIB, dipotong menjadi 1 dari 3 item):

```json
{
  "success": true,
  "message": "Riwayat keputusan persetujuan Anda berhasil diambil.",
  "data": [
    {
      "id": 32,
      "type": "REIMBURSEMENT",
      "type_label": "Reimbursement",
      "sequence": 1,
      "stage_name": "Tahap 1",
      "status": "REJECTED",
      "status_label": "Ditolak",
      "decided_at": "2026-12-02T03:05:00+00:00",
      "decided_by": "Anton Satu",
      "notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek.",
      "can_decide": false,
      "requester": {
        "id": 3,
        "name": "Citra Satu",
        "employee_number": "EMP-0007",
        "department": "Divisi Operasional",
        "position": "Spesialis"
      },
      "request": {
        "id": 4,
        "number": "RMB-202612-0002",
        "category": {
          "id": 1,
          "name": "Transportasi",
          "category_type": "TRANSPORT"
        },
        "business_trip_id": null,
        "expense_date": "2026-12-01",
        "amount": 95000,
        "approved_amount": 0,
        "description": "Ojek dari gudang Cakung ke kantor pelanggan untuk serah terima dokumen.",
        "status": "REJECTED",
        "status_label": "Ditolak",
        "is_paid": false,
        "paid_at": null,
        "payment_reference": null,
        "submitted_at": "2026-12-02T01:02:00+00:00",
        "decided_at": "2026-12-02T03:05:00+00:00",
        "cancelled_at": null,
        "decision_notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek.",
        "approvals": [
          {
            "sequence": 1,
            "stage_name": "Tahap 1",
            "approver": "Anton Satu",
            "status": "REJECTED",
            "status_label": "Ditolak",
            "decided_at": "2026-12-02T03:05:00+00:00",
            "decided_by": "Anton Satu",
            "notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek."
          },
          {
            "sequence": 2,
            "stage_name": "Tahap 2",
            "approver": "Budi Satu",
            "status": "CANCELLED",
            "status_label": "Dibatalkan",
            "decided_at": null,
            "decided_by": null,
            "notes": null
          }
        ]
      }
    }
  ]
}
```

Validasi (`status=semua`, `type=CUTI`):

```json
{
  "success": false,
  "message": "Data yang dikirim tidak lolos pemeriksaan.",
  "errors": {
    "status": [
      "Pilihan pada kolom status daftar tidak sah."
    ],
    "type": [
      "Pilihan pada kolom jenis pengajuan tidak sah."
    ]
  }
}
```

**Catatan**

- Tanpa pagination dan tanpa `meta`/`links`. Belum ada notifikasi push; segarkan daftar saat aplikasi
  dibuka dan saat pengguna menarik layar.
- Rate limit: tidak ada. FeatureGate / modul: server tidak memblokir.
- Status langganan: terkunci → 402.

---

## Detail tahap

**`GET /approvals/{approval}`**

Deskripsi: satu tahap beserta pengajuannya. Hanya penyetuju tahap itu atau orang yang memutuskannya
yang boleh membuka.

| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | `auth:sanctum`, `EnsureSubscriptionActive` |
| Route name | `api.v1.approvals.show` |

**Parameter**

| Nama | Lokasi | Tipe | Wajib | Aturan |
|---|---|---|---|---|
| `approval` | path | integer | ya | `id` dari objek `task` |

**Contoh Request**

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

**Contoh Response Sukses** (`200`, 2026-12-02 09:00 WIB)

```json
{
  "success": true,
  "message": "Detail tahap persetujuan berhasil diambil.",
  "data": {
    "id": 30,
    "type": "REIMBURSEMENT",
    "type_label": "Reimbursement",
    "sequence": 1,
    "stage_name": "Tahap 1",
    "status": "PENDING",
    "status_label": "Menunggu Persetujuan",
    "decided_at": null,
    "decided_by": null,
    "notes": null,
    "can_decide": true,
    "requester": {
      "id": 3,
      "name": "Citra Satu",
      "employee_number": "EMP-0007",
      "department": "Divisi Operasional",
      "position": "Spesialis"
    },
    "request": {
      "id": 3,
      "number": "RMB-202612-0001",
      "category": {
        "id": 5,
        "name": "Komunikasi",
        "category_type": "COMMUNICATION"
      },
      "business_trip_id": null,
      "expense_date": "2026-12-01",
      "amount": 150000,
      "approved_amount": 0,
      "description": "Paket data seluler bulan Desember untuk koordinasi lapangan.",
      "status": "PENDING",
      "status_label": "Menunggu Persetujuan",
      "is_paid": false,
      "paid_at": null,
      "payment_reference": null,
      "submitted_at": "2026-12-02T01: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
        }
      ]
    }
  }
}
```

**Contoh Response Error**

| Kondisi | HTTP | `message` |
|---|---|---|
| Bukan penyetuju dan bukan pemutus tahap itu, termasuk pemohon sendiri | 403 | `Tahap persetujuan 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.` |

```json
{
  "success": false,
  "message": "Tahap persetujuan ini bukan milik Anda.",
  "errors": {}
}
```

---

## Setujui tahap

**`POST /approvals/{approval}/approve`**

Deskripsi: menyetujui tahap yang sedang berjalan. Bila masih ada tahap berikutnya, pengajuan diteruskan;
bila ini tahap terakhir, pengajuan menjadi `APPROVED` dan efeknya diterapkan sama seperti keputusan di
panel (koreksi diterapkan ke rekap presensi, saldo cuti terpakai, perjalanan bisnis membebaskan
geofence, lembur membuka presensi hari libur, nominal reimbursement ditetapkan).

| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | `auth:sanctum`, `EnsureSubscriptionActive` |
| Route name | `api.v1.approvals.approve` |

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

**Body**

| Nama | Tipe | Wajib | Aturan |
|---|---|---|---|
| `notes` | string | tidak | maks. 1000 karakter; terbaca pemohon |
| `approved_amount` | integer | tidak | min. 1; **hanya untuk `REIMBURSEMENT`**, diabaikan jenis lain |

`approved_amount` disimpan pada **tahap terakhir** (Tahap 2, atau Tahap 1 bila alurnya satu tahap).
Pada tahap sebelumnya nilai tetap diperiksa (tidak boleh melebihi nominal klaim) tetapi tidak disimpan.
Bila tidak dikirim pada tahap terakhir, nominal klaim penuh yang disetujui.

**Contoh Request** (Tahap 1, 2026-12-02 09:10 WIB)

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

{
  "notes": "Sesuai paket data perusahaan."
}
```

**Contoh Response Sukses** (`200`). `data` adalah objek `task` setelah diputuskan:

```json
"message": "Disetujui pada tahap Tahap 1. Pengajuan diteruskan ke tahap berikutnya.",
"data": {
  "id": 30,
  "type": "REIMBURSEMENT",
  "type_label": "Reimbursement",
  "sequence": 1,
  "stage_name": "Tahap 1",
  "status": "APPROVED",
  "status_label": "Disetujui",
  "decided_at": "2026-12-02T02:10:00+00:00",
  "decided_by": "Anton Satu",
  "notes": "Sesuai paket data perusahaan.",
  "can_decide": false,
  "requester": {
    "id": 3,
    "name": "Citra Satu",
    "employee_number": "EMP-0007",
    "department": "Divisi Operasional",
    "position": "Spesialis"
  },
  "request": {
    "id": 3,
    "number": "RMB-202612-0001",
    "category": {
      "id": 5,
      "name": "Komunikasi",
      "category_type": "COMMUNICATION"
    },
    "business_trip_id": null,
    "expense_date": "2026-12-01",
    "amount": 150000,
    "approved_amount": 0,
    "description": "Paket data seluler bulan Desember untuk koordinasi lapangan.",
    "status": "PENDING",
    "status_label": "Menunggu Persetujuan",
    "is_paid": false,
    "paid_at": null,
    "payment_reference": null,
    "submitted_at": "2026-12-02T01:00:00+00:00",
    "decided_at": null,
    "cancelled_at": null,
    "decision_notes": null,
    "approvals": [
      {
        "sequence": 1,
        "stage_name": "Tahap 1",
        "approver": "Anton Satu",
        "status": "APPROVED",
        "status_label": "Disetujui",
        "decided_at": "2026-12-02T02:10:00+00:00",
        "decided_by": "Anton Satu",
        "notes": "Sesuai paket data perusahaan."
      },
      {
        "sequence": 2,
        "stage_name": "Tahap 2",
        "approver": "Budi Satu",
        "status": "PENDING",
        "status_label": "Menunggu Persetujuan",
        "decided_at": null,
        "decided_by": null,
        "notes": null
      }
    ]
  }
}
```

Tahap terakhir oleh Budi Satu dengan nominal sebagian (2026-12-02 10:00 WIB):

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

{
  "approved_amount": 125000,
  "notes": "Disetujui Rp125.000 sesuai plafon paket data."
}
```

```json
{
  "success": true,
  "message": "Disetujui pada tahap Tahap 2. Seluruh tahap persetujuan selesai.",
  "data": {
    "id": 31,
    "type": "REIMBURSEMENT",
    "type_label": "Reimbursement",
    "sequence": 2,
    "stage_name": "Tahap 2",
    "status": "APPROVED",
    "status_label": "Disetujui",
    "decided_at": "2026-12-02T03:00:00+00:00",
    "decided_by": "Budi Satu",
    "notes": "Disetujui Rp125.000 sesuai plafon paket data.",
    "can_decide": false,
    "requester": {
      "id": 3,
      "name": "Citra Satu",
      "employee_number": "EMP-0007",
      "department": "Divisi Operasional",
      "position": "Spesialis"
    },
    "request": {
      "id": 3,
      "number": "RMB-202612-0001",
      "category": {
        "id": 5,
        "name": "Komunikasi",
        "category_type": "COMMUNICATION"
      },
      "business_trip_id": null,
      "expense_date": "2026-12-01",
      "amount": 150000,
      "approved_amount": 125000,
      "description": "Paket data seluler bulan Desember untuk koordinasi lapangan.",
      "status": "APPROVED",
      "status_label": "Disetujui",
      "is_paid": false,
      "paid_at": null,
      "payment_reference": null,
      "submitted_at": "2026-12-02T01:00:00+00:00",
      "decided_at": "2026-12-02T03:00:00+00:00",
      "cancelled_at": null,
      "decision_notes": "Disetujui Rp125.000 sesuai plafon paket data.",
      "approvals": [
        {
          "sequence": 1,
          "stage_name": "Tahap 1",
          "approver": "Anton Satu",
          "status": "APPROVED",
          "status_label": "Disetujui",
          "decided_at": "2026-12-02T02:10:00+00:00",
          "decided_by": "Anton Satu",
          "notes": "Sesuai paket data perusahaan."
        },
        {
          "sequence": 2,
          "stage_name": "Tahap 2",
          "approver": "Budi Satu",
          "status": "APPROVED",
          "status_label": "Disetujui",
          "decided_at": "2026-12-02T03:00:00+00:00",
          "decided_by": "Budi Satu",
          "notes": "Disetujui Rp125.000 sesuai plafon paket data."
        }
      ]
    }
  }
}
```

**Penolakan dan urutan pemeriksaan** (422, `errors.approval` kecuali disebut lain)

| # | HTTP | `message` (direkam bila bertanda ✓) |
|---|---|---|
| 1 | 401 / 402 | token tidak sah / langganan terkunci |
| 2 | 404 | ✓ `Sumber daya tidak ditemukan.` (ID tidak ada atau milik perusahaan lain) |
| 3 | 403 | ✓ `Tahap persetujuan ini bukan milik Anda.` (bukan penyetuju dan bukan pemutus tahap itu) |
| 4 | 422 | `Data yang dikirim tidak lolos pemeriksaan.` (validasi FormRequest, `errors` per field) |
| 5 | 422 | `Anda bukan penyetuju pada tahap ini. Keputusan sebagai Admin HR hanya dapat diambil lewat panel.` |
| 6 | 422 | ✓ `Tahap ini sudah diputuskan.` |
| 7 | 422 | `Pengajuan ini sudah tidak menunggu persetujuan.` (dibatalkan pemohon atau dicabut Admin HR) |
| 8 | 422 | ✓ `Tahap sebelumnya belum diputuskan, sehingga tahap ini belum dapat diputuskan.` |
| 9 | 422 | `Nominal yang disetujui tidak boleh melebihi nominal klaim.` (`REIMBURSEMENT`) |

Tahap 2 dikirim sebelum Tahap 1 menyetujui:

```json
{
  "success": false,
  "message": "Tahap sebelumnya belum diputuskan, sehingga tahap ini belum dapat diputuskan.",
  "errors": {
    "approval": [
      "Tahap sebelumnya belum diputuskan, sehingga tahap ini belum dapat diputuskan."
    ]
  }
}
```

**Catatan**

- **Idempotency:** keputusan kedua pada tahap yang sama ditolak (nomor 6), sehingga tombol yang
  tertekan dua kali tidak menggandakan keputusan. Client tetap menonaktifkan tombol selama request
  berjalan.
- Setelah sukses, segarkan `GET /approvals`; tahap yang sudah diputuskan hilang dari daftar `pending`.
- Rate limit: tidak ada.

---

## Tolak tahap

**`POST /approvals/{approval}/reject`**

Deskripsi: menolak tahap yang sedang berjalan. Penolakan **final**: pengajuan menjadi `REJECTED` dan tahap
berikutnya `CANCELLED`. Saldo cuti yang dipesan dikembalikan.

| Auth & Middleware | |
|---|---|
| Token | wajib |
| Middleware | `auth:sanctum`, `EnsureSubscriptionActive` |
| Route name | `api.v1.approvals.reject` |

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

**Body**

| Nama | Tipe | Wajib | Aturan |
|---|---|---|---|
| `notes` | string | ya | maks. 1000 karakter; alasan penolakan, terbaca pemohon |

**Contoh Request** (2026-12-02 10:05 WIB)

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

{
  "notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek."
}
```

**Contoh Response Sukses** (`200`)

```json
{
  "success": true,
  "message": "Ditolak pada tahap Tahap 1.",
  "data": {
    "id": 32,
    "type": "REIMBURSEMENT",
    "type_label": "Reimbursement",
    "sequence": 1,
    "stage_name": "Tahap 1",
    "status": "REJECTED",
    "status_label": "Ditolak",
    "decided_at": "2026-12-02T03:05:00+00:00",
    "decided_by": "Anton Satu",
    "notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek.",
    "can_decide": false,
    "requester": {
      "id": 3,
      "name": "Citra Satu",
      "employee_number": "EMP-0007",
      "department": "Divisi Operasional",
      "position": "Spesialis"
    },
    "request": {
      "id": 4,
      "number": "RMB-202612-0002",
      "category": {
        "id": 1,
        "name": "Transportasi",
        "category_type": "TRANSPORT"
      },
      "business_trip_id": null,
      "expense_date": "2026-12-01",
      "amount": 95000,
      "approved_amount": 0,
      "description": "Ojek dari gudang Cakung ke kantor pelanggan untuk serah terima dokumen.",
      "status": "REJECTED",
      "status_label": "Ditolak",
      "is_paid": false,
      "paid_at": null,
      "payment_reference": null,
      "submitted_at": "2026-12-02T01:02:00+00:00",
      "decided_at": "2026-12-02T03:05:00+00:00",
      "cancelled_at": null,
      "decision_notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek.",
      "approvals": [
        {
          "sequence": 1,
          "stage_name": "Tahap 1",
          "approver": "Anton Satu",
          "status": "REJECTED",
          "status_label": "Ditolak",
          "decided_at": "2026-12-02T03:05:00+00:00",
          "decided_by": "Anton Satu",
          "notes": "Nota tidak mencantumkan tanggal. Ajukan ulang dengan bukti dari aplikasi ojek."
        },
        {
          "sequence": 2,
          "stage_name": "Tahap 2",
          "approver": "Budi Satu",
          "status": "CANCELLED",
          "status_label": "Dibatalkan",
          "decided_at": null,
          "decided_by": null,
          "notes": null
        }
      ]
    }
  }
}
```

**Penolakan:** sama dengan [setujui tahap](#setujui-tahap) nomor 1–8. Validasi tanpa alasan:

```json
{
  "success": false,
  "message": "Data yang dikirim tidak lolos pemeriksaan.",
  "errors": {
    "notes": [
      "Kolom alasan penolakan wajib diisi."
    ]
  }
}
```

---

## Hasil keputusan di sisi pemohon

Pemohon tidak memakai endpoint ini. Hasilnya terbaca di endpoint modul, mis. `GET /reimbursements/{id}`
milik Citra Satu setelah Budi Satu menyetujui (2026-12-02 10:05 WIB):

```json
{
  "id": 3,
  "number": "RMB-202612-0001",
  "category": {
    "id": 5,
    "name": "Komunikasi",
    "category_type": "COMMUNICATION"
  },
  "business_trip_id": null,
  "expense_date": "2026-12-01",
  "amount": 150000,
  "approved_amount": 125000,
  "description": "Paket data seluler bulan Desember untuk koordinasi lapangan.",
  "status": "APPROVED",
  "status_label": "Disetujui",
  "is_paid": false,
  "paid_at": null,
  "payment_reference": null,
  "submitted_at": "2026-12-02T01:00:00+00:00",
  "decided_at": "2026-12-02T03:00:00+00:00",
  "cancelled_at": null,
  "decision_notes": "Disetujui Rp125.000 sesuai plafon paket data.",
  "approvals": [
    {
      "sequence": 1,
      "stage_name": "Tahap 1",
      "approver": "Anton Satu",
      "status": "APPROVED",
      "status_label": "Disetujui",
      "decided_at": "2026-12-02T02:10:00+00:00",
      "decided_by": "Anton Satu",
      "notes": "Sesuai paket data perusahaan."
    },
    {
      "sequence": 2,
      "stage_name": "Tahap 2",
      "approver": "Budi Satu",
      "status": "APPROVED",
      "status_label": "Disetujui",
      "decided_at": "2026-12-02T03:00:00+00:00",
      "decided_by": "Budi Satu",
      "notes": "Disetujui Rp125.000 sesuai plafon paket data."
    }
  ]
}
```
