H2B API – Reservations: Reservations
Această metodă returnează lista rezervărilor efectuate de către utilizatorul autentificat.
Recomandare de utilizare: Se recomandă rularea acestei metode periodic (ex: la 15–30 minute sau la 1h) pentru sincronizarea rezervărilor, mai ales dacă sistemul partener gestionează inventarul sau facturarea.
Endpoint:
POST /api/?type=reservations&call=reservations-reservations
Parametri explicati:
auth_key
Tip: string | Obligatoriu: Da
Cheia de autentificare pentru utilizatorul API.
customer_session_id
Tip: string | Obligatoriu: Nu
Se folosește doar dacă se interoghează rezervări în numele unui client logat.
Date_From
Tip: string (format YYYY-MM-DD HH:mm) | Obligatoriu: Nu
Data de început pentru filtrare. Exemplu: 2025-07-01 00:00
Date_To
Tip: string (format YYYY-MM-DD HH:mm) | Obligatoriu: Nu
Data de sfârșit pentru filtrare. Exemplu: 2025-07-31 23:59
Property_Id
Tip: integer | Obligatoriu: Nu
Filtrare după ID-ul proprietății (unității de cazare)
Reservation_Id
Tip: integer | Obligatoriu: Nu
Filtrare după ID-ul rezervării
Last_Modified_Date_After
Tip: string (format YYYY-MM-DD HH:mm) | Obligatoriu: Nu
Returnează doar rezervările modificate după această dată.
Status
Tip: string | Obligatoriu: Nu
Filtrare după status. Valori acceptate:
- Proposal
- Submitted
- Confirmed
- Cancelled
Request
POST /api/?type=reservations&call=reservations-reservations
Content-Type: application/x-www-form-urlencoded
auth_key=API_Key
Date_From=2025-07-01
Date_To=2025-07-31
Response
{
"Id": 11146,
"Property_Id": 4,
"Date": "2025-07-16 15:39:23",
"Status": "Error",
"Buyer": {
"Firstname": "Andrei",
"Name": "Test",
"Email": "andrei@h2b.ro"
},
"Items": [
{
"Room_Name": "Dubla1",
"Rate_Plan_Name": "Standard",
"Occupants": [
{
"First_Name": "Test 1",
"Last_Name": "Test 1",
"Date_Of_Birth": "1970-01-01"
},
{
"First_Name": "Test 2",
"Last_Name": "Test 2",
"Date_Of_Birth": "1970-01-01"
}
]
}
]
}