U-ETDS web servis entegrasyonu nasıl yapılır?

Web servis entegrasyonu nedir?

U-ETDS'ye bilgi göndermenin iki yolu vardır. Birincisi e-Devlet portalı üzerinden elle giriş yapmaktır. İkincisi, Bakanlığın web servis dediği yöntemdir: kullandığınız program, girdiğiniz taşıma bilgilerini e-Devlet'e girmeden otomatik olarak U-ETDS'ye iletir.

Bakanlık bu yöntemi birinci yöntemden çok daha basit bir çözüm olarak tanımlar. Çünkü her sefer için e-Devlet'e girmeniz, bilgileri iki ayrı yere yazmanız gerekmez. Programa bir kez girer, gerisini program yapar.

Entegrasyon için gerekenler

• Web servis yetkilendirmesi: Firmanızın e-Devlet'ten ya da bölge müdürlüklerinden web servis yetkilendirmesi yaptırması gerekir.
• Kullanıcı adı ve şifre: Yetkilendirme sonrasında firmanıza web servis kullanıcı adı ve şifresi tanımlanır.
• IP izni: Web servise istek gönderen sunucunun IP adresi, bölge müdürlüğünde tanımlı IP adresleri arasında olmalıdır.
• Bir program: Bilgileri servise ileten yazılım. U-ETDSPaneli bu bağlantıyı hazır sunar.

Yetkilendirme ve kullanıcı bilgisi tanımlama işlemleri Bakanlık ve bölge müdürlükleri tarafından yürütülür. Süreç ve gerekli belgeler zaman içinde değişebilir; güncel bilgi için Ulaştırma ve Altyapı Bakanlığı'nın U-ETDS sayfasına bakın.

Adım adım entegrasyon

1. Firmanız için web servis yetkilendirmesini e-Devlet'ten ya da bölge müdürlüğünden yaptırın.
2. Size tanımlanan web servis kullanıcı adı ve şifresini not edin. Bu bilgiler genellikle oluşturulduktan bir gün sonra etkinleşir.
3. U-ETDSPaneli'nde yönetici olarak oturum açın ve Sistem ayarları sayfasını açın.
4. U-ETDS Web servisi ayarları bölümüne kullanıcı adını ve şifreyi girip kaydedin.
5. Gerekirse bölge müdürlüğünden sunucu IP adresimize izin verilmesini isteyin. Bu adımda destek ekibimiz size yol gösterir.
6. Deneme olarak bir sefer oluşturun ve durumunun Seferler ekranında U-ETDS Onaylı olarak göründüğünü doğrulayın.

Sistem ayarları sayfasındaki uyarıya dikkat edin: web servis bilgileriniz değişmediyse hiçbir değişiklik yapmayın. Yanlış bilgi kaydedilirse panel U-ETDS'ye bağlanamaz ve sefer bildirimleri durur.

Gerçek ve test ortamı arasındaki fark

Bakanlığın teknik sorular sayfasına göre web servis adresi test ortamıysa test kullanıcı adı ve şifresiyle, gerçek ortamsa gerçek ortam kullanıcı adı ve şifresiyle istek gönderilmelidir. Bilgilerin ortamla eşleşmemesi yetki hatasının en yaygın nedenlerinden biridir.

U-ETDSPaneli'nde Sistem ayarlarındaki alanların adı Gerçek Servis Kullanıcı Adı ve Gerçek Servis Şifresidir. Yani buraya yasal bildirimin yapıldığı gerçek ortamın bilgilerini girersiniz. Test ortamı bilgilerini bu alanlara yazarsanız bildirimleriniz gerçek sisteme ulaşmaz.

Sık görülen bağlantı hataları

• Yetki hatası: Önce isteği gönderen IP adresinin bölge müdürlüğünde tanımlı IP'ler arasında olup olmadığını kontrol edin. Ardından kullanılan adresin test mi gerçek ortam mı olduğuna bakın.
• Kullanıcı adı veya şifre hatası: Bilgiler oluşturulduktan sonra etkinleşmesi bir gün sürebilir. Süre dolduğu halde hata sürüyorsa bilgilerin doğruluğunu kontrol edip Bakanlıkla iletişime geçin.
• Sisteme bağlanılamadı: Panel bu durumda web servis kullanıcı adı ve şifresinin doğru olduğundan ve IP adresine izin verildiğinden emin olmanızı ister.

Diğer hata mesajlarının anlamları ve çözümleri için sefer bildirimi hataları rehberine bakın.

Entegrasyon sonrası neler değişir?

Bağlantı kurulduktan sonra sefer oluşturduğunuzda panel bilgileri U-ETDS'ye iletir ve sonucu size gösterir. Sefer önce Bekliyor durumuna alınır, ardından U-ETDS Onaylı ya da U-ETDS Hatalı olur.

Onaylı seferler başlangıç ve bitiş zamanına göre Planlandı, Devam ediyor ve Tamamlandı olarak izlenir. Hatalı seferlerde U-ETDS'nin döndürdüğü açıklama olduğu gibi gösterilir; neyi düzelteceğinizi bilirsiniz.

Personel için e-Devlet şifresi gerekmez

Web servis bilgileri panele bir kez girildikten sonra sefer bildirecek personelin e-Devlet şifrenizi bilmesine gerek kalmaz. Her personel kendi kullanıcı adıyla panele girer ve kendi yetkisi kadar sefer oluşturur.

Bu, e-Devlet şifresini paylaşmaktan çok daha güvenlidir; çünkü hangi personelin hangi seferi girdiği panelde izlenebilir. Kullanıcı sayısında sınır yoktur.

Kendi yazılımınız mı, hazır panel mi?

Web servis bağlantısını kendi yazılımınızla kurmak isterseniz bir yazılım ekibine ihtiyaç duyarsınız. Sefer ekleme, güncelleme, iptal, yolcu bildirimi ve hata yönetimi ayrı ayrı geliştirilir; Bakanlığın servis değişiklikleri de takip edilmelidir.

Hazır bir panel kullanırsanız bu işlerin tamamı hazır gelir. Siz yalnızca web servis bilgilerini girer, sonra sefer ve yolcu bilgilerini doldurursunuz. Küçük ve orta ölçekli turizm firmaları için bu genellikle daha hızlı ve ekonomik yoldur.

Bilgilerinizi güvende tutun

• Web servis kullanıcı adı ve şifresini yalnızca yetkili yöneticiler görmelidir. Sistem ayarları sayfası bu nedenle yalnızca yöneticilere açıktır.
• Şifreyi e-posta veya mesajlaşma uygulamasıyla paylaşmaktan kaçının.
• Personel işten ayrıldığında panelde kullanıcısını kapatın.
• Şüphe duyarsanız bölge müdürlüğünden yeni bir şifre isteyin ve panele yeniden girin.

Panelin tüm özelliklerini görmek için U-ETDS entegrasyonu sayfasına, genel tanıtım için U-ETDS programı sayfasına bakabilirsiniz.

Entegrasyon öncesi kontrol listesi

• Web servis yetkilendirmesi yapıldı mı?
• Kullanıcı adı ve şifre geldi, etkinleşme süresi doldu mu?
• Sunucu IP adresine izin tanımlandı mı?
• Gerçek ortam bilgileri doğru alana yazıldı mı?
• Deneme seferi U-ETDS Onaylı göründü mü?