Codici di errore

Gli errori arrivano in tre forme: gli errori di autenticazione come HTTP 401, gli errori di logica applicativa all’interno di un HTTP 200 con success: false e gli errori dell’invio della prenotazione in BookingPushRS.Error. Questa pagina elenca tutti i codici.

Errori di autenticazione#

HTTP	Risposta	Causa
401	`{"success": false, "error": "Authentication required"}`	Token mancante o sconosciuto, oppure formato `Bearer` non valido.
200	`message: partner_is_not_found`	Login: la coppia di chiavi non corrisponde.
200	`message: hotel_is_not_found`	Login: nessun hotel per `hotelSeoUrl`.
200	`message: hotel_permission_is_not_found`	Login: il partner non è autorizzato per l’hotel.

Codici message#

Codici testuali in snake_case, restituiti insieme a success: false.

message	Endpoint	Descrizione
`hotel_id_is_not_found`	Quasi tutti	`hotelID` non è stato inviato.
`start_date_is_not_found` / `end_date_is_not_found`	Disponibilità	Parametro di data mancante.
`online_cupon_is_not_found`	Coupon	Codice sconosciuto, non attivo, scaduto o non disponibile.
`mail_host_is_not_found`	Impostazioni e-mail	Nessun SMTP configurato per il canale online.
`hotel_company_info_could_not_found`	Dati del POS virtuale	Nessun provider di pagamento configurato per l’hotel.
`bank_info_is_not_found`	Pagamento (tipo 3)	Nessun conto bancario abilitato per la vendita online.
`required_input_info_not_submitted`	Pagamento (tipo 10)	Manca un campo obbligatorio; `errors[]` indica quali.
`country_info_sent_incorrectly`	Pagamento (tipo 10)	`countryID` non è presente nell’elenco dei paesi.
`there_is_missing_info_in_the_shopping_cart`	Pagamento (tipo 10)	In un elemento del carrello manca `id`, `name`, `piece` o `price`; `errors[]` indica quale.

Codici di errore dell’elenco camere#

L’elenco camere (POST /external/online/roomType) restituisce un errorCode numerico e un errorMessage leggibile. Il messaggio viene tradotto in base al parametro language: nel tuo codice basati su errorCode.

errorCode	Significato	Cosa fare
`10001`	Hotel non trovato	Controlla `hotelID`.
`10002`	Parametro mancante (`hotelID`, `startDate`, `endDate`, `adultCount`)	Invia i campi obbligatori.
`10003`	Hotel chiuso alla vendita online	L’hotel deve abilitare il canale online nel pannello.
`10004`	Nessuna tipologia di camera aperta ai canali	L’hotel deve aprire le tipologie di camera alla vendita online.
`10022`	Parametri non validi	Check-in oggi o in una data successiva, check-out dopo il check-in, al massimo 30 notti, 1–40 adulti, 0–10 bambini.
`20001`	Disponibilità insufficiente per gli adulti	Proponi altre date o un’altra occupazione.
`20002`	Disponibilità insufficiente per i bambini	Non restano camere con capacità per bambini.
`20003` / `20004`	Disponibilità insufficiente per adulti e bambini	La capacità totale non è sufficiente per la richiesta.

Quando c’è disponibilità ma una determinata tipologia di camera non è vendibile, il suo roomCount è 0 e il motivo è indicato in roomRestrictionMessage: closed_to_checkin, closed_to_checkout, passive_sales, minimum_stay, maximum_stay, closed_to_arrival, price_not_found.

Errori dell’invio della prenotazione#

Al posto di Success: true, BookingPushRS contiene un campo Error:

Risposta · 200 (errore)

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

Error	Codice	Causa
No available data could be found.	01	Corpo vuoto o JSON non interpretabile; `Bookings[0].hotelID` mancante.
Hotel registration not found on HMS.	02	L’hotel non è collegato al canale online oppure il canale non è attivo.
Could not register.	—	Errore durante il salvataggio (ID di tipologia di camera o di trattamento non valido, date incoerenti).
Failed to parse information.	—	Nella struttura mancano campi previsti.

Indicazioni sui nuovi tentativi#

401: ripeti il login una volta e riprova la richiesta.
500 ed errori di rete: fino a 3 tentativi, dopo 1 s, 2 s e 4 s. Quando ripeti l’invio di una prenotazione, riusa lo stesso ID: un Book con un codice esistente aggiorna il record invece di crearne un duplicato.
success: false: non riprovare; correggi il parametro o proponi un’alternativa all’ospite.
Nei ticket di supporto includi la richiesta completa (con chiavi segrete e dati delle carte mascherati), la risposta e l’orario.

Ultimo aggiornamento: 21 settembre 2026Hai trovato un errore? Segnalacelo