← Tüm entegrasyonlarBİLGE Sistemi
Entegrasyon · BİLGEScaffold
BİLGE Sistemi
Beyanname iletimi, kabul/red ve referans no — gerçek zamanlı
Türk Gümrük İdaresi BİLGE (Bilgisayarlı Gümrük Etkinlikleri) sistemine mTLS SOAP üzerinden doğrudan iletim. Beyanname XML hazırlama, gönderim, kabul/red yanıtı yakalama ve referans/tescil no parse — hepsi otomatik.
Yetenekler
Bu entegrasyonun sunduğu özellikler.
mTLS SOAP Client
BİLGE'nin gerektirdiği iki yönlü TLS şifreli iletişim, kurumsal sertifika destekli.
XML Üretim
BİLGE şemasına (xmlns="http://gtb.gov.tr/bilge/schema/v1") uygun beyanname XML.
Status Tracking
Prepared → Submitted → Accepted / Rejected — tüm geçişler zaman damgalı kayıt.
Referans No Parse
BİLGE cevabından ReferansNo, BeyannameNo, TescilNo otomatik çıkarılır.
SOAP Fault Yakalama
Hata yanıtları tam olarak gösterilir, düzeltme için yönlendirme.
Submission Geçmişi
Her case için tüm iletim denemelerinin tam log'u (XML, response, status).
İş akışı
01
Sertifika tanımla
BILGE_CLIENT_CERT_PATH, BILGE_CLIENT_KEY_PATH, BILGE_CA_BUNDLE_PATH env'lere eklenir.
02
XML hazırla
Beyanname Asistanı validation'dan geçti mi? XML üret butonu aktif.
03
Submit
mTLS handshake + SOAP envelope + BİLGE endpoint'e POST.
04
Yanıt işle
Accept ise referans no kayıt, Reject ise hata sebep göster.
Faydalar
- ✓Müşaviriniz manuel BİLGE giriş yapmaz, dakikalar yerine saniyeler
- ✓Hata yanıtları yapılandırılmış görüntülenir (kod + mesaj + alan)
- ✓Geçmiş iletim audit-ready (her XML + response saklanır)
- ✓Dosya bazlı submission listesi, status görseli
Sıkça sorulanlar
Sertifika nereden alınır?
Gümrük İdaresi (Ticaret Bakanlığı) onaylı kurumsal sertifika sağlayıcıları. Şirket adına başvuru gerekiyor.
Sertifika yokken ne yapabilirim?
XML üretip indirilebilir, "Manuel İletildi" işaretiyle status takibi yapılır.
Test ortamı var mı?
Gümrük'ün UAT ortamı için ayrı sertifika alınır. Endpoint env değişkeni ile yönlendirilir.