Servis çağrılarının sağlıklı bir şekilde yapılabilmesi için firma ve dönem bilgilerinin doğru gönderilmesi gerekmektedir. Masaüstü istemciden yada servis yoluyla bu bilgiler öğrenilebilir.

Firmalar (sis3000) ekranında listeden Firma Kodu bilgisi servislere gönderilecek firma kodudur. İlgili firma kartına girildiğinde (sis3001) Dönem Bilgileri kısmında Dönem Kodu kısmından da servislere gönderilecek dönem bilgisine ulaşılabilir. Ekran görüntüleri aşağıdadır:

Firma ve dönemlerin bir görünen, birde gerçek kodları vardır. Servis çağrılarında gerçek (numerik sıralı bir numaradır) kodlar kullanılmalıdır. Bu kodlara ulaşmanın en kolay yolu sis_yetkili_firma_donem_sube_depo servisini çağırmaktır. Çağrı sonucunda kullanıcının yetkisi olan tüm firmalara ait bilgiler result içerisinde liste şeklinde dönecektir. Dönen bilgiler içerisinde:

  • firmakodu: Firma gerçek kodu, servis çağrılarında kullanılacak
  • firmaadi: Firma adı
  • donemler: Firmaya tanımlı dönemler liste şeklinde görüntülenir. Hangi dönemde çalışılacaksa donemkodu bilgisi servislere parametre olarak gönderilmelidir.
  • subeler: Firmaya tanımlı şubeler liste şeklinde görüntülenir.
    • _key: Şubeye ait anahtar
    • subeadi: Şube adı
    • depolar: Şube altında tanımlı aktif depolar liste şeklinde görüntülenir.
  • ontanimli__: Kullanıcı kartında kullanıcıya öntanımlı atanmış anahtar değerler. Örneğin ontanimli__key_scf_carikart tanımlı öntanımlı cari kart anahtar (_key) değeridir.

Örnek Çağrı (Input):

{"sis_yetkili_firma_donem_sube_depo" :
    {"session_id": "b2d4820cc43f4d98a8c6698686b6d386"
    }
}

Örnek Çıktı (Response):

{'code': '200',
 'msg': '7dd79840-ecf8-4e2e-acf7-0653bdbc1221',
 'result': [{'_key_sis_doviz_raporlama': 9223365439785136625,
              'anadovizadi': 'TL',
              'anadovizkey': 9223365439785136625,
              'calismagunleri': 127,
              'donemler': [{'_key': 176602,
                             'baslangictarihi': '2017-01-01',
                             'bitistarihi': '2017-12-31',
                             'donemkodu': 1,
                             'gorunendonemkodu': '01',
                             'ontanimli': 't'}],
              'efatura': 't',
              'firmaadi': 'DİA GENEL',
              'firmakodu': 34,
              'ontanimli__key_pos_pos_tanimi': 0,
              'ontanimli__key_rst_garson': 181650,
              'ontanimli__key_scf_carikart': 181078,
              'ontanimli__key_scf_kasakart': 178760,
              'ontanimli__key_scf_satiselemani': 182570,
              'ontanimli__key_scf_sevkaraci': 176350,
              'ontanimli__key_sis_departman': 99344,
              'ontanimli__key_sis_depo': 176601,
              'ontanimli__key_sis_sube': 176600,
              'ontanimlifirmakodu': 34,
              'ontanimliyetkikodlari': [],
              'subeler': [{'_key': 176600,
                            'depolar': [{'_key': 176601,
                                          'depoadi': 'MERKEZ DEPO (İST)'}],
                            'subeadi': 'MERKEZ (İST)'},
                           {'_key': 180744,
                            'depolar': [{'_key': 180745,
                                          'depoadi': 'ANKARA DEPO 1'},
                                         {'_key': 184427,
                                          'depoadi': 'ANKARA DEPO 2'}],
                            'subeadi': 'ANKARA'}]
               }]
}