T.C.
SOSYAL GÜVENLİK KURUMU
Medula Eczane Stok Bilgileri Web Servisleri Kullanım Kılavuzu
27 Aralık 2017
Amaç
Eczanelerin sorgulanan güne ait olan reçete ilaç bilgilerinin istemci tarafına gönderilmesi.
Yetkilendirme
Uygulamalar bu servise eczanenin kullanıcı adı / şifresiyle erişebileceklerdir.
Web Servislerinde Şifre Gönderilmesi
Web servislerinde HTTP Basic Authentication yöntemi kullanılmaktadır. Bunun için web servis isteklerinde (request), eczane kullanıcı adı ve şifresi HTTP Header içinde GSS sunucusuna gönderilmelidir. Web servisleri teknolojisi ile oturum (session) bilgisini muhafaza etmenin henüz standart bir yolu olmadığı için, kullanıcı adı ve şifrenin her SOAP isteminde (request) gönderilmesi gerekmektedir.
Web Servisi Adresi
https://medeczane.sgk.gov.tr/medula/eczane/eczaneStokIslemleriWS
Web Servisi WSDL Adresi
https://medeczane.sgk.gov.tr/medula/eczane/eczaneStokIslemleriWS?wsdl
Web servisiyle ilgili sorunlarınızı eczane@sgk.gov.tr e-posta adresine gönderebilirsiniz.
Bu dokümanın son haline https://medeczane.sgk.gov.tr/eczane/ adresinden ulaşabilirsiniz.
Değişiklikler
2.05 27.12.2017
SOSYAL GÜVENLİK KURUMU SSL/TLS SERTİFİKASI TLS 1.2 KULLANIMI HAKKINDA DUYURU (26.12.2017 tarihinde Kurum portalında yayınlanmıştır.)
Bilindiği gibi 07.12.2016 tarihli “Sosyal Güvenlik Kurumu SSL/TLS Sertifikası TLS 1.2 Kullanımı” konulu duyuru ile 13.01.2017 tarihi itibari ile “SGK Kurum internet ve web servis uygulamalarına SSL/TLS erişiminde(https erişimi) en az TLS 1.2 sürümü desteklenecektir.” bildirisi yapılmıştı. Konu ile ilgili 13.01.2017 tarihli diğer bir duyuru ile Kurum uygulamalarımıza bağlantı kuran cihazların eski sürüm cihazlar olması, bir önceki duyuruda belirtilen güncellemelerin yapılabilmesini sağlayacak yatırım planları için yeterli zaman bulunmaması gibi sahadan gelen bildirimler değerlendirilerek bağlantı metodu değişikliğinin 03.01.2018 tarihine ertelenmesine karar verilmişti.
Kurum uygulamaları https bağlantı yönteminde tls1.0 ve 1.1’in kapatılarak sadece tls1.2 sürümünün desteklenmesi ile ilgili 1 yıl önce yapılan Ek’te bulunan duyurular uyarınca (Ekler Kurum portalında yayınlanan 26.12.2017 tarihli duyuruda yer almaktadır) 03.01.2018 tarihi itibari ile Kurum internet uygulamaları bağlantılarında en az TLS 1.2 sürümü kabul edilecektir.
Kurum internet uygulamaları kullanıcılarının uygulamalara daha güvenli bağlanabilmesi için kullandıkları cihazların işletim sistemi ve internet tarayıcılarını mümkün olan en son sürüm ve güncelleştirmeler ile kullanması Kurumumuz tarafından önerilmektedir.
Duyurunun tam metnine Kurum portalındaki 26.12.2017 tarihli duyurudan ulaşılabilmektedir.
2.04 01.03.2017
27.07.2015 tarihinde web servis erişim yöntemi ws-security olarak değiştirilerek yeni web servis adresi yukarıda paylaşılmış ve 01.03.2017 tarihi itibariyle eski web servis kullanıma
kapatılmıştır.
2.03 07.02.2017
27.07.2015 tarihinde web servis erişim yöntemi ws-security olarak değiştirilerek yeni web servis adresi yukarıda paylaşılmıştır. Eski web servise erişim Şubat ayı sonunda kapatılacak olup, bahsi geçen tarih öncesi gerekli entegrasyonun sağlanması gerekmektedir.
2.02 29.12.2016
SOSYAL GÜVENLİK KURUMU SSL/TLS SERTİFİKASI TLS 1.2 KULLANIMI HAKKINDA DUYURU (07.12.2016 tarihinde Kurum portalında yayınlanmıştır.)
Bilindiği gibi bilgi teknolojisi sistemlerinde güvensiz ağlarda taşınan kritik verilerin korunması için SSL/TLS şifreleme algoritmalarının değişik sürümleri kullanılmaktadır.
SGK Kurum internet ve web servis uygulamalarına SSL/TLS erişiminde (https erişimi) en az TLS 1.2 sürümü desteklenecektir. Bu sürüm dışındaki sürümlerle gelen istekler ise bilgi güvenliği gerekçeleri ile kabul edilmeyecektir.
Bahsi geçen duruma uyumun sağlanması ile ilgili yapılan araştırmalara göre:
• Kurum uygulamalarına tarayıcılar üzerinden bağlanan kullanıcıların en az Internet Explorer 8, Mozilla Firefox 27, Google Chrome 38 tarayıcı sürümlerini kullanması gerekmektedir.
• Kurum web servis uygulamalarına bağlanan kullanıcıların sunucu olarak en az Microsoft Windows 2008 R2 veya Windows 7 sürümünü, Linux sürümleri içinse TLS 1.2 desteği sunan openssl 1.0.0.1e paketi yüklü sunucuları kullanmaları gerekmektedir.
• Kurum uygulamalarına bağlanan istemcilerin işletim sistemi ve tarayıcı güncelleştirmelerinin yapılmış olması önemlidir. Microsoft Windows 7 sürümü altı işletim sistemleri, TLS 1.2 desteği sunmadığı için web servis ve internet explorer tarayıcısıyla erişimde problem yaşayacaktır. Google Chrome’un TLS 1.2 desteği Internet Explorer gibidir. Chrome da en az
Windows 7 işletim sistemine gereksinim duymaktadır. Mozilla Firefox ise Windows 7 sürümü altı işletim sistemlerinde (en az Windows XP SP2), TLS 1.2 desteği vermektedir. Belirtilen tarih sonrası Windows 7 altı sistemlerden Kurum uygulamalarımıza bağlanmak isteyenler yukarıda en azı belirtilen Firefox sürümü ile uygulamalarımıza bağlantı kurabileceklerdir.
Konu ile ilgili olarak belirtilen tarihe kadar istemci tarafında yukarıda belirtilen hazırlıkların yapılması gerekmektedir.
2.01 27.07.2015 • Stok bilgileri web servisine erişim yöntemi ws-security olarak değiştirilmiş olup, yeni web servis gerçek ortamda kullanıma açılmıştır.
Servise yeni erişim yöntemiyle ilgili sorularınız için xml@sgk.gov.tr e-posta adresini kullanabilirsiniz.
• Günlük Stok Bilgisi Sorgulama Metodu
Metod Adı Giriş Parametresi Çıkış Parametresi
gunlukStokBilgisiSorgulama StokBilgisiSorgulamaDVO (bkz. Tablo 1.a) StokBilgisiSorgulamaCevapDVO (bkz. Tablo 1.b)
Tablo – 1.a: StokBilgisiSorgulamaDVO Parametre
Adı Açık Adı Tipi Uzunluk Gerekli
mi? Açıklama
sorguTarihi Sorgu Tarihi String 10 Evet Sorgulanan stok bilgisi tarihi. dd.MM.yyyy formatında olmalıdır.
eczaneKodu Eczane Kodu int 8 Evet Stok bilgisi sorgulanan eczanenin kodu.
Tablo – 1.b : StokBilgisiSorgulamaCevapDVO Parametre
Adı Açık Adı Tipi Uzunlu
k Açıklama
sonucKodu Sonuç kodu String 4 Sonuç 0 (sıfır) ise sorgu hatasız olarak yapılmıştır. 0 ’dan farklı ise işlem hatalıdır.
sonucMesaji Sonuç mesajı String N/A Sonuç açıklaması. Hata durumunda, hatanın sebebi bu alanda belirtilecektir.
uyariMesaji Uyarı mesajı String N/A Yapılan işlemle ilgili oluşan uyarı mesajı.
stokListesi Stok listesi StokBilgisiDVO[] (bkz. Tablo
1.c) N/A Stok listesi
Tablo –1.c : StokBilgisiDVO Parametre
Adı Açık Adı Tipi Uzunluk Açıklama
receteNo Reçete
Numarası String N/A Reçete Kayıt Numarası
barkod Barkod long 11-13 Hastaya verilen ilacın barkod bilgisi
adet İlaç Adedi int İlacın adedi.
