Κωδικοί σφαλμάτων

Τα σφάλματα έρχονται σε τρεις μορφές: σφάλματα ελέγχου ταυτότητας ως HTTP 401, σφάλματα επιχειρησιακών κανόνων μέσα σε HTTP 200 με success: false και σφάλματα αποστολής κράτησης στο BookingPushRS.Error. Αυτή η σελίδα παραθέτει όλους τους κωδικούς.

Σφάλματα ελέγχου ταυτότητας#

HTTP	Απόκριση	Αιτία
401	`{"success": false, "error": "Authentication required"}`	Το token λείπει, είναι άγνωστο ή η μορφή `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`	Ρυθμίσεις email	Δεν έχει ρυθμιστεί SMTP για το online κανάλι.
`hotel_company_info_could_not_found`	Στοιχεία εικονικού POS	Δεν έχει ρυθμιστεί πάροχος πληρωμών για το ξενοδοχείο.
`bank_info_is_not_found`	Πληρωμή (τύπος 3)	Δεν έχει ενεργοποιηθεί τραπεζικός λογαριασμός για online πωλήσεις.
`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`	Το ξενοδοχείο είναι κλειστό για online πωλήσεις	Το ξενοδοχείο πρέπει να ενεργοποιήσει το online κανάλι στον πίνακα διαχείρισης.
`10004`	Κανένας τύπος δωματίου ανοιχτός στα κανάλια	Το ξενοδοχείο πρέπει να ανοίξει τύπους δωματίων για online πώληση.
`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:

Απόκριση · 200 (σφάλμα)

{
    "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	Το ξενοδοχείο δεν είναι συνδεδεμένο με το online κανάλι ή το κανάλι είναι ανενεργό.
Could not register.	—	Σφάλμα κατά την αποθήκευση (μη έγκυρο αναγνωριστικό τύπου δωματίου/διατροφής, ασυνεπείς ημερομηνίες).
Failed to parse information.	—	Από τη δομή λείπουν αναμενόμενα πεδία.

Οδηγίες επανάληψης#

401: συνδεθείτε ξανά μία φορά και επαναλάβετε το αίτημα.
500 και σφάλματα δικτύου: έως 3 προσπάθειες σε 1 s, 2 s, 4 s. Όταν επαναλαμβάνετε μια αποστολή κράτησης, χρησιμοποιήστε ξανά το ίδιο ID· ένα Book με υπάρχοντα κωδικό ενημερώνει την εγγραφή αντί να δημιουργεί διπλότυπο.
success: false: μην επαναλαμβάνετε· διορθώστε την παράμετρο ή προσφέρετε στον επισκέπτη μια εναλλακτική.
Στα αιτήματα υποστήριξης συμπεριλάβετε το πλήρες αίτημα (με απόκρυψη των μυστικών κλειδιών και των δεδομένων καρτών), την απόκριση και την ώρα.

Τελευταία ενημέρωση: 21 Σεπτεμβρίου 2026Βρήκατε κάποιο λάθος; Ενημερώστε μας