DİA Web Servis Çalıştır [DİA Doc]

Kontör: - (kontör ws çağrılan sunucudan düşmektedir.)

Lisans: plus, enterprise

Çözüm Ortağı Olmalı mı?: Evet

DİA Web servis süreci ile kendi sunucunuzdaki yada farklı bir sunucudaki servisleri çağırabilirsiniz. Çağrı sonucu 200 dönerse başarılı kabul edilir, diğer durumlar başarısız.

Açıklama: fonksiyon için kısa açıklama, sonuç değişkeni kullanabilirsiniz.
Renk: Aracın tasarımda hangi renkte gözükmesini istiyorsanız seçebilirsiniz.
Sonuç Değişken: Web servis çağrısı sonucu dönen bilgileri saklayan değişkendir. Listeleme servislerinde liste (list), getirme servisinde tek kayıt (hash), ekleme, değiştirme ve silme servislerinden de kaydın key (text) bilgisi döner.
Kaynak Sunucu: Servisin çağrılacağı sunucu kodu bilgisi.
Kullanıcı: Servisin çağrılacağı sunucudaki kullanıcı kodu (web servis çağırabilir yetkisi olmalıdır)
Şifre: Kullanıcı şifresi
Api Key: WS çağrıları atabilmek için uygulamaya özel verilen gizli anahtar değerdir. Bu anahtarı almak süreçleri hakkında bilgi almak için satış birimimizle iletişime geçebilirsiniz.
Servis Adı: Çağrılacak servisin adı
Firma: Servisin çağrılacağı firma kodu. Sonuç değişkeni kullanılabilir.
Dönem: Servisin çağrılacağı dönem. Sonuç değişkeni kullanılabilir.
İnput (JSON): Json formatında input bilgisi. Sonuç değişkeni kullanılabilir. Text alanlar için tek tırnak kullanılmamalıdır, çift tırnak kullanılmalıdır.

Servis Dökümanı: https://doc.dia.com.tr/doku.php?id=gelistirici:wsapi:anasayfa

Örnek Listeleme Çağrısı:

Servis Adı: sis_ozelkod_listele
Json Bilgisi:

{
 "filters":[{"field": "turkodu", "operator": "=", "value": "CHK3"}],
 "sorts": [{"field": "turkodu", "sorttype": "DESC"}],
 "params": "",
 "limit":0,
 "offset": 0
}

Örnek Getir Çağrısı:

Servis Adı: sis_ozelkod_getir
Json Bilgisi:

{
  "key": "12345"
}

Örnek Ekle Çağrısı:

Servis Adı: sis_ozelkod_ekle
Json Bilgisi:

{     
"kart": 
  {
   "aciklama": "ÖZEL KOD WS",
   "durum": "A",
   "kod": "WS0022",
   "turkodu": "M2"
  }
}

Örnek Güncelle Çağrısı:

Servis Adı: sis_ozelkod_guncelle
Json Bilgisi:

{     
"kart": 
  {
     "_key": {"kod": "WS003", "turkodu": "M2"},
      "aciklama": "ÖZEL KOD WS",
      "durum": "A",
       "kod": "WS003",
       "turkodu": "M2"
  }
}

NOT: Ekle ve güncelle servislerinde modeldeki tüm alanları yazmanıza gerek yok, yazılmazsa default değerini korur.

Örnek Sil Çağrısı:

Servis Adı: sis_ozelkod_sil
Json Bilgisi:

{
  "key": "12345"
}

NOT: Web Servis Çalıştır aracında flw_tanim_calistir servisi kullanılarak başka bir sürecin çalıştırılması sağlanabilir. Servis parametrelerinde değişkenler gönderilerek çalıştırılacak olan süreçte bu değerler üzerinden işlem yapılması sağlanabilmektedir. Parametreler içerisinde islemturu alanı sürecinizin başlatma türü alanını belirtmeniz için gereklidir.

M: Manuel çalıştırma yöntemidir.

Örnek Manuel Süreci Parametreleri:

{
 "key": "123",
 "params": {"islemturu":"M",
            "firmaUnvani":"DİA Yazılım A.Ş.",
            "kdvOrani": 18}
 }

A: Aksiyon çalıştırma yöntemidir. Süreçte tanımlı olan Aksiyon alanı actioncode değeri ile, hangi aksiyon ile işlem yaptığı da action değeri ile parametrelere eklenmelidir.

Örnek Aksiyon Süreci Parametreleri:

{
 "key": "1234",
 "params": {"islemturu": "A",
            "action": "update",
            "actioncode": "scf1100",
            "kaynakkey": "5885399",
            "firmaUnvani":"DİA Yazılım A.Ş.",
            "kdvOrani": 18}
 }

Zamanlayıcı başlatma türündeki sürecin çalıştırılması için islemturu alanının M olarak verilmesi gerekmektedir.

Örnek Zamanlayıcı Süreci Parametreleri:

{
 "key": "12345",
 "params": {"islemturu":"M",
            "firmaUnvani":"DİA Yazılım A.Ş.",
            "kdvOrani": 18}
 }