Hata kodları

Hatalar üç biçimde gelir: kimlik doğrulama hataları HTTP 401, iş kuralı hataları HTTP 200 içinde success: false ile ve rezervasyon aktarımında BookingPushRS.Error ile. Bu sayfa tüm kodları listeler.

Kimlik doğrulama hataları#

HTTP	Yanıt	Neden
401	`{"success": false, "error": "Authentication required"}`	Token yok, tanınmıyor veya `Bearer` biçimi bozuk.
200	`message: partner_is_not_found`	Giriş: anahtar çifti eşleşmedi.
200	`message: hotel_is_not_found`	Giriş: `hotelSeoUrl` ile otel bulunamadı.
200	`message: hotel_permission_is_not_found`	Giriş: iş ortağının otel için yetkisi yok.

message kodları#

Snake_case metin kodlarıdır; success: false ile birlikte gelir.

message	Uç nokta	Açıklama
`hotel_id_is_not_found`	Çoğu	`hotelID` gönderilmedi.
`start_date_is_not_found` / `end_date_is_not_found`	Müsaitlik	Tarih parametresi eksik.
`online_cupon_is_not_found`	Kupon	Kod yok, pasif, süresi dolmuş veya kullanıma kapalı.
`mail_host_is_not_found`	E-posta ayarları	Otel için online kanal SMTP tanımı yok.
`hotel_company_info_could_not_found`	Sanal POS bilgisi	Otel için ödeme sağlayıcı tanımı yok.
`bank_info_is_not_found`	Ödeme (tip 3)	Online satışa açık banka hesabı tanımlı değil.
`required_input_info_not_submitted`	Ödeme (tip 10)	Zorunlu alan eksik; `errors[]` hangi alanların eksik olduğunu listeler.
`country_info_sent_incorrectly`	Ödeme (tip 10)	`countryID` ülke listesinde yok.
`there_is_missing_info_in_the_shopping_cart`	Ödeme (tip 10)	Sepet öğesinde `id`, `name`, `piece` veya `price` eksik; `errors[]` öğeyi gösterir.

Oda listesi hata kodları#

Oda listesi (POST /external/online/roomType) sayısal errorCode ve okunur errorMessage döner. Mesaj metni language parametresine göre çevrilir; kodunuzu errorCode alanına göre yazın.

errorCode	Anlamı	Ne yapmalı
`10001`	Otel bulunamadı	`hotelID` değerini kontrol edin.
`10002`	Eksik parametre (`hotelID`, `startDate`, `endDate`, `adultCount`)	Zorunlu alanları gönderin.
`10003`	Otel online satışa kapalı	Otelin panelde online kanalı etkinleştirmesi gerekir.
`10004`	Kanallara açık oda tipi yok	Otelin oda tiplerini online satışa açması gerekir.
`10022`	Parametreler geçersiz	Giriş tarihi bugün veya sonrası, çıkış girişten sonra, en fazla 30 gece, 1–40 yetişkin, 0–10 çocuk.
`20001`	Yeterli yetişkin müsaitliği yok	Misafire tarih veya kişi sayısı değiştirmesini önerin.
`20002`	Yeterli çocuk müsaitliği yok	Çocuk kapasitesi olan oda kalmamış.
`20003` / `20004`	Yeterli yetişkin ve çocuk müsaitliği yok	Toplam kapasite talebi karşılamıyor.

Müsaitlik olduğu halde belirli bir oda tipi satılamıyorsa oda öğesindeki roomCount 0 olur ve nedeni roomRestrictionMessage alanında gelir: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Rezervasyon aktarımı hataları#

BookingPushRS içinde Success: true yerine Error alanı döner:

Yanıt · 200 (hata)

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

Error	Kod	Neden
No available data could be found.	01	Gövde boş ya da JSON ayrıştırılamadı; `Bookings[0].hotelID` yok.
Hotel registration not found on HMS.	02	Otel, online kanala bağlı değil veya kanal pasif.
Could not register.	—	Kayıt sırasında hata (oda/konaklama tipi kimliği geçersiz, tarih tutarsız).
Failed to parse information.	—	Yapı beklenen alanları içermiyor.

Yeniden deneme önerileri#

401: Bir kez yeniden giriş yapıp isteği tekrarlayın.
500 ve ağ hataları: 1 s, 2 s, 4 s aralıklarla en fazla 3 deneme. Rezervasyon aktarımını tekrarlarken aynı ID değerini kullanın; aynı kodla gelen Book isteği yeni kayıt açmak yerine mevcut kaydı günceller.
success: false: Tekrar denemeyin; parametreyi düzeltin veya misafire seçenek sunun.
Destek taleplerinde isteğin tam gövdesini (kart verisi ve gizli anahtarlar maskelenmiş), yanıtı ve zamanı ekleyin.

Son güncelleme: 8 Eylül 2026Bu sayfada bir hata mı var? Bize yazın