e-İrsaliye ve Depoda Barkod Entegrasyonu

e-İrsaliye ile birlikte sevkiyat belgesi kâğıt olmaktan çıktı: mal yola çıkmadan önce alıcının sistemine bir XML dosyası düşüyor. Buna rağmen pek çok depoda mal kabul hâlâ eskisi gibi yürüyor — belge ekrandan okunuyor, kalemler gözle karşılaştırılıyor, miktarlar elle giriliyor.

Sebep genelde yazılım eksikliği değil. Sorun daha temel bir yerde: belgedeki ürün kodu ile raftaki barkod aynı şeyi söylemiyor. Entegrasyon tam orada duruyor.

Bu yazıda e-İrsaliyenin barkodla nerede kesiştiğini, kalem satırında ürün kimliğinin nerede durduğunu, eşleştirmenin nasıl kurulduğunu ve mal kabul akışının pratikte nasıl işlediğini anlatıyoruz.

Önce Kavram Karışıklığını Temizleyelim: Üç Ayrı Kod

Bir sevkiyatta üç ayrı kod bulunur ve üçü tamamen farklı sorulara cevap verir. Bunları birbirine karıştırmak, entegrasyon projelerinde en sık yapılan hatadır.

• Belge karekodu — "hangi belge?" e-Belgelerin üzerinde bulunan karekod, belgenin kendisini tanımlar: taraf vergi kimlik numaraları, belge numarası, tarih, ETTN gibi alanlar taşır. 1 Eylül 2023'ten itibaren kapsamdaki e-belgelerde zorunludur. Ürün hakkında hiçbir bilgi taşımaz.
• Ürün barkodu — "hangi ürün?" Ambalajın üzerindeki EAN-13 veya kolinin üzerindeki ITF-14. Ürün çeşidini tanımlar, tek tek kutuyu değil. Ayrıntısı GTIN nedir yazımızda.
• Taşıma birimi kimliği — "hangi palet?" GS1 dünyasında SSCC. O tek paletin ya da kolinin dünyada benzersiz numarasıdır. GS1-128 ve uygulama tanımlayıcıları yazımızda ayrıntılı anlattık.

Depo personeline "irsaliyenin karekodunu okut" dendiğinde ürün kaydının açılmasını beklemek, bu üç katmanı karıştırmanın tipik sonucudur. Belge karekodu yalnızca belgeyi getirir; malı saymaz.

e-İrsaliye Kaleminde Ürün Kimliği Nerede Durur?

e-İrsaliye, UBL-TR temelli bir XML belgesidir. Her sevkiyat kalemi bir DespatchLine satırıdır ve ürün bilgisi bu satırın içindeki Item bloğunda taşınır.

Burada kritik bir ayrıntı var: şemada "GTIN" adında ayrılmış zorunlu bir alan yoktur. Ürün kodu, üç ayrı tanımlayıcıdan birine yazılır:

• SellersItemIdentification — satıcının kendi ürün kodu. Pratikte neredeyse her e-İrsaliyede doludur, çünkü satıcının ERP'si bu kodu zaten üretir. Sizin sisteminizde ise bir karşılığı yoktur.
• BuyersItemIdentification — sizin stok kodunuz. Satıcı bunu sipariş sırasında öğrendiyse doldurur. Doluysa eşleştirme sorunu kendiliğinden ortadan kalkar.
• ManufacturersItemIdentification — üreticinin kodu. GTIN'i taşımak için pratikte tercih edilen alandır, ancak standart bunu zorunlu kılmaz.

Yani "GTIN hangi alana yazılacak?" sorusunun standart bir cevabı yoktur — taraflar arasında kararlaştırılan bir konudur. Entegrasyona başlamadan önce bunu yazılı hâle getirmek, sonradan yüzlerce satırı elle düzeltmekten çok daha ucuzdur.

Alan adları ve zorunluluk durumları UBL-TR sürümüne göre değişebilir. Geliştirmeye başlamadan önce Gelir İdaresi Başkanlığı'nın yayımladığı güncel e-İrsaliye paketindeki şemayı doğrulayın.

Eşleştirme Tablosu: Entegrasyonun Asıl İşi

Satıcının kodunu kendi stok kodunuza bağlayan bir tablo yoksa, e-İrsaliye elle işlenen bir PDF'ten farksızdır. Otomasyonun tamamı bu tablonun doluluk oranına bakar.

Tabloyu doldurmanın üç yolu vardır:

1. Siparişte verin. Kendi stok kodunuzu sipariş belgesinde satıcıya bildirin; e-İrsaliyede BuyersItemIdentification olarak geri gelsin. En temiz yol budur, çünkü eşleştirme belgenin kendisinde çözülmüş olur.
2. GTIN üzerinden yürüyün. Karşılıklı olarak GTIN taşımayı kararlaştırın. GTIN ürün ambalajındaki barkodla birebir aynı olduğu için, depoda okutulan kod doğrudan belge satırına oturur. Açık tedarik zincirinde çalışıyorsanız en sağlam seçenek budur.
3. İlk kabulde öğrenin. Eşleşmeyen satırda operatör bir kez elle bağlar, sistem bunu kaydeder ve bir dahakine otomatik eşleşir. Hızlı başlar; riski, ilk seferde yapılan yanlış eşleştirmenin kalıcılaşmasıdır. Bu yolu seçerseniz elle yapılan bağlamaları ayrıca gözden geçirin.

Tablo bir kez kurulup unutulacak bir şey değildir. Yeni ürün, ambalaj değişikliği, tedarikçi kodu güncellemesi — hepsi tabloyu eskitir. Bakımı belirli bir kişinin sorumluluğunda olmalıdır.

Ambalaj değişikliğinin GTIN'i ne zaman değiştirdiği ayrı bir konu; GTIN nedir yazımızda ele aldık.

Mal Kabul Akışı: Belge Sistemde, Mal Kapıda

1. Belge düşer

e-İrsaliye sisteminize gelir ve kalemler "beklenen giriş listesine" dönüşür. Bu aşamanın en değerli tarafı şudur: eşleşmeyen satırları mal kapıya gelmeden önce görürsünüz. Tırın rampada beklediği anda kod araştırmak, en pahalı çözme biçimidir.

2. Fiziksel okutma

Palet etiketi varsa önce o okutulur, sonra ürünler. Okutulan her kod beklenen listeye karşı işler; sayaç ilerledikçe operatör kaç kalemin kaldığını görür.

Burada cihaz seçimi doğrudan hızı belirler: rampada çalışan bir ekip için el terminali ile sabit okuyucunun farkı gün sonunda saatlere karşılık gelir. Barkod okuyucu seçimi yazımızda form faktörlerini karşılaştırdık.

3. Mutabakat

Okunan miktar ile belgedeki miktar karşılaştırılır. Fark varsa sebebiyle birlikte kaydedilir: eksik gelmiş mi, hasarlı mı, yanlış ürün mü? Sebebi yazılmayan fark, bir sonraki sayımda karşınıza aynı şekilde çıkar. Bu, stok sayımında barkod kullanımı yazımızda anlattığımız mutabakat mantığının aynısıdır — sayım farklarının önemli bir bölümü zaten mal kabulde doğar.

4. e-İrsaliye yanıtı

Sayım sonucunuz burada belgeye dönüşür. Sevkiyatı tümüyle kabul edebilir, bir kısmını kabul edip bir kısmını reddedebilir (kısmi kabul) ya da tümüyle reddedebilirsiniz.

Önemli olan şu: yanıt vermezseniz sevkiyat sistemsel olarak eksiksiz teslim alınmış sayılır. Barkodla yaptığınız sayımın belgeye dönüşmediği bir kurulumda, fark sizin stoğunuzda kalır. Yanıt süreleri ve usul kuralları için Gelir İdaresi Başkanlığı'nın güncel e-İrsaliye kılavuzuna bakın — bu süreler tebliğ değişiklikleriyle güncellenebiliyor.

Palet Seviyesi: Tek Okutmayla Mal Kabul

24 kolilik bir paleti tek tek okutmak 24 ayrı hata ihtimali demektir. Operatör yorulduğunda miktar tuşuna kaçar ve koli bazlı izlenebilirlik orada biter.

SSCC bu sorunu çözer: palet etiketindeki (00) uygulama tanımlayıcılı GS1-128 barkodu bir kez okutulur, sistem o paletin içeriğini bilir ve belgedeki satırların tamamını açar.

Ön koşul şu: hangi SSCC'nin içinde hangi ürünlerin olduğu bilgisinin size önceden ulaşmış olması gerekir. Bu bilgi klasik olarak sevkiyat bildirimi (DESADV) mesajıyla taşınır ve e-İrsaliyenin kendisinde gelmeyebilir. SSCC'yi e-İrsaliyeye iliştirmek standart bir zorunluluk değildir; kullanacaksanız hangi alanda taşınacağını taraflarca kararlaştırın.

Palet etiketinin fiziksel tarafı da ihmal edilmemeli. Etiket haftalarca depoda kalacaksa direkt termal yerine termal transfer tercih edilir (barkod yazıcı seçimi), streç filmin altında kalacaksa yüzey malzemesi buna göre seçilir (barkod etiketi malzeme rehberi). Etiketin paletin en az iki bitişik yüzüne yapıştırılması kuralı da buradan gelir — ayrıntısı barkod etiketi ölçüleri ve yerleşim kuralları yazımızda.

Kimler e-İrsaliye Kullanmak Zorunda?

Zorunluluk kapsamı iki ayrı ölçüte bakıyor: ciro ve faaliyet konusu.

Ciro tarafında brüt satış hasılatı belirli bir eşiğin üzerinde olan mükellefler kapsama giriyor. Faaliyet tarafında ise cirodan bağımsız olarak bazı sektörler doğrudan zorunlu tutuluyor — maden, şeker, demir-çelik, gübre ve ÖTV kapsamındaki malları imal/ithal edenler bunların başında geliyor.

Rakam ve tarih vermekten kaçınıyoruz, çünkü eşikler ve geçiş takvimleri tebliğ değişiklikleriyle güncelleniyor; ikinci el kaynaklarda birbiriyle çelişen değerler dolaşıyor. Kendi durumunuzu Gelir İdaresi Başkanlığı'nın e-Belge mevzuat sayfasından ya da mali müşavirinizden teyit edin.

Barkod tarafı açısından pratik sonuç şu: kapsama girdiğiniz an, mal kabulünüzün belgeyle konuşabilmesi gerekir. Bunu hazırlıksız yakalanmadan kurmak, sonradan kurmaktan çok daha kolaydır.

Kurulum Kontrol Listesi

1. Ürün kodunun hangi alanda geleceğini yazılı olarak kararlaştırın. Satıcının kodu mu, GTIN mi, sizin kodunuz mu — ilk sevkiyattan önce.
2. Eşleştirme tablosunu kurun ve sahibini belirleyin. Tabloyu kimin güncelleyeceği belli değilse tablo altı ayda ölür.
3. Eşleşmeyen satırları belge düştüğü anda raporlayın. Rampada değil, ofiste çözün.
4. Belge karekodu ile ürün barkodunu ayırın. Personel eğitiminde bu ikisini açıkça ayırın; el terminali yazılımında da farklı davranmalı.
5. Fiziksel okutmayı gerçekten yapın. "Belgede 240 yazıyor, 240 girelim" alışkanlığı entegrasyonun tüm faydasını siler.
6. Farkı sebebiyle kaydedin. Sebepsiz düzeltme, farkı yok etmez; yalnızca görünmez yapar.
7. Yanıtı otomatikleştirin. Mutabakat sonucunun e-İrsaliye yanıtına dönüşmesi elle yapılan bir adım olarak kalırsa, yoğun günlerde atlanır.
8. Etiket kalitesini ölçün. Okunamayan barkod, entegrasyonu elle girişe düşüren en sessiz sebeptir. Barkod neden okunmuyor yazımızdaki kontrol listesi mal kabul için de geçerlidir.

Sıkça Sorulan Sorular

e-İrsaliyenin karekodunu okutunca ürünler sisteme girer mi?

Hayır. Belge karekodu belgeyi tanımlar — taraflar, belge numarası, tarih gibi alanlar taşır. İçinde ürün listesi yoktur. Ürün girişi için ürün barkodlarının ya da palet etiketinin okutulması gerekir.

Satıcı bize GTIN göndermiyor, ne yapmalıyız?

Üç seçeneğiniz var: sipariş belgesinde kendi stok kodunuzu bildirip BuyersItemIdentification alanında geri istemek, satıcıyla GTIN taşımayı kararlaştırmak, ya da satıcı kodu ile kendi kodunuz arasında bir eşleştirme tablosu tutmak. Uzun vadede en az bakım isteyen yol GTIN'dir.

e-İrsaliyede SSCC alanı var mı?

SSCC için ayrılmış, standart olarak zorunlu bir alan bulunmuyor. Palet seviyesinde çalışacaksanız bu bilgiyi hangi alanda taşıyacağınızı karşı tarafla kararlaştırmanız gerekir. Klasik çözüm, palet içeriğini ayrı bir sevkiyat bildirimi mesajıyla göndermektir.

Depoda kendi barkodumuzu kullanabilir miyiz?

Evet. Kendi deponuzun içinde kalan kodlar için GS1 üyeliğine gerek yoktur; Code 128 ile kendi şemanızı basabilirsiniz. Ancak e-İrsaliyeyle eşleşmesi gereken kod, karşı tarafın da tanıdığı bir koddur — iç kodunuz o rolü tek başına üstlenemez. İkisini eşleştirme tablosuyla birbirine bağlarsınız.

Kısmi kabul yaptığımızda reddedilen mal ne oluyor?

Reddedilen kısım için satıcı tarafında düzeltici işlem gerekir. Sizin açınızdan kritik olan, reddi sayıma dayandırmaktır: hangi kalemde kaç adet eksik çıktığı barkodla belgelenmişse itiraz süreci kısa sürer.

Mal kabulde okutulan barkod ile sayımda okutulan barkod aynı mı olmalı?

Evet, aynı kimlik katmanında olmalı. Mal kabulde GTIN okutup depo içinde kendi kodunuzu kullanırsanız, iki dünya arasında sürekli çeviri yaparsınız. Baştan tek bir ürün kimliği seçip diğerlerini ona bağlamak daha sağlıklıdır.

Sonuç

e-İrsaliye, sevkiyat bilgisini malın kendisinden önce alıcıya ulaştırır. Bu bilginin değeri, depodaki fiziksel okutmayla buluştuğu anda ortaya çıkar — buluşmazsa elinizde yalnızca ekrandan okunan yeni bir belge formatı olur.

Köprüyü kuran şey karmaşık bir yazılım değil, iki basit karardır: ürün kimliğinin hangi alanda taşınacağını baştan kararlaştırmak ve eşleştirme tablosunun bakımını birine emanet etmek. Bu ikisi yerindeyse, geri kalanı okutmadan ibarettir.

Lojistik etiketin nasıl kurulduğunu GS1-128 ve uygulama tanımlayıcıları, depo içindeki sayım tarafını ise stok sayımında barkod kullanımı yazımızda ayrıntılı anlattık.