IdeaSoft E-Ticaret ile LOGO Ticari Yazılım Entegrasyon Kullanım Kılavuzu ISLE IdeaSoft E-Ticaret siteniz ile Logo Yazılımınız (GO 3, Tiger 3, Tiger 3 Enterprise) arasında veri aktarımını sağlayan bir yazılımdır. Program Logo nun güncel sürüm ürünleri ile çalışacak şekilde güncellenir. Entegrasyon programı masaüstü uygulaması olup kullanıcı kontrolünde çalışmaktadır. Program girişi Logo ERP deki kullanıcı tanımı ile yapılmakta ve Logo Objects lisansı ile çalışmaktadır. Logo Objects lisansı olmaması durumunda Logo ERP ye aktarımlar XML dosya ile manuel yapılmaktadır. Program girişinde entegrasyon yapılacak firma ve dönemi seçilir. 1 / 1
Entegrasyon ayarları ve parametreleri AYARLAR sekmesi altında tanımlanır. Doküman da kullanılan site tabiri IdeaSoft E-Ticaret sitenizi, Logo tabiri de kullanmakta olduğunuz Logo ticari yazılımınızı ifade etmektedir. 2 / 1
E-Ticaret URL: API Client Id: API Client Secret: Yönetici Adı: Şifresi: Aktarılacak Fiş Tipi Marka Bilgisi Kategori Bilgisi Ürün Açıklaması Malzeme Detay Bilgisini Gönder Miktar Bilgisini Sabit Gönder Gönderilecek Stok (- /+) Adedi: Miktar bilgisini Gerçek Stoktan oku. Sadece E-Mağazada Erişebilir Olanlar Sadece değişiklik görenler Malzeme eşlemesi Entegrasyonu yapılacak sitenin URL bilgisi E-Ticaret yönetim panelindeki Entegrasyonlar bölümündeki Client ID bilgisi E-Ticaret yönetim panelindeki Entegrasyonlar bölümündeki Client Secret bilgisi E-Ticaret yönetim paneline giriş için kullanıcı adı E-Ticaret yönetim paneline giriş için şifre Siteden Logo ya aktarılacak siparişlerin fiş türü belirlenir. Satış Sipariş seçilmesi durumunda fişin Onay Bilgisi: Sevkedilebilir / Rezerve: Evet Ürünler için marka bilgisinin malzeme kartının hangi alanından okunacağı bilgisi Ürünün hangi kategoriye bağlanacağının malzeme kartının hangi alanından okunacağı bilgisi Sitede oluşturulacak ürünün açıklamasının nasıl oluşacağı belirlenir. Malzeme kartındaki detay bilginin, ürünün detaylı bilgi alanına aktarılıp aktarılmayacağı seçeneği Bu parametrenin seçilmesi durumunda ürünlerin miktar bilgisi sabit bir değer gönderilir. Bu parametrede belirtilen değer ürün miktarına eklenir. Bu parametrenin seçilmesi durumunda malzemelerin Gerçek Stok değeri, seçilmemesi durumunda ise Fiili Stok değeri gönderilir Bu parametrenin seçilmesi durumunda sadece Erişim Bilgileri E-Mağazada Erişilebilir olan malzemeler gönderilir veya güncellenir. Bu parametrenin seçilmesi durumunda sadece belirtilen günden (Değişiklik Gün:) beri değişiklik gören kayıtlar gönderilir veya güncellenir. Sitedeki ürünlerin Logo daki malzeme kartları ile eşleşmenin nasıl yapılacağı belirlenir. Kayıtların Aktarılacağı Miktar için Ambarlar Siteden Logo ya aktarılacak fişlerde kullanılacak İşyeri / Ambar / Bölüm bilgileri tanımlanır Miktar bilgilerinin hangi ambarlardan okunacağı bilgisi belirlenir 3 / 1
Filtrele Seç Siteye gönderimi veya güncellemesi yapılacak malzemelerin, seçilen parametreye göre programın işlem yapması sağlanabilir. Filtrele nin seçili olması durumunda sadece seçilen değere sahip kayıtlar dikkate alınır. Filtrele Seç Grup Şirket Kodu: Cari Kodu Ön Eki: Cari Kodu Muh. Kodu : Torba Cari Kodu : Siteye gönderimi veya güncellemesi yapılacak carilerin, seçilen parametreye göre programın işlem yapması sağlanabilir. Filtrele nin seçili olması durumunda sadece seçilen değere sahip kayıtlar dikkate alınır. Sitedeki üyelerin Logo da cari kart olarak açılacak olması durumunda bağlanılması istenilen Grup Şirket Kodu tanımı yapılabilir. Oluşturulacak carinin kodunda ön ek tanımı yapılabilir. Bu durumda oluşacak kod [Cari Kodu Ön Eki][ÜyeID] şeklinde olur. Örnek: Cari Kodu Ön Eki: = WS. Olması durumunda ; WS.76 gibi. Oluşturulacak carinin öndeğer muhasebe hesap kodu Seçilmesi durumunda üyeler için yeni cari kart açılmaz ve fişler bu cari koda bağlanır. 4 / 1
Fiyat Eşleme Seç E-Mağaza Tarih KDV D/H Döviz CH Grup Kodu Öncelik Sıralama TİG Fiyat Açıklaması Filtresiz satış fiyatı bul Bu eşleme tablosunda Logo daki hangi kıstastaki satış fiyat kartlarının siteye gönderileceği belirlenir. Satış fiyat kartının buradaki belirtilen bütün kıstasları sağlıyor olması gerekir. Güncellemesi yapılacak fiyat tipi seçilir. Seçilmeyen kayıtlar için işlem yapılmaz. Fiyat kartındaki E-Mağazada Geçerlidir seçeneğinin karşılığı Seçilmesi durumunda fiyat kartının geçerlilik tarihi de kontrol edilir. Fiyat kartındaki KDV Dahil / Hariç değerinin karşılığı Belirtilmesi durumunda fiyat kartındaki Döviz değerinin karşılığı Fiyat kartındaki Cari değerinin karşılığı Fiyat kartındaki Grup Kodu değerinin karşılığı Fiyat kartındaki Öncelik değerinin karşılığı Fiyat kartındaki Sıralama değerinin karşılığı Fiyat kartındaki Ticari İşlem Grubu değerinin karşılığı Fiyat kartındaki Fiyat Açıklaması değerinin karşılığı Bu seçeneğin aktif edilmesi durumunda yukarıdaki kriterler dikkate alınmadan en son eklenen satış fiyat bilgisi kullanılır. Birim Eşleme Stok Tipi Birim Seti Birim Banka Eşleme ID Banka POS Havale Cari Seç Sitede tanımlı olan Stok Tipi Logo daki Birim Set kodu Birim setine bağlı birim kodu Sitedeki banka tanım ID si Sitedeki Ödeme Ayarlarındaki isim Logo daki Kredi Kartı hesabın kodu Logo daki Ticari Hesabın kodu Bu seçeneğin seçilmesi durumunda POS alanına Logo daki tanımlı cari kod secimi yapılır. Kendi sanal pos sisteminizi kullanmamanız durumunda veya başka ödeme yöntemleri kullanmanız durumunda seçilmeli. Bu yöntemde siparişe ait tahsilat Logo da Cari Hesap Fişleri > Virman Fişi olarak oluşur. 5 / 1
POS Geri Ödeme Planları Kredi Kartı Hesabına tanımlı geri ödeme plan tanımların kodları. Firma Adı Cari Kodu Taşıyıcı Kodu Masraf Tipi Kod KDV Birim K.Ödeme Tipi Kod KDV Birim Sitede Kargo Firmaları alanından tanımlı taşıyıcı firmanın Firma İsmi Kargo firmasının Logo daki cari kodu. Kapıda ödeme yöntemi kullanılıyor ise virman fişi bu cari hesap kartına işlenecektir. Logo daki Taşıyıcı Firma kodu Kargo Masraf Satır Tipi Logo daki ilgili Masraf/Hizmet/Malzeme Kodu KDV oranı Birim kodu Kapıda Ödeme Masraf Satır Tipi Logo daki ilgili Masraf/Hizmet/Malzeme Kodu KDV oranı Birim kodu Paket Ürün Kodu Ürün Detayları Malzeme Kodu Miktar Birim KDV Fiyat KDV D/H Sitede tanımlı ürünün kodu Sipariş satırlarında sitedeki kod ile değiştirilecek ürün bilgileri Logo daki Malzeme Kodu 1 Adet paket ürün içerisindeki malzeme miktar bilgisi Ana birim kodu KDV oranı 1 Adet paket ürün içerisindeki malzeme fiyat bilgisi Fiyat bilgisi KDV Dahil/Hariç 6 / 1
Özel Kod: Yetki Kodu: Satış Eleman Kodu: Entegrasyon ile oluşacak fişlere atanacak Özel Kod değeri Entegrasyon ile oluşacak fişlere atanacak Yetki Kodu değeri Entegrasyon ile oluşacak fişlere atanacak Satış Elemanı Kodu değeri Malzeme Listesi İçin Özel Sorgu: Varsayılan Sorgu: Test Çalıştır: Kaydet: Logo dan siteye entegrasyonu yapılacak malzemeler için işletmenize özel sorgu oluşturabilirsiniz. Yeni oluşturacağınız sorgunun dönüş verisindeki kolon başlıkları ve veri tipleri varsayılan sorgu ile aynı olmalı. Uygulamanın öndeğer kullandığı sorguyu getirir Yazılan sorgu sonucunu kontrol edip değerleri getirir. Sorguyu kaydeder. 7 / 1
Token Al (Manuel) (http://apidoc.ideasoft.com.tr/#authentication ) Entegrasyon programı IdeaSoft API entegrasyonu için gerekli olan Token değerini otomatik almaktadır. Fakat bazı bilgisayar sistemlerindeki güvenlik seviye veya Internet Explorer yapılandırılmalarından dolayı bu işlemi yapamamaktadır. Bu durumda Token değerini alma işlemi manuel yapılmalı. Yetki Sayfası Adresi Kimlik Doğrulama Kodu: TOKEN Al Düğmesine tıkandıktan sonra oluşan URL internet gezgini uygulamanızın adres bölümüne yapıştırılarak sitenin yönetici bilgileri ile giriş yapılmalı. Yukarıdaki adım sonrası internet gezgini uygulamanızdaki yeni adres bilgisi bu alana girilmeli. Kimlik Doğrulama Kodu girildikten sonra Token alma isteği gönderilir. Kimlik Doğrulama Kodu geçerlilik süresi 30 saniyedir. Bu sürenin aşılması durumunda yukarıdaki işlemler tekrarlanmalıdır. İşlemleri başarılı olması durumunda Access Token ve Refresh Token değerleri elde edilmiş olur. Access Token geçerlilik süresi 6 saattir. Refresh Token geçerlilik süresi 2 aydır. Uygulama bu süreler içinde bu değerli yenilmektedir. Dolayısı ile sitemde bir değişiklik olmadığı sürece yeniden Tokan alma sürecine gerek kalmayacaktır. Site ile Logo arasındaki aktarım ve eşleştirme ENTEGRASYON sekmesi altından yapılır. 8 / 1
Marka Tanımları Aktar Kategori Tanımları Aktar Malzemeleri Aktar LOG Kayıtlı Güncelle Log Kayıtlarını Sil Miktar Güncelle Fiyat Güncelle Resim Güncelle Site <-> Logo Ürün Eşleme Carileri Aktar Logo daki marka tanımınızı siteye aktarır. Malzeme aktarımı öncesi mutlaka sitede marka tanımlarının olması gerekmekte. Sitede kategorilerin oluşturulmasını sağlar. Logo daki malzeme kartlarını aktarır. Aktarılan alanlar; Kodu, Açıklama, Üretici Kodu, 1. Barkod, KDV Oranı, Ana Birim, Miktar, Varyantlar, Kategori bağlantısı, Detay, Resimler, Fiyatlar Siteye güncellenen malzemelerin bilgisini loglar. Bu loglar silinmediği sürece güncellenen ürünleri bir daha güncellemez. Güncelleme sonrasında tutulan malzeme log bilgileri silinir. Sadece miktar bilgileri güncellenir. Sadece fiyat bilgileri güncellenir. Logo daki resmi olan ürünlerin sitedeki mevcut Resim 1 ve Resim 2 lerini siler ve yeniden ekler. Sitedeki ürün kodu ile Logo daki malzeme kodu eşleşmesi yapılır. Bu işlem sonucunda Logo daki malzemenin E-Mağaza Kodu alanına sitedeki ürünün ID si yazılır. (Malzeme varyantlarında ise Özel Kod4 alanına ID yazılır ) Bu eşlemenin yapılmasının sebebi Miktar ve Fiyat güncelleme işleminde kod ile değil ID ile işlem yapılmasıdır. Logo daki cari kartları siteye üye olarak oluşturur. Üye açılmadan önce Üye/Bayi Gruplarında Fiyat Türü: Fiyat 2 olan LOGO Carileri adında bir üye grubu oluşturulur ve yeni açılan üyeler bu gruba dahil edilir. Cari kartların e-posta adresi olmak zorunda. 9 / 1
Üye için kullanıcı adı bu e-posta adresi kullanılmakta. Öndeğer şifre 1234 olarak ayarlanır. Sitede üye başarılı bir şekilde oluşturulduktan sonra üye ID si ve cari hesap bilgi kaydı ID si Logo da cari kartın Veri Aktarım No alanına [UyeID];[CariHesapBilgiID] şeklinde yazılır. Carileri Bakiye Güncelle Hatalı Cari Eşlemeleri Güncelle Verileri Göster Sitedeki üyelerin cari hesap bilgilerindeki bakiye ve risk tutarları güncellenir. Güncelleme işlemi veri aktarım no alanındaki ID lerin eşleşmesi ile yapılır. Sitedeki üyelerin Cari Hesap Bilgileri bölümündeki Cari Kod bilgisi ile Logo daki Cari Hesap Kartı Kodu eşlemesi yapılarak Veri Aktarım No alanı güncellenir. Bu seçeneğin işaretlenmesi durumunda Logo dan çekilen kayıtların bilgisi data grid alanında gösterilir. Başlangıç Tarihi: Bitiş Tarihi: Sipariş / Tahsilat Aktar Görev Zamanla Siteden aktarılacak siparişlerin başlangıç tarihi Siteden aktarılacak siparişlerin bitiş tarihi Belirtilen tarih aralığındaki seçilen sipariş durumundaki siparişleri aktarır. Parametreye bağlı olarak üye için Logo da cari kart oluşturur. Sipariş satırlarındaki ürün kodu Logo da yok ise malzeme kartını oluşturur. Parametredeki seçeneğe göre Logo da satış fişini oluşturur. Siparişin ödeme yöntemine ve parametreye göre Logo fiş oluşturur. Logo daki e-devlet modülleri lisansına göre e-fatura veya e-arşiv İnternet fatura kurallarına uygun kayıt oluşturulur. Not: Uygulamaya girişte XML Aktarım Kullan seçilmesi durumunda LObjects kullanılmadan masa üstünde XML Aktarım klasörüne manuel aktarım için dosyalar oluşturulur. Zamanlanan İşlemler deki seçilen işlevleri belirtilen zaman aralıklarında çalıştırır. 10 / 1