Documentație Sincronizare Parteneri (Webhook) | GIA Booking System
GIA Booking System utilizează o metodă Webhook pentru a asigura sincronizarea **instantanee** a inventarului, prețurilor și restricțiilor (RAR) de la sistemul dumneavoastră extern (PMS/Channel Manager) către platforma noastră.
IMPORTANT: Această metodă este destinată sistemelor tehnice (nu proprietarilor). Sincronizarea trebuie efectuată în timp real (instantaneu) pentru a preveni suprarezervările (overbooking).
1. Endpoint-ul GIA și Autentificare
Fiecare cameră/proprietate primește un **URL Webhook unic**. Acesta este endpoint-ul către care trebuie să trimiteți datele:
Adresa Endpoint-ului
POST https://giabooking.com/api/sync_webhook.php?key=[CHEIE_PROPRIETAR_UNICA]
Autentificare
Autentificarea se realizează prin parametrul **`key`** (Cheia API unică). Această cheie este disponibilă în panoul de administrare al proprietarului (Secțiunea Integrare CM).
2. Structura Payload-ului (JSON)
Toate datele trebuie trimise în format **JSON** cu header-ul `Content-Type: application/json`.
Exemplu de Request (Actualizare Stoc și Preț)
{
"partner_name": "Nume_PMS_Extern",
"updates": [
{
"room_id": 12, // ID-ul camerei în GIA Booking System
"inventory_date": "2025-11-20",
"available_rooms": 2, // Noul stoc disponibil
"price_eur": 85.50 // Noul preț pe noapte
},
{
"room_id": 12,
"inventory_date": "2025-11-21",
"available_rooms": 1,
"price_eur": 95.00
}
]
}
Sistemul GIA va executa o actualizare rapidă direct pe tabela `room_inventory`.
3. Coduri de Răspuns GIA
- 200 OK: Sincronizare reușită. Mesajul include numărul de înregistrări actualizate.
- 401 Unauthorized: Cheia API (`key`) lipsește sau este goală.
- 403 Forbidden: Cheia API este invalidă sau a expirat.
- 500 Internal Server Error: Eroare la nivel de bază de date (verificare `system_logs`).