Paylaşımlı transfer
Paylaşımlı transfer, tedarikçinin havalimanı ile kendi bölgesi arasında kişi başı fiyatla sattığı hizmettir. Farklı müşterilerden gelen rezervasyonlar tedarikçinin aynı aracında (sefer) birlikte taşınır. Sizin için her rezervasyon yine ayrı bir kayıttır: kendi PNR'ı, fiyatı, iptali ve webhook olaylarıyla.
Paylaşımlı transfer kademeli olarak açılır. Hesabınızda veya çalıştığınız tedarikçide etkin
değilse paylaşımlı rezervasyon oluşmaz ve bu sayfadaki olaylar size gelmez. Özel araç
transferlerinde değişen tek şey, tüm transfer olaylarına eklenen stateVersionUtc alanıdır
(aşağıda Sıralama).
Paylaşımlı teklif arayın
Paylaşımlı teklifler müsaitlik aramasının yanıtında
data.sharedTransfers listesinde gelir; ayrı bir açık/kapalı sorgusu yapmanız gerekmez. Alan
yalnız istekte sharedSearchParty gönderildiğinde doldurulur. Alan null ya da liste boşsa o rota,
tarih ve grup için paylaşımlı teklif yoktur.
Paylaşımlı aramada sharedSearchParty ile her yolcunun seyahat tarihinde tamamladığı
yaşı ve büyük bagaj sayısını gönderin. Dönen sharedTransfers listesindeki party ve
terms hizmetin yaş, bagaj ve bekleme koşullarını taşır. vehicles boşken bu listede
teklif bulunabilir. Seçilen teklifin itemId, toplam fiyatı ve conditionsVersion
değerlerini kullanın; koşulları kabul ettirdikten sonra son değeri rezervasyonda
acceptedServiceConditionsVersion alanıyla gönderin. passengerCount teklifin
party.seatsRequired değeridir; paylaşımlı grupta en çok 100 yolcu ve 20 yolcu adı
kabul edilir. Kategori sayılarıyla sharedParty araması yalnız API kullanıcısı
hesaplarına açıktır; iki grup alanını birlikte göndermeyin.
Paylaşımlı rezervasyonu tanıyın
- Webhook
datasnapshot'ındasharedTransferbloğu yalnız paylaşımlı rezervasyonda bulunur; özel transferde alan hiç yazılmaz. Snapshot'ta ayrıca bir hizmet türü alanı yoktur. GET /api/booking/{id}yanıtında paylaşımlı rezervasyonserviceType: "Shared"ve aynısharedTransferbloğunu taşır. Özel transferdeserviceTypeyazılmaz.- Araç tipi satışta seçilmez:
vehicleTypeIdvevehicleTypeNamenull olur; liste uçlarında araç tipi adı boş metin gelebilir. Sürücü ve plaka, tedarikçi seferi yayımlayana kadar boştur. Bunları hata saymayın. - Webhook snapshot'ındaki
passengerCountsatın alınan kişi sayısıdır; yalnız baş yolcu adı girilmiş olsa da azalmaz.passengerslistesinin uzunluğuyla karşılaştırmayın.
Olaylar
Taslak planlar size gönderilmez. Araç ve sürücü, tedarikçi seferi yayımladığında her rezervasyona ayrı ayrı yazılır ve olaylar yalnız size ait rezervasyonlar için gelir. Sefer kimliği, aynı araçtaki diğer rezervasyonlar ve onların yolcuları gönderilmez.
Olaylar webhook rehberindeki genel kurala göre üretilir:
data'da değişen her alan transfer.updated ile, eski ve yeni değeriyle gelir; sharedTransfer
bloğunun alt alanları nokta yoluyla (sharedTransfer.plannedDepartureUtc) listelenir. Paylaşımlı
rezervasyonda sık görülen değişiklikler:
| Ne oldu | Beklenecek olaylar ve changes alanları |
|---|---|
| Sefer yayımlandı ya da yayımlanmış seferde sürücü değişti | transfer.driver_assigned; transfer.updated (driverFullName, driverPhone, vehiclePlate, vehiclePhotos ve değiştiyse sharedTransfer.isPublished, sharedTransfer.plannedDepartureUtc) |
| Yayımlanmış seferde yalnız araç değişti | transfer.updated (vehiclePlate, vehiclePhotos) |
| Dönüşte otel alış saati yayımlandı ya da değişti | transfer.updated (pickUpTime, pickUpLocalDateTime) |
| Gelişte seferin kalkışı değişti | transfer.updated (sharedTransfer.plannedDepartureUtc) |
| Gelişte grubunuz hazır işaretlendi | transfer.updated (sharedTransfer.departureIsPlanned true → false) |
| Gelen yolcu sayısı kaydedildi | transfer.updated (sharedTransfer.presentPassengerCount) |
| Rezervasyon seferden çıkarıldı ya da sefer planı kaldırıldı | Durum değiştiyse transfer.status_changed; sürücü vardıysa transfer.driver_unassigned; transfer.updated (sürücü ve araç alanları null) |
Seferin planı kaldırılsa da rezervasyon kesin kalır ve iptal olmaz. İptal, ücret ve iade, mevcut
iptal akışıyla aynıdır. Güncel durumu her zaman data ve data.sharedTransfer üzerinden okuyun.
sharedTransfer bloğu
{
"sharedTransfer": {
"isPublished": true,
"plannedDepartureUtc": "2026-10-20T10:30:00Z",
"departureIsPlanned": true,
"reservedPassengerCount": 4,
"presentPassengerCount": null
}
}
| Alan | Tip | Açıklama |
|---|---|---|
| isPublished | boolean | Tedarikçi seferi yayımladı mı. Yayımlanmadan araç, sürücü ve kalkış kesin değildir |
| plannedDepartureUtc | string (ISO 8601) | null | Yayımlanmış seferin kalkışı (UTC); yayımlanmadan null |
| departureIsPlanned | boolean | Yalnız gelişte: grubunuz buluşma noktasında hazır işaretlenene kadar true; kalkış planlanan saattir |
| reservedPassengerCount | number | Satın alınan kişi sayısı |
| presentPassengerCount | number | null | Kaydedilen gelen yolcu sayısı; kayıt yoksa null |
| estimatedDropoffUtc | string (ISO 8601) | null | Yalnız GET /api/booking/{id} yanıtında, webhook'ta yoktur. Yayımlanmış gelişte adresinize güncel planlanan bırakış (UTC); rota yeniden hesaplanınca değişebilir. Dönüşte ve yayımlanmadan null |
Geliş ve dönüş
- Geliş (havalimanı → bölge): Kalkış, grubunuz buluşma noktasında hazır işaretlenene kadar
planlanan saattir. Hazır işaretiyle
departureIsPlannedfalseolur ve bekleme süreniz başlar. Kalkış, aynı seferdeki diğer grupların hazır olmasına göre bekleme sınırınız içinde güncellenebilir ve yeniden bildirilir. - Dönüş (bölge → havalimanı): Otel alış saatini tedarikçi belirler. Sefer yayımlanınca
data.pickUpTimebu saate güncellenir vetransfer.updated(pickUpTime) gelir. Rezervasyon seferden çıkarılırsa müşterinin istediği saat geri yüklenir. - Kısmi katılım: Gelen yolcu sayısı kaydedilir (
presentPassengerCount); ücret ve iade bu yüzden kendiliğinden değişmez.
Sıralama: stateVersionUtc
Teslimatlar en az bir kez yapılır ve yeniden denemelerde sırası bozulabilir
(Webhook rehberi). Her olayın data'sı kendi sürümünü
stateVersionUtc olarak taşır: size yayımlanan her yeni hâlde kesin artan bir UTC zaman damgası.
- Gelen değer sakladığınızdan büyükse yükü uygulayın; küçükse uygulamayın; eşitse aynı hâldir. Değerleri zaman damgası olarak karşılaştırın. Böylece eski bir atama yeni plakanın üzerine yazılmaz.
- Alan yalnız test bildiriminde
null'dır. Emin değilseniz rezervasyonu API'den okuyun.
Kontrol listesi
- Tanımadığınız alanları ve
changesalan yollarını yok sayın. Katı şema doğrulaması kullanıyorsanız (ör. Java Jackson'daFAIL_ON_UNKNOWN_PROPERTIES) bilinmeyen alanlara izin verin. data.sharedTransfervarsa rezervasyonu paylaşımlı kabul edin; yoksa özel transferdir.vehicleTypeIdnull ve boş sürücü/plaka alanlarını hata saymayın.- Araç ve sürücü bilgisini yalnız
sharedTransfer.isPublishedtrueiken kesin kabul edin. - Sakladığınızdan küçük
stateVersionUtctaşıyan yükü uygulamayın.