İçeriğe geç
Blog

Rezervasyon motoru API hata yönetimi: paraya mal olan üç hata

Tekravel Editöryal
Yapay zekânın yardımıyla yazıldı

Destek talebi perşembe akşamı düşer. Müşteri ödemeyi yapmış, sayfa dönmüş, sonra genel bir hata çıkmış. Kart çekilmiş. Loglarınızda tedarikçiye giden ve hiç yanıt almayan bir POST var. Havayolu koltuğu tuttu mu? Kimse söyleyemiyor, müşteri bekliyor. Sağlam bir rezervasyon motoru API hata yönetimi büyük ölçüde bu duruma hiç düşmemenin, düşünce de tam olarak ne yapacağınızı bilmenin işidir.

Çoğu entegrasyon rehberi hataları durum kodlarının listesi gibi ele alır. Rezervasyonda kodlar işin kolay kısmıdır. Para kaybettiren, isteğin başarısız görünüp dünyanın yine de değiştiği ya da başarılı görünüp hiçbir şeyin değişmediği birkaç durumdur. Üçü diğerlerinden önemlidir.

Birinci hata: arama ile rezervasyon arasında fiyat değişti

Arama sonuçları bir tekliftir, sözleşme değil. Tarifeler önbelleğe alınır, envanter tedarikçinin sattığı tüm kanallar arasında paylaşılır ve birkaç dakika önce gösterdiğiniz rakam artık eski olabilir. Tedarikçi bunu rezervasyon oluşturma adımında söyler; bazen açık bir "tarife değişti" yanıtıyla, bazen de başarılı görünen bir yanıtın içinde sessizce farklı bir toplam döndürerek.

Tehlikeli olan ikincisi. Kodunuz onayı okuyup rezervasyonu kaydeder ve müşteriden gördüğü tutarı çekerse, fark marjınızdan ya da sonradan bir ADM ile cebinizden çıkar. Kural basit: ödemeyi çekmeden önce, her seferinde ve kodla, tedarikçinin onayladığı toplamı müşterinin kabul ettiği toplamla karşılaştırın.

Fark çıktığında ne yapacağınız boşluğun büyüklüğüne ve kimin taşıyacağına bağlıdır. Para birimleri arasındaki küçük yuvarlama bir toleranstır, bir kez ayarlarsınız. Daha büyük her şey yeni fiyat ve açık bir kabul düğmesiyle müşteriye döner. Asla otomatik olarak yutmayın, asla otomatik olarak tahsil etmeyin.

İkinci hata: rezerve edildi ama bilet kesilmedi

PNR'nin var olması biletin var olması demek değildir. Pek çok akış önce rezervasyonu oluşturur, e-bileti ayrı bir adımda keser ve ikisi arasında bir süre sınırı vardır. Ödeme geçer, biletleme düşerse elinizde müşterinin parası ve kendi saatiyle süresi dolacak bir rezervasyon kalır.

Bu hata nadiren gürültülüdür. Biletleme çağrısı hata ya da zaman aşımı döndürür; veritabanınız rezervasyonu "ödendi" diye etiketlerken tedarikçi hâlâ "tutuldu" der. Bu arada bilet süresi işler ve destek kuyruğunuzun aksine havayolu beklemez.

Bunu başarının ya da başarısızlığın bir türü değil, kendi durumu olarak ele alın. Bir rezervasyonun en az şu durumları olmalı: oluşturuldu, tutuldu, ödeme alındı, biletleniyor, biletlendi, başarısız ve iade edilebilir. "Ödeme alındı, biletleniyor" durumu bir zamanlayıcı ister: bir rezervasyon orada fazla kaldıysa, bir iş rezervasyonu tedarikçiden yeniden okuyup karar vermeli; birinin fark etmesini beklememeli. Tedarikçinin süre sınırını bildiğinizde karar ucuzdur, çünkü iade etmeden önce ne kadar güvenle yeniden deneyebileceğinizi söyler.

Üçüncü hata: sonucu bilinmeyen zaman aşımı

Perşembe akşamı talebi bu. İsteğiniz çıktı, yanıt dönmedi; bağlantı koptu ya da ağ geçidi vazgeçti. Tedarikçi isteği tamamen, kısmen ya da hiç işlememiş olabilir.

Akla gelen yeniden denemektir. Rezervasyon oluşturma çağrısını körü körüne tekrarlamayın; ikinci deneme ikinci bir rezervasyon üretebilir ve mükerrer kayıt gerçek bir maliyettir: iki koltuk tutulur, belki iki bilet kesilir, birinde iade kavgası çıkar.

Güvenli sıra: dur, oku, karar ver. Müşteri akışını "rezervasyonunuzu doğruluyoruz" gibi dürüst bir durumla durdurun. Tedarikçi tarafını, çağrıdan önce ürettiğiniz referansla rezervasyonu sorgulayarak okuyun (bu yüzden önce kendi istemci referansınızı üretir, tedarikçi kabul ediyorsa isteğe eklersiniz). Ancak sonra karar verin: bulunduysa gerçek durumdan devam edin; tedarikçinin kendi işlem penceresi geçtikten sonra da yoksa bir kez yeniden denemek güvenlidir.

Tedarikçi referansınızla sorguya izin vermiyorsa yolcu adı, güzergâh ve tarihle dar bir pencerede arayın ve eşleşmeyi bulundu sayın. Çirkin ama mükerrer kayıttan çok daha ucuz.

Karşı çıkabileceğiniz bir karar tablosu

GördüğünüzBildiğinizYapılacakYapılmayacak
Tedarikçi "tarife değişti" döndürürHiçbir şey rezerve edilmediYeni toplamı göster, onay iste, oluşturmayı yeniden çalıştırEski fiyatla tekrar gönderip geçmesini ummak
Başarılı, ama toplam müşterinin kabul ettiğinden farklıYeni fiyatla bir rezervasyon varÖdemeyi beklet, müşteriye sor, reddederse rezervasyonu iptal etEski tutarı çekip farkı üstlenmek
Ödeme alındı, biletleme hata verirPNR var, bilet durumu bilinmiyorRezervasyonu yeniden oku, süre sınırı içinde yeniden dene, sonra iade etRezervasyonu başarısız işaretleyip PNR'yi unutmak
Oluşturmada zaman aşımıSonuç bilinmiyorReferansla sorgula, sonra devam et ya da bir kez yeniden deneHemen körü körüne yeniden deneme
İptalde zaman aşımıSegmentten hâlâ sorumlu olabilirsinizMüşteriye bir şey söylemeden önce durumu yeniden okuTıklama oldu diye "iptal edildi" göstermek

Tartışmaya açık bir satır: bazı ekipler müşteriyi sakinleştirmek için ilk biletleme hatasında iade yapar. Küçük biletlerde savunulabilir, pahalılarda kötü bir alışkanlıktır; bir dakika sonra kurtarabileceğiniz bir tarifeyi kaybedebilirsiniz.

Yanlış yapmanın size maliyeti

Her hatanın faturası farklıdır. Kaçırılan fiyat değişikliği dokunduğu her rezervasyonda kaybedilmiş marjdır ve çoğu zaman mutabakata kadar fark edilmez. Rezerve edilip biletlenmemiş bir durum, havalimanına süresi dolmuş bir rezervasyonla ve kartından çekilmiş bir tutarla gelen müşteridir; aynı anda hem itiraz hem itibar sorunu. Zaman aşımında körü körüne yeniden deneme mükerrer rezervasyondur ve havayolları mükerrerleri denetler; tekrarlayan bir örüntü bir ADM ile sonuçlanabilir.

Bunların hiçbiri egzotik değil. Demoyu hafta sonu boyunca kendi başına çalışabilecek bir şeyden ayıran gösterişsiz tesisatın ta kendisi.

Mutabakat işini ihtiyaç duymadan önce kurun

Üç hata da aynı yerde biter: veritabanınız ile tedarikçinin kaydı uyuşmaz. O hâlde ikisini karşılaştıran işi ilk olaydan önce yazın. Gecelik çalıştırma asgaridir; geçiş durumundaki her şey için birkaç dakikada bir çalıştırmak daha iyidir. İş, tutuldu, biletleniyor ya da bilinmiyor durumunda takılan rezervasyonları listeler, tedarikçiye ne düşündüğünü sorar ve kaydı onarır ya da kanıtıyla birlikte bir talep açar.

Rezervasyon çağrılarının her isteğini ve yanıtını, zaman aşımları dâhil, gönderdiğiniz referansla birlikte saklayın. Müşteri bir çekime itiraz ettiğinde o log sizin savunmanızdır. Gecikme tartışmasını da dürüst tutar: zaman aşımlarının neden ortadan kaldırılacak bir hata değil bir gerçek olduğunu görmek için API gecikmesinde neyi düzeltebilir, neyi düzeltemezsiniz yazısına bakın.

Tedarikçi bağlantısının kendisini nasıl kuracağınıza hâlâ karar veriyorsanız, uçuş rezervasyon API entegrasyonu rehberi bu yazının varsaydığı çağrı sırasını anlatır. Bu durumların uçuş ve otel API'lerimize nasıl karşılık geldiğini konuşmak isterseniz, erişim bir görüşmeyle başlar: seyahat API sayfasına bakın.

Tekravel Editöryal

Seyahat teknolojisi masası

Tekravel seyahat teknolojisi masası sektör için yazar: acente sahipleri, konsolidatörler ve onları entegre eden geliştiriciler. Her yazı, yayımlanmadan önce anlattığı platform üzerinde doğrulanır.