U-ETDS API Entegrasyonu Rehberi: Adımlar ve Örnek İstek

Başlamadan Önce Hazırlık

Kısa cevap: Bir U-ETDS entegrasyonu için üç şeye ihtiyacınız var: geçerli yetki belgesi, firmanıza tanımlı servis kullanıcı adı ve şifresi ve Bakanlığın güncel servis dokümantasyonu. Kodlamaya başlamadan önce üçünü de netleştirin.

✓Servis dokümantasyonunu (işlem adları, alanlar, kod listeleri) Bakanlık kaynaklarından edinin; bu sayfa örnek amaçlıdır.
✓Plaka, personel ve yolcu verilerinin kendi sisteminizde nasıl tutulacağını planlayın.
✓Hangi ortamda test edeceğinizi belirleyin: U-ETDS test ortamı.
✓Yolcu listesinin kaynağını (form, Excel, rezervasyon sistemi) ve veri doğrulama kurallarını belirleyin.

Çağrıların genel yapısı için önce U-ETDS web servis nedir? sayfasına göz atabilirsiniz.

Çağrı Sırası: Bildirim Akışı

Kimlik bilgisini hazırlayın

Her istek, servis kullanıcı adı ve şifresiyle doğrulanır. Bilgiyi koddan ayrı, güvenli bir yapılandırmada tutun.

Seferi ekleyin

Plaka, hareket-bitiş tarih ve saati, sefer açıklaması ve kendi sefer numaranızı gönderin. Başarılıysa sefer referans numarasını saklayın.

Grubu ekleyin

Sefer referansını kullanarak yolcu grubunu tanımlayın ve grup referansını saklayın.

Personeli ekleyin

Şoför ve varsa yardımcı personeli sefere bağlayın.

Yolcuları ekleyin

Her yolcuyu grup referansına bağlı olarak gönderin; her yolcunun sonucunu ayrı ayrı kaydedin.

Sonucu kaydedin ve izleyin

Tüm referans numaralarını ve sonuç mesajlarını kendi veritabanınızda tutun; hata alan adımı yeniden gönderebilmek için hangi adımda kaldığınızı bilmeniz gerekir.

Örnek İstek Yapısı (Sahte Değerlerle)

Aşağıdaki örnek yalnızca yapıyı göstermek içindir; tüm değerler sahtedir ve gerçek alan adları Bakanlığın dokümantasyonuyla karşılaştırılmalıdır.

Örnek sefer ekleme isteği

Örnek sefer ekleme isteği
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uet="http://uetds.unetws.udhb.gov.tr/"> <soapenv:Body> <uet:seferEkle> <wsuser> <kullaniciAdi>ORNEK_KULLANICI</kullaniciAdi> <sifre>ORNEK_SIFRE</sifre> </wsuser> <ariziSeferBilgileriInput> <aracPlaka>34ABC123</aracPlaka> <seferAciklama>TRANSFER</seferAciklama> <hareketTarihi>2026-11-01</hareketTarihi> <hareketSaati>09:00</hareketSaati> <firmaSeferNo>1001</firmaSeferNo> <seferBitisTarihi>2026-11-01</seferBitisTarihi> <seferBitisSaati>11:00</seferBitisSaati> </ariziSeferBilgileriInput> </uet:seferEkle> </soapenv:Body> </soapenv:Envelope>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:uet="http://uetds.unetws.udhb.gov.tr/">
  <soapenv:Body>
    <uet:seferEkle>
      <wsuser>
        <kullaniciAdi>ORNEK_KULLANICI</kullaniciAdi>
        <sifre>ORNEK_SIFRE</sifre>
      </wsuser>
      <ariziSeferBilgileriInput>
        <aracPlaka>34ABC123</aracPlaka>
        <seferAciklama>TRANSFER</seferAciklama>
        <hareketTarihi>2026-11-01</hareketTarihi>
        <hareketSaati>09:00</hareketSaati>
        <firmaSeferNo>1001</firmaSeferNo>
        <seferBitisTarihi>2026-11-01</seferBitisTarihi>
        <seferBitisSaati>11:00</seferBitisSaati>
      </ariziSeferBilgileriInput>
    </uet:seferEkle>
  </soapenv:Body>
</soapenv:Envelope>

SOAP isteğinin Bakanlık servisine gönderilmesi ve yanıtın alınması

Yanıtları Yönetmek

✓Sonuç kodu 0: adım başarılı; dönen referans numarasını kaydedin ve bir sonraki adıma geçin.
✓Veri hatası: mesajda eksik veya geçersiz alan belirtilir (ör. uyruk kodu, kimlik numarası). Veriyi düzeltip yalnızca o adımı yeniden gönderin.
✓Geçici Bakanlık hatası: "sistem hatası" veya boş mesaj gibi durumlarda kısa bir bekleme sonrası yeniden deneyin; art arda deneme yapmayın.
✓Zaman aşımı: yanıt gelmediyse işlemin Bakanlıkta tamamlanıp tamamlanmadığı belirsizdir; yeniden göndermeden önce durumu kontrol edin.

Hata mesajlarının anlamları ve çözümleri için U-ETDS hata mesajları ve çözümleri sayfasına bakın.

Kendiniz mi Geliştirin, Hazır Çözüm mü?

Konu	Kendi entegrasyonunuz	Hazır platform
İlk kurulum	Dokümantasyon okuma, kodlama, test	Servis bilgisini tanımlama
Hata yönetimi	Kendiniz tasarlarsınız	Hazır: hata nedeni gösterilir, sefer kayıtlı kalır
Yabancı yolcu	Pasaport okumayı ayrıca geliştirmek gerekir	Pasaport okuma (OCR) hazır
Bakım	Servis değişikliklerini siz izlersiniz	Sağlayıcı izler

Seçim kriterleri için U-ETDS programı ve yazılımı seçerken 8 kriter yazısına bakın.

Not: Bu sayfa genel bilgilendirme amaçlıdır. Mevzuat, ekranlar ve süreçler değişebilir; güncel ve bağlayıcı bilgi için her zaman Ulaştırma ve Altyapı Bakanlığı kaynaklarını esas alın.

Sık Sorulan Sorular

U-ETDS API entegrasyonu nasıl yapılır?+

Servis kullanıcı bilginizle kimlik doğrulayıp sırayla sefer, grup, personel ve yolcu çağrılarını gönderir, her adımda dönen referans numaralarını kaydedersiniz.

U-ETDS API için örnek istek var mı?+

Bu sayfada sahte değerlerle bir sefer ekleme isteği yapısı verilmiştir. Gerçek alan adları ve zorunlulukları için Bakanlığın dokümantasyonunu esas alın.

Servis kullanıcı bilgisini nereden alırım?+

Bilgi, yetki belgeli firmanıza Bakanlık sistemleri üzerinden tanımlanır. Ayrıntı için Kamu Türkiye U-ETDS girişi sayfasına bakın.

Bir adım hata verirse tüm seferi baştan mı göndermeliyim?+

Hayır. Önceki adımlarda alınan referanslar geçerlidir; hatayı düzeltip yalnızca başarısız adımı yeniden göndermeniz yeterlidir.

Entegrasyonu test etmeden canlıya almalı mıyım?+

Hayır. Önce test ortamında deneyin; bkz. U-ETDS test ortamı.

İlgili Rehberler

U-ETDS (UETDS) Rehberi →U-ETDS Web Servis Nedir? →U-ETDS Test Ortamı →U-ETDS Sefer Ekleme Adımları →U-ETDS Hata Mesajları ve Çözümleri →U-ETDS Programı ve Yazılımı →U-ETDS Entegrasyonu Nasıl Yapılır? →Yolcu Bildirim Sistemi →