Nilvera'da gönderilen e-irsaliyenin PDF, XML ve HTML hâli ayrı uçlarla alınır. PDF, metin olarak kodlanmış hâlde; XML ise düz metin olarak gelir, bu yüzden ikisi farklı çözülür. İmzayı sağlayıcı ekler ve belgenin görsel tasarımını da kendisi gömer; kantar tarafından ek bir tasarım dosyası gerekmez.
Üç çıktı
Sağlayıcı, gönderilmiş her belge için üç çıktı sunar: kâğıda basılabilen PDF, ekranda okunan HTML görünümü ve belgenin makine okunur asıl hâli olan XML. Üçü de aynı belgeden türer.
| Biçim | En uygun kullanım |
|---|---|
| Arşiv, çıktı alma, alıcıya iletme | |
| HTML | Ekranda hızlı kontrol |
| XML | Muhasebe, denetim, kayıt eşleştirme |
Genel arşiv yaklaşımı e-irsaliye PDF ve XML arşivi yazısında; Nilvera'ya özgü ayrıntılar aşağıda.
Farklı sarmalama biçimleri
Üç çıktı aynı biçimde gelmez. Denememizde PDF, bir metin alanının içinde kodlanmış olarak geldi; kod çözülünce gerçek bir PDF dosyası ortaya çıktı. XML ise düz metin olarak, yine bir metin alanının içinde geldi ve ayrıca kodlanmamıştı. Bu fark küçük görünür ama atlanırsa hata verir: XML'i kod çözücüden geçirmek bozuk veri, PDF'i düz metin saymak geçersiz dosya üretir.
- PDF. Önce kodu çözülür, sonra dosya olarak kaydedilir.
- XML. Olduğu gibi okunur ve kaydedilir.
- HTML. Ekranda gösterilir; saklanması gerekmez.
Bu yüzden her çıktı için ayrı bir çözümleme adımı yazılır. Aynı davranış başka sağlayıcılarda farklı olabilir; bu yüzden her sağlayıcının çıktısı ayrı ayrı denenir.
İmzayı kim ekliyor?
Gönderdiğimiz belgede imza yoktu. Sağlayıcının sakladığı XML'e bakıldığında imza bölümü ve imza bilgileri eklenmişti. Yani mali mühür işlemini Nilvera yürütüyor. Belgenin içeriği olduğu gibi korundu: belge numarası, iki taraf vergi bilgisi, plaka ve birim kodu aynen yerindeydi.
Bunun pratik anlamı, kantar tarafında imza sertifikası ya da imza işlemi tutmak zorunda olmamaktır. Bu, kurulumu belirgin biçimde sadeleştirir. Ancak belgeye eklenen bölümleri bilmek, ileride XML'i muhasebe yazılımına aktarırken beklenmedik bölümlerle karşılaşmamak için faydalıdır.
Tasarım şablonu
Belgenin görsel tasarımı için gereken şablon da sağlayıcı tarafından belgeye gömülür. Bazı sağlayıcılarda hesapta bir tasarım şablonu tanımlamak gerekir; Nilvera'da kantar tarafının ayrıca bir tasarım dosyası göndermesi gerekmedi. Önizleme ve PDF'in görünümünde irsaliye numarası, taraf bilgileri, plaka, şoför adı, malzeme ve miktar yer aldı.
Tek eksik, kalem kodunun görünümde basılmamasıydı; kod XML'de mevcuttu. Yani veri kaybı yok, yalnız bir sunum tercihi var. Şoför ve plaka gibi taşıma alanlarının belgede nasıl durduğunu taşıyıcı, şoför ve dorse bilgileri yazısında anlattık.
Kantar kaydında saklama
Belge sonucu belli olduktan sonra PDF ve XML tartım kaydına eklenir; böylece kaydın içinden belgenin kendisine ulaşılır. Bir ihtilafta esas olan imzalı XML'dir; PDF onun okunur hâlidir. Bu iki dosyayı aynı kayıtta tutmak, ileride belgeyi savunmayı kolaylaştırır. Hazırlık durumunu Nilvera rehber yazısında bulabilir, demo için iletişim sayfasına yazabilirsiniz; demo ücretsizdir.
Sık sorulan sorular
Nilvera'da PDF nasıl alınır?
Sağlayıcı, gönderilmiş belgenin PDF'ini üreten bir uç sunar. Yanıt, PDF dosyasının metin olarak kodlanmış hâlini içerir; kodu çözünce geçerli bir PDF elde edilir.
XML de aynı biçimde mi gelir?
Hayır. XML düz metin olarak, bir metin alanının içinde gelir; PDF'teki gibi ayrıca kodlanmaz. Bu yüzden iki çıktı için ayrı çözümleme gerekir.
Belgeyi kim imzalıyor?
İmzayı Nilvera ekler. Saklanan XML'de imza bölümü bulunur; biz imza göndermedik. Belgenin diğer alanları olduğu gibi korunur.
Belge tasarımını bizim vermemiz gerekir mi?
Hayır. Görsel tasarım için gereken şablon belgeye sağlayıcı tarafından gömülür; kantar tarafında ayrıca tasarım dosyası eklemek gerekmez.
STEQAR bu görüntülemeyi Nilvera için şimdi sunuyor mu?
Henüz değil. Çıktılar sağlayıcı tarafında denendi; STEQAR'ın Nilvera bağlantısı hazırlık aşamasındadır.
STEQAR, SCP Bilişim ve Otomasyon Sistemleri'nin geliştirdiği kantar programıdır; Türkiye genelinde uzaktan kurulum ve destek verir.