Otobüs bileti API entegrasyonu: içerik, tahsilat ve kayıt tek zincirde

Otobüs bileti entegrasyonu denince akla genellikle yalnızca sefer bağlantısı gelir. Oysa tek bir bilet satışı üç ayrı sistemden geçer: seferin geldiği otobüs sağlayıcısı, paranın alındığı ödeme altyapısı ve satışın kaydedildiği muhasebe yazılımı. DIJI.TECH'in otobüs bileti yazılımı bu üç katmanı tek altyapıda birleştirir; yukarıda tüm entegrasyonları kategorilerine göre görebilirsiniz.

Otobüs bileti API entegrasyonu hangi katmanlardan oluşur?

Otobüs bileti API entegrasyonu üç katmandan oluşan bir zincirdir: içerik, tahsilat ve kayıt. Her katman farklı bir sistemle konuşur, ancak yazılım hepsini aynı rezervasyon kaydına bağlar.

Bu sayfa otobüs bileti satışıyla doğrudan ilgili 28 entegrasyonu listeler; DIJI.TECH'in tüm ürün modüllerindeki API entegrasyonu sayısı 100'ün üzerindedir. Kodda karşılığı bulunmayan dört bağlantı (Accords ORS, Sofort, ParolaPara, TKPAY) DIJI.TECH'in listesinde yer alır ve detay sayfalarında bu durum açıkça belirtilir.

İçerik katmanı: seferler nereden gelir?

İçerik katmanı, acentenin sattığı seferlerin kaynağıdır. Yazılımın otobüs modülünde seferler BiletAll ağ geçidinden, SOAP/XML protokolüyle gelir. Kiracı başına birden fazla BiletAll hesabı tanımlanabilir; arama hepsine paralel gider, satış seferin bulunduğu hesaptan yapılır. Koltuk haritası her açılışta canlı okunur ve seçilen koltuklar satıştan önce firmanın kurallarıyla denetlenir.

Otobüs modülü yurt içi, tek yön seferleri satar ve fiyatlar Türk lirasıdır. Sağlayıcı bağlantılarının ayrıntısı otobüs entegrasyonları sayfasındadır.

Tahsilat katmanı: ödeme yolunu kim belirler?

Otobüste ödeme yolunu acente değil, otobüs firması sefer bazında belirler. Bu, tahsilat katmanını uçak veya otelden ayıran en önemli farktır.

Ödeme listesindeki banka sanal POS'ları ve ödeme kuruluşları ürün bağımsız adaptörlerdir ve otobüste yalnızca ön ödemeli seferde devreye girer. B2B portalda acente cari hesabıyla ödeme, bakiye ve kredi limiti kontrolünden sonra yapılır. Ön ödemeli otobüs bileti B2B panel sepetinde diğer ürünlerle birlikte tek ödemeyle alınabilir; B2C sitesinde ise otobüs bileti sepette tek başına satılır. Firma satışı açıkça reddederse tutar cariye veya karta iade edilir ve iade tamamlandıktan sonra müşteriye site markalı bir bilgilendirme e-postası gider; sonuç belirsizse para oynatılmaz, kayıt mutabakat kuyruğuna düşer. Ayrıntılar sanal POS entegrasyonu sayfasında anlatılır.

Kayıt katmanı: satış muhasebeye nasıl geçer?

Kayıt katmanı, satışın muhasebe sistemine aktarılmasıdır. Paraşüt, Luca ve Logo Netsis bağlantılarında otobüs satışı "Otobüs Rezervasyon Bedeli" belge satırıyla aktarılır, otobüs için ayrı bir KDV oranı ayarı bulunur ve e-Fatura veya e-Arşiv belgesi oluşturulabilir. Bu aktarımın tetiği kartla ödenen otobüs satışlarına bağlıdır; her otobüs satışının otomatik muhasebeleştiği söylenemez.

SYS bağlantısı farklı çalışır: SYS, yalnızca ödenmiş ve onaylı satışları bir çekme beslemesiyle alır, iptal edilen koltuklar düşülür. Satırda otobüs firması, PNR, koltuklar, yolcu, Kimlik No veya pasaport no ile net, markup ve toplam tutar ayrı ayrı yer alır. Ayrıntılar muhasebe entegrasyonu sayfasındadır.

Üç katman bir satışta nasıl birleşir?

Ön ödemeli bir sefer üzerinden zincir şöyle işler: yolcu B2C sitenizde seferi bulur ve koltuk seçer; koltuklar firmaya karşı doğrulanır ve 15 dakikalık ön rezervasyon başlar. Ödeme sitenizin sanal POS'undan 3D Secure ile alınır, bilet sağlayıcıda kesilir, rezervasyona PNR ve e-bilet numaraları yazılır. Kartla ödenen bu satış, bağlı muhasebe sistemine aktarımı tetikler.

Firmanın 3D sayfasını kullanan seferde zincirin tahsilat halkası sizin POS'unuz yerine firmanın sayfasıdır; bu yüzden ödeme kaydı sizin tarafınızda oluşmaz ve muhasebe aktarımı kurulumda ayrıca ele alınmalıdır.

Platformun kendi REST API'si

Dış sistemlere bağlanmanın yanında platformun kendi REST API'si de vardır. API, OpenAPI 3.1 standardıyla belgelenmiştir; otobüs için B2B, platform yönetimi, B2C ve B2C destinasyon sayfalarına ait operasyonları içerir. Bu API kendi kanallarınızı geliştirmeniz içindir. Yazılım otobüs içeriğini başka acentelere veya partnerlere XML ya da API ile dağıtmaz; içerik yalnızca sizin B2B portalınızda, alt acente ağınızda ve B2C sitenizde satılır.

Entegrasyonlar için neler gerekir?

Her entegrasyon için ilgili sağlayıcıyla, bankayla veya muhasebe yazılımıyla ticari anlaşma ve erişim bilgileri acenteye aittir; yazılım bu bilgileri platformda tanımlayıp teknik bağlantıyı kurar. Kurulum ortalama 1 hafta sürer.

Satış yetkisi ise entegrasyonlardan gelmez. Karayolu Taşıma Yönetmeliği yolcu taşımacılığında acenteliği F1 veya F2 yetki belgesine ve otobüs firmasıyla yapılan acentelik sözleşmesine bağlar; TÜRSAB belgesi tek başına yeterli değildir. Bir acenta olarak belge sürecini netleştirdikten sonra entegrasyon zincirini birlikte planlamak için demo talep edebilirsiniz.