Ana içeriğe geç

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 data snapshot'ında sharedTransfer bloğ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ı rezervasyon serviceType: "Shared" ve aynı sharedTransfer bloğunu taşır. Özel transferde serviceType yazılmaz.
  • Araç tipi satışta seçilmez: vehicleTypeId ve vehicleTypeName null 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 passengerCount satın alınan kişi sayısıdır; yalnız baş yolcu adı girilmiş olsa da azalmaz. passengers listesinin 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 olduBeklenecek olaylar ve changes alanları
Sefer yayımlandı ya da yayımlanmış seferde sürücü değiştitransfer.driver_assigned; transfer.updated (driverFullName, driverPhone, vehiclePlate, vehiclePhotos ve değiştiyse sharedTransfer.isPublished, sharedTransfer.plannedDepartureUtc)
Yayımlanmış seferde yalnız araç değiştitransfer.updated (vehiclePlate, vehiclePhotos)
Dönüşte otel alış saati yayımlandı ya da değiştitransfer.updated (pickUpTime, pickUpLocalDateTime)
Gelişte seferin kalkışı değiştitransfer.updated (sharedTransfer.plannedDepartureUtc)
Gelişte grubunuz hazır işaretlenditransfer.updated (sharedTransfer.departureIsPlanned true → false)
Gelen yolcu sayısı kaydedilditransfer.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
}
}
AlanTipAçıklama
isPublishedbooleanTedarikçi seferi yayımladı mı. Yayımlanmadan araç, sürücü ve kalkış kesin değildir
plannedDepartureUtcstring (ISO 8601) | nullYayımlanmış seferin kalkışı (UTC); yayımlanmadan null
departureIsPlannedbooleanYalnız gelişte: grubunuz buluşma noktasında hazır işaretlenene kadar true; kalkış planlanan saattir
reservedPassengerCountnumberSatın alınan kişi sayısı
presentPassengerCountnumber | nullKaydedilen gelen yolcu sayısı; kayıt yoksa null
estimatedDropoffUtcstring (ISO 8601) | nullYalnı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 departureIsPlanned false olur 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.pickUpTime bu saate güncellenir ve transfer.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 changes alan yollarını yok sayın. Katı şema doğrulaması kullanıyorsanız (ör. Java Jackson'da FAIL_ON_UNKNOWN_PROPERTIES) bilinmeyen alanlara izin verin.
  • data.sharedTransfer varsa rezervasyonu paylaşımlı kabul edin; yoksa özel transferdir.
  • vehicleTypeId null ve boş sürücü/plaka alanlarını hata saymayın.
  • Araç ve sürücü bilgisini yalnız sharedTransfer.isPublished true iken kesin kabul edin.
  • Sakladığınızdan küçük stateVersionUtc taşıyan yükü uygulamayın.