# Katalog Kode Galat TRUKCO (dihasilkan oleh: php bin/trukco galat:dokumen)

Kode HTTP berasal dari Kontrak API v1.1b bagian 6.2 (berstatus usulan). Klien mengambil keputusan dari kode, bukan dari pesan.

| Kode | HTTP | Arti |
|---|---|---|
| VALIDASI_GAGAL | 400 | Isian tidak memenuhi aturan; respons memuat daftar bidang dan pesan per bidang. |
| TOKEN_TIDAK_VALID | 401 | Token akses tidak ada, rusak, atau tidak dikenali. |
| TOKEN_KEDALUWARSA | 401 | Token akses kedaluwarsa; klien memakai EP-U06. |
| REFRESH_TIDAK_VALID | 401 | Token refresh tidak dikenal atau sudah dicabut. |
| REFRESH_DIGUNAKAN_ULANG | 401 | Token refresh yang sudah dirotasi dipakai lagi; seluruh rantai token dicabut. |
| KREDENSIAL_SALAH | 401 | Identitas atau kata sandi salah; pesan sengaja tidak menyebut yang mana. |
| TANDA_TANGAN_TIDAK_SAH | 401 | Tanda tangan webhook gateway tidak valid; tidak diproses. |
| AKSES_DITOLAK | 403 | Peran atau kepemilikan tidak mengizinkan (BR-003). |
| AKUN_BELUM_AKTIF | 403 | Akun masih menunggu_otp. |
| AKUN_NONAKTIF | 403 | Akun dinonaktifkan. |
| AKUN_DITANGGUHKAN | 403 | Status pengguna ditangguhkan. |
| AKUN_DIBLOKIR | 403 | Akun diblokir. |
| WAJIB_GANTI_SANDI | 403 | Kata sandi sementara; hanya EP-U09 yang boleh dipanggil. |
| DRIVER_BELUM_DISETUJUI | 403 | Pendaftaran driver belum berstatus disetujui. |
| DRIVER_DITANGGUHKAN | 403 | Driver sedang suspend; tidak boleh Online atau menerima tawaran. |
| DOMPET_DIBEKUKAN | 403 | Dompet berstatus dibekukan. |
| TIDAK_ADA_DATA | 404 | Periode laporan tidak memiliki data. |
| TIDAK_DITEMUKAN | 404 | Sumber daya tidak ada atau bukan milik pemanggil (pesan sama agar tidak membocorkan keberadaan). |
| PENDAFTARAN_BELUM_ADA | 404 | Driver belum pernah mengajukan pendaftaran. |
| DOMPET_TIDAK_ADA | 404 | Dompet pengguna belum dibuat. |
| RUTE_TIDAK_DITEMUKAN | 422 | Layanan peta tidak menemukan rute jalan antara dua titik. |
| IDEMPOTENSI_BENTROK | 409 | Idempotency-Key sama dengan isi permintaan berbeda, atau permintaan pertama masih diproses. |
| STATUS_TIDAK_VALID | 409 | Status objek tidak mengizinkan tindakan. |
| PESANAN_SUDAH_DIAMBIL | 409 | Driver lain sudah menerima pesanan. |
| PESANAN_SUDAH_DIBATALKAN | 409 | Pesanan sudah dibatalkan atau batas waktu terlewati. |
| PESANAN_TIDAK_AKTIF | 409 | Pesanan tidak lagi aktif. |
| PESANAN_MASIH_BERJALAN | 409 | Masih ada pesanan berjalan sehingga tindakan ditolak. |
| PESANAN_BENTROK_PELANGGAN | 409 | Pelanggan memiliki pesanan lain pada jadwal yang tumpang tindih [Usulan]. |
| JADWAL_BENTROK | 409 | Jadwal tumpang tindih dengan pesanan lain driver (BR-033). |
| DP_SUDAH_DIBAYAR | 409 | DP sudah dibayar. |
| DP_BELUM_DIBAYAR | 409 | DP belum dibayar. |
| PELUNASAN_SUDAH_DIBAYAR | 409 | Pelunasan sudah dibayar. |
| PELUNASAN_BELUM_DIBAYAR | 409 | Pelunasan belum dibayar. |
| PENDAFTARAN_SUDAH_ADA | 409 | Pendaftaran driver sudah ada untuk akun ini. |
| REKENING_SEDANG_DIPAKAI | 409 | Rekening dipakai penarikan yang sedang diproses. |
| LAPORAN_SUDAH_ADA | 409 | Laporan jenis yang sama pada pesanan ini sudah dibuat. |
| KEBERATAN_SUDAH_ADA | 409 | Keberatan sudah diajukan pada pesanan ini. |
| RATING_SUDAH_ADA | 409 | Rating sudah diberikan oleh pemanggil. |
| KONTAK_SUDAH_TERDAFTAR | 409 | Nomor HP atau email sudah terpakai; pesan tidak menyebut peran akun yang ada. |
| NIK_SUDAH_TERDAFTAR | 409 | NIK sudah terdaftar aktif atau masuk daftar hitam; pesan tidak merinci. |
| NOPOL_SUDAH_TERDAFTAR | 409 | Nomor polisi sudah terdaftar. |
| HARGA_BBM_SUDAH_ADA | 409 | Harga BBM untuk jenis dan waktu mulai yang sama sudah ada. |
| REKONSILIASI_SUDAH_ADA | 409 | Rekonsiliasi tanggal tersebut sudah ada. |
| DRIVER_SUDAH_DITANGGUHKAN | 409 | Driver sudah berstatus suspend. |
| AKUN_MASIH_BERSALDO | 409 | Penghapusan akun ditunda karena saldo lebih dari Rp0 (BR-070). |
| HARGA_BERUBAH | 409 | Total terhitung berbeda dari total_disetujui; respons memuat rincian baru. |
| KEBIJAKAN_BERUBAH | 409 | Perlakuan dana pembatalan berubah sejak pratinjau (melewati batas 4 jam); respons memuat pratinjau baru. |
| PEMBATALAN_TIDAK_DIIZINKAN | 409 | Status tidak mengizinkan pembatalan (sudah Dalam Perjalanan atau lebih). |
| MASA_KEBERATAN_BERAKHIR | 409 | Masa tunggu finalisasi sudah lewat atau pesanan sudah selesai_final. |
| BATAS_TUNGGU_BELUM_TERCAPAI | 409 | Batas menunggu sebelum lapor pelanggan tidak melunasi belum tercapai (CFG-24). |
| TAWARAN_KEDALUWARSA | 409 | Batas respons driver sudah lewat. |
| DRIVER_TIDAK_ONLINE | 409 | Driver sedang Offline. |
| DRIVER_TIDAK_SIAP | 409 | Driver tidak memenuhi syarat siap (belum disetujui, offline, atau GPS usang). |
| POSISI_TIDAK_AKTIF | 409 | Posisi tidak dikirim atau dibaca di luar status aktif. |
| CHAT_TIDAK_AKTIF | 409 | Chat belum aktif (sebelum DP) atau sudah ditutup. |
| RATING_BELUM_DIBUKA | 409 | Rating dibuka setelah selesai_final. |
| RATING_DITUTUP | 409 | Batas waktu pengisian rating (CFG-29) terlewati. |
| DOKUMEN_KEDALUWARSA | 409 | Dokumen driver kedaluwarsa; Online ditolak sampai diperbarui dan disetujui. |
| DOKUMEN_WAJIB_KURANG | 400 | Dokumen wajib belum lengkap. |
| JADWAL_TERLALU_DEKAT | 422 | Jadwal jemput kurang dari CFG-11 (6 jam) dari waktu server. |
| JARAK_MELEBIHI_BATAS | 422 | Jarak antar lebih dari CFG-02 (1000 km). |
| TIDAK_ADA_TRUK_TERSEDIA | 422 | Tidak ada driver siap dalam radius CFG-01. |
| LOKASI_DI_LUAR_WILAYAH | 422 | Lokasi di luar Jawa, Bali, dan Sumatera (BR-001). |
| PERSETUJUAN_DIPERLUKAN | 422 | Persetujuan data pribadi tidak diberikan (FR-004). |
| IZIN_LOKASI_DITOLAK | 422 | Izin lokasi ditolak sehingga tindakan yang memerlukannya ditolak. |
| SALDO_TIDAK_CUKUP | 422 | Saldo dompet kurang; respons memuat kekurangan. |
| NOMINAL_DI_LUAR_BATAS | 422 | Nominal di luar batas minimum atau maksimum. |
| PARAMETER_BELUM_DITETAPKAN | 422 | Fitur membutuhkan parameter konfigurasi yang masih kosong; respons menyebut kodenya. |
| NILAI_TIDAK_VALID | 422 | Nilai parameter tidak dapat dibaca atau di luar rentang. |
| TANGGAL_DI_MASA_LALU | 422 | Waktu berlaku di masa lalu. |
| ALASAN_WAJIB | 422 | Keputusan wajib disertai alasan (BR-004). |
| REFERENSI_BANK_WAJIB | 422 | Nomor referensi bank wajib. |
| BUKTI_MUTASI_WAJIB | 422 | Bukti mutasi bank wajib (FR-056). |
| BUKTI_TRANSFER_WAJIB | 422 | Bukti transfer wajib (FR-053). |
| DANA_OPERASIONAL_KURANG | 422 | Saldo Dana Operasional tidak cukup untuk kompensasi (FR-055). |
| KOMPENSASI_TIDAK_VALID | 422 | Kompensasi tidak boleh untuk jenis laporan atau pelapor ini. |
| URUTAN_SANKSI_TIDAK_VALID | 422 | Tingkat sanksi tidak sesuai urutan (BR-064). |
| JENIS_LAPORAN_TIDAK_VALID | 422 | Jenis laporan tidak boleh untuk peran atau status pesanan ini. |
| TIDAK_BOLEH_NONAKTIFKAN_DIRI | 422 | Admin tidak dapat menonaktifkan akunnya sendiri. |
| SANDI_LAMA_SALAH | 422 | Kata sandi lama salah. |
| SANDI_TIDAK_MEMENUHI_SYARAT | 422 | Kata sandi tidak memenuhi aturan (aturan belum ditetapkan, FR-002). |
| REKENING_NAMA_TIDAK_COCOK | 422 | Nama rekening tidak sama dengan nama akun (BR-037). |
| REKENING_TIDAK_VALID | 422 | Rekening tidak aktif atau bukan milik pemanggil. |
| OTP_SALAH | 422 | Kode OTP salah. |
| OTP_KEDALUWARSA | 422 | Kode OTP kedaluwarsa. |
| OTP_BATAS_PERCOBAAN | 429 | Batas percobaan OTP tercapai (nilai belum ditetapkan). |
| OTP_TERLALU_SERING | 429 | Permintaan OTP terlalu sering. |
| TERLALU_BANYAK_PERMINTAAN | 429 | Batas laju permintaan tercapai; header Retry-After memuat jeda [Usulan]. |
| BERKAS_TERLALU_BESAR | 413 | Ukuran berkas melebihi batas (batas belum ditetapkan). |
| BERKAS_TIDAK_VALID | 415 | Jenis atau isi berkas tidak dapat diterima. |
| OTP_KIRIM_GAGAL | 502 | Pengiriman OTP gagal pada penyedia SMS atau email. |
| GATEWAY_GAGAL | 502 | Gateway pembayaran gagal menjawab. |
| PAYOUT_GAGAL | 502 | Permintaan payout ke penyedia gagal. |
| LAYANAN_PETA_GAGAL | 502 | Layanan peta (Google Maps) gagal menjawab. |
| PEMELIHARAAN | 503 | Server sedang dalam mode pemeliharaan. |
| KESALAHAN_SERVER | 500 | Kesalahan tak terduga; respons memuat trace_id. |
