INSUFFICIENT_PRIVILEGES hatası alıyoruz, ne yapabiliriz?
Kullanıcının ilgili işlem için giriş yapılan firmada yetkileri açık olmalıdır. Firma kodu mutlaka kontrol edilmelidir. DiaApp üzerinden Kullanıcılar ekranından yetkileri ayarlayabilirsiniz. Firma koduna ise Firmalar ekranından ulaşabilirsiniz.
INVALID_SESSION hatası alıyoruz, ne yapabiliriz?
Invalid session hatası,session_idbilgisinin hatalı olması durumda veya sisteme login olamadığınızda, login olduktan sonra bağlantı kopması, timeout süresinin dolması gibi sebeplerle oturum kapandığında alınıyor olabilir. Sisteme login olup olunmadığını kontrol ederek işlemlerin tekrarlanmasını sağlayıp sorunun çözülmemesi durumunda ise gönderdiğiniz firma ve dönem kodu parametrelerinizin doğruluğundan emin olup tekrar deneyebilirsiniz.
TypeError("bad operand type for unary -: 'NoneType'",) bad operand type for unary -: 'NoneType'"
Bu hatanın sebebi sebebi veri tipine uygun değer gönderilmemesi olabilir, parametrelerinizin tiplerini kontrol etmelisiniz. Model dökümanımızdan veri tiplerine bakabilirsiniz.
Array value must start with "{" or dimension information.\n',) malformed array literal: DETAIL: Array value must start with "{" or dimension information.
Array veri tipindeki bir alana string değer göndermek istediğinizde bu hata ile karşılaşırsınız, alanların veri tipleri model dökümanlarımızdan kontrol edebilirsiniz.
"msg": "DataError('value too long for type character varying(128)\\n',)\nvalue too long for type character varying(128)\n"
İlgili alan için çok uzun bir veri girildiyse bu hata alınabilir, alanlarınızın uzunluğunu kontrol etmelisiniz.
"Kritere uygun birden fazla kayıt var!" uyarısı alıyoruz. Ne yapabiliriz?
Gönderdiğiniz parametreye işaret eden birden fazla kayıt varsa bu uyarıyı alıyorsunuz. Bu durumda parametre filtrelerini artırarak benzer bir kayıta işaret etmediğinden emin olmalısınız ya da direkt key değeri vermelisiniz. Örneğin;“_key_sis_sube_source”: {“subekodu”: “000001”, “subeadi”:“İSTANBUL”}. Ya da uyarıda parantez içinde dönen tablonun modelini getirebilmek için ilgili getir servisini çağırıp _key değerini elde ederek direkt olarak _key ile örneğin“_key_sis_sube_source”: 123456şeklinde işlem yapmalısınız.
"... girilmelidir" şeklinde uyarı alıyoruz, zorunlu alan kontrolüne takılıyoruz. Ne yapabiliriz?
Bu uyarı eğer zorunlu alan kontrolü kaynaklı ise; zorunlu alanlar sistem parametrelerinden firma bazında ayarlanmaktadır. İşlem yaptığınız firma için hangi alanların zorunlu olduğu bilgisini DiaApp üzerinden öğrenebilirsiniz. Ayrıca web servis çağrısında zorunlu alanlardan kaynaklanan uyarılar da hangi alanlar olduğu döndürülmektedir, oradan takip edebilirsiniz.
Fatura kalemlerindeki ürün stok kartı kodunu ne şekilde belirteceğiz?
_key_kalemturualanı stok ya da hizmetin_keyalanıdır, buraya ilgili stoğun_keydeğeri verilmelidir stokkartkodu direkt verilemez, ancak filtre ile örneğin{“stokkartkodu”: “ABC001”}şeklinde verilebilir.
''_key_kalemturu'' nedir?
_key_kalemturudeğerine fişinize ekleyeceğiniz stok ya da hizmet kartın_keybilgisini yazmanız gerekmektedir.
''_key_scf_kalem_birimleri'' nedir?
_key_scf_kalem_birimlerialanına ilgili stoğun ya da hizmetin fiş kaleminde olmasını istediğiniz biriminin_keydeğeridir. Bu_keydeğerini scf_stokkart_birimleri_listele servisinden elde edebilirsiniz ya da tek birimli stok kullanıyorsanız ve birimin kodu-adını biliyorsanız daha pratik bir yöntem olarak{“birimadi”:“Adet”}veya{“birimkod”:“AD”}şeklinde filtreleyerek bu alanı doldurabilirsiniz.
Parametrelerdeki kodların karşılıklarını nasıl elde edebilirim ve DiaApp'deki combobox olarak gelen alanların kısaltmaları nelerdir?
Web servislerimizde kullanılan alanların karşılıklarını model dökümanımızdan öğrenebilirsiniz. Örneğin cari kart ekleme servisinde kullanabileceğiniz alanlara carikart model alanlarından bakabilirsiniz. Servislerin gittiği ilgili modelleri ise getir servislerinin dökümanlarından görebilirsiniz.
Toplu ekleme veya silme işlemi yapabilir miyiz?
Ekleme, silme ve güncelleme servislerimiz tek bir kart için çalışmaktadır.
Firmadan firmaya kopyalama işlemi yapabilir miyiz?
İşlem yaptığınız web servislerin parametrelerindekifirma_kodu,donem_koduparametrelerine diğer firmanın bilgilerini vererek web servisi tekrar çağırarak işlem yapmayı deneyebilirsiniz. Ayrıca_keyile başlayan verileri de uyarlamanız gerekecektir.
Çok fazla stoğumuz var listelemek uzun süre alıyor, tahmin edilebilir bir işlem süresi var mıdır?
Stok kart listeleme işleminizin en azından belirlenebilir bir süre içerisinde gerçekleşebilmesi için bir çözüm yolu önereceğiz. Aşağıda örneğini bulunan json verisinin çalışma mantığı şu şekilde;stokkartkoduparametresinin value değerini başlangıçta sıfır vererek stoklarınızın unique bir değeri olan ilk stokkartkodu değerini alıyoruz, artan şekilde sıralı olarak ilk 100 sonucu elde ettikten sonra value parametresine son stokkartkodu değerini veriyoruz, bu şekilde limit 100 değeri sabit olmak üzere tüm stokkartlarınızı listeleyebilirsiniz. Yani aslında kendi offset değerimizi kendimiz belirlemiş olup offsetten farklı olarak da her seferinde tüm listeyi çekip o offset değerine gitmektense filtreleme ile direkt sonraki stokkartlara gidip hızlı veri getirmiş oluyoruz. Bu yöntem size 10 saniye gibi bir süre içerisinde 100 stokkart listeleyerek stoklarınızın tamamını 10'ar saniyelik dilimler halinde en azından belirlenebilir bir sürede alabilmenizi sağlayacak. Tavsiye ettiğimiz yöntemi inceleyip tekrar sorunuz olması durumda bize ulaşabilirsiniz.{"scf_stokkart_listele" : {"session_id": "{session_id}", "firma_kodu": {firma_kodu}, "donem_kodu": {donem_kodu}, "filters":[{"field": "durum", "operator": "=", "value": "A"}, {"field": "stokkartkodu", "operator": ">", "value": "0"}], "sorts": [{"field": "stokkartkodu", "sorttype": "ASC"}], "limit": 100 } }
Listeleme servislerinde sunucuyu yormamak ve veri kalabalıklığı olmaması için sadece bazı alanları getirmek istiyoruz, nasıl yapabiliriz?
Listeleme servislerimizde kullanabileceğiniz selectHeader parametresi ile bu mümkündür. Örneğin stokkarttaki sadece stokkartkodu, birimkeyleri, birimisimleri, fiili_stok, fiyat1 alanlarını çekmek isterseniz"params": { "__selectHeader": ["stokkartkodu", "birimkeyleri", "birimisimleri", "fiili_stok", "fiyat1"]}şeklinde parametre göndermeniz yeterlidir. Bu kullanım veri getirme süresini de kısaltacaktır.
Belirli depolardaki stok miktarlarını görmek istiyoruz, nasıl yapabiliriz?
scf_stokkart_listele web servisimizde paramsdaki_key_sis_depoalanına ilgili deponun _key değerini yazarak belirli bir depodaki stokları filtreleyerek çekebilirsiniz. Eğer birden fazla depoyla işlem yapmak istiyorsanız sis_depo_grubu_listele servisimizle elde edeceğiniz depo grubu_keydeğeri ile birden fazla depodaki stokları elde edebilirsiniz.
Stok kartın miktarlarını anlık olarak görmek istiyoruz. scf_stokkart_hareket_listele tek stok için çalışıyor ne yapabiliriz?
Genelde uygulanan çözüm, belirli periyotlarla (örneğin 20 dakikada bir) “scf_stokkart_listele” servisiyle istenen stokları alıp, veritabanının güncellenmesi şeklindedir. Miktar anlık olarak hareketler üzerinden hesaplandığı için değişim durumu bu serviste gösterilememektedir.
Tüm ürünlerin varyantlarını, barkodlarını, resimlerini, fiyat kartlarını tek seferde çekebilir miyiz?
scf_stokkart_detay_listele servisini kullanabilirsiniz.
Stokların en güncel halini nasıl görebiliriz?
_datealanına göre verileri filtreleyerek listeyi çekerseniz son değiştirilen ürünleri elde edebilirsiniz. Cron mantığıyla belirli aralıklarla web servis çağrısı yapabilirsiniz.
Stoklardaki resimleri nasıl elde edebiliriz?
Resim dosyalarının urllerini elde edebilmeniz için sis_aws_dosya_listele web servisimizi kullanabilirsiniz. Örneğin bir stok kartın resmini çekmek istiyorsanız kayitturu alanını'kayitturu': 'scf_stokkart'şeklinde_key_kayitalanını ise stokkartın_keydeğeri olacak şekilde göndererek resminaws_urlalanından url bilgisini elde edebilirsiniz.
Dinamik alan verilerini nasıl getirebiliriz?
Dinamik alan verileri, ayrı bir tabloda değil ilgili tablodaki__dinamikön ekli kolonlarda tutulmaktadır. İstediğiniz veriler için, ilgili modeldeki dinamik alanlara bakabilirsiniz. Örneğin cari karta ait dinamik alanlar için ScfCarikartModel'e bakmanız gerekir.
Faturanın toplam tutar bilgisini gönderecek miyiz?
Toplam tutar bilgisini göndermeyip, varsa indirim, birim fiyat ve miktar gibi parametreler üzerinden toplam tutarın hesaplanmasını sağlayabilirsiniz.
Bütün firmalardaki carilerin toplu şekilde hareketlerini çekmek istiyoruz, nasıl yapabiliriz?
scf_carikart_hareket_listeleservisimiz tek cari için çalışır. Benzer işlem için Cari Kart Bakiye raporumuzu incelemenizi ve ihtiyacınızı karşılıyorsa bu raporun sonucunu web servis ile almanızı önerebiliriz. Web servis ile rapor sonucu alınabilmesi hakkındaki dökümanımızı da inceleyebilirsiniz.
E-fatura oluşturmak istiyoruz, nasıl yapabiliriz?
scf_fatura_ekle web servisimiz ile E-fatura veya E-arşiv ekleyebilmek içinefaturatipkodu,efaturasenaryosu, efatalias gibi alanlara E-fatura veya E-arşiv olması durumuna göre parametrelerinizi düzenleyerek göndermelisiniz bu parametrelerin karşılıklarını ScfFaturaModel modelde görebilirsiniz. Posta kutusu adresi bilgisini earsivgonderimeposta alanı ile gönderebilirsiniz. E-fatura kullanıcıları listesinde bulunmayan her cari E-arşiv olarak işlenebilir. Bir de dikkat edilmesi gereken uygun bir numara göndermektir bunun için DiaApp üzerindeki kayıt numara şablonlarını E-fatura ve E-arşiv için oluşturduktan sonra sis_numara_getir web servisimiz ile E-arşiv ya da E-fatura numarası üretebilirsiniz.
Belge eklerken nasıl otomatik numara üretebiliriz?
Sistemdeki kayıt numara şablonuna göre numara getirmek ya da sıradaki numarayı alabilmek için sis_numara_getir servisimiz mevcuttur. Bu servise ilgili parametreleri vererek sıradaki numarayı getirebilirsiniz. Fatura eklerken bu numaranın gelmesi için, scf_fatura_ekle servisindekibelgeno2alanına bu değeri vererek işlem yapabilirsiniz.
E-fatura için kayıt numara şablonu ile nasıl numara üretebiliriz?
Oluşturduğunuz kayıt numara şablonlarından doğru veri elde edebilmek için net parametrelerle göndermeniz gereklidir, parametrelere uygun bir numara bulunmadığında sistem en büyük numaradan sonraki numarayı üretmeye başlar. Aşağıda E-arşiv için örnek bir json verisi bulunmaktadır, bazı parametrelerin yanlarında E-fatura için yapılması gereken örnek parametreler de yer almaktadır.{"sis_numara_getir" : {"session_id": "{session_id}", "firma_kodu": {firma_kodu}, "donem_kodu":{donem_kodu} , "table_name": "scf_fatura", "column_name" : "belgeno2", "template_type": "FAT_S_FATURANO", "tarih": "2020-05-06", "statu": 1, "on_eki": "VCI2020", //ya da "on_eki": "VCB2020" "subekey": 0, "depokey": 0, "kasakey": 0, "kategori": "F", "earsiv": "E", //ya da "efatura": "E" "efaturasenaryosu": "3", //ya da "efaturasenaryosu": "0" "filters":[] } }
Web servis üzerinden malzemeye ait son alış fiyatı veya ortalama giriş maliyetini almak istiyoruz, mümkün müdür?
Fiyat hazırlama için özel bir web servisimiz bulunmamaktadır, bunun yerine özel rapor hazırlayarak ilgili alanları elde edip bu raporu web servisle çağırabilirsiniz. Web servisle rapor getirme ve özel rapor hazırlama konularındaki dökümanlarımızı inceleyebilirsiniz.
Basit üretime girdiğimiz reçete ve alt reçeteleri özel rapor ekranında ve webserviste görebilir miyimiz?
scf_stokkart_getir web servisimiz ile basit üretim malzeme reçetesinde bulunan stokkartlarına erişebilirsiniz. Burada reçetesi olan bir stok içinm_altmalzemeleralanı gelmelidir. Özel rapor için ise ScfStokkartAltmamulModel'i ScfStokkartModel ile eşleyerek reçete verilerini elde edebilirsiniz. ScfStokkartAltmamulModel'deki_key_altmamulbaşka bir stoğun_keydeğeridir.