Kurumsal planlı birleştirme
Bu sözleşme geliştirme dalına eklenmiştir. Hesabınız için test ortamında otomatik planlama açılmadan yeni zorunluluklar devreye girmez. Üretim ortamında açıldığını varsaymayın; hesabınızın giriş ve yön yeteneklerini operasyon ekibiyle doğrulayın.
Hangi rezervasyonda uygulanır?
Her bacak ayrı değerlendirilir: kişi başı fiyatlı özel transfer; etkin cari, gerçek transfer şehrinde planlı birleştirme ayarı, tanımlı havalimanı ve desteklenen yön birlikte gerekir. Dağıtma ayrıca etkin olmalıdır. Otogar ve araç başı teklifler bu kapsama girmez. Tedarikçinin kendi şirketine, misafir ödeme veya white-label üzerinden açtığı rezervasyonlara bu kurallar uygulanmaz.
Kapsam etkinse normal POST /api/booking gövdesine şu alanları ekleyin:
| Alan | Anlam |
|---|---|
flightLocalDateTime | Havalimanının yerel uçuş tarihi ve saati. Toplamada kalkış, dağıtmada iniş. Örnek: 2026-11-10T14:30:00; Z veya saat farkı eki gönderilmez. |
isInternationalFlight | Dış hat için true, iç hat için false. Belirtilmemesi iç hat sayılmaz. |
largeBags | Büyük bagaj adedi; sıfır geçerlidir, negatif sayı ve araç kapasitesinin üstü reddedilir. |
flightNo bu planlama için isteğe bağlıdır; tek başına uçuş saatinin yerini tutmaz.
Belirsiz veya geçersiz yerel saatler sessizce tahmin edilmez. Hatalı girdide PNR oluşmaz.
Teklif, yolcu sayısı, cari fiyatı ve yetkilendirme kontrolleri ayrıca uygulanır.
Gidiş-dönüşte gidiş alanlarını ana gövdede, dönüş alanlarını returnLeg içinde gönderin.
Dönüşün uçuş saati, iç/dış hat bilgisi ve bagajı gidişten devralınmaz. İki bacak da uygun
olabilir veya yalnız biri planlı kapsama girebilir. Kapsam dışındaki bacağın mevcut
fiyatı ve hizmet koşulları korunur. İki rezervasyon ve bağlantıları birlikte kaydolur;
ikinci bacak reddedilirse ilk bacak da kaydedilmez. Aynı anahtarla yeniden gönderimde
dönüş dahil bütün gövde aynı kalmalıdır.
Dönen saatleri nasıl kullanmalıyım?
requestedPickUpTime, kabul edilen teklifteki ilk alış anını korur.
pickUpTime, kullanılacak güncel alış anıdır; UTC olarak döner.
pickUpTimeOrigin: Customer müşteri saati, Provisional geçici saat, Planned yayımlanan plan saati.
Geçici değeri kesinleşmiş alış saati olarak yolcuya sunmayın.
planningParticipation: None kapsam dışında, AwaitingSupplier tedarikçi ataması bekliyor,
Pending planlama bekliyor, Active aktif, NeedsAttention operasyon incelemesi gerekiyor, Closed kapalı.
transferPlanId henüz tedarikçi atanmamış kayıtta boş olabilir.
Detay ve liste okumaları güncel planlama alanlarını döndürür; ilk oluşturma yanıtını
süresiz önbelleğe almayın. Saat değişikliklerini webhook rehberindeki
transfer.updated bildirimi ardından güncel detaydan okuyun.
Tekrar gönderim
Her yeni niyet için yeni Idempotency-Key kullanın. Ağ hatasında aynı gövde ve
anahtarla tekrar gönderin. Kabul edilmiş kaydın teklifi tüketilmiş veya yeni kabul
kapatılmış olsa da aynı rezervasyon döner. Aynı anahtarla uçuşu, bagajı, fiyat teklifini
veya cari kapsamını değiştirmeyin; değişen gövde 409, yanlış cari fiyat kapsamı 410
ile reddedilebilir. Yanıt alınamadığında ikinci bir anahtarla yeni PNR açmayın.
Bu dilimin sınırı
Tedarikçi bekleyen PNR, operasyon portalında kabul edilen tedarikçi atanınca aynı fiyat ve rota koşullarıyla planlamaya devam eder. Çift yönün atomik planlı kabulü yerel testlerle doğrulandı; genel uçtan uca kabul ve ortam yayını tamamlanmadan otomatik havuz genel kullanıma açılmaz. Rota hesaplaması ilk kabul edilen fiyat girdilerini veya iptal ücreti referansını değiştirmez.