Kode error

Error hadir dalam tiga bentuk: error autentikasi sebagai HTTP 401, error aturan bisnis di dalam HTTP 200 dengan success: false, dan error pengiriman reservasi di BookingPushRS.Error. Halaman ini mencantumkan semua kodenya.

Error autentikasi#

HTTP	Respons	Penyebab
401	`{"success": false, "error": "Authentication required"}`	Token tidak ada, tidak dikenal, atau format `Bearer`-nya salah.
200	`message: partner_is_not_found`	Login: pasangan kunci tidak cocok.
200	`message: hotel_is_not_found`	Login: tidak ada hotel untuk `hotelSeoUrl`.
200	`message: hotel_permission_is_not_found`	Login: mitra tidak memiliki otorisasi untuk hotel tersebut.

Kode message#

Kode teks dalam format snake_case, dikembalikan bersama success: false.

message	Endpoint	Deskripsi
`hotel_id_is_not_found`	Sebagian besar	`hotelID` tidak dikirim.
`start_date_is_not_found` / `end_date_is_not_found`	Ketersediaan	Parameter tanggal tidak ada.
`online_cupon_is_not_found`	Kupon	Kode tidak dikenal, tidak aktif, kedaluwarsa, atau tidak tersedia.
`mail_host_is_not_found`	Pengaturan email	SMTP belum dikonfigurasi untuk channel online.
`hotel_company_info_could_not_found`	Detail virtual POS	Belum ada penyedia pembayaran yang dikonfigurasi untuk hotel.
`bank_info_is_not_found`	Pembayaran (jenis 3)	Tidak ada rekening bank yang diaktifkan untuk penjualan online.
`required_input_info_not_submitted`	Pembayaran (jenis 10)	Ada field wajib yang tidak dikirim; `errors[]` mencantumkan field mana saja.
`country_info_sent_incorrectly`	Pembayaran (jenis 10)	`countryID` tidak ada dalam daftar negara.
`there_is_missing_info_in_the_shopping_cart`	Pembayaran (jenis 10)	Ada item keranjang yang tidak memiliki `id`, `name`, `piece`, atau `price`; `errors[]` menunjukkan item tersebut.

Kode error daftar kamar#

Daftar kamar (POST /external/online/roomType) mengembalikan errorCode numerik dan errorMessage yang mudah dibaca. Pesan tersebut diterjemahkan sesuai parameter language; buat logika kode Anda berdasarkan errorCode.

errorCode	Arti	Yang perlu dilakukan
`10001`	Hotel tidak ditemukan	Periksa `hotelID`.
`10002`	Parameter tidak ada (`hotelID`, `startDate`, `endDate`, `adultCount`)	Kirim field yang wajib.
`10003`	Hotel ditutup untuk penjualan online	Hotel harus mengaktifkan channel online di panel.
`10004`	Tidak ada tipe kamar yang dibuka untuk channel	Hotel harus membuka tipe kamar untuk penjualan online.
`10022`	Parameter tidak valid	Check-in hari ini atau setelahnya, check-out setelah check-in, maksimal 30 malam, 1–40 dewasa, 0–10 anak.
`20001`	Ketersediaan untuk dewasa tidak mencukupi	Tawarkan tanggal atau jumlah tamu lain.
`20002`	Ketersediaan untuk anak tidak mencukupi	Tidak ada lagi kamar dengan kapasitas anak.
`20003` / `20004`	Ketersediaan untuk dewasa dan anak tidak mencukupi	Kapasitas total tidak dapat memenuhi permintaan.

Jika ada ketersediaan tetapi tipe kamar tertentu tidak dapat dijual, roomCount-nya bernilai 0 dan alasannya ada di roomRestrictionMessage: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Error pengiriman reservasi#

Alih-alih Success: true, BookingPushRS memuat field Error:

Respons · 200 (error)

{
    "BookingPushRS": {
        "Error": "Could not register.",
        "BookingConfirmNumbers": [
            {
                "confirmTime": 1755500000,
                "bookingID": 0,
                "bookingType": "Book",
                "HMS_ID": null
            }
        ]
    }
}

Error	Kode	Penyebab
No available data could be found.	01	Body kosong atau JSON tidak dapat diurai; `Bookings[0].hotelID` tidak ada.
Hotel registration not found on HMS.	02	Hotel tidak terhubung ke channel online, atau channel tersebut tidak aktif.
Could not register.	—	Terjadi error saat menyimpan (ID tipe kamar/meal plan tidak valid, tanggal tidak konsisten).
Failed to parse information.	—	Strukturnya tidak memiliki field yang diharapkan.

Panduan percobaan ulang#

401: login sekali lagi lalu ulangi permintaan.
500 dan error jaringan: maksimal 3 percobaan dengan jeda 1 dtk, 2 dtk, 4 dtk. Saat mengulang pengiriman reservasi, gunakan kembali ID yang sama; Book dengan kode yang sudah ada akan memperbarui record, bukan membuat duplikat.
success: false: jangan diulang; perbaiki parameternya atau tawarkan alternatif kepada tamu.
Sertakan permintaan lengkap (dengan secret dan data kartu disamarkan), respons, dan waktunya dalam tiket dukungan.

Terakhir diperbarui: 21 September 2026Menemukan kesalahan? Beri tahu kami