e-Belge dizaynı nedir, nereden düzenlenir?
e-Belge dizaynı, faturanızın XML içeriğini insan gözüyle okunabilir bir görsele çeviren XSLT şablonudur. Mikro Yazılım kullanıcıları için bu şablon E-Mikro Portalı’nda Ayarlar > e-Belge Dizayn > Gelişmiş Tasarım Modu altında durur. Temel düzeyde HTML ve CSS bilgisiyle şablona yeni alan ekleyebilir, mevcut alanların yerini değiştirebilirsiniz.
Dizayn ekranına nasıl girilir?
ERP programlarında hazırladığımız evrakların görsel çıktılarını, e-dönüşüm dizaynları ile ortaya çıkarırız. Bir satış faturası program içerisinde e-Fatura veya e-Arşiv olarak dönüştürüldüğünde, bu faturayı görsel olarak göstermek isteriz. Bu isteğin karşılığında ilgili faturanın XML içeriği bir XSLT dizaynı tarafından okunur.
Bu XSLT dizaynı, Mikro Yazılım için E-Mikro Portalı’nda yer alır. Portala girdiğimizde, sol altta yer alan Ayarlar sekmesinin altındaki e-Belge Dizayn alanında Gelişmiş Tasarım Modu adında bir bölüm görürüz. Bu bölümde ilgili e-dönüşüm ürününü (e-Fatura, e-Arşiv veya e-İrsaliye) seçerek dizaynımızı yaparız.
Varsayılan tasarım ne zaman yetmez?
Mikro Yazılım, bizlere hâlihazırda kullanabileceğimiz varsayılan bir tasarım sunmaktadır. Bu tasarımda, son güncellemeler ile gelen tüm senaryoların içerikleri bulunabilir. Ancak burada şöyle bir ihtiyaç ortaya çıkmaktadır: uzun zamandır kullandığınız bir tasarım için yeni bir senaryo alanı eklemek veya müşterilerinize özel yeni bir bilgiyi bu dizayna dahil etmek istediğinizde manuel düzenleme yapmanız gerekecektir.
XSLT tasarımı nasıl okunur?
Temel seviyede HTML ve CSS bilgisi, bu XSLT tasarımını anlamanıza yetecektir. Bu tasarım, temel bir web sitesi mantığıyla çalışır. Görselde yukarıda gördüğünüz elementlerin kodları, tasarımda da yine üst kısımlarda yer alır. Örneğin, faturanın sol üstünde alıcı ve gönderici bilgileri yer alırken orta kısımlarda fatura kalemleri bulunur. Kod tarafında da cari ve gönderici ile ilgili alanlar üst satırlardayken, fatura kalemlerine ait alanlar daha aşağıda yer alır. Genel bir kontrol yaptığınızda, hangi alanda hangi bilgilerin yer aldığını başlıklardan da anlayabilirsiniz.
En önemli kısım: select alanları ve XML yolu
Bizim için en önemli kısım ise tag’ler içinde gördüğünüz select alanlarıdır. Bu alanlara baktığınızda bir çeşit path (yol) görürsünüz. Bu path’ler, XML tag’lerinin hiyerarşik isimleridir. Örnek: stokların ismi XML içerisinde Invoice > InvoiceLine > Item > Name hiyerarşisinde yer alır. XML içeriklerindeki tag alanlarının bu hiyerarşisi, XSLT tasarımını oluştururken büyük önem taşır.
Varsayılan tasarımda bir örnek
Varsayılan XSLT tasarımında bu alanın nasıl getirildiğine bakalım:
<xsl:template match="//n1:Invoice/cac:InvoiceLine">
<tr id="lineTableTr">
<td id="lineTableTd" align="center">
<xsl:text> </xsl:text>
<xsl:value-of select="./cbc:ID"/>
</td>
<td id="lineTableTd">
<xsl:text> </xsl:text>
<xsl:value-of select="./cac:Item/cbc:Name"/>
....
Görüldüğü üzere, template’in başında tüm fatura kalemleri için ortak olacak şekilde tanım yapıldıktan sonra, her bir satırda alınması istenilen verinin tag yolu belirtilmiştir. Bu yöntem ile XML’de bulunan verileri rahatlıkla fatura görseline getirebilirsiniz.
Sık ihtiyaç duyulan alanlar
Uygulamada en çok eklenmesi istenen alanlar; sevkiyat ve etiket numaraları (bkz. İDİS fatura senaryosu), ihracat faturalarında gümrük müşavirliği bilgileri (bkz. e-İhracat faturası süreç yönetimi) ve firmaya özel açıklama sahalarıdır. Dizayn değişikliğinden sonra fatura hâlâ hatalı geçiyorsa sorun görselde değil belgede olabilir; e-Fatura hata kodları tablosuna bakmanızı öneririz.
Yardıma mı ihtiyacınız var?
XSLT üzerinde çalışmak istemiyorsanız dizaynınızı sizin adınıza düzenleyebiliriz. Mikro Yazılım teknik destek ve eğitim hizmetimiz kapsamında uzaktan bağlanarak firmanıza özel fatura görselini hazırlıyoruz. Henüz e-dönüşüme geçmediyseniz ücretsiz demo talebi oluşturabilir veya iletişim sayfamızdan bize ulaşabilirsiniz.
Destek Hattı: +90 216 449 20 65 – 66 (pbx)
Etiketler
Sık Sorulan Sorular
e-Fatura dizaynı nereden düzenlenir?
E-Mikro Portalı’na girip sol altta yer alan Ayarlar sekmesi altındaki “e-Belge Dizayn” alanına, oradan da “Gelişmiş Tasarım Modu” bölümüne ilerlemeniz gerekir. Bu ekranda düzenlemek istediğiniz e-dönüşüm ürününü (e-Fatura, e-Arşiv veya e-İrsaliye) seçerek tasarım üzerinde çalışabilirsiniz.
Dizayn düzenlemek için hangi teknik bilgi gerekir?
Temel seviyede HTML ve CSS bilgisi yeterlidir. XSLT tasarımı temel bir web sitesi mantığıyla çalışır: görselde üstte duran elemanların kodları da tasarımın üst kısmında yer alır, bu yüzden aradığınız alanı başlıklardan takip ederek bulabilirsiniz.
Dizayna yeni bir alan nasıl eklenir?
Eklemek istediğiniz verinin XML içindeki hiyerarşik yolunu (path) bulup bunu bir <code>xsl:value-of select="..."</code> ifadesiyle tasarıma yazmanız gerekir. Örneğin stok adı XML’de Invoice > InvoiceLine > Item > Name hiyerarşisinde durduğu için tasarımda <code>./cac:Item/cbc:Name</code> yolu kullanılır.
Mikro’nun varsayılan dizaynı yeterli mi?
Çoğu firma için yeterlidir; varsayılan tasarım son güncellemelerle gelen tüm senaryoların içeriklerini barındırır. Manuel düzenleme ihtiyacı genellikle iki durumda doğar: uzun süredir kullandığınız eski bir tasarıma yeni bir senaryo alanı eklemek istediğinizde ya da müşterilerinize özel bir bilgiyi faturada göstermek istediğinizde.