შეცდომის კოდები
შეცდომები სამი ფორმით ბრუნდება: ავთენტიფიკაციის შეცდომები — HTTP 401 სტატუსით, ბიზნეს-წესების შეცდომები — HTTP 200 პასუხში success: false მნიშვნელობით, ხოლო ჯავშნის გადაცემის შეცდომები — BookingPushRS.Error ველში. ამ გვერდზე ჩამოთვლილია ყველა კოდი.
ავთენტიფიკაციის შეცდომები#
| HTTP | პასუხი | მიზეზი |
|---|---|---|
| 401 | {"success": false, "error": "Authentication required"} | ტოკენი აკლია, უცნობია ან Bearer ფორმატი არასწორია. |
| 200 | message: partner_is_not_found | შესვლა: გასაღებების წყვილი არ ემთხვევა. |
| 200 | message: hotel_is_not_found | შესვლა: hotelSeoUrl მნიშვნელობით სასტუმრო ვერ მოიძებნა. |
| 200 | message: hotel_permission_is_not_found | შესვლა: პარტნიორს სასტუმროზე წვდომის უფლება არ აქვს. |
message კოდები#
snake_case ფორმატის ტექსტური კოდები, რომლებიც success: false მნიშვნელობასთან ერთად ბრუნდება.
| message | ენდპოინტი | აღწერა |
|---|---|---|
hotel_id_is_not_found | უმეტესობა | hotelID არ გაიგზავნა. |
start_date_is_not_found / end_date_is_not_found | ხელმისაწვდომობა | აკლია თარიღის პარამეტრი. |
online_cupon_is_not_found | კუპონი | კოდი უცნობია, არააქტიურია, ვადაგასულია ან მიუწვდომელია. |
mail_host_is_not_found | ელფოსტის პარამეტრები | ონლაინ არხისთვის SMTP კონფიგურირებული არ არის. |
hotel_company_info_could_not_found | ვირტუალური POS-ის მონაცემები | სასტუმროსთვის გადახდის პროვაიდერი კონფიგურირებული არ არის. |
bank_info_is_not_found | გადახდა (ტიპი 3) | ონლაინ გაყიდვებისთვის საბანკო ანგარიში ჩართული არ არის. |
required_input_info_not_submitted | გადახდა (ტიპი 10) | აკლია სავალდებულო ველი; რომელი — ჩამოთვლილია errors[] მასივში. |
country_info_sent_incorrectly | გადახდა (ტიპი 10) | countryID ქვეყნების სიაში არ არის. |
there_is_missing_info_in_the_shopping_cart | გადახდა (ტიპი 10) | კალათის ელემენტს აკლია id, name, piece ან price; errors[] მიუთითებს, რომელს. |
ოთახების სიის შეცდომის კოდები#
ოთახების სია (POST /external/online/roomType) აბრუნებს რიცხვით errorCode კოდს და ადამიანისთვის წაკითხვად errorMessage შეტყობინებას. შეტყობინება language პარამეტრის მიხედვით ითარგმნება; კოდში errorCode მნიშვნელობას დაეყრდენით.
| errorCode | მნიშვნელობა | რა უნდა გააკეთოთ |
|---|---|---|
10001 | სასტუმრო ვერ მოიძებნა | შეამოწმეთ hotelID. |
10002 | აკლია პარამეტრი (hotelID, startDate, endDate, adultCount) | გაგზავნეთ სავალდებულო ველები. |
10003 | სასტუმრო დახურულია ონლაინ გაყიდვებისთვის | სასტუმრომ პანელში ონლაინ არხი უნდა ჩართოს. |
10004 | არხებისთვის ღია ოთახის ტიპი არ არის | სასტუმრომ ოთახის ტიპები ონლაინ გაყიდვისთვის უნდა გახსნას. |
10022 | არასწორი პარამეტრები | ჩასახლება — დღეს ან უფრო გვიან, გაწერა — ჩასახლების შემდეგ, მაქსიმუმ 30 ღამე, 1–40 ზრდასრული, 0–10 ბავშვი. |
20001 | ზრდასრულებისთვის საკმარისი ხელმისაწვდომობა არ არის | შესთავაზეთ სხვა თარიღები ან სტუმრების რაოდენობა. |
20002 | ბავშვებისთვის საკმარისი ხელმისაწვდომობა არ არის | ბავშვების ტევადობის მქონე ოთახები აღარ დარჩა. |
20003 / 20004 | ზრდასრულებისა და ბავშვებისთვის საკმარისი ხელმისაწვდომობა არ არის | საერთო ტევადობა მოთხოვნას ვერ აკმაყოფილებს. |
როცა ხელმისაწვდომობა არსებობს, მაგრამ კონკრეტული ოთახის ტიპის გაყიდვა შეუძლებელია, მისი roomCount არის 0, ხოლო მიზეზი მითითებულია roomRestrictionMessage ველში: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.
ჯავშნის გადაცემის შეცდომები#
Success: true მნიშვნელობის ნაცვლად BookingPushRS შეიცავს Error ველს:
{
"BookingPushRS": {
"Error": "Could not register.",
"BookingConfirmNumbers": [
{
"confirmTime": 1755500000,
"bookingID": 0,
"bookingType": "Book",
"HMS_ID": null
}
]
}
}| Error | კოდი | მიზეზი |
|---|---|---|
| No available data could be found. | 01 | ტანი ცარიელია ან JSON ვერ დამუშავდა; აკლია Bookings[0].hotelID. |
| Hotel registration not found on HMS. | 02 | სასტუმრო ონლაინ არხთან დაკავშირებული არ არის ან არხი არააქტიურია. |
| Could not register. | — | შეცდომა შენახვისას (ოთახის/კვების ტიპის არასწორი ID, შეუსაბამო თარიღები). |
| Failed to parse information. | — | სტრუქტურას აკლია მოსალოდნელი ველები. |
განმეორებითი მცდელობის რეკომენდაციები#
- 401: კიდევ ერთხელ შედით და გაიმეორეთ მოთხოვნა.
- 500 და ქსელის შეცდომები: მაქსიმუმ 3 მცდელობა 1 წმ, 2 წმ და 4 წმ ინტერვალით. ჯავშნის გადაცემის გამეორებისას იგივე
IDგამოიყენეთ;Bookარსებული კოდით ჩანაწერს განაახლებს და დუბლიკატს არ შექმნის. - success: false: ნუ გაიმეორებთ; გაასწორეთ პარამეტრი ან სტუმარს ალტერნატივა შესთავაზეთ.
- მხარდაჭერისადმი მიმართვაში მიუთითეთ სრული მოთხოვნა (საიდუმლო გასაღებები და ბარათის მონაცემები დაფარული), პასუხი და დრო.