Logo Connect E-fatura Kural Tanımı Tarih: 16.12.2014 Her hakkı Logo Elektronik Ticaret Hizmetleri A.Ş' ye aittir.
İÇİNDEKİLER 1. E-fatura İşlemleri İçin Basit Kural Tanımları :... 4 1.1. Basit Kural Seçenekleri... 4 1.2. Basit Kural Koşul İşlemi... 9 1.3. Basit Kural İşlem Seçenekleri..... 13 1.3.1. Basit Kural İşlemler Onaya Gönder... 13 1.3.2. Basit Kural İşlemler - Onayla... 14 1.3.3. Basit Kural İşlemler - Paketle... 14 1.3.4. Basit Kural İşlemler - Kaydet... 15 1.3.5. Basit Kural İşlemler - Onay Geri al... 16 1.3.6. Basit Kural İşlemler Veri Üzerinden Değişiklik Yap... 16 1.3.7. Basit Kural İşlemler E-Posta Gönder... 20 1.3.8. Basit Kural İşlemler Klasöre Kaydet... 21 1.3.9. Basit Kural İşlemler - Onay Akış Grubu Seç... 22 1.3.10. Basit Kural İşlemler Serbest Alan Ekle... 23 2. E-fatura İşlemleri İçin Script Kural Tanımları :... 26 3. Oluşturulan Kuralın İçeri Alımı - Dışarı Aktarımı ve Devri :... 33
KURAL TANIMLARI Kural Tanımları, Logo Connect platform unun özelleştirilmesi amacıyla kullanılan geniş bir bölümdür. Logo Connect Kural Tanımı Bankacılık, B2B ve FDA Modüllerinin yanı sıra E-fatura Modülü içinde kullanılabilir. Logo Connect E-fatura Modülü Kural Tanımları, Gelir İdaresi Sistemine gönderilecek olan ve Gelir İdaresi Sisteminden gelen e-fatura,uygulama yanıtları ve sistem yanıtları için, elle yaptığımız bir takım işlemlerin otomatikleştirilmesi veya bu belgelerin XML belgesi üzerinde veri değişikliği yapılabilmesi için kullanılır. Kural Tanımları, Basit ve Script kural olmak üzere ikiye ayrılmaktadır. Basit kural oluşturmak için belli tanımlamalar yapılırken, Script kural tanımları için Visual Basic Script yazım dili kullanılmaktadır. Visual Basic Script yazım dili Excel ve Word programlarının içerisindeki macro dili olarak da kullanılmakta olan, en standart script kodlama dilidir ve yapılmak istenen her türlü işlem ile ilgili örnek kodlar internette bulunabilmektedir. Kural tanımlarına Logo Connect ara yüzündeki Planlama Modülü altındaki Kural Tanımları seçeneği ile ulaşılmaktadır. Alt kısımda bulunan combobox (açılan kutu) içeriği ile Script kural veya basit kural ayrımı yapılmaktadır. Şekil 1 Kural Tanımı Tür Seçim Ekranı
1. E-fatura İşlemleri İçin Basit Kural Tanımları : Kural tanımı türünün basit kural seçilmesinden sonra F9 menüsünden (sağ tık) Ekle işlemi ile kural tanımı eklenebilir. Bu durumda açılacak olan ekran aşağıdaki gibidir. Şekil 2 Basit Kural Tanım Ekranı 1.1. Basit Kural Seçenekleri Kural No : Tanımlanan kuralın tanım numarasıdır. Açıklaması : Kural tanımının adı ya da açıklayıcı bilgisidir. Doküman : Kuralın hangi belge türü için uygulanacağı bu alanda belirlenir.
E-fatura İçin Seçilebilecek Doküman Türleri : Herhangi bir Doküman : Logo Connect ile aktarımı yapılabilen her türlü standart ve özel doküman tiplerinde çalışacak bir kural tanımlamak için seçilir. Kural tanımı tüm paketlerde tipe bakılmaksızın işletilecektir. Bu doküman tipi seçildiğinde koşul verilebilecek alanlar kısmında sadece Header_Record bölümü gözükecektir. E-fatura : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sistemine gönderilecek veya Gelir İdaresi Başkanlığının sisteminden gelecek olan e-faturalar için çalışacak bir kural tanımlamak için seçilir. Bu doküman tipi seçildiğinde koşul verilebilecek alanlar kısmında Header_Record ve e- faturanın XML tagleri gözükecektir. Uygulama Yanıtı (e-fatura) : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sistemine gönderilecek veya Gelir İdaresi Başkanlığının sisteminden gelecek olan uygulama yanıtları (Kabul,Red) için çalışacak bir kural tanımlamak için seçilir. Bu doküman tipi seçildiğinde koşul verebilecek alanlar kısmında sadece Header_Record bölümü gözükecektir. Sistem Yanıtı (e-fatura) : Logo Connect aracılığı ile Gelir İdaresi Başkanlığının sisteminden gelecek olan sistem yanıtları (Zarf durum kodları) için çalışacak bir kural tanımlamak için seçilir. Bu doküman tipi seçildiğinde koşul verebilecek alanlar kısmında sadece Header_Record bölümü gözükecektir. NOT : Header_Record bölümünün altında Connect Database inde bulunan LG_XXX_APPROVAL tablosunun kolonları bulunmaktadır. Olay : Kural tanımı için seçilmiş olan doküman tipindeki belgenin hangi hareketi sırasında kural ın çalışacağının belirlendiği alandır. Kural ın çalışacağı olay tipleri aşağıda verilmiştir, bu tiplerden bazıları seçilen doküman tipine göre kullanım dışı olabilmektedir veya seçilen olaya göre basit kural İşlem kısmındaki yapılabilecek işlemler kısıtlanabilir. E-fatura İçin Seçilebilecek Olay Türleri : Geldiğinde : Logo Connect Posta Kutusu altında Gelen İşlemler kısmına (Gelen Kutusu - Inbox) herhangi bir şekilde ilgili belge geldiğinde kural tanımı işletilmektedir. Onaya Gönderildiğinde : Logo Connect ile oluşturulan belge hemen alıcıya gönderilmek istenmeyebilir. Önce şirket içerisindeki bir onay sürecinden geçirilmek istenebilir, bu durumda onaylayacak kişinin onayına gönderilir. Bu işlem sırasında kural tanımının çalışması için kullanılır. (Hem giden hem gelen için çalışır.)
Onaylandığında : Onaya gönderilen bir kayıt, yetkili kişi tarafından incelenip onaylandığında kural tanımının çalışması için seçilmektedir. (Hem giden hem gelen için çalışır.) Onay Geri Alındığında : Onaylanmış bir belge için onay ı geri al işlemi yapıldığında kural tanımının işletilmesini sağlar. (Hem giden hem gelen için çalışır.) Kaydedilmeden Önce (İşlenmeden) : Kural için seçilmiş olan tipteki dokümanın kaydetme işleminde tetiklenecek olan kural tanımlamaya yarar. Bu seçenekteki İşlenmeden terimi, kaydedilecek veri üzerinde bazı eşleme değişiklikleri yapılabilir anlamına gelmektedir. Bu değişiklikler yapılmadan önce kaydın ham hali üzerinde kural çalıştırılmak istenirse bu olay seçilmelidir. Kaydedilmeden Önce (İşlendikten sonra) : Kural için seçilmiş olan tipteki dokümanın kaydetme işleminde tetiklenecek olan kural tanımlamaya yarar. Bu seçenekteki İşlendikten sonra terimi, kaydedilecek veri üzerinde bazı eşleme değişiklikleri yapılabilir anlamına gelmektedir. Bu değişiklikler yapıldıktan sonra kaydın son hali üzerinde kural çalıştırılmak istenirse bu olay seçilmelidir. Kaydedildikten sonra : Kural için seçilmiş olan tipteki dokümanın kaydetme işlemi tamamlandıktan sonra tetiklenecek olan kural tanımlamaya yarar. Paketlenmeden/Zarflanmadan Önce : Kural için seçilmiş olan tipteki Dokümanın paketleme veya zarflama işleminden hemen önce tetiklenecek olan kural tanımlamaya yarar. Paketlendiğinde/Zarflandığında : Kural için seçilmiş olan tipteki Dokümanın paketleme veya zarflama işleminden sonra tetiklenecek olan kural tanımlamaya yarar. Gönderildiğinde : Kural için seçilmiş olan tipteki Dokümanın gönderme işleminden sonra tetiklenecek olan kural tanımlamaya yarar. NOT : E-fatura UBL-TR formatında gönderilmekte ve alınmaktadır. E-fatura gönderilirken ERP Sisteminden Logo Connect te XML olarak aktarılır. Logo Connect Paketlemeden/Zarflamadan Önce işlemi sırasında XML i UBL e çevirir. Kural tanımları bölümünde yapılan veri değişikliği işlemi sırasında XML deki veriler değişir ve UBL e taşınır. E-fatura üzerinde veri değiştirmek amaçlı kural tanımı yapılırken Paketlemeden/Zarflamadan Önce olayı seçilmelidir. E-fatura alınırken UBL-TR formatında gelir ve Geldiğinde işlemi sırasında XML formatı oluşur. Gelen e-fatura üzerinde veri değiştirmek amaçlı tanımlanacak olan kural tanımlarında Geldiğinde olayı seçilmelidir. Statüsü : Bir kural ın belli bir süre çalışmasını durdurmak için kullanılan alandır. Bu durumda kural ı silmeden çalışmasını engellemek için bu alanın içeriğinin Pasif durumuna çekilmesi gerekir. Kuralın tekrar çalışmasını için içeriği Aktif durumuna çekilmesi gerekir.
ÖNEMLİ NOT : Yapılan kural tanımının çalışıp çalışmayacağı sadece kural tanımı içerisindeki Statüsü alanına bağlı değildir. Logo Connect Çalışma Parametreleri Genel Parametreler altındaki Kural Kullan parametresininde işaretli olması gerekir. Bu parametre işaretli değilken tanımlanan hiçbir kural çalışmaz. Şekil 3 Genel Parametreler - Kural Parametresi ÖNEMLİ NOT : Kural Geçmişini Kaydet parametresi ile dokümanlar üzerinde çalışacak olan kurallar İzleme Kayıtları tutulur. Belgeler üzerinde F9 menüsünden Uygulanan kurallar seçeneği ile belge üzerinde çalışmış olan kurallar bu parametre işaretliyken görülebilir. NOT : Diğer İşlemler İzleme Kayıtları altına Logo Connect ile yapılan tüm doküman işlemleri yazılmaktadır. Planlama İzleme Kayıtlarına ise Kural tanımı ile ilgili işlemler yazılmaktadır.
Şekil 4 Planlama İzleme Kayıtları Ekranı Şekil 5 Uygulanan Kurallar Ekranı Öncelik : Aynı doküman tipine ve olaya birden fazla kural tanımlanabilir, bu durumda hangisinin önce çalışacağını belirlemek için kullanılacak alandır.
1.2. Basit Kural Koşul İşlemi Koşul : Elle giriş yapılıp, koşul yazılabilen bir alandır. Kural a atanacak koşul bu alanda belirtilir. Koşul bölümünde hiçbir şey yazılmamış ise oluşturulan kural tanımı her koşulda çalışacak demektir. Alanlar : Seçtiğimiz doküman tipi ile ilişkili olarak koşul tanımlayabileceğimiz XML alanları bu bölümde bulunmaktadır. Doküman tipinin Logo ürünündeki XML formatı bellidir. Logo Connect ürünü bu formatı temel alarak, ihtiyacı olan diğer alanları bu format üzerine eklemektedir. NOT : Header_Record bölümünün altında Connect Database inde bulunan LG_XXX_APPROVAL tablosunun kolonları bulunmaktadır. HEADER_RECORD Alanları : Bir veri gönderilmek üzere paketlendiğinde veya geldiğinde LG_XXX_ APPROVAL tablosuna kayıt atılır. XML kayıtları arasında bu tablo alanlarının tamamına denk gelen Tag ler yoktur. Bu alanların da kural tanımlarında kullanılabilmesi için ilgili dokümanın standart XML formatı bozulmadan aşağıda gösterildiği üzere en başta bulunan HEADER_RECORD başlığı altında toplanarak standart XML formatına eklenmektedir. HEADER_RECORD başlığı altındaki alanlar doküman tipinden bağımsız olarak tüm dokümanlarda aynıdır. Standart alanlarda olduğu gibi bu alanlar üzerinde de koşul tanımlanabilmektedir. Connect Veritabanında (Inboxta, outboxta, onay işlemlerinde görünen) her kayıt APPROVAL tablosunda tutulur. Her doküman için APPROVAL tablosunda bulunan aşağıdaki alanlara ulaşılabilir. Şekil 6 HEADER_RECORD Alanı GENEXP : Onaylama işlemi için girilen mesaj. DATE : Giden paket için hazırlanma, gelen paket için alınma tarihi. RECTYPE : Doküman tipi.
SENDER : Gelen belge için gönderen carinin vergi numarası/kimlik numarası, Giden belge için gönderilen carinin numarası/kimlik numarası. EXPLAIN : Giden için alıcıya mesaj, gelen için göndericinin mesajı. TRCODE : Belgelerin ERP deki tipi. ATTRIBUTE : 0: eklenecek, 1: güncellenecek, 2: silinecek. ERRORCODE : 0: hata yok 1: eşleme hatası var. TIME : Giden belge için hazırlanma, gelen belge için alınma zamanı. SCROSS : 0: düz 1: Çapraz (FDA Modülü için) SUBTYPE : Özel dokümanlar için custom tip. Veri tabanındaki LG_XXX_APPROVAL tablosunda bulunup HEADER_RECORD bölümünde bulunmayan alanlar: STATUS : Alan dokümanın hangi aşamada olduğunu gösterir. CUSTOMDATA1 : Posta Kutusu Özelleştir bölümündeki 1. No' lu alan. CUSTOMDATA2 : Posta Kutusu Özelleştir bölümündeki 2. No' lu alan. CUSTOMDATA3 : Posta Kutusu Özelleştir bölümündeki 3. No' lu alan. CUSTOMDATA4 : Posta Kutusu Özelleştir bölümündeki 4. No' lu alan. DATA : Gelen veya gönderilecek verinin kendisinin tutulduğu bölümdür. Operatörler : Kuralın çalışacağı koşulları tanımlanırken bir takım alan ve bilgileri karşılaştırıp, kıyaslayıp, kural tanımının bu karşılaştırmaların sonuçlarına göre işlemesi sağlanabilir. Bu durum için operatörlerden yararlanılır. - Matematiksel Operatörler : Alanların değerleri üzerinde çalışırken kullanılabilir. (+) Toplama (-) Çıkarma (*) Çarpma (/) Bölme - Karşılaştırma Operatörleri : Karşılaştırma operatörleri değişkenin belirlediğimiz kriterle arasındaki ilişkiyi belirlerken kullanılabilir. Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin eşit olma durumu. Eşit Değil Operatörü : Belirlenen alanın değeri ile belirlenen kriterin eşit olmama durumu.
Büyük Operatörü : Belirlenen alanın değeri ile belirlenen kriterin büyük olma durumu. Büyük Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin büyük eşit olma durumu. Küçük Operatörü : Belirlenen alanın değeri ile belirlenen kriterin küçük olma durumu. Küçük Eşit Operatörü : Belirlenen alanın değeri ile belirlenen kriterin küçük eşit olma durumu. - Mantıksal Operatörler : Bazı durumlarda yukarıda açıklanan karşılaştırma operatörleri ile tanımlanan koşullar yeterli olmayabilir. Birden fazla şart ı bir arada kullanmak için mantıksal operatörlere ihtiyaç duyulabilir. Ve Operatörü : Birden çok şart ın doğru olmasını isteyen bir operatördür. Birleştirdiği her bir karşılaştırma şartının doğru olmasını gerekir. ÖRN : DOĞRU AND DOĞRU = DOĞRU YANLIŞ AND DOĞRU = YANLIŞ VEYA Operatörü : Birden çok şart ın içerisinde sadece bir şart ın doğru olmasının yeterli olduğu operatördür. Birleştirdiği tüm karşılaştırma şartlarından sadece birisi doğru olması yeterlidir. ÖRN : DOĞRU OR YANLIŞ = DOĞRU YANLIŞ OR YANLIŞ = YANLIŞ DEĞİL Operatörü : Belirlenen sonucun tersine işlem yapar. ÖRN : NOT DOĞRU = YANLIŞ EXCLUSIVE OR (Özel VEYA) Operatörü : Koşullardan sadece seçilen bir tanesinin sağlanması durumunda kullanılır. Sonucunun olumlu olabilmesi için bileşenlerden sadece bir tanesinin olumlu olması gerekir, her iki birleşende olumlu ise sonuç olumsuz olur. ÖRN : DOĞRU XOR DOĞRU = YANLIŞ YANLIŞ XOR DOĞRU = DOĞRU, ve Yardımcı Operatörler : Mantıksal operatörler kullandığımızda mutlaka ifadeler parantez ile düzenlenmelidir. - Koşul Operatörleri : Kuralın belirlenen koşulun sağlanması halinde çalışmasını sağlayan operatörlerdir. IFTHEN İfadesi : Bu operatör ile tanımlanmış bir şart ifadesinin sonucunun doğru ya da yanlış olmasına göre kuralın nasıl çalışacağı belirlenebilir.
ÖRN : IFTHEN(Koşul? Doğruysa;Yanlışsa) : Koşul doğruysa 1. yanlışsa 2. değeri verir. NUMBER = IFTHEN(LEN(NUMBER)=7? X +NUMBER; Y +NUMBER) Yukarıdaki örnekte kural tanımında seçilmiş olan ilgili XML şablonunda bulunan fiş numarası 7 karakter ise başına X koymakta, 7 karakterden küçük veya büyük ise fiş numarasının başına Y karakteri eklemektedir. SWITCH ifadesi : IFTHEN ifadesinden farklı birden fazla değer tanımlanarak kuralın nasıl çalışacağı belirlenebilir. ÖRN : SWITCH(ifade?Değer1=Sonuç1;DeğerN=SonuçN;...) : ifade sonucu değer1 ise Sonuç1, ifade sonucu değern ise SonuçN verir. NUMBER = SWITCH(DOC_NUMBER? 01 = A ; 02 = B ; 03 = D ) Yukarıdaki örnekte fiş numarasına fişin doküman izleme numarasındaki değer 01 ise A, 02 ise B, 03 ise D değerleri atanmaktadır. - Metin Operatörleri : Metin alanlar içinden istenilen bilginin alınması veya işlenmesinde kullanılır. Kural tanımlarında metin tipindeki ifadeler XYZ de olduğu gibi tek tırnak içerisinde gösterilirler. MID Operatörü : Bir metin alanın istenilen karakterinden başlayıp istenilen kadarını almak için kullanılır. ÖRN : MID(String,Başlangıç,Bitiş) : Verilen String in Başlangıç tan itibaren Bitiş e kadar olan karakterlerini verir. MID(CODE,1,5)='KALEM' Yukarıdaki koşul tanımında ilgili XML şablonundaki CODE alanının taşıdığı metin bilginin ilk beş karakteri alınır ve KALEM ifadesi ile karşılaştırır. Eğer ilk beş karakter KALEM ise koşul olumlu, değil ise koşul olumsuz sonuç üretir. LEN Operatörü : Bir metin ifadenin karakter sayısını öğrenmek için kullanılır. ÖRN : LEN(String) : Parametre olarak aldığı metin ifadenin kaç karakter olduğunu sonuç olarak döner. NUMBER = MID(DOC_NUMBER,1,LEN(DOC_NUMBER)-1) Yukarıdaki kural tanımında seçilen XML şablonundaki doküman numarası tag inde (DOC_NUMBER) taşınan bilginin son karakteri hariç fiş numarası (NUMBER) alanına atanır. % Operatörü : Bir metin ifadesinin bulunduğu koşullarda kullanıldığında sonraki karakterler ne olursa olsun anlamını taşır. ÖRN : NUMBER ='A%' : İlgili fişin numarası A ile başlıyorsa sonuç olumlu döner.
- Özel Operatörler : Farklı amaçlar tanımlanmış operatörlerdir. TODAY Operatörü : Üzerinde çalışılan terminal in sistem tarihinden okuyarak günün tarih ini metin olarak getirir. Oluşturulan metinin işletim sisteminin bölgesel ayarlarından etkilendiği unutulmamalıdır. 1.3. Basit Kural İşlem Seçenekleri İşlemler : Basit kural tanımlarında yapılacak işlemlerin tanımlandığı kısımdır. Basit kural tanımında kod yazımı olmadığı için kural tanımlarının yapacağı işlemler önceden tanımlanmıştır. Doküman tipine ve olaya göre işlemler değişiklik gösterebilir. Şekil 7 Basit Kural İşlem Ekranı 1.3.1. Basit Kural İşlemler Onaya Gönder Onaya Gönder : Bu işlem seçeneği ile belirlenen olay ve koşul a uyan belgeler otomatik olarak onaya gönderilebilirler. Onay İçin Açıklama : Belgenin onaya gönderilmesi sırasında kullanıcıya gönderilecek olan mesajın girildiği alandır. Onay Grubu : LogoConnectSYS de tanımlanmış kullanıcı gruplarının seçildiği ekrandır.
Şekil 8 Onaya Gönder Kuralı 1.3.2. Basit Kural İşlemler - Onayla Onayla : Bu işlem seçeneği ile belirlenen olay ve koşul a uyan belgeler otomatik olarak onaylanabilir. Şekil 9 Onayla Kuralı 1.3.3. Basit Kural İşlemler - Paketle Paketle : Belirlenen kural a uyan belgeler otomatik paketlenebilir.
Şekil 10 Otomatik Paketleme Kuralı 1.3.4. Basit Kural İşlemler - Kaydet Kaydet : Bu işlem seçeneği ile belirlenen olay ve koşul a uyan belgeler otomatik olarak Logo Uygulamasına kaydedilebilir. Logo Connect ayarlarına göre belge kaydedilirken gösterilebilir veya gösterilmeden kaydedilebilir. ( Logo Connect Çalışma Parametreleri Doküman Parametreleri e-fatura sekmesi altında Faturayı Kaydetmeden Önce Göster parametresi) Şekil 11 Faturayı Kaydetmeden Önce Göster Parametresi
1.3.5. Basit Kural İşlemler - Onay Geri Al Onay Geri Al : Onaylama işleminin geri alınması için tanımlanır. Kayıt, Onay Bekleyen işlemler bölümünde görülebilir. Şekil 12 Onay Geri Al Kuralı 1.3.6. Basit Kural İşlemler Veri Üzerinden Değişiklik Yap Veri Üzerinde Değişiklik Yap : Kural tanımında seçilen Doküman tipi ve olaya bağlı olarak taşıdığı alanlar ve içerikleri üzerinde değişiklik yapılmak için kullanılır. Alan içerikleri değiştirilebilir, boşaltılabilir veya yeni XML alanı eklenebilir.
Şekil 13 Veri Üzerinde Değişiklik Yap Kuralı Alan Adı : Hangi alan üzerinde değişiklik yapılacağının seçildiği bölümdür. Değeri : Değişiklik yapılacak olan alana hangi değerin geleceğinin seçildiği bölümdür. Alan üzerindeki seçim alanı ile ilgili XML de tanımlı olan bütün alanlar arasından seçim yapılabilir veya Değeri alanına manuel giriş yapılabilir. Seçim ekranına HEADER_RECORD alanları gelmez. Şekil 14 XML Alanı Seçim Ekranı
ÖRNEK 1 : Giden e-fatura Özel Kodu X e eşit ise DOC_NUMBER (Fatura Belge Numarası) alanına AUXIL_CODE (Fatura Özel Kod) alanınındaki bilgiyi getir. Şekil 15 Koşul Ekranı Şekil 16 DOC_NUMBER Alanına AUXIL_CODE Alanındaki Bilgiyi Getirmek İçin Yapılan Tanımlama Ekranı
Şekil 17 ERP Fatura Özel kod Tanımı Ekranı SONUÇ : Şekil 18 Fatura XML Ekranı
1.3.7. Basit Kural İşlemler E-Posta Gönder E-Posta Gönder : Kural tanımı ile seçilen Doküman tipindeki kayıtlar için, seçilen olay ve koşulların gerçekleşmesi durumunda kişilere otomatik bilgilendirme maili yollanması sağlanabilir. Subject : Mail konu başlığı. Message : Mail içeriği. NOT : Mail gönderiminin gerçekleştirilmesi için Logo ConnectSYS Araçlar E-Posta Ayarları altından gönderimi yapacak mail adresinin tanımlanması gerekmektedir. Şekil 19 E-Posta Gönder Kuralı ÖNEMLİ NOT : Message bölümüne sağ tuş ile Alan Adları bölümünden XML in alanları taşınabilir. Bu durumda oluşturulan mesaj alanına gelen belgeye özgü alanların taşınması sağlanabilir. Mesaj alanına XML alanları dışında HEADER_RECORD alanlarıda taşınabilir.
ÖRNEK 2 : Fatura numarasının FYS ile başlaması durumunda bilgi maili atılması. Şekil 20 E-Posta Gönder Kuralı Koşul Ekranı Şekil 21 E-Posta Gönder Kural Örneği 1.3.8. Basit Kural İşlemler Klasöre Kaydet Klasör e Kaydet : Gelen verinin seçilen klasör e kaydedilmesini sağlar. Klasör : Belgenin kaydedileceği klasörün seçildiği alan. İşlem Sonrası Arşive Gönder : Klasör e kaydetme işleminden sonra kayıtların arşive gönderilmesini sağlar.
Şekil 22 Klasör e Kaydet Kuralı 1.3.9. Basit Kural İşlemler - Onay Akış Grubu Seç Onay Akış Grubu Seç : Entegratör sayfasında tanımlanmış olan İş Akış Sisteminin tanımlı Çalışma Alanında çalışmasını sağlayan kural tanımıdır. Bu kural tanımı sadece E-fatura Gönderim Bağlantı Ayarı Logo Özel Entegratör olan Çalışma Alanlarında gelecektir. Şekil 23 Entegratör İş Akış Kuralı
NOT : Entegratörlük sayfasında oluşturulan kullanıcılara onay yetkisi görevi verilmesinden sonra Onay İş Akış Tanımla ile iş akış tanımlanması durumunda bu işlemin Logo Connect te çalışması için yukarıdaki kuralın tanımlanması gerekmektedir. Entegratör İş Akışı ile kural tanımından sonra Connect te gelen faturalar üzerinde İncele dışında işlem yapılamayacaktır. Onay yetkisi olarak tanımlanmış kullanıcı Entegratör sayfasına girerek Onay Bekleyen kayıtlar altındaki faturalara onay vermesi durumunda Connect te Al işlemi yapıldıktan sonra bu faturalar üzerinde işlem yapılabilecektir. 1.3.10. Basit Kural İşlemler Serbest Alan Ekle Serbest Alan Ekle : Kural ile XML ve UBL alanlarına AdditionalDocumentReference alanı script kurala ihtiyaç kalmadan otomatik eklenir. ID : XML de oluşacak olan AdditionalDocumentReference alanı altındaki <ID> alanının değerinin belirlendiği alandır. DOCUMENTTYPE : XML de oluşacak olan AdditionalDocumentReference alanı altındaki <DOCUMENTTYPE > alanının değerinin belirlendiği alandır. Şekil 24 Serbest Alan Ekleme Kuralı
ÖRNEK 3 : Fatura belge numarasının faturanın UBL ine taşınması. Şekil 25 AdditionalDocumentReference Alanı Ekleme Örneği Şekil 26 ERP Fatura Belge No Tanımı Ekranı
SONUÇ : Şekil 27 Fatura UBL Ekranı
2. E-fatura İşlemleri İçin Script Kural Tanımları : Kural tanımı türünün script kural seçilmesinden sonra F9 menüsünden (sağ tık) Ekle işlemi ile kural tanımı eklenebilir. Bu durumda açılacak olan ekran aşağıdaki gibidir. Şekil 28 Script Kural Ekranı Kural No, Açıklama, Doküman, Olay, Statüsü,Öncelik alanları basit kural tanımı bölümünde anlatılan bilgiler ile aynıdır. Şifre : Oluşturulan script kurala şifre konulmasını sağlayan alandır. Script : Kural tanımının yapılacağı alandır. Burada tanımlanacak kuralın script dili VBScript (Vusial Basic Script)'tir.
Script ekranı açıldığında yukardaki gibi içi boş App nesnesini parametre olarak alan bir prosedür üretilir. sub ProcessEvent(App) end sub App Nesnesinin Metodları : LDXObject : LDXCComApi nesnesinin login olunmuş bir örneğini verir. Uobject : UObjects nesnesinin login olunmuş bir örneğini verir. HeaderByName( alan_adı ) : Verilen dokümanın alan_adı ile tanımlanan başlık bilgisini verir. FieldAsString( alan_adı ) : Verilen doküman alan_adı datasının bilgisini String olarak verir. FieldAsInteger( alan_adı ) : Verilen dokümanın alan_adı datasının bilgisini Integer olarak verir. FieldAsFloat ( alan_adı ) : Verilen dokümanın alan_adı datasının bilgisini Float olarak verir. ModifyData ( alan_adı, değeri ) : alan adı ile verilen data field bilgisinin değerini değeri ile değiştirir. SaveData : Modify Data ile değeri değiştirilmiş alanlar XML'e kaydedilir. Eğer SaveData çağrılmazsa ModfiyData daki değişiklikler XML'e yansıtılmaz. RunQuery (Query, Quick) : XML üzerinde verilen query çalıştırılır ve XML'in şarta uygun olup olmadığına göre sonuç döndürülür. Quick Parametresi eğer XML üzerinde işlem yapılacaksa true yapılmayacaksa daha hızlı çalışması için false verilmelidir. FirstChild ( child_path ) : Verilen path ilk child'a konumlanır. NextChild : Sonraki Child noda konumlanılır. Eğer yoksa false döndürür. SendToApproval onay için mesaj : Doküman Onaya gönderilir. AppApprove : Doküman onaylanır. UndoApproval : Onay Geri Alınır. Save : Doküman kaydedilir. Pack : Doküman paketlenir. SendMail to, cc, subject, message : Mail gönderir.
ÖRNEK 4 : Alınan 'FYS2014000000001' numaralı faturanın onaya gönderilmesi. sub ProcessEvent(App) qry = "INVOICE.NUMBER.AsString = 'FYS2014000000001'" if App.RunQuery(qry, true) then App.SendToApproval "FYS2014000000001 fatura onaylandı." end if end sub Şekil 29 Alınan Faturanın Onaya Gönderilmesi Örneği
ÖRNEK 5 : Script kural ile AdditionalDocumentReference alanına Özel Kod ve Proje Kodu alanlarının eklenmesi sub ProcessEvent(App) OzelKod = App.Doc.FieldAsString("AUXIL_CODE") ' Ek bilgi olarak göndermek istenen fatura özel kodunu ERP XML den okur. App.Doc.WriteStartElement "ADDITIONALDOCUMENTS/ADDITIONALDOCUMENT" ' UBL'e ek açıklama olarak taşınacak blok tanımlanır. Buradaki App.Doc nesnesi herhangi bir yerde tanımlanmasına gerek yoktur. Hazır olarak gelen ve içerisinde XML dökümanını barındıran bir nesnedir. Yapılmak istenen tüm değişiklikler bu App.Doc nesnesi üzerinde gerçekleşir. App.Doc.WriteElementString "ISSUEDATE", Year(Date()) & "-" & Month(Date()) & "-" & Day(Date()) ' UBL'deki Ek Açıklama alanı bir tarih bilgisi bekler. Bu tarih bilgisi ISSUEDATE XML alanına set edilir. App.Doc.WriteElementString "DOCUMENTTYPE", "AUXIL_CODE" ' Gönderilen bilginin ne bilgisi olduğunu DOCUMENTTYPE alanında belirlenir. App.Doc.WriteEndElement 'Set işlemlerini sonlandırıp Element'i(bloğu) kapatır. ' Yukarıdaki işlemleri bir kez de ProjeKodu için tekrarlanır. ProjeKodu = App.Doc.FieldAsString("PROJECT_CODE") App.Doc.WriteStartElement "ADDITIONALDOCUMENTS/ADDITIONALDOCUMENT" App.Doc.WriteElementString "ID", ProjeKodu App.Doc.WriteElementString "ISSUEDATE", Year(Date()) & "-" & Month(Date()) & "-" & Day(Date()) App.Doc.WriteElementString "DOCUMENTTYPE", "PROJECT_CODE" App.Doc.WriteEndElement App.Doc.SaveData ' Yapılan değişiklikleri kaydeder. end sub
Şekil 30 ERP Fatura Özel Kod ve Proje Kodu Tanım Ekranı SONUÇ : Şekil 31 Fatura UBL Ekranı
ÖRNEK 5 : Satır Açıklaması üzerinden cari kod kontrolü ile Malzeme Özel bilgisinin gönderilmesi sub ProcessEvent(App) okay=app.doc.firstchild("transactions.transaction") ' Faturanın ilk satırına konumlanır. while okay ' Eğer faturanın bir satırı varsa okay değişkeni true(başarılı) sonucunu alır. Bir sonraki satıra her başarılı konumlanmada aşağıdaki while bloğu bir kez çalışacaktır. stype = App.Doc.FieldAsInteger("TRANSACTIONS.TRANSACTION.TYPE") ' Satır tipi okunur. if stype = 0 then ' Eğer satır tipi = 0 ise (malzeme ise) okuma-yazma işlemleri başlar. strlinespecode1 = App.Doc.FieldAsString("TRANSACTIONS.TRANSACTION.MASTER_AUXIL_CODE") 'İstenilen veriler ERP XML i içerisinden okunur. strdescription = strlinespecode1 App.Doc.ModifyData "TRANSACTIONS.TRANSACTION.DESCRIPTION", strdescription ' Veri DESCRIPTION alanına yazılır. end If okay=app.doc.nextchild ' bir sonraki satır çağrılır. Eğer çağırılabilirse okay = true değerini alıp döner. Eğer çağırılamazsa, yani son satırda ise okay = false değerini alır ve döngü sona erer. wend App.Doc.SaveData ' Yapılan değişiklikler kaydedilir. end sub Şekil 32 Malzeme Market Özel Kod Tanımı Ekranı
SONUÇ : Şekil 33 Fatura UBL Ekranı
3. Oluşturulan Kuralın İçeri Veri Alımı - Dışarı Veri Aktarı ve Devri : İçeri - Dışarı Veri Aktarımı : Veri aktarım işlemi ile tanımlanan kurallar tanımlanma yapılmış olan Çalışma Alanından dışına aktarılabilir ve başka Çalışma alanına alınabilir. Bu işlem Logo Connect Araçlar Veri Aktarımı (İçeri/Dışarı) kısmından yapılır. Şekil 34 Veri Aktarım Ekranı Şekil 35 İçeri Veri Aktarım Ekranı
Dosya Adı : İçeri aktarılacak olan kural dosyasının seçildiği alandır. Tanımlı Alanlar Aktarılacak : Tanımlanmış olan kural tanımını içeri aktarmak için seçilmesi gereken parametredir. Şekil 36 Dışarı Veri Aktarım Ekranı Dosya Adı : Dışarı aktarılacak olan kural dosyasının seçildiği alandır. Tanımlı Alanlar Aktarılacak : Tanımlanmış olan kural tanımını dışarı aktarmak için seçilmesi gereken parametredir. Kural Devri : Çalışma Alanı Devir İşlemi sırasında tanımlanan kural tanımların aktarılması sağlanabilir. Şekil 37 Devir İşlemi Seçim Ekranı