XML entegrasyonu nedir?

XML entegrasyonu, iki yazılımın XML biçimindeki mesajlarla web servisi üzerinden veri alışverişi yapmasıdır. Otobüs bileti satışında acente yazılımı, sefer, koltuk, satış ve iptal işlemlerini bu yolla bileti sağlayan sisteme iletir.

XML Entegrasyonu
XML entegrasyonu, iki yazılımın XML biçiminde yapılandırılmış mesajlarla, genellikle SOAP web servisleri üzerinden veri alışverişi yapmasıdır; otobüs bileti satışında sefer, koltuk, satış ve iptal verisini taşır.
Diğer adları: XML bağlantısı, SOAP entegrasyonu, otobüs bileti XML, web servis entegrasyonu, XML web servisi

XML entegrasyonu, iki yazılımın XML (Extensible Markup Language) biçiminde yapılandırılmış mesajlarla web servisi üzerinden veri alışverişi yapmasıdır. Bir sistem "şu tarihte şu iki şehir arasındaki seferleri getir" gibi bir istek gönderir; karşı sistem seferleri, saatleri ve fiyatları aynı biçimde yanıt olarak döner. BiletAll örneğinde bu mesajlar SOAP protokolüyle taşınır.

XML entegrasyonu nasıl çalışır?

XML entegrasyonu istek ve yanıt mantığıyla çalışır: acente yazılımı bir işlem için mesaj hazırlar, bileti sağlayan sistemin servisine gönderir ve gelen yanıtı kendi ekranlarına dönüştürür. Her işlem türünün kendi mesajı vardır ve iki tarafın aynı alan adlarında anlaşması gerekir.

Bir otobüs bileti satışında sırasıyla şu işlemler XML mesajlarıyla yürür:

  1. Sefer arama: Kalkış, varış ve tarih gönderilir; seferler, saatler ve fiyatlar döner.
  2. Sefer detayı: Koltuk haritası, satış kuralları, güzergâh durakları ve servis noktaları istenir.
  3. Koltuk kontrolü: Seçilen koltukların firmanın kurallarına uygunluğu sorulur.
  4. Satış: Yolcu, koltuk ve ödeme bilgileri gönderilir; PNR ve bilet numaraları döner.
  5. Sorgu ve iptal: PNR ve soyadıyla rezervasyonun güncel durumu okunur, gerekirse iptal isteği gönderilir.

XML entegrasyonunda dikkat edilmesi gerekenler

Bir XML bağlantısının çalışması, verinin acente için kullanışlı hâle geldiği anlamına gelmez. Gelen ham verinin doğru eşlenmesi, hatalı veya geciken yanıtların güvenli biçimde ele alınması gerekir. Değerlendirirken şu sorular yol gösterir:

  • Ana veri eşlemesi: Duraklar ve otobüs firmaları sağlayıcının kodlarıyla mı, yoksa yazılımın kendi kataloğunda mı tutuluyor?
  • Zaman aşımı: Yanıt vermeyen bir servis tüm aramayı bekletiyor mu?
  • Belirsiz sonuç: Satış isteği yanıtsız kalırsa para ne oluyor?
  • İz kaydı: Sağlayıcıya giden her çağrı sonradan incelenebiliyor mu?

XML ve REST karşılaştırması

XML bir veri biçimi, SOAP ve REST ise bu verinin taşınma biçimleridir. Köklü rezervasyon sistemlerinde SOAP üzerinden XML mesajları sık görülürken, yeni geliştirilen servisler genellikle JSON kullanan REST yaklaşımını tercih eder. Acente açısından önemli olan, hangi biçimin kullanıldığından çok bağlantının yazılım tarafından eksiksiz yönetilmesidir.

KonuSOAP/XMLREST/JSON
Mesaj biçimiXML zarf ve gövdeÇoğunlukla JSON
SözleşmeServis tanım dosyasıyla katı şemaBelgelenmiş uç noktalar
Yaygın kullanımKöklü rezervasyon ve dağıtım sistemleriYeni web ve mobil servisler
Hata ayıklamaMesajlar daha uzun ve ayrıntılıMesajlar daha kısa ve okunaklı

Örnek: iki BiletAll hesabıyla arama

Bir kiracının platformda iki ayrı BiletAll hesabı tanımladığını düşünelim. Acente İstanbul–Ankara araması yaptığında istek iki hesaba paralel gider ve sonuçlar her hesap yanıt verdikçe listeye akar. Hesaplardan biri 45 saniye içinde yanıt vermezse arama onu beklemez; cevap vermeyen kaynak listede belirtilir. Acente bir sefer seçtiğinde satış, o seferin bulunduğu hesap üzerinden yapılır.

Otobüs bileti yazılımında XML entegrasyonu

DIJI.TECH'in otobüs bileti yazılımı otobüs seferlerine BiletAll ağ geçidi üzerinden SOAP/XML ile bağlanır. Bugün kodda kayıtlı tek otobüs sağlayıcısı BiletAll'dır; çok sağlayıcılı otobüs araması yoktur.

  • Sağlayıcıdan bağımsız katalog: Duraklar ve otobüs firmaları ana katalogda, sağlayıcı kodları eşleme tablolarında tutulur; eşlemeler platform yönetiminden düzenlenir.
  • Yerel koltuk tutma: BiletAll sağlayıcı tarafında koltuk tutmadığı için ödeme öncesi tutma yazılımda yereldir.
  • Denetim izi: Arama, detay, koltuk, satış, iptal ve senkron çağrılarının tamamı log kaydına yazılır.
  • Satış sınırı: BiletAll tek satışta en fazla 4 yolcu kabul eder.

Yazılım, otobüs seferlerini iş ortaklarına XML veya API olarak dağıtmaz. Bağlantının ayrıntıları BiletAll entegrasyonu sayfasındadır.

Sık sorulan sorular

XML entegrasyonu ne demek?

XML entegrasyonu, iki yazılımın XML adlı işaretleme diliyle hazırlanmış mesajlar aracılığıyla birbirine veri göndermesidir. Bir taraf istek gönderir, diğer taraf aynı biçimde yanıt döner; böylece iki sistem insan müdahalesi olmadan çalışır.

Otobüs bileti XML entegrasyonu nasıl yapılır?

Önce bileti sağlayan sistemden bir hesap ve servis bilgileri alınır, ardından acente yazılımı bu servise bağlanır. DIJI.TECH yazılımında BiletAll hesabının API adresi, kullanıcı adı, şifresi ve ödeme modu platform yönetiminden tanımlanır.

XML ile REST API arasındaki fark nedir?

XML bir veri biçimidir, REST ise bir servis tasarım yaklaşımıdır. Köklü rezervasyon sistemlerinde XML mesajlarının SOAP ile taşınması yaygındır; yeni servislerde çoğunlukla JSON kullanan REST tercih edilir. DIJI.TECH, BiletAll'a SOAP/XML ile bağlanır; platformun kendi API'si ise OpenAPI ile belgelenmiş bir REST API'dir.

XML entegrasyonuyla otobüs bileti satmak için yetki gerekir mi?

Evet. Teknik bağlantı satış yetkisi yerine geçmez. Karayolu Taşıma Yönetmeliği'ne göre yolcu taşımacılığında acentelik F1 veya F2 yetki belgesi ister; dağıtıcı üzerinden satış modelinizin durumunu sağlayıcınızla ve Bakanlıkla teyit edin.

İlgili sayfalar

Son güncelleme:

Otobüs bileti satışına kendi markanızla başlayın

B2B acente portalı, B2C satış sitesi veya ikisi birden: acentenize uygun kurguyu demo görüşmesinde birlikte belirleyelim. Teklif, ihtiyaç duyduğunuz modüllere göre hazırlanır.

Demo & Teklif Al