AŞI TAKİP SİSTEMİNİ AHBS, HSBS, HBYS KULLANICILARININ WEB SERVİS KULLANIMI

Sağlık Bakanlığı Türkiye Halk Sağlığı Kurumu tarafından Aşı Takip Sistemini AHBS, HSBS, HBYS kullanıcılarının web servis (SOAP) kullanımı hakkında duyuru yayımlandı.

Aşı Takip Sistemini AHBS, HSBS, HBYS kullanıcılarının Web Servis Kullanımı

16 Ekim 2014 Perşembe 07:48

Servis_Adresi: http://testwsats.saglik.gov.tr/entegrasyon/EntegrasyonServisi.svc

UI Adresi: http://testats.saglik.gov.tr/

Firmanıza tanımlı stok bilgileri için test yaptığınız kullanıcı adı bilgisi ile ats.yardim@saglik.gov.tr mail adresine başvurunuz.

1 Kapsam

Aşı Takip Sistemini AHBS, HSBS, HBYS 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 Kullanıcı Yönetimi ve Yetkilendirme

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 Servis

3.1 Kullanabilirlik Sorgusu

Kullanıcıların uygulamadan önce aşıların sağlık durum sorgusunu yaptığı servistir.

WSDL Adresi

Kod

Metot Adı

Giriş Parametresi

Çıkış Parametresi

Açıklama

WS-ATS01

AsiKullanilabilirlikSorgusu

AsiKullanilabilirlikSorgusuGirdi

Bkz. Tablo 3.1.1

AsiKullanilabilirlikSorgusuCikti

Bkz. Tablo 3.1.4

AHBS, HSBS, HBYS kullanıcıları, bu servis ile birimlerindeki stokların(ürün) Kullanılabilirlik durum bilgisini öğrenebilir.

3.1.1 Tablo AsiKullanilabilirlikSorgusuGirdi

Parametre Adı	Tipi	Zorunluluk	Uzunluk (Mak.)	Açıklama
KullanıcıBilgisi		Zorunlu		Bkz. Tablo 3.1.2
SorguBilgisi		Zorunlu		Bkz. Tablo 3.1.3

3.1.2 Tablo Kullanıcı Bilgisi

Parametre Adı	Tipi	Zorunluluk	Uzunluk (Mak.)	Açıklama
KullaniciAdi	String	Zorunlu	11
Parola	String	Zorunlu	40

Kurallar

“KullanıcıAdi” açık metin olarak gönderilecektir.
“Parola” SHA1 ile şifrelenmiş olarak gönderilmelidir.

3.1.3 Tablo Sorgu Bilgisi

Parametre Adı	Tipi	Zorunluluk	Uzunluk (Mak.)	Açıklama
OnlineProtokol	String	Zorunlu		SağlıkNet’in vermiş olduğu protokol numarası.
StokBarkodu	String	Zorunlu	14	Minumum 8
StokSeriNo	String	Zorunlu	20
StokPartiNo	String	Zorunlu	19
Hl7Kodu	String	Zorunlu	10	Karekod üzerindeki HL7 Kodu
SonKullanmaTarihi	DateTime	Zorunlu		Karekod üzerindeki tarih
KirilimBilgisi	String	Zorunlu		Karekod üzerindeki Kırılım Bilgisi
UygulanacakKisiTipi	Enum	Zorunlu		Vatandas, Yabanci, YeniDogan, Vatansiz
UygulanacakKisiID	String	Zorunlu	20
HekimKimlikNo	String	Zorunlu	11
GeziciHizmetMi	Boolean	Zorunlu

3.1.4 Tablo KullanilabilirlikSorgusu metot çıktısı

Parametre Adı	Tipi	Uzunluk (Mak.)	Açıklama
Bilgi	String
SorguDurum	Enum		Kullanilabilir, Kullanilamaz, YetkiYok, StokYok, KullaniciadiParolaHatali
SorguNumarasi	String		GUID

Kurallar

Gönderilen Hasta bilgileri ile “OnlineProtokol” numarasının alındığı hasta bilgileri eşleşmelidir.
Gönderen Birim ile “OnlineProtokol” numarasını alan birim bilgileri eşleşmelidir.
AHBS, HSBS, HBYS kullanıcısının, sorguladığı stok “Kullanılabilir” değil ise, detaylı bilgiye “Bilgi” alanından ulaşabilmelidir.
AHBS, HSBS, HBYS kullanıcıları, sadece kendi birimindeki stoklarlar için “AsiKullanilabilirlikSorgusu” yapabilir.
AHBS, HSBS, HBYS sistemleri, daha sonra SağlıkNet’e göndermek üzere “SorgulamaNumarasi”nı saklamalıdır.
AHBS, HSBS, HBYS kullanıcıları, gezici hizmette olan veya kurye nakliyesindeki stoklar ile ilgili “AsiKullanilabilirlikSorgusu” yapmamalıdır.
AHBS, HSBS, HBYS kullanıcıları, başka birime ait stoklar ile ilgili “AsiKullanilabilirlikSorgusu” yapmamalıdır.
AHBS, HSBS, HBYS kullanıcıları, kullanılmış ya da stoktan düşmüş stoklar ile ilgili “AsiKullanilabilirlikSorgusu” yapmamalıdır.
AHBS, HSBS, HBYS 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.
AHBS, HSBS, HBYS 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.
AHBS, HSBS, HBYS kullanıcısı, “AsiKullanilabilirlikSorgusu”da gönderdiği UygulananKisiTipi “VATANDAS” ise UygulananKisiID alanına Hastanın Kimlik Numarası girilmelidir.
AHBS, HSBS, HBYS kullanıcısı, “AsiKullanilabilirlikSorgusu”da gönderdiği UygulananKisiTipi “YENIDOGAN” ise UygulananKisiID alanına Anne ya da Baba Kimlik Numarasını girmelidir.
AHBS, HSBS, HBYS kullanıcısı, “AsiKullanilabilirlikSorgusu”da gönderdiği UygulananKisiTipi “YABANCI” ise UygulananKisiID alanına Yabancı Kimlik Numarasını ya da Pasaport Numarasını girmelidir.