U-ETDS Entegrasyonu Nasıl Yapılır? Adım Adım Rehber (2026)

U-ETDS (Ulaştırma Elektronik Takip ve Denetim Sistemi), yetki belgeli taşımacılık firmalarının her seferi ve o seferdeki yolcuları Ulaştırma ve Altyapı Bakanlığı'na bildirmesini zorunlu kılar. Bu bildirimi manuel olarak, Bakanlık'ın web arayüzünden tek tek girmek mümkündür — ancak günde onlarca sefer yapan bir firma için bu, hem zaman kaybı hem de insan hatasından kaynaklanan ceza riski demektir. Bu yazıda U-ETDS'e API üzerinden entegrasyon sürecinin nasıl işlediğini adım adım anlatıyoruz.

1. Yetki Belgenizi ve Bakanlık Kaydınızı Kontrol Edin

U-ETDS entegrasyonunun ön koşulu, firmanızın Ulaştırma ve Altyapı Bakanlığı'ndan geçerli bir yetki belgesine (A1, A2, B1, B2, D1, D2, D4, F1, F2 vb.) sahip olmasıdır. Yetki belgesi türünüz, hangi sefer türlerini (tarifeli, arızi, turizm taşıması vb.) bildirmeniz gerektiğini belirler.

Yetki belgeniz varsa, Bakanlık size bir U-ETDS kullanıcı adı ve şifresi tanımlar. Bu kimlik bilgileri, hem Bakanlık'ın web panelinden manuel giriş yapmak hem de API üzerinden otomatik bildirim göndermek için kullanılır.

2. API mi, Manuel Giriş mi?

Manuel Giriş

✗ Her sefer ve her yolcu için ayrı ayrı form doldurma
✗ Yoğun günlerde unutma / geç bildirim riski
✗ Personel zamanının büyük kısmını veri girişine ayırma
✗ TC kimlik / pasaport numarası girişinde yazım hatası riski

API Entegrasyonu

✓ Sefer oluşturulduğu anda otomatik bildirim
✓ Geç bildirim ve unutma riski sıfıra iner
✓ Pasaport/OCR ile yolcu verisi otomatik doldurulur
✓ Onay kodları ve geçmiş tek panelde saklanır

3. Entegrasyon Adımları

1

Kullanıcı adı/şifre bilgilerinizi hazırlayın

Bakanlık'tan aldığınız U-ETDS erişim bilgilerini bir kenara not edin. Bu bilgiler entegrasyon sağlayıcınıza (ör. SeferBildirim.com) tanımlanacaktır.

2

Araç ve personel bilgilerinizi sisteme kaydedin

Plaka, kapasite ve şoför/personel bilgileri bir kere girilir; sonraki her seferde tekrar tekrar yazmanıza gerek kalmaz.

3

Bağlantıyı test edin

Gerçek bir sefer göndermeden önce, kullanıcı adı/şifre kombinasyonunun Bakanlık sunucusuna başarıyla bağlandığını doğrulayan bir test isteği gönderilir.

4

İlk seferinizi oluşturun

Sefer bilgileri ve yolcu listesi girildiği anda sistem otomatik olarak U-ETDS'e bildirim gönderir ve Bakanlık'tan gelen onay/referans numarasını kaydeder.

5

Bildirim geçmişinizi izleyin

Her seferin bildirim durumu (başarılı, beklemede, hata) panelde görünür hâle gelir; denetimde ibraz edilecek kayıtlar tek yerde tutulur.

4. Entegrasyon Sırasında Dikkat Edilmesi Gerekenler

Bakanlık'ın U-ETDS servisleri zaman zaman anlık gecikme veya geçici hata verebilir. İyi bir entegrasyon çözümü, böyle durumlarda bildirimi otomatik olarak yeniden dener ve sonucu sizinle şeffafça paylaşır — bildirimin gerçekten Bakanlık'a ulaşıp ulaşmadığını asla tahmin etmek zorunda kalmazsınız.

Sık Sorulan Sorular

U-ETDS entegrasyonu ne kadar sürer?

Bakanlık başvurusu ve API erişim onayı firmanın mevcut durumuna göre birkaç iş günü sürebilir. Onay alındıktan sonra hazır bir platforma bağlanmak genellikle aynı gün içinde tamamlanır.

Kendi yazılımımızla mı bağlanmalıyız, hazır bir platform mu kullanmalıyız?

Kendi yazılımınızı sıfırdan geliştirmek SOAP servis dokümantasyonu, hata yönetimi ve sürekli bakım gerektirir. Küçük ve orta ölçekli firmalar için hazır bir U-ETDS otomasyon platformuna abone olmak çok daha hızlı ve düşük maliyetlidir.

Entegrasyon için hangi belgeler gerekir?

Firma yetki belgesi (D1, D2, D4, A1, A2, B1, B2, F1, F2 vb.), vergi kimlik bilgileri ve Bakanlık'tan alınacak U-ETDS kullanıcı adı/şifre bilgileri gereklidir.

U-ETDS Entegrasyonu Nasıl Yapılır? Adım Adım Rehber