İçeriğe atla
SinaptikLabAI KNOWLEDGE PLATFORM

TEMSİLÎ VAKA · LOJİSTİK

Gümrük belge setinde eksik alan tespiti

Bir uluslararası taşıma ve gümrükleme operasyonunda ihracat dosyaları elle kontrol ediliyordu: fatura, çeki listesi, taşıma senedi, dolaşım veya menşe belgesi ve varsa uygunluk yazıları yan yana açılıp alan alan karşılaştırılıyordu. Eksik ya da çelişkili bir alan çoğu zaman dosyanın gümrükte beklemesiyle ortaya çıkıyordu; düzeltme maliyetinin en yüksek olduğu nokta da tam orasıydı. Hangi belge tipinde hangi alanın sık hata verdiği hiçbir yerde tutulmadığı için kontrol listesi uzmanın hafızasına bağlıydı. Yeni başlayan birinin hangi dosyayı kime sorduğu da kayıt dışıydı.

Beklenen etki

Kapsam
İhracat dosyalarında ticari ve taşıma belgeleri ön kontrolden geçiyor; kuruma özel izin yazıları doğrudan insan kuyruğuna yönleniyor
Ölçüm
Eksik alanın ön kontrolde mi, imza öncesi insan kontrolünde mi yoksa gümrük aşamasında mı yakalandığı ayrı izleniyor
Görünürlük
Belge tipi ve alan bazında hata dağılımı raporlanabiliyor; kontrol listesi kişisel hafızadan çıktı
Karar sınırı
Tarife pozisyonu yalnızca öneri olarak gösteriliyor, hiçbir alana otomatik yazılmıyor

Temsilî senaryo: buradaki satırlar ölçüm sonucu değil, bu kurulumda hangi büyüklüğün izlenmesi gerektiğini gösterir.

TEMSİLÎ SENARYO

Bu kayıt gerçek bir müşteri işi değildir. Sinaptik Lab'in bu problemde izlediği yaklaşımı, mimari kararları ve ölçüm düzenini göstermek için yazılmış temsilî bir senaryodur: kurum adı taşımaz, içindeki hiçbir değer gerçek ölçüm değildir ve referans olarak gösterilemez. Gerçek projelerden vakalar müşteri onayı alındıkça bu kütüphaneye eklenir.

Problem

Bir uluslararası taşıma ve gümrükleme operasyonunda ihracat dosyaları elle kontrol ediliyordu: fatura, çeki listesi, taşıma senedi, dolaşım veya menşe belgesi ve varsa uygunluk yazıları yan yana açılıp alan alan karşılaştırılıyordu. Eksik ya da çelişkili bir alan çoğu zaman dosyanın gümrükte beklemesiyle ortaya çıkıyordu; düzeltme maliyetinin en yüksek olduğu nokta da tam orasıydı. Hangi belge tipinde hangi alanın sık hata verdiği hiçbir yerde tutulmadığı için kontrol listesi uzmanın hafızasına bağlıydı. Yeni başlayan birinin hangi dosyayı kime sorduğu da kayıt dışıydı.

Yaklaşım

Kurulan şey belgeyi okuyup karar veren tek bir model değil, okuma ile kararın ayrıldığı iki katmanlı bir akış oldu. Dil modeli belge tipini sınıflandırıyor, alanları çıkarıyor ve gerektiğinde doğrulama servislerini araç olarak çağırıyor; uygunluk kararını ise kural motoru veriyor, çünkü aynı dosyanın iki kez aynı sonucu vermesi ve her ret sebebinin bir kural kimliğine bağlanması gerekiyordu. Araçlar dar imzalı tutuldu: tarife pozisyonu arama, vergi kimliği doğrulama, birim ve ağırlık tutarlılığı, kur karşılığı. Düşük güvenli çıkarımlar karara hiç girmiyor, doğrudan insan kuyruğuna düşüyor. Beyanname imzası akışın dışında bırakıldı; sistem yalnızca imza öncesi bir ön kontrol raporu üretiyor.

Kullanılan teknolojiler

  • Belge tipi sınıflandırma
  • Alan bazlı güven eşiği
  • Dar imzalı araç çağırma
  • Deterministik kural motoru
  • İnsan onay kuyruğu
  • Karar izi kaydı
01VAKA ANLATIMI

Bağlam, kurulum ve ölçüm

Problem ve yaklaşım özetin üstünde; burada kararların gerekçesi ve mimarinin ayrıntısı var.

Bağlam ve kısıtlar#

Bir ihracat dosyası tek bir yerde durmuyor: fatura ve çeki listesi müşteri portalından ya da e-posta ekinden geliyor, taşıma senedi taşıyıcıdan, dolaşım ve menşe belgeleri kâğıt kökenli taranmış görüntü olarak, izin ve uygunluk yazıları ise kurum yazışması olarak. Beyanname bu belgelerin toplamından kuruluyor ve elektronik gümrük sistemine giriliyor. İşin insan kararı zorunlu adımı belli: beyannameyi imzalayan gümrük müşavirinin hukuki sorumluluğu devredilebilir bir şey değil.

Kısıtların ilki hata maliyetinin asimetrik olması: bir dosyaya yanlışlıkla 'eksik' demek birkaç dakika, yanlışlıkla 'tam' demek araç limanda beklerken çözülen bir problem demek. İkincisi zaman baskısı — kontrol, aracın hareket saatiyle yarışıyor. Üçüncüsü belge kalitesi: telefonla çekilmiş eğik fotoğraflar, el yazılı düzeltmeler, aynı sette Türkçe, İngilizce ve Almanca faturalar. Bu üç kısıt birlikte, 'her şeyi okuyup karar veren tek model' fikrini baştan eledi.

Veri ve erişim#

Belgeler üç ayrı yerde birikiyordu: operasyon posta kutusu ekleri, dosya yönetim sistemi ve müşteri portalı yüklemeleri. Erişim de bu üçünde farklı kuruluydu; operasyon uzmanı kendi dosyalarını, gümrük müşaviri tümünü, muhasebe yalnızca faturayı görüyordu. Sistem tek bir servis kimliğiyle her şeyi okuyup kullanıcıya göstermek yerine, sorgu anında kullanıcının yetki kapsamını uyguluyor; ön kontrol raporu da dosyanın kendisiyle aynı yetkiye bağlı.

  • Ticari fatura ve çeki listesi: portal yüklemesi veya e-posta eki; aynı dosya için birden çok sürüm bulunabiliyor
  • Taşıma senedi ve araç bilgisi: taşıyıcıdan geliyor, sürücü adı ve kimlik bilgisi içeriyor
  • Dolaşım ve menşe belgeleri: kâğıt kökenli, büyük kısmı taranmış görüntü
  • İzin ve uygunluk yazıları: kurum yazışması; yalnızca gümrük müşaviri erişiminde
  • Dosya künyesi ve beyanname taslağı: operasyon sisteminde; ön kontrol raporu buna bağlanıyor

Mimari kararlar#

Tasarımın omurgası tek bir ayrım: model okur, kural karar verir. Model belge tipini bulur, alanları çıkarır, gerektiğinde doğrulama aracını çağırır ve her çıkarıma bir güven değeri yazar; kural motoru bu alanları alıp kontrol listesini işletir ve her ret için bir kural kimliği üretir. Böylece rapor 'model böyle düşündü' değil 'şu kural şu alanda tetiklendi' biçiminde okunuyor. Aşağıdaki kararların hepsi bu ayrımın sonucu.

KararSeçilen yolNeden
Uygunluk kararını kim verirKural motoru; model yalnızca okur ve araç çağırırRet sebebinin bir kural kimliğine bağlanması ve aynı girdide aynı sonucun üretilmesi gerekiyordu
Araç tasarımıHer doğrulama için dar imzalı ayrı araçTek geniş araçta model parametreleri yanlış eşliyor ve hatanın yeri görünmez oluyor
Düşük güvenli çıkarımKarara hiç girmez, insan kuyruğuna düşerBelirsiz okumayı karara katmak sessiz yanlış onay üretiyor
Tarife pozisyonuÖneri olarak gösterilir, otomatik yazılmazYanlış tarife beyanının idari sonucu var; öneriyi karara çevirmek sorumluluğu bulanıklaştırır
Belge eşleştirme anahtarıDosya adı değil, belge içeriğinden çözülen numara ve tarihYükleme sırası ve dosya adı sahada güvenilir değil
Tablo yalnızca karar gerekçelerini taşır; hiçbir satır performans iddiası değildir.

Güvenlik ve yetki#

Bir gümrük dosyası iki tür hassas veriyi birlikte taşıyor: kişisel veri (sürücü adı ve kimlik bilgisi, alıcı temsilcisinin iletişim bilgisi) ve ticari sır (birim fiyat, müşteriye özel iskonto). KVKK tarafında veri minimizasyonu ve amaç sınırlaması bu yüzden teknik bir kısıt hâline geldi: çıkarımdan sonra saklanan alanlar kontrol için gerekenlerle sınırlandı, ham görüntünün saklama süresi dosya kapanışına bağlandı. Model sağlayıcısının yurt dışında olduğu kurulumda aktarım kapsamı ayrıca değerlendirildi ve hangi alanların dışarı çıktığı yazılı hâle getirildi. Erişim rol bazlı; denetim izinde hangi dosyada hangi araç çağrıldı ve hangi kural tetiklendi görünüyor.

Ölçüm düzeni#

  • Alan bazında insan düzeltmesi: hangi belge tipinde hangi alan düzeltiliyor
  • Yakalama yeri: eksikliğin ön kontrolde, imza öncesi kontrolde ya da gümrük aşamasında çıktığı ayrı ayrı
  • Araç çağrısı sağlığı: zaman aşımı, boş yanıt ve şema dışı yanıt sınıfları ayrı izleniyor
  • Kural motoru ile model anlaşmazlığı: okunan alanın kuralın beklediği biçime uymadığı durumlar
  • İnsan kuyruğuna düşen dosyalar ve düşme sebebinin dağılımı

Devreye alma ve işletme#

  1. 1Gölge koşu

    Ön kontrol raporu üretildi ama uzmana gösterilmedi; insanın vardığı sonuçla karşılaştırıldı

  2. 2Tek belge çiftiyle açılış

    Yalnızca ticari fatura ile çeki listesi karşılaştırması canlıya alındı, diğer tipler kuyrukta bırakıldı

  3. 3Kural kümesinin genişletilmesi

    Gümrükten dönen dosyaların sebepleri kural olarak yazıldı; her kurala bir kimlik ve bir sahip verildi

  4. 4Kuyruk ve nöbet

    Düşük güvenli çıkarımlar için insan kuyruğu ve gün içi bakış nöbeti tanımlandı

  5. 5Sürüm dondurma

    Model ve istem sürümü dosya kaydına yazıldı; sürüm değiştiğinde gölge koşu yeniden açıldı

Nerede yanıldık#

İlk sürümde tek bir istemle 'dosyayı incele ve eksikleri söyle' dendi; model eksik belgeyi eksik saymak yerine varsaydı ve raporu dolduramadığı yerde yumuşak bir dil kurdu. İkinci yanılgı daha sinsiydi: tarama kalitesini sabit varsaydık. Eğik çekilmiş fotoğraflarda alan çıkarımı bozulurken güven değeri yüksek kalmaya devam etti, yani güven değerinin kalibre edilmemiş olduğunu ancak insan düzeltmelerini alan bazında ayırmaya başladıktan sonra gördük. Bugün her yeni belge tipi, kendi küçük değerlendirme kümesi yazılmadan akışa alınmıyor.

02ÖĞRENİLEN DERSLER

Bir sonraki projede ne değişir?

Bir vakanın en değerli bölümü sonuç değil, tekrar edilebilir dersidir.

  1. 01

    Modele 'bu belge seti eksiksiz mi' diye sormak yanlış soruydu; model eksik belgeyi 'muhtemelen ekte' diye tolere ediyordu. Eksiklik sorusu kural motorunun işi, okuma işi modelin.

  2. 02

    Aynı dosyada faturanın birkaç sürümü bulunabiliyor. Dosya adına ve yükleme sırasına güvenmek sessiz hataya yol açtı; hangi sürümün geçerli olduğu belge içindeki numara ve tarihten çözülmeli.

  3. 03

    Geniş imzalı tek bir 'doğrula' aracı, model parametreleri birbirine karıştırdığı için başlı başına hata kaynağı oldu. Araç sayısını artırıp her birinin imzasını daraltmak, istem metniyle uğraşmaktan daha çok işe yaradı.

  4. 04

    Güven eşiğini tek bir sayı olarak tutmak işe yaramıyor; eşik alan bazında gerekiyor. Tutar alanındaki küçük bir sapmanın sonucu ile adres alanındaki sapmanın sonucu aynı değil.

  5. 05

    Taranmış belgelerde sayfa sırası bozuk geliyor. Ayrıştırmadan önce sayfa sınıflandırma adımı konmazsa çıkarım doğru alanları yanlış belgeye yazıyor.

03DİĞER VAKALAR

Vaka kütüphanesinden

BUILD

Aynı yaklaşımı kurumunuzda kurmak ister misiniz?

Discovery oturumunda mevcut durumunuzu, veri erişiminizi ve başarı tanımınızı birlikte yazıyoruz.