Rezervasiya

Qonağın seçdiyi otaq, qidalanma tipi və qiymət BookingPushRQ strukturu ilə HMS-ə ötürülür. Eyni son nöqtə type sahəsində Cancel və ya Modify göndərməklə ləğv və dəyişikliklər üçün də istifadə olunur. Başdan-sona proses üçün Rezervasiya axını bələdçisinə baxın.

POST/external/online/channel/bookingRezervasiyanın ötürülməsi (BookingPushRQ)

Rezervasiyanın ötürülməsi (BookingPushRQ)#

POST/external/online/channel/booking

Autentifikasiya: Authorization: Bearer · Gövdə: application/json

Bir və ya bir neçə rezervasiyanı HMS-də qeydə alır. ID sizin tərəfinizdə yaradılan unikal rezervasiya kodudur; eyni ID ilə Modify göndərmək qeydi yeniləyir, Cancel isə onu ləğv edir. Eyni otaq tipi və qidalanma tipindən bir neçə otaq satıldıqda hər otaq NumberOfUnits dəyəri 1, 2, 3… olan ayrıca RoomStays elementidir.

Kredit kartı (9) ödəniş növündə kart məlumatları PaymentCard altında göndərilir; digər ödəniş növlərində bu sahəni göndərməyin. Kart məlumatlarını emal etdiyiniz üçün PCI DSS tələblərinə tabe olursunuz.

Sorğu gövdəsi

BookingPushRQ.Bookings[]object[]məcburi
Rezervasiyaların siyahısı. Adətən bir element olur.
hotelIDstringməcburi
Otel ID-si.
IDstringməcburi
Sizin sisteminizdəki unikal rezervasiya kodu. Vauçer nömrəsi kimi də saxlanılır.
typestringməcburi
Əməliyyat növü.
BookModifyCancel
createDateTimedatetime
Rezervasiyanın yaradılma vaxtı (ISO 8601).
checkinDate / checkoutDatedateməcburi
Giriş və çıxış tarixləri, YYYY-MM-DD.
RoomStays[]object[]məcburi
Satılan otaqlar.
roomTypeIDstringməcburi
Otaq siyahısındakı items[].id.
roomNamestring
Otaq tipinin adı (məlumat üçün).
ratePlanIDstringməcburi
Otaq siyahısındakı accommodationTypes[].id.
ratePlanNamestring
Qidalanma tipinin adı (məlumat üçün).
typestring
Otaq üçün əməliyyat növü.
BookModifyCancel
NumberOfUnitsstringməcburi
Eyni otaq/qidalanma tipli otaqların sıra nömrəsi: 1, 2, 3…
checkinDate / checkoutDatedateməcburi
Otağın giriş və çıxış tarixləri.
GuestCountobjectməcburi
adult və child sayları.
PerDayRatesobject
currency və PerDayRate[]: stayDate, baseRate, hotelServiceFees.
Totalobjectməcburi
Otaq üzrə cəmi: amountAfterTaxes, amountOfTaxes, currency.
PaymentCardobject
Yalnız 9 (kredit kartı) ödəniş növü üçün. CardHolder{fullname, address, country, city}, cardNumber, expireDate (MMYY), cardCode, seriesCode (CVV).
PrimaryGuests[]object[]məcburi
Əsas qonaq(lar): name, surname, PhoneNumber, email, CountryCode.
ChildGuests[]object[]
Uşaqlar. age məcburidir; name, surname, year, date, detail ixtiyaridir.
SpecialRequest[]object[]
Qonaq qeydləri və ləğv şərtləri: text. Rezervasiyanın qeydlərinə birləşdirilir.
extras[]object[]
Satılan əlavə xidmətlər/paketlər: name, note, person, piece, price, priceMode, priceTotal, stockID (paket siyahısındakı id).
Totalobjectməcburi
Yekun məbləğ: amountAfterTaxes, amountOfTaxes, extraTotal, currency.

Cavab

200 BookingPushRS obyekti. Uğurlu olduqda Success: true və HMS rezervasiya ID-si (HMS_ID); xəta olduqda Error mesajı və BookingConfirmNumbers[].Error[].

Xəta cavabları

  • 200 Error: No available data could be found. (01, gövdə boşdur və ya təhlil edilə bilmir) · Hotel registration not found on HMS. (02, otel onlayn kanala qoşulmayıb) · Could not register. · Failed to parse information.
Sorğu
curl -X POST "https://test.hms.gen.tr/external/online/channel/booking" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BookingPushRQ": {
        "Bookings": [
            {
                "hotelID": "1000",
                "ID": "4811174883",
                "type": "Book",
                "createDateTime": "2026-08-01T08:32:11:293Z",
                "checkinDate": "2026-08-18",
                "checkoutDate": "2026-08-20",
                "RoomStays": [
                    {
                        "roomTypeID": "2",
                        "roomName": "Standart otaq",
                        "ratePlanID": "2",
                        "ratePlanName": "Səhər yeməyi daxil",
                        "type": "Book",
                        "NumberOfUnits": "1",
                        "checkinDate": "2026-08-18",
                        "checkoutDate": "2026-08-20",
                        "GuestCount": {
                            "adult": 2,
                            "child": 1
                        },
                        "PerDayRates": {
                            "currency": "TRY",
                            "PerDayRate": [
                                {
                                    "stayDate": "2026-08-18",
                                    "baseRate": "965.00",
                                    "hotelServiceFees": "0"
                                },
                                {
                                    "stayDate": "2026-08-19",
                                    "baseRate": "965.00",
                                    "hotelServiceFees": "0"
                                }
                            ]
                        },
                        "Total": {
                            "amountAfterTaxes": "1930.00",
                            "amountOfTaxes": "175.45",
                            "currency": "TRY"
                        }
                    }
                ],
                "PrimaryGuests": [
                    {
                        "name": "Ayşe",
                        "surname": "Demir",
                        "PhoneNumber": "+905551112233",
                        "email": "[email protected]",
                        "CountryCode": "TR"
                    }
                ],
                "ChildGuests": [
                    {
                        "age": 7
                    }
                ],
                "SpecialRequest": [
                    {
                        "text": "Gec gəliş, təxminən saat 23:00."
                    }
                ],
                "extras": [
                    {
                        "name": "Şam yeməyi",
                        "note": "",
                        "person": 2,
                        "piece": 1,
                        "price": "400.00",
                        "priceMode": null,
                        "priceTotal": "400.00",
                        "stockID": 12
                    }
                ],
                "Total": {
                    "amountAfterTaxes": "2330.00",
                    "amountOfTaxes": "211.82",
                    "extraTotal": "400.00",
                    "currency": "TRY"
                }
            }
        ]
    }
}'
Cavab · 200
{
    "BookingPushRS": {
        "Success": true,
        "BookingConfirmNumbers": [
            {
                "confirmTime": 1755500000,
                "bookingID": 48213,
                "bookingType": "Book",
                "HMS_ID": 48213
            }
        ]
    }
}
Cavab · 200 (xəta)
{
    "BookingPushRS": {
        "Error": "Hotel registration not found on HMS.",
        "BookingConfirmNumbers": [
            {
                "bookingID": null,
                "bookingType": null,
                "confirmTime": 1755500000,
                "Error": [
                    {
                        "code": "02",
                        "text": "Hotel registration not found on HMS."
                    }
                ]
            }
        ]
    }
}
Son yenilənmə: 21 sentyabr 2026Səhv tapdınız? Bizə bildirin