H2B API – Reservations: Make
Metoda Reservations: Make permite crearea unei rezervări pe baza unui rezultat anterior obținut prin metoda Search: Search. Este necesar să se trimită toate informațiile legate de cumpărător, ocupanți și, opțional, serviciile extra selectate.
Recomandare: această metodă ar trebui utilizată doar după validarea unui rezultat de căutare și cu acordul utilizatorului final.
Endpoint:
POST /api/?type=reservations&call=reservations-make
Parametri explicați:
auth_key
Tip: string
Obligatoriu: Da
Cheia de autentificare generată în platforma H2B, secțiunea „Useri”.
Reservations[0][Room]
[
"2030-08-01", // Check-in date
1, // Nights
625, // Total price
319, // Property ID
957, // Room ID
1, // Number of rooms
536, // Rate plan ID
0, // Facil
0, // With extra bed
"EUR", // Currency
[4995, "breakfast"], // Meal (ID + tip)
[[14573, 1]], // Extra services (ID + cantitate)
[ // Payment policy
{"from": "1970-01-01", "to": "2025-07-22", "value": "30%"},
{"from": "2025-07-23", "to": "2030-07-25", "value": "70%"}
],
[ // Cancellation policy
{"from": "2025-07-22", "value": "30%"},
{"from": "2030-07-25", "value": "100%"}
],
20, // Comision %
0, // Price change fixed
0, // Price change percent
null, // Available rooms (null = necunoscut)
0, // Missing contract
500 // Price without commission
]
Important: Nu trebuie să decodezi sau să reinterpretezi acest array. Se trimite exact ca string JSON, așa cum este returnat de Search: Search.
Reservations[0][Occupancy]
Tip: string (JSON stringificat)
Obligatoriu: Da
Date despre ocupanți.
Exemplu:
{"Adults":"2","Children_Ages":"3,5"} sau {"Adults":"2","Children_Ages":""}.
Reservations[0][Occupants][n][First_Name]
Tip: string
Obligatoriu: Da (pentru fiecare ocupant)
Prenumele fiecărui ocupant.
Reservations[0][Occupants][n][Last_Name]
Tip: string
Obligatoriu: Da (pentru fiecare ocupant)
Numele de familie al fiecărui ocupant.
Reservations[0][Occupants][n][Date_Of_Birth]
Tip: string (format YYYY-MM-DD)
Obligatoriu: Da (pentru fiecare ocupant)
Data nașterii fiecărui ocupant.
Reservations[0][Occupants][n][Gender]
Tip: string
Obligatoriu: Nu
Genul ocupantului – „Male” sau „Female”.
Buyer[Gender]
Tip: string
Obligatoriu: Nu
„Male” sau „Female”.
Buyer[Firstname]
Tip: string
Obligatoriu: Nu
Prenumele cumpărătorului.
Buyer[Name]
Tip: string
Obligatoriu: Nu
Numele de familie al cumpărătorului.
Buyer[IdentityCardNumber]
Tip: string
Obligatoriu: Nu
CNP sau un alt identificator personal.
Buyer[Email]
Tip: string
Obligatoriu: Nu
Adresa de e-mail a cumpărătorului.
Buyer[Phone]
Tip: string
Obligatoriu: Nu
Numărul de telefon al cumpărătorului.
Buyer[Address][Country][Code]
Tip: string
Obligatoriu: Nu
Codul țării (ex: RO).
Buyer[Address][County][Name]
Tip: string
Obligatoriu: Nu
Numele județului.
Buyer[Address][City][Name]
Tip: string
Obligatoriu: Nu
Numele orașului.
Buyer[Address][PostCode]
Tip: string
Obligatoriu: Nu
Codul poștal.
Buyer[Address][Street]
Tip: string
Obligatoriu: Nu
Numele străzii.
Buyer[Address][StreetNumber]
Tip: string
Obligatoriu: Nu
Numărul stradal.
Buyer[Address][Building]
Tip: string
Obligatoriu: Nu
Clădire, bloc, scara etc. (opțional).
Buyer_Company[Name]
Tip: string
Obligatoriu: Nu
Numele firmei, dacă se emite factură pe companie.
Buyer_Company[Reg_No]
Tip: string
Obligatoriu: Nu
Numărul de înregistrare al firmei (ex: J/23/2011).
Buyer_Company[VAT_No]
Tip: string
Obligatoriu: Nu
Codul de TVA (ex: RO12345678).
Buyer_Company[Bank_Accounts][0][Bank_Name]
Tip: string
Obligatoriu: Nu
Numele băncii pentru companie.
Buyer_Company[Bank_Accounts][0][IBAN]
Tip: string
Obligatoriu: Nu
Contul IBAN al companiei.
Buyer_Company[Address][…]
Tip: obiect
Obligatoriu: Nu
Datele adresei firmei (structura identică cu cea pentru persoană fizică).
Extra_Services[n][Service][Id]
Tip: integer
Obligatoriu: Nu
ID-ul serviciului extra selectat.
Extra_Services[n][Quantity]
Tip: integer
Obligatoriu: Nu
Cantitatea serviciului extra.
Extra_Services[n][Info]
Tip: string
Obligatoriu: Nu
Informații suplimentare pentru acel serviciu (ex: „gluten free”).
Notes
Tip: string
Obligatoriu: Nu
Observații opționale legate de rezervare.
