AŞI TAKİP SİSTEMİ ENTEGRASYON WEB SERVİS DOKÜMANTASYONU 1. KAPSAM Aşı Takip Sistemi AHBS, HSBS, HBYS ve MBYS kullanıcılarının web servis (SOAP) aracılığıyla kullanacakları metotların yapısı ve kuralları anlatılmaktadır. Servisler SSL üzerinden çalışacaktır. 2. KULLANICI YÖNETİMİ VE YETKİLENDİRME Tüm kullanıcıların Kullanıcı Adı ve Parola bilgisi Sağlık.Net sisteminde kullandığı veriler olmalıdır. 2.1. AHBS Sistem Kullanıcıları Kullanıcı Adı, aile hekiminin kimlik numarasıdır. Parola ise, aile hekimine verilmiş Sağlık.Net parolasıdır. Online Protokol Numarası, yazılım firmasının Sağlık.Net üzerinden aldığı protokol numarasıdır. 2.2. HSBS Sistem Kullanıcıları Kullanıcı Adı, birime verilmiş Sağlık.Net kullanıcı adıdır. Parola ise, birime verilmiş Sağlık.Net parolasıdır Online Protokol numarası, yazılım firmasının Sağlık.Net üzerinden aldığı protokol numarasıdır. 2.3. HBYS Sistem Kullanıcıları Kullanıcı Adı, kurumun ÇKYS kodudur. Parola ise, kuruma verilmiş Sağlık.Net parolasıdır. Online Protokol Numarası, yazılım firmasının Sağlık.Net üzerinden aldığı protokol numarasıdır. 3. WEB SERVİSLER WSDL servisi adresleri; Gerçek Ortam: https://wsats.saglik.gov.tr/entegrasyonv2/entegrasyonservisi.svc Test Ortamı: http://testwsats.saglik.gov.tr/entegrasyonv2/entegrasyonservisi.svc
Kodu Metod Adı Giriş Parametresi Çıkış Parametresi WS-ATS01 AsiKullanilabilirlikSorgusu AsiKullanilabilirlikSorgusuGirdi AsiKullanilabilirlikSorgusuGirdi Bkz. Tablo 3.1.1 AsiKullanilabilirlikSorgusuCikti AsiKullanilabilirlikSorgusuCikti Bkz. Tablo 3.1.2 AHBS, HSBS, HBYS, MBYS kullanıcıları, bu servis ile birimlerindeki stokların(ürün) Kullanılabilirlik durum bilgisini öğrenebilir. WS-ATS02 AsiUygulama Istek AsiUygulamaParametre Bkz. Tablo 3.2.1 AsiUygulamaResult AsiUygulamaCikti Bkz. Tablo 3.2.2 AHBS, HSBS, HBYS,MBYS kullanıcıları, bu servis ile uyguladıkları stokların uygulama bilgisini gönderebilir. WS-ATS03 UygulamaSorgusu SorguNo UygulamaSorgusuResult guid Bkz. Tablo 3.3.1 UygulamaSorgusuCikti Bkz. Tablo 3.3.2 3.1. Kullanabilirlik Sorgusu Kullanıcıların uygulamadan önce aşıların sağlık durum sorgusunu yaptığı servistir. 3.1.1 AsiKullanılabilirlikSorgusuGirdi Zorunluluk Uzunluk KullaniciBilgisi KullaniciBilgisi Zorunlu Bkz. Tablo 3.1.1.1 SorguBilgisi AsiSorguBilgisi Zorunlu Bkz. Tablo 3.1.1.2 Tablo 3.1.1.1 KullanıcıBilgisi Zorunluluk Uzunluk KullaniciAdi string Zorunlu 11 Parola string Zorunlu 40
Kurallar 1. KullanıcıAdi açık metin olarak gönderilecektir. 2. Parola SHA1 ile şifrelenmiş olarak gönderilmelidir. Tablo 3.1.1.2 AsiSorguBilgisi Zorunluluk Uzunluk AsiKodu string Zorunlu DogumTarihi datetime Zorunlu DozBilgisi int Zorunlu GeziciHizmetMi boolean Zorunlu HekimKimlikNo string Zorunlu KirilimBilgisi string Zorunlu OnlineProtokolNo string Opsiyonel SonKullanmaTarihi datetime Zorunlu StokBarkod string Zorunlu StokPartiNo string Zorunlu StokSeriNo string Zorunlu UygulanacakKisiId string Zorunlu UygulanacakKisi EKisi Zorunlu Vatandas = 1 Yabanci = 2 Vatansiz = 3 YeniDogan = 4
Tablo 3.1.2 AsiKullanilabilirlikSorgusuCikti Zorunluluk Uzunluk Bilgi string Zorunlu SorguKullanilabilirlikDurumu EKullanilabilirlikDurumu Zorunlu Kullanilabilir = 1 Kullanilamaz = 2 YetkiYok = 3 StokYok = 4 KullaniciadiParolaHatali = 5 TasimaBirimiUrunDegil = 6 SogukZincirMaruziyet = 7 TasimaDurumunda = 8 GeziciHizmetTuketimyok = 9 GeziciHizmette = 10 SorguNumarasi string Zorunlu guid Kurallar 1. AHBS, HSBS, HBYS, MBYS kullanıcısının, sorguladığı stok Kullanılabilir değil ise, detaylı bilgiye Bilgi alanından ulaşabilmelidir. 2. AHBS, HSBS, HBYS, MBYS kullanıcıları, sadece kendi birimindeki stoklar için AsiKullanilabilirlikSorgusu yapabilir. 3. AHBS, HSBS, HBYS, MBYS sistemleri, daha sonra SağlıkNet e ve/veya Uygulama Bildirim Servisinden stok düşümünde göndermek üzere SorgulamaNumarasi nı saklamalıdır. 4. AHBS, HSBS, HBYS, MBYS kullanıcıları, gezici hizmette olan veya kurye nakliyesindeki stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır.bu durumda olan aşılar için yapılan sorgularda Kullanılamaz mesajı ile beraber Bilgi alanında aşının durumu kullanıcıya gönderilir. Sorgu Numarası gönderilmez. 5. AHBS, HSBS, HBYS, MBYS kullanıcıları, başka birime ait stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır. Bu durumda olan aşılar için yapılan sorgularda Kullanılamaz mesajı ile beraber Bilgi alanında aşının durumu kullanıcıya gönderilir. Sorgu Numarası gönderilmez. 6. AHBS, HSBS, HBYS, MBYS kullanıcıları, kullanılmış ya da stoktan düşmüş stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır. Bu durumda olan aşılar için yapılan sorgularda Kullanılamaz mesajı ile beraber Bilgi alanında aşının durumu kullanıcıya gönderilir. Ek olarak bu aşının kime uygulandığı bilgisi Bilgi alanında gösterilir. Sorgu Numarası gönderilmez. 7. AHBS, HSBS, HBYS, MBYS kullanıcıları, AsiKullanilabilirlikSorgusu sorgusunda stok(ürün) taşıma birimi, o ürün için en alt seviye taşıma birimi olmalıdır. Çoklu doz flakon ya da ürün olabilir. Bu durumda olan aşılar için yapılan sorgularda Kullanılamaz mesajı ile beraber Bilgi alanında Taşıma Birimi Ürün Değil mesajı gönderilir. Sorgu Numarası gönderilmez. 8. AHBS, HSBS, HBYS, MBYS kullanıcısı, GeziciHizmetMi alanına Evet demiş ise, o stokla ilgili Gezici Hizmetin sonlandırılmış olması gerekir. Gezici Hizmette görünen stoklar için yapılan sorgularda Kullanılamaz mesajı ile beraber Bilgi alanında Gezici Hizmet Tüketimi Yok mesajı gönderilir. Sorgu Numarası gönderilmez. 9. AHBS, HSBS, HBYS, MBYS kullanıcısı, AsiKullanilabilirlikSorgusu da gönderdiği UygulananKisi VATANDAS ise UygulananKisiID alanına Hastanın Kimlik Numarası girilmelidir. 10. AHBS, HSBS, HBYS, MBYS kullanıcısı, AsiKullanilabilirlikSorgusu da gönderdiği UygulananKisi YENIDOGAN ise UygulananKisiID alanına Anne ya da Baba Kimlik Numarasını girmelidir. 11. AHBS, HSBS, HBYS, MBYS kullanıcısı, AsiKullanilabilirlikSorgusu da gönderdiği UygulananKisi YABANCI ise UygulananKisiID alanına Yabancı Kimlik Numarasını ya da Pasaport Numarasını girmelidir. 12. AHBS, HSBS, HBYS, MBYS kullanıcısı, AsiKullanilabilirlikSorgusu da gönderdiği UygulananKisi VATANSIZ ise UygulananKisiID alanına Yabancı Kimlik Numarasını, Pasaport Numarasını girmelidir. Böyle bir numara yoksa boş olarak gönderilebilir.
Not: Daha önceki versiyonlarda Zorunlu olarak istenen Online Protokol numarası zorunluluğu bu versiyonda kaldırılmıştır. Kullanıcı sorguladığı aşı ile ilgili Yetki hatası alıyorsa ÇKYS tarafındaki mevcut durum bilgilerinin güncellenmiş olmasını kontrol ettirmelidir. 3.2. Aşı Uygulama Kullanıcıların aşı uygulama sonrası stok uygulama bilgisinin gönderildiği servistir. Tablo 3.2.1 AsiUygulamaParametre Zorunluluk Uzunluk KullaniciBilgisi KullaniciBilgisi Zorunlu Bkz. Tablo 3.1.1.1 UygulamaSorguBilgisi AsiUygulamaBilgisi Zorunlu Bkz. Tablo 3.2.1.1 Tablo 3.2.1.1 AsiUygulamaBilgisi Zorunluluk Uzunluk OnlineProtokolNo string Opsiyonel SorguNumarasi string Zorunlu UygulamaZamani datetime Zorunlu Tablo 3.2.2 AsiUygulamaCikti Zorunluluk Uzunluk SorguNumarasi string Zorunlu UygulamaDurum EUygulamaDurum Zorunlu Basarili=1 Basarisiz=2 YetkiYok=3 StokYok=4 KullaniciadiParolaHatali=5 Kurallar
1. KullanıcıAdi açık metin olarak gönderilecektir. 2. Parola SHA1 ile şifrelenmiş olarak gönderilmelidir. 3. Uygulama bildirimi aşı uygulaması yapıldığında gönderilmelidir. 4. Aşı Kullanılabilirlik Sorgusundan alınan Sorgu No ile en geç 3 saat içerisinde uygulama bildirimi yapılmalıdır. Eğer yaptığı sorgu 3 saati geçmiş ise yeniden AsiKullanilabilirlikSorgusu yapıp, AsiUygulama verisini öyle göndermelidir. 5. AHBS, HSBS, HBYS, MBYS kullanıcısı, AsiKullanilabilirlikSorgusu yapılmayan stokların AsiUygulama sını gönderemez. 6. AsiUygulama da gönderilen SorguNumarasi, AsiKullanilabilirlikSorgusu nda alınan GUID olmalıdır. 7. AHBS, HSBS, HBYS, MBYS kullanıcısının, uyguladığı stoğa ait Uygulama Durumu Basarili değil ise, detaylı bilgiye Bilgi alanından ulaşabilmelidir. 8. AHBS, HSBS, HBYS, MBYS kullanıcısı, kendi biriminde ve sahibi olduğu stokların uygulama bilgisini gönderebilir. 9. AHBS, HSBS, HBYS, MBYS kullanıcısı, kendi aldığı SorguNumarasi ile AsiUygulama gönderebilir. 10. AHBS, HSBS, HBYS, MBYS kullanıcıları, gezici hizmette olan veya kurye nakliyesindeki stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır. 11. AHBS, HSBS, HBYS, MBYS kullanıcıları, başka birime ait stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır. 12. AHBS, HSBS, HBYS, MBYS kullanıcıları, kullanılmış ya da stoktan düşmüş stoklar ile ilgili AsiKullanilabilirlikSorgusu yapmamalıdır. 13. AHBS, HSBS, HBYS, MBYS kullanıcıları, AsiKullanilabilirlikSorgusu sorgusunda stok(ürün) taşıma birimi, o ürün için en alt seviye taşıma birimi olmalıdır. Çoklu doz flakon ya da ürün olabilir. 14. AHBS, HSBS, HBYS, MBYS kullanıcısı, GeziciHizmetMi alanına Evet demiş ise, o stokla ilgili Gezici Hizmetin sonlandırılmış olması gerekir. Gezici Hizmette görünen stoklar uygulanamaz olarak görünecektir.