Xəta kodları

Xətalar üç formada gəlir: autentifikasiya xətaları HTTP 401 kimi, biznes qaydası xətaları HTTP 200 cavabının içində success: false ilə, rezervasiya ötürülməsi xətaları isə BookingPushRS.Error sahəsində. Bu səhifədə bütün kodlar sadalanır.

Autentifikasiya xətaları#

HTTP	Cavab	Səbəb
401	`{"success": false, "error": "Authentication required"}`	Token yoxdur, naməlumdur və ya `Bearer` formatı pozulub.
200	`message: partner_is_not_found`	Giriş: açar cütü uyğun gəlmədi.
200	`message: hotel_is_not_found`	Giriş: `hotelSeoUrl` üzrə otel tapılmadı.
200	`message: hotel_permission_is_not_found`	Giriş: partnyorun bu otel üçün səlahiyyəti yoxdur.

message kodları#

success: false ilə birlikdə qaytarılan snake_case formatlı mətn kodları.

message	Son nöqtə	Təsvir
`hotel_id_is_not_found`	Əksəriyyəti	`hotelID` göndərilməyib.
`start_date_is_not_found` / `end_date_is_not_found`	Mövcudluq	Tarix parametri çatışmır.
`online_cupon_is_not_found`	Kupon	Kod naməlumdur, aktiv deyil, müddəti bitib və ya istifadəyə açıq deyil.
`mail_host_is_not_found`	E-poçt ayarları	Onlayn kanal üçün SMTP konfiqurasiya edilməyib.
`hotel_company_info_could_not_found`	Virtual POS məlumatları	Otel üçün ödəniş provayderi konfiqurasiya edilməyib.
`bank_info_is_not_found`	Ödəniş (3-cü növ)	Onlayn satış üçün aktiv bank hesabı yoxdur.
`required_input_info_not_submitted`	Ödəniş (10-cu növ)	Məcburi sahə çatışmır; hansıların çatışmadığı `errors[]` massivində göstərilir.
`country_info_sent_incorrectly`	Ödəniş (10-cu növ)	`countryID` ölkələr siyahısında yoxdur.
`there_is_missing_info_in_the_shopping_cart`	Ödəniş (10-cu növ)	Səbət elementində `id`, `name`, `piece` və ya `price` çatışmır; `errors[]` həmin elementi göstərir.

Otaq siyahısının xəta kodları#

Otaq siyahısı (POST /external/online/roomType) rəqəmli errorCode və insan üçün oxunaqlı errorMessage qaytarır. Mesaj language parametrinə uyğun olaraq tərcümə edilir; kodunuzu errorCode əsasında yazın.

errorCode	Mənası	Nə etməli
`10001`	Otel tapılmadı	`hotelID` dəyərini yoxlayın.
`10002`	Parametr çatışmır (`hotelID`, `startDate`, `endDate`, `adultCount`)	Məcburi sahələri göndərin.
`10003`	Otel onlayn satış üçün bağlıdır	Otel paneldə onlayn kanalı aktivləşdirməlidir.
`10004`	Kanallar üçün açıq otaq tipi yoxdur	Otel otaq tiplərini onlayn satışa açmalıdır.
`10022`	Parametrlər yanlışdır	Giriş tarixi bu gün və ya daha gec, çıxış tarixi girişdən sonra, ən çox 30 gecə, 1–40 böyük, 0–10 uşaq.
`20001`	Böyüklər üçün kifayət qədər yer yoxdur	Başqa tarixlər və ya qonaq sayı təklif edin.
`20002`	Uşaqlar üçün kifayət qədər yer yoxdur	Uşaq tutumu olan boş otaq qalmayıb.
`20003` / `20004`	Böyüklər və uşaqlar üçün kifayət qədər yer yoxdur	Ümumi tutum sorğunu ödəmir.

Boş otaq olduğu halda konkret otaq tipi satıla bilmirsə, onun roomCount dəyəri 0 olur, səbəbi isə roomRestrictionMessage sahəsində göstərilir: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Rezervasiya ötürülməsi xətaları#

BookingPushRS bu halda Success: true əvəzinə Error sahəsi daşıyır:

Cavab · 200 (xəta)

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

Error	Kod	Səbəb
No available data could be found.	01	Gövdə boşdur və ya JSON təhlil edilə bilmədi; `Bookings[0].hotelID` çatışmır.
Hotel registration not found on HMS.	02	Otel onlayn kanala qoşulmayıb və ya kanal aktiv deyil.
Could not register.	—	Saxlama zamanı xəta (yanlış otaq/qidalanma tipi ID-si, uyğunsuz tarixlər).
Failed to parse information.	—	Strukturda gözlənilən sahələr yoxdur.

Təkrar cəhd tövsiyələri#

401: bir dəfə yenidən daxil olun və sorğunu təkrarlayın.
500 və şəbəkə xətaları: 1 san, 2 san, 4 san fasilə ilə ən çox 3 cəhd. Rezervasiya ötürülməsini təkrarlayarkən eyni ID dəyərindən istifadə edin; mövcud kodla göndərilən Book dublikat yaratmır, qeydi yeniləyir.
success: false: təkrarlamayın; parametri düzəldin və ya qonağa alternativ təklif edin.
Dəstək müraciətlərinə tam sorğunu (gizli açarlar və kart məlumatları maskalanmış halda), cavabı və vaxtı əlavə edin.

Son yenilənmə: 21 sentyabr 2026Səhv tapdınız? Bizə bildirin