T. C. Sağlık Bakanl ığı Sağlık Bilgi Sistemleri Genel Müdürlüğü -Reçete Uygulaması Yazılım Geliştirici Kılavuzuu Sürüm 1.3 2012
İçindekiler 1. Proje Amacı.................. 3 2. Kapsam... 3 3. Değişim Yönetimi... 3 4. Kullanıcı Yönetimi ve Yetkilendirme... 3 4.1. Aile ekimleri... 3 4.2. BYS Sistemleri... 3 4.3. Diğer kullanıcılar... 4 4.4. Web Servisi Şifre Gönderimi... 4 5. Web Servis Adresleri... 4 6. Metotlar..................... 4 6.1. Metot: ReceteAramaSonucunuSayfaliGetir... 4 6.2. Metod: ReceteAramaSonucunuSayisiniGetir... 5 6.3. Metot: ReceteCiktisiGetirr... 6 6.4. Metot: ReceteDuzenle.................. 6 6.5. Metot: Recetekle... 7 6.6. Metot: ReceteGetir... 7 6.7. Metot: ReceteIdIle... 8 6.8. Metot: ReceteGetirProtokolNumarasiIle... 8 6.9. Metot: Receteiptal... 9 6.10. Metot: ReceteleriGetir... 9 7. Veri Setleri... 10 7.1. Reçete Veri Seti... 10 7.2. Reçete Ilaç Veri Seti... 11 7.3. Reçete Tanı Veri Seti... 13 7.4. ServiceResult Veri Seti... 14 7.5. SaglikNetxception Veri Seti... 14 8. Sözlük ve lar... 15 8.1. ReceteTuru... 15 8.2. İlaç Rapor Durumu... 15 1
8.3. Rapor Formatları... 15 8.4. Reçete Durumu... 16 8.5. numxceptiontype... 16 9. İş Süreçleri... 16 10. Kullanıcı Ara yüzü... 16 11. Standartlar... 17 12. Sık Sorulan Sorular... 17 1. Soru: Aşağıdaki alanların anlamları nedir?... 17 13. İletişim... 24 2
1. Proje Amacı Sağlık Bakanlığı ü 663 Sayılıı Kanun ükmünde Kararname ile Türkiye de sağlık hizmetinin geliştirilmesi ve memnuniyetin arttırılması kapsamında elektronik hizmetlerin geliştirilmesi ve bu sayede hizmet kalitesini arttırmayı hedeflemektedir. Bu kapsamda geliştirilen projelerden bir tanesi olan e reçete ülkemizde üretilen tüm reçetelerin elektronik olarak toplanabilmesine olanak tanıyan, toplanan veriler üzerinden yapılacak analizler ile politika belirlenmesine yardımcı olacak bir projedir. Bu projelerin hedefi vatandaşlarımıza verilen hizmetin kalitesinin arttırılmasıdır. 2. Kapsam reçete uygulaması ülkemizde üretilen tüm reçetelerin elektronik olarak web servisler ile toplanmasını hedeflemek ktedir. 3. Değişim Yönetimi Sık Sorulan Sorular alanı güncellenmiştir. ReceteIlac: IlacKullanimAdedi alanı decimal olarak güncellenmiş ve WSDL güncellenmiştir. 4. Kullanıcı Yönetimi ve Yetkilendir rme 4.1.. Aile ekimleri Aile hekimleri kullandıkları yazılımlar aracılığı ile ilgili web servislere bilgi gönderecektir. Bu servisleri kullanırken Sağlık Bakanlığı tarafından kendilerine verilmiş olan ABSYS kullanıcı adı ve şifresini kullanacaklardır. Şifre ABS servislerin de olduğu gibi SA1 ile kriptolu olmalıdır. (SGK Tarafından verilen hekim şifresi değildir. Sağlık Bakanlığı Aile A ekimliği Şifresidir) KullanıcıAdı Formatı: Recete:ABSKullaniciAdi Şifre: SA1 li şifre 4.2.. BYS Sistemleri BYS ler hastanelerde üretilen reçeteleri gönderirken hastane için atanmış sağlık net şifresini kullanacaklardır. Kullanıcı adı : LDAP\recete:KullanıcıAdı şeklinde gönderilecektir. Şifre sağlık nette olduğu gibi açık gönderilecektir. (SGK Tarafından verilen hekim şifresidir.) şifresi değildir. Sağlık BakanlığıSağlıknett kurum 3
KullanıcıAdı Formatı: LDAP\Recete:KullaniciAdi Şifre: ashlenmemiş cleartext şifre 4.3.. Diğer kullanıcılar Sağlık net şifresi kullanılacaktır. Kullanıcı adı : LDAP\Recete:KullanıcıAdı şeklinde gönderilecektir. Şifre sağlık nette olduğuu gibi açık gönderilecektir. KullanıcıAdı Formatı: LDAP\Recete:KullaniciAdi Şifre: ashlenmemiş cleartext şifre 4.4.. Web Servisi Şifre Gönderimi Web Servisi güvenliği WS Security standardları kapsamındak a Transport Security ve WSS UserName Token (Password Type = ="http://docs.oasis open.org/wss/2004/01/oasis 200401 wss username token profile yapılmıştır. 5. Web Servis Adresleri WSDL Adresi https://erecete.saglik.gov.tr/routerservice/recete.wsdl Servis Adresi https://erecete.saglik.gov.tr/routerservice/router.svc/recete 1.0#PasswordText" ) yapısı ile çalışacak şekilde düzenleme 6. Metotlar 6.1.. Metot: ReceteAramaSonucunuSayfaliGetir Verilen bilgilere göre çıkan reçete sonuçlarını sayfalayarak getiren metottur. Arama kriterlerinden eksik olanlar null gönderilebilir. Kullanıcı, ancak yetkisii olan reçete sonuçlarını görebilir. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. receteturu Reçete Türü recetetarihibaslangic recetetarihibitis protokolnumarasi sgktakipnumarasi hastakimliknumarasi datetime datetime Reçete Başlangıç Tarihi Reçete Bitiş Tarihi Protokol Numarası SGK Takip Numarası asta T.C. Kimlik Numarası 4
hastatelefonnumarasi sosyalguvencedurumu diplomatescilnumarasi hekimkimliknumarasi kurum sayfa sayfaboyutu asta Telefon Numarası asta Sosyal Güvence Durumu ekim Diploma Tescil Numarası ekim T.C. Kimlik Numarası Kurum Kodu Sayfa Sayfanın Boyutu Output (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteAramaSonucunuSayfaliGetirResult ServiceResult<List<Recete Reçete Listesi 6.2.. Metod: ReceteAramaSonucunuSayisiniGetir Arama kriterler ile gelecek reçete listesinin eleman sayısını getiren metottur. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. receteturu recetetarihibaslangic recetetarihibitis protokolnumarasi sgktakipnumarasi hastakimliknumarasi hastatelefonnumarasi sosyalguvencedurumu datetime datetime Reçete Türü Reçete Başlangıç Tarihi Reçete Bitiş Tarihi Protokol Numarası SGK Takip Numarası asta T.C. Kimlik Numarası asta Telefon Numarası asta Sosyal Güvence Durumu 5
diplomatescilnumarasi hekimkimliknumarasi kurum ekim Diploma Tescil Numarası ekim T.C. Kimlik Numarası Kurum Kodu Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteAramaSonucunuSayisiniGetirResult ServiceResult< Arama Sonuç Sayısı 6.3.. Metot: ReceteCiktisiGetir Verilen reçete kodu ve format tipi ile reçete çıktısını dönen metottur. Reçete formatı, NUMS kısmında bulunan format tiplerinden bir tanesi olmalıdır. Kullanıcı ancak yetkisi olan reçetenin çıktısını alabilir. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. recetekodu raporformati Reçete Kodu Rapor Formatı Çıktı (Literal) Metot Çıktılarıı aşağıdaki tabloda t listelenmiştir. ReceteCiktisiGetirResult ServiceResult<byte[] Formatlanmış dosya çıktısı 6.4.. Metot: ReceteDuzenle Daha önceden kullanıcınınn kaydettiği reçete üzerinde değişiklik yapmasını sağlayan metottur. 6
Reçete Sürüm 1,0 Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. duzenlenecekrecetee Recete Değiştirilecek Reçete nesnesi. Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteDuzenleResult ServiceResult<bool Düzenleme işleminin sonucu 6.5.. Metot: Recetekle Yeni reçete ekleme işlemi yapan metottur. Girdi (Literal) Metot girdilerii aşağıdaki tabloda t listelenmiştir. eklenecekrecete Recete Reçete nesnesi Çıktı (Literal) Metot Çıktılarıı aşağıdaki tabloda t listelenmiştir. RecetekleResult ServiceResult<Recete klenmiş reçete nesnesi 6.6.. Metot: ReceteGetir Verilen reçete kodu ile, ilgili reçeteyi getiren metottur. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. recetekodu Reçete Kodu Bilgisi 7
Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteGetirResult ServiceResult<Recete İlgili reçete nesnesi 6.7.. Metot: ReceteIdIle Verilen reçete ID si ile ilgili reçeteyi getiren metottur. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. receteid long İlgili reçete database id si Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteGetirIdIleResult ServiceResu ult<recete İlgili reçete nesnesi 6.8.. Metot: ReceteGetirProtokolNumarasiIle Verilen protokol numarası ile ilgili reçeteyi getiren metottur. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. protokolnumarasi İlgili reçete protokol numarası Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteGetirProtokolNumarasiIleResult p ServiceResult< <Recete İlgili reçete nesnesi 8
6.9.. Metot: Receteiptal Verilen reçete kodu ile reçeteyi iptal eden metottur. Bu metodu ancak k reçeteyi ekleyen doktor kullanabilir. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. recetekodu İptal edilmesi istenilen reçete kodu Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. ReceteIptalResult ServiceResult<bool İşlem sonucu 6.10. Metot: ReceteleriGetir Verilen tarih aralığında, ilgili doktorun, ilgili tarih aralığındaki reçetelerini getirir. Gönderilmesi gereken durum kodu bilgisi NUMS kısmında Reçete Durumu adı ile bulunmaktadır. Girdi (Literal) Metot girdileri aşağıdaki tabloda listelenmiştir. recetetarihibaslangic recetetarihibitis hekimkimliknumarasi durum datetime datetime Tarih aralığı başlangıç Tarih aralığı bitiş ekim Kimlik Numarası Durum Kodu Çıktı (Literal) Metot çıktıları aşağıdaki tabloda listelenmiştir. 9
ReceteleriGetirResult ServiceResult<Recete Sonuç Reçete nesne n listesi 7. Veri Setleri Aşağıdaa belirtilen veri setlerinde kullanılan zorunlu alan çeşitleri şunlardır: : vet, : ayır, G: Güncelleme işleminde zorunlu, z sistem içinde otomatik üretilir. Güncelleme işlemi için recete versinin son versiyonu üzerinde işlem yapılmalıdır. Recete R son versiyonu üzerindeki G degerleri değiştirilmeden gönderilmelidir. 7.1.. Reçete Veri Seti ekimin muayene sonucunda yazdığı reçete bilgilerini barındıran veri setidir. Alan Adıı Id ReceteKodu ReceteTuruKodu ReceteTarihi ProtokolNumarasi DiplomaTescilNumarasi SGKTakipNumarasi ekimkimliknumarasi SosyalGuvenceDurumuKodu KurumKodu Açık Adı Id Reçete Koduu Reçete Türü Kodu Reçete Tarihi Protokol Numarası Diploma Tescil Numarası SGK Takip Numarasi ekim T.C. Kimlik No Sosyal Güvence Durumu Kodu Kurum Koduu Zoru nlu G G i datetime İnt Uz. Açıklama 8 Bu alan sistemin iç kullanımı amaçlıdır. 20 Reçete sisteminde reçetelere tekil bir kod vermek amaçlı üretilir. Reçeteler bu kod ile takip edilir. 4 SKRSS Reçete Türü kodları kullanılacak Reçetenin yazıldığı tarih 40 astane sistemindeki protokol numarası 20 Reçeteyi yazan ekim Diploma Tescil Numarası 20 SGK Sistemindenn alınan Takipp Numarası 11 Reçeteyi yazan ekim T.C. Kimlik Numarası 4 SKRSS Sosyal Güvence Durumu kodları kullanılacakk Reçetenin yazıldığı kurum koduu. SKRS Kurumlar 10
astakimliknumarasi YabanciastaPasaportNuma rasi astatelefonnumarasi SGKreceteNumarasi SGKreceteKayitSonucu ReceteIlac ReceteTani ReceteDurumu AktifMi ZamanDamgasi asta T.C. Kimlik No Yabancı asta Pasaport Numarası asta Telefon Numarası SGK Reçete Numarasi SGK Reçete Kayıt Sonucuu Reçete İlaçları Reçete Tanıları Reçete Durumu Aktif Mi Zaman Damgası G G G ReceteIla c[] ReceteTa ni[] bool binary kodları kullanılacak 11 astaa Türkiye vatandaşı veya T.C. Kiimlik numarası var ise astanın T.C. Kimlik Numarası. 15 astaa T.C. Kimlik Numarası yok ise YabanciastaPasaportNumarr asi alanı dolu gönderilmelidir. YabanciastaPasaportNumarr asi veya astakimliknumarasi alanlarının ikisinden biri mutlaka dolu olmalıdır. 15 Adınaa Reçete yazılan hasta telefon numarası 50 SGK Reçete sistemine kayıttan sonra alınan Reçete numarası. 500 SGK Reçete sistemine kayıt sırasında alınmış olan başarı yadaa hata mesajıı Reçete de yazılmış olan ilaçlar listesi. Reçete İlaç veri seti kısmında detayları belirtilmiştir. Reçete de hekimin belirlemiş olduğuu tanılar listesi. Reçete Tanı veri seti kısmında detayları belirtilmiştir 10 Bu alan sistemin iç kullanımı amaçlıdır. Bu alan sistemin iç kullanımı amaçlıdır. Reçete verisinin veri bütünlüğünü korumak amaçlı olarak sistem içinde kullanılır. 7.2.. Reçete Ilaç Veri Seti ekimin muayene sonucunda belirlemiş olduğu ilaçlar için kullanılacakk k olan veri setidir. Alan Adıı Açık Adı Zorunlu i Uz. Açıklama 11
Id IlacBarkod SerbestIlacAdi IlacKullanimSekliKodu IlacKullanimPeriyodu IlacKullanimPeriyoduBirimiKoduu IlacKullanimAdedi IlacAdedi IlacRaporDurumuKodu IlacKareKod MuadiliOlduguReceteIlacId Id İlaç Barkod Serbest İlaç Adı İlaç Kullanım Şekli Kodu İlaç Kullanım Periyodu Kodu İlaç Kullanım Periyodu Birimi Kodu İlaç Kullanım Adedi İlaç Adedi İlaç Rapor Durumu Kodu İlaç Kare Kod Muadili Oldugu Recete İlaç İd G decimal 8 Bu alan sistemin iç kullanımı amaçlıdır. Güncelleme işleminde reçete ilaç veri setinde gönderilmesi zorunludur. 20 SKRSS İlaçlar kodlarındaki Barkodu alanı kullanılacak 250 Yazılan ilaç tanımlı SKRS İlaçlar kodları arasında yok ise SerbestIlacAdi dolu gönderilmelidir. IlacBarkod veyaa SerbestIlacAdi alanlarının ikisinden biri mutlaka dolu olmalıdır. 4 SKRSS İlaç Kullanım Şekli kodları kullanılacak 4 İlacınn kullanım periyodunu sıklığını belirtir 4 SKRSS İlaç Kullanım Periyodu Birimi kodları kullanılacak 18,2 İlacınn kullanım adedini belirtir 4 Kutuu adedini belirtir 4 Aşağıda tanımlanan İlaç Rapor Durumu Kodları değerleri kullanılmalıdır. 500 Reçete czane satış otomasyonu sisteme dahil edilirse kullanılacak bir alandır. Şu an için bu alan kullanılmamaktadır. 8 Reçete czane satış otomasyonu sisteme dahil edilirse kullanılacak bir alandır. czanenin bir ilacın yerine başka bir ilaç vermesi durumunda kullanılacaktır.şu an için bu alan kullanılmamaktadır. 12
ReceteIlacDurumKodu ZamanDamgasi ReceteId Reçete İlaç Durum Kodu Zaman Damgası Reçete Idd G G G binary İnt 4 Bu alan sistemin iç kullanımı amaçlıdır. Reçete verisinin veri bütünlüğünü korumak amaçlı olarak sistem içinde kullanılır. 8 İlacınn ilişkili olduğu Reçete verisinin Id bilgisidir. Güncelleme işleminde reçete ilaç veri setinde gönderilmesi zorunludur. 7.3.. Reçete Tanı Veri Seti ekimin muayene sonucunda belirlemiş olduğu tanılar için kullanılacakk olan veri setidir. s Belirtilen tanılar içerisindee en fazla bir tane ana tanı olaiblir,, tanılardann bir tanesi mutlaka ana tanı olara belirtilmek zorunda z değildir. Ana Tani olarak belirtilmek istenmeyen tanılark için AnaTaniMi değeri false değeri almalıdır. Alan Adıı Id ICD_KODU kbilgi AnaTaniMi ZamanDamgasi ReceteId Açık Adıı Id ICD Kodu k Bilgi Ana Tani Mi? Zaman Damgası Reçete Id Zorunlu G G G i Uz. 8 Açıklama A Bu B alan sistemin iç kullanımı amaçlıdır. Güncelleme işleminde reçete tanı veri setinde gönderilmesi zorunludur 10 150 SKRS ICD10 kodları kullanılacak ekimin tanıya ilişkin ek bilgi girmek istemesi durumunda kullanılabilir. Bool Belirtilen B tanıı eğer ana tanı ise bu alan true değeri almalıdır. Akdi takdirde falsee olarak belirtilmelidir. Belirtilen B tanılar içerisinde en fazla bir b tane ana tanı olaiblir, tanılardan bir b tanesi mutlaka ana tanı olara belirtilmek b zorunda değildir. Binary Reçete verisinin veri bütünlüğünü korumak amaçlı olarak sistem içinde kullanılır. 8 Tanının T ilişkilii olduğu Reçete verisinin Id bilgisidir. Güncelleme işleminde reçete tanı verii setinde gönderilmesi zorunludur. 13
7.4.. ServiceResult Veri Seti Servis metod çağrıları sonucunda herr geri dönüşş değeri bu veri v seti içerisinde kullanıcılara gönderilir. Alan Adıı ReturnValue IsValid rrorcode rrorlist xception Açık Adı Return Value Is Valid? rror Code rror List xception Zorunlu i generic bool List< < Açıklama Servis metod çağrısının asıll geri dönüş değeri bu alan içerisinde gönderilir. i servis metod çağrısına göre değişmektedir. Servis metdo çağrısında herhangi birr uygulama hatası oluşmamış ise bu alan True, aksi halde False değerini alır. Servis metod çağrısında, bir hata oluşmuş ve bu hataya ilişkin özel birr rrorcode tanımlanmış ise bu alanda belirtilir. Servis metod çağrısında iş kuralına ilişkin hatalar mevcut ise bu alanda belirtilir. Servis metod çağrısında herhangi sistemsel bir hata oluşmuş ise bu alanda belirtilir. 7.5.. SaglikNetxception Veri Seti Servis metod çağrısı sırasında herhangi bir hata oluşması durumunda bu hata kullanıcı tarafına SaglikNetxception veri seti içerisinde gönderilir. Alan Adıı xceptiontypeproperty rrormessage rrorcode InnerxceptionString Açık Adı xception Type rror Message rror Code Inner xception String Zorunlu i numxceptiontype List< Açıklama atanın tipi numxceptiontype enumundaki tiplerden biri olabilir. ataa bilgisine ilişkin mesaj ataya verilmiş olan kod bilgisi ataa bilgisine ilişkin detay numxceptiontype Değerleri Değer Açıklama 14
0 1 2 Systemxception Applicationxception Securityxception 8. Sözlük ve lar Sağlık Bakanlığı ülkemizde sağlık sektöründe ve kamu alanında üretilen ve sağlık bilgilerinin toplandığı tüm yazılımların ortak bir sözlük kullanması için SKRSS sistemini geliştirmiştir. SGK ile yapılan görüşmeler sonucunda ilk önce e reçete ardından diğer projelerde kullanılan kodlarında SKRS de bulunması yönünde karar alınmıştır. Bu kapsamda SGK nın e reçete kılavuzunda yer alan kodlar mevcut SKRS sistemine eklenmiş diğerlerinin eklenmesi çalışmaları devam etmektedir. 8.1.. ReceteTuru SKRSS 2 kod sisteminde tanımlı Reçetee türü alanıdır. Değerler Kodu 1 2 3 4 5 Recetee Türü Anlamı Normal Kırmızı Yeşil Turuncu Mor 8.2.. İlaç Rapor Durumuu Değerler Kodu 1 2 Rapor Durumu Anlamı Raporlu Raporsuz 8.3.. Rapor Formatları Değerler Format İsimleri PDF XCL IMAG XML 15
WORD MTML 8.4.. Reçete Durumu Kodu 1 2 3 4 5 Recete Durumu Anlamı Yeni Düzenlendi Satış İptal atalı 8.5.. numxceptiontype Değerler Kodu 0 1 2 Değerler Systemxception Applicationxception Securityxception 9. İş Süreçleri 1 ) Gönderme işlemii için tek bir düğme tasarlanmalı ve adı Reçetee Gönder gönder olmalıdır. 2 ) Güncelleme işlemi için tek birr düğme tasarlanmalı ve adı Reçete Güncelle olmalıdır. 3 ) Silme işlemi için tek bir düğme tasarlanmalı ve adı Reçete Sil olmalıdır. o 1 ) Yazılımların ara yüzleri kullanılarak reçetee bilgileri oluşturulur. 2 ) Oluşturulan bilgiler tek bir gönder düğmesi kullanılarak SGK servislerine ardından SGK dan gelen cevap olumsuz, olumlu veya hatalı olsa bilee Sağlık Bakanlığı reçete servislerine gönderilir. Bu iki işlem aynı süreç içinde yönetilmelidir. 3 ) Yapılacak değişiklik ve silme işlemleri dee yine aynı şekilde iki servise bilgileri gönderecek şekilde tasarlanmalıdır. 10. Kullanıcı Ara yüzü 16
11. Standartlar Sağlık Bakanlığı Reçete servisleri USVS ( Ulusal Sağlık Veri Standartları) 2.0 kullanır. Mevcut sürümde SKRS 2 ( Sağlık Kodlama Referans Sözlüğü ) sözlüğünü kullanır. Yeni yayınlanacak SKRS 3 ile tüm sağlık kurum kuruluşlarında aynı kodların kullanılması planlanmaktadır. 12. Sık Sorulan Sorular 1. Soru: Aşağıdaki alanların anlamları nedir?? Recete:Id : Reçeteler sisteme eklendikten sonra otomatik olarak birr ID değeri alır, bu değer otomatik olarak üretilir, reçete ekleme işleminde kullanıcı tarafından verilmemelidir. Recete:Aktifmi : Reçete sistemde aktif olduğunu belirtir, reçete silme işleminden sonra reçete pasife çekilir. Reçete sisteme eklenirkenn bu alana değer verilmesi gerekmez, varsayılan değeri True, değer verilmiş ise de True değeri almalıdır, aksi halde sisteme pasif olarak eklenir e Recete:ReceteKodu : Sağlık Bakanlığının belirlediği formatta, reçeteyi tekil olarak ifade edebilecek ve reçetee çıktılarına konulması düşünülen birr alandır. Bu alanda otomatik olarak üretildiğin, kullanıcı tarafından verilmemelidir. Recete:ReceteDurumu : Reçetelerin sistem içerisindeki durumunu takip t etme amaçlı olarak kullanılır ve sistemin iç kullanımı amaçlı bir alandır. Kullanıcı tarafından verilmemelidir. Recete:ZamanDamgasi : Recete sistemindeki veri bütünlüğünü korumak için sistemin iç kullanımı amaçlı bir alandır. Reçete güncellemelerindee bu alan kullanıcı tarafından verilmelidir, diğer metotlar için verilmemelidir. Reçete güncellemelerinde, reçete önce sorgulanmalı ve reçetenin o andaki sürümü üzerinde (Bu durumda ZamanDamgası alanı dolu gelecektir) değişiklik yapılmalıdır. Recete:SGKReceteKayitSonucu : SGK Recete kayıt servisinden hata alınması durumunda, Sağlık Bakanlığı sistemine kayıt yapılacak fakat SGK dan hata alınmışsa bu alana alınan hata bilgisi girilecek. ReceteIlac:IlacKareKod : czane satışı yapıldığı zaman reçete üzerindeki karekodd belirlenecek. Yani bu alan eczane entegrasyonu kapsamında elee alınması gereken, doktorlar için boş bırakılması gereken bir alandır. Şu anda eczane entegrasyonununn açılması planlanmamaktadır. ReceteIlac: MuadiliOlduguReceteIlacId : czane satışlarının da sisteme dahil olduğu durumda, eğer eczane bir ilaç yerinee farklı bir ilacın satışını yapıyor ise, farklı ilaç bilgilerini buradan girecektir. Reçete Satış işlemleri şu an düşünülmediğinden, bu alanın boş bırakılması gerekmektedir. ReceteIlac:SerbestIlacAdi : ğerr doktorun yazdığı ilaç SKRS ilaç listesinde yok isee bu alan girilmelidir, eğer var ise IlacBarkod bilgisi girilmelidir, bu alanlardan yalnızca biri dolu d olabilir. 17
ReceteTani:kBilgi alanı açıklama alanı olarak kullanılıyor, doktorun tanıya ek olarak açıklama girmek istediği zaman kullanabileceği bir alann ReceteTani:AnaTaniMi : Tanılarr arasında enn fazla bir tanı ana tanı olabilir, en az bir tane değil. 2. Soru: miyiz? Bildirimlerin gönderimi tamamen sağlıknet ile aynı mıdır? Farklı F olan noktaları öğrenebilir Bildirimlerin gönderimine ilişkin güvenlik içinn kullanılan format şu şekilde olmalıdır. Kullanıcılar için Kullanıcı eğer ABS kullanıcısı ise KullanıcıAdı Formatı: Recete:ABSKullaniciAdi Şifre: SA1 li şifre Kullanıcı SağlıkNet kullanıcısı ise KullanıcıAdı Formatı: LDAP\Recete:KullaniciAdi Şifre: ashlenmemişş cleartext şifre 3. Soru: ntegrasyon sırasında hatası alıyoruz, sebebi nedir? An error occurred when verifying security for the message. Web Servisi çağrılarında kullanıcı adı ve şifre bilgisi ile kullanıcı doğrulama işlemi yapılmaktadır. Kullanıcı adı ve şifre bilgileri bir önceki soruda anlatıldığı formatta doğru bir şekilde gönderilmezse yukarıdaa belirtilen hata alınır. Şu anda sistem altypası üzerinde bir çalışma yapıldığından aşağıdaki örnek kullanıcı ile denemelerinizi yapabilirsiniz. Örnek KullanıcıAdı: Recete:\12345678902 Örnek Kullanıcı Şiifree SA1 hashlenmiş: 7110eda4d09e062aa5e4a390b0a572ac0d2c02203 4. Soru: Web Servisii için örnek bir SOAP paketi nasıl olmalıdır? ReceteGetir servis metoduna yönelik örnek SOAP paketi aşağıdaki gibidir. <soapenv:nvelope xmlns:erec= "http://schemas.saglik.gov.tr/recete" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" <soapenv:eader <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" http://docs. oasis open.org/wss/2004/ /01/oasis 200401 wss wssecurity secext 1.0.xsd"" xmlns:wsu= ="http://docs.oasis wsu:id=" "UsernameToken 3"<wsse:UsernameRecete:12345678902< </wsse:username<wsse:password Type="http://docs.oasis open.org/wss/2004/01/oasis 200401 wss username token profile 1.0#PasswordText" 7110eda4d09e062aa5e4a390b0a572ac0d2c0220</wsse:Password<wsse:Nonce ncodingtype="http://docs.oasis open.org/wss/2004/01/oasis 200401 wss soap message security 1.0#Base64Binary" rpwaa81yilpmzenyuctyq==</wsse:nonce<wsu:created 2012 06 open.org/wss/2004/ /01/oasis 200401 wss wssecurity utility 1.0.xsd" <wsse:usernametokenn 19T07:31:44.354Z</ wsu:created</wsse:usernametoken</wsse:security</soapenv:eader 18
<soapenv:body <erec:recetegetir <! Optional: <erec:recetekodufdpas4f8bcfhu</erec:recetekodu </erec:recetegetir </soapenv:body </soapenv:nvelope Recetekle servis metoduna yönelik örnek SOAP paketi aşağıdaki gibidir. <soapenv:nvelope xmlns:erec= "http://schemas.saglik.gov.tr/recete" xmlns:sag="http://schemas.saglik.gov.tr/sagliknettypes" xmlns:ser="http://schemas.microsoft.com/2003/10/serialization/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" <soapenv:eader <wsse:security soapenv:mustunderstand="1" xmlns:wsse="http:/ //docs.oasis open.org/wss/2004/ /01/oasis 200401 wss wssecurity secext 1.0.xsd"" xmlns:wsu= ="http://docs.oasis open.org/wss/2004/ /01/oasis 200401 wss wssecurity utility 1.0.xsd" <wsse:usernametoken wsu:id="usernametoken 3" " <wsse:usernamerecete:12345678902</wsse:username <wsse:password Type="http://docs.oasis open.org/wss/2004/ /01/oasis 200401 wss <wsse:nonce ncodingtype="http://docs.oasis open.org/wss/ /2004/01/oasis 200401 wss soap message security 1.0#Base64Binary"rPWaa81YILpmzenYUcTyQ==</wsse:Nonce <wsu:created2012 06 19T07:31:44.354Z</wsu:Created </wsse:usernametoken </wsse:security </soapenv:eader <soapenv:body <erec:recetekle <erec:eklenecekrecete ser: Id="i1" xmlns:i="http://www.w3.org/2001/xmlschema instance" <sag:aktifmitrue</sag:aktifmi <sag:diplomatescilnumarasi100755< </sag:diplomatescilnumarasi <sag:astakimliknumarasi40858597758</sag:astakimliknumarasi <sag:astatelefonnumarasi7522809</sag:astatelefonnumarasi <sag:ekimkimliknumarasi36829504108</sag:ekimkimliknumarasi <sag:id0</sag:id <sag:kurumkodu 2961</sag:KurumKodu username token profile 1.0#PasswordText" 7110eda4d09e062aa5e4a390b0a572ac0d2c0220</wsse:Password <sag:protokolnumarasi2001033312</sag:protokolnumarasi <sag:recetedurumu i:nil="true"/ <sag:receteilac 19
T.C. Sağlı Sağlık Bilg dubirimi dubirimi </ <s <s </ k Bakanlığı gi Sistemleri G <sag:recete ikodu <sag:zam </sag:recet <sag:recete ikodu <sag:zam </sag:recet /sag:recetei sag:receteko sag:receteta <sag:recete <sag:anat <sag:kbilg <sag:icd_k <sag:id0< <sag:recet <sag:recet <sag:zama </sag:recet /sag:recetet Genel Müdürlü eilac ser:id=" KullanimAde KullanimPer mandamgasi eilac eilac ser:id=" KullanimAde KullanimPer mandamgasi eilac lac odu i:nil="tru ani etani ser:id=" TaniMitrue< gi i:nil="true KODUB37</ </sag:id te i:nil="true eid0</sag:r andamgasi i: etani Tani üğü i2" <sag:id edi1</sag:il iyodu3</sa <sag:mu <sag:rec <sag:rec <sag:rec i:nil="true"/ "i3" <sag:id edi1</sag:il iyodu3</sa <sag:mu <sag:rec <sag:rec <sag:rec i:nil="true"/ ue"/ "i4" </sag:anatan "/ /sag:icd_ko e"/ ReceteId nil="true"/ 0</sag:Id cadedi2</s cbarkod869 ckarekod i:n lackullanima ag:ilackullani ckullanimper ckullanimsek crapordurum uadilioldugu cete i:nil="tr ceteid0</sa ceteilacduru / 0</sag:Id cadedi1</s cbarkod869 ckarekod i:n lackullanima ag:ilackullani ckullanimper ckullanimsek crapordurum uadilioldugu cete i:nil="tr ceteid0</sa ceteilacduru / nimi ODU ag:ilacadedi 99593351075 il="true"/ Adedi imperiyodu riyodubirimi klikodu1</s mukodu1</ ReceteIlacId ue"/ ag:receteid umkodu1</ ag:ilacadedi 99516015343 il="true"/ Adedi imperiyodu riyodubirimi klikodu1</s mukodu1</ ReceteIlacId ue"/ ag:receteid umkodu1</ 5</sag:IlacBa Kodu2</sag sag:ilackullan /sag:ilacrapo i:nil="true"/ sag:receteil 3</sag:IlacBa Kodu2</sag sag:ilackullan /sag:ilacrapo i:nil="true"/ sag:receteil Reçete S arkod g:ilackullanim nimseklikod ordurumuko / acdurumkod arkod g:ilackullanim nimseklikod ordurumuko / acdurumkod Sürüm 1,0 20 mperiyo u odu du mperiyo u odu du
<sag:recetetarihi2012 06 14T00:00: :00.000+03:00</sag:ReceteTarihi <sag:receteturukodu1</ /sag:receteturukodu <sag:sgkrecetekayitsonucu i:nil="true"/ <sag:sgkrecetenumarasi3asl</sag:sgkrecetenumarasi <sag:sgktakipnumarasiyyqvv4</sag:sgktakipnumarasi <sag:sosyalguvencedurumukodu3</sag: SosyalGuvenceDurumuKodu <sag:yabanciastapasaportnumarasi i:nil= ="true"/ <sag:zamandamgasi i:nil="true"/ </erec:eklenecekrecete </erec:recetekle </soapenv:body </soapenv:nvelope ReceteGüncelle servis metoduna yönelik örnek SOAP paketi aşağıdaki gibidir. <soapenv:nvelope xmlns:erec= "http://schemas.saglik.gov.tr/recete" xmlns:sag="http://schemas.saglik.gov.tr/sagliknettypes" xmlns:ser="http://schemas.microsoft.com/2003/10/serialization/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" <soapenv:eader <wsse:security soapenv:mustunderstand="1" xmlns:wsse="http:/ //docs.oasis open.org/wss/2004/ /01/oasis 200401 wss wssecurity secext 1.0.xsd"" xmlns:wsu= ="http://docs.oasis open.org/wss/2004/ /01/oasis 200401 wss wssecurity utility 1.0.xsd" <wsse:usernametoken wsu:id="usernametoken 3" " <wsse:usernamerecete:12345678902</wsse:username <wsse:password Type="http://docs.oasis open.org/wss/2004/ /01/oasis 200401 wss <wsse:nonce ncodingtype="http://docs.oasis open.org/wss/ /2004/01/oasis 200401 wss soap message security 1.0#Base64Binary"rPWaa81YILpmzenYUcTyQ==</wsse:Nonce <wsu:created2012 06 19T07:31:44.354Z</wsu:Created </wsse:usernametoken </wsse:security </soapenv:eader <soapenv:body <erec:receteduzenle <! Optional: <erec:duzenlenecekrecete ser:id="i1" xmlns:i="http://www.w3.org/2001/xmlschema instance" <sag:aktifmitrue< </sag:aktifmi <sag:diplomatescilnumarasi546788</sag:diplomatescilnumarasi <sag:astakimliknumarasi38281134640< </sag:astakimliknumarasi <sag:astatelefonnumarasi5433456576< </sag:astatelefonnumarasi <sag:ekimkimliknumarasi38281134640</sag:ekimkimliknumarasi <sag:id5</sag:id username token profile 1.0#PasswordText" 7110eda4d09e062aa5e4a390b0a572ac0d2c0220</wsse:Password 21
PeriyoduBirimiKodu u asi si <sag:kurumkodu 0</sag:KurumKodu <sag:protokolnumarasi32ssddsdf2</sag:protokolnumarasi <sag:recetedurumudüzenlendi</sag:recetedurumu <sag:receteilac <sag:receteilac ser:id="i2" < <sag:id5</sag:id < Adedi10</sag:IlacAdedi < Barkod8003670072041</sag:IlacBarkod < KareKod i:nil="true"/ < KullanimAdedi2.00</sag:IlacKullanimAdedi < KullanimPeriyodu8</sag:IlacKullanimPeriyodu < KullanimPeriyoduBirimiKodu2</sag:IlacKullanim < KullanimSekliKodu1</sag:IlacKullanimSekliKodu < RaporDurumuKodu1</sag:IlacRaporDurumuKod < <sag:muadilioldugureceteilacid i:nil= ="true"/ < <sag:recete ser:ref="i1"/ / < <sag:receteid5</sag:receteid < <sag:receteilacdurumkodu i:nil="true"/ < <sag:serbestilacadi i:nil= "true"/ < <sag:zamandamgasiaaaaaaagbu8=</sag:zamandamg </sag:receteilac </sag: ReceteIlac <sag:recetekodu 50p1UtwFG0ri</sag:ReceteKodu <sag:recetetani <sag:recetetani ser:id="i3" < <sag:anatanimitrue</sag:anatanimi < <sag:kbilgi i:nil="true"/ < <sag:icd_koduy90.1</ sag:icd_kodu < <sag:id5</sag:id < <sag:recete ser:ref="i1"/ / < <sag:receteid5</sag:receteid < <sag:zamandamgasiaaaaaaaab+s= =</sag:zamandamga </sag:recetetani </sag: ReceteTani <sag:recetetarihce i:nil="true"/ <sag:recetetarihi 2012 04 04T00:00:00</ /sag:recetetarihi <sag:receteturukodu2</sag: :ReceteTuruKodu <sag:sgkrecetekayitsonucu i:nil="true"/ <sag:sgkrecetenumarasi i:nil="true"/ <sag:sgktakipnumarasi23443</sag:sgktakipnumarasi <sag:sosyalguvencedurumukodu2</sag: SosyalGuvenceDurumuKodu <sag:yabanciastapasaportnumarasi i:nil= ="true"/ 22
<sag:zamandamgasiaaaaaaagbu4=</sag:zamandamgasi </erec:duzenlenecekrecete </erec:receteduzenle </soapenv:body </soapenv:nvelope 5. Soru: Servisleri denemek için örnek uygulama varmıdır? http://www.e saglik.gov.tr adresinden örnek. NT ve SOAPUI(ReceteGetir örneklemesi yapılmıştır) projelerini indirebilirsiniz. 6. Soru: nd Po atası ne demektir? Nasıl düzeltebiliriz? npo hatası eğer kullanıcılar, klavuzda belirtilen serviss adresi dışındaki bir adrese isteklerini gönderirlerse oluşur. Bu nedenlee istek gönderdikleri adresi klavuzdaki ile kontrol edilmelidir. 7. Soru: Yazılan reçeteyi iki web servise (SGK, Sağlık Bakanlığı) ayrı ayrı a gönderecek miyiz? Sağlık Sağlık Bakanlığının web servisi eş zamanlı olarak SGK ya kendisi bildirecek midir? Yoksa Yazılan reçeteyi her iki web servise de ayrı ayrı göndermeniz gerekmektedir. 8. Soru: Diploma Tescil Numarası alanı değerini yanlış girdiğimizde sistem hata mesajı iletmeden kabul edecek mi? vet bu alan MSVS de olduğu için konuşmuştur. 9. Soru: Reçete Turu Kodu alanına reçete içeriğinde renkli reçete ilacı bulunmadığı halde Kırmızı Reçete kodu olan 2 değerini atadık, sistem hata mesajı iletmedenn kabul edecek mi? Türkiye İlaç ve Tıbbi Cihaz Kurumunun yayınladığı ilaç listelerine alanların eklenmesi ile SKRS güncellenecektir. Bu işlemin ardından iş kuralları devreyee alınacaktır, varsa yazılımm bu kuralı kendisi uygulayabilir. 10. Soru: Reçete Turu Kodu alanı enumerasyonunda SGK dokumanı ile sizin dokumanınız arasındaa farklılıklar var, hangisi baz alınacaktır? Kodlar SKRS tablosundan gelmektedir. Çevrim tablosu kullanılmalıdır, standardı değiştiremiyoruz. Fakat SKRS 3 ile bu fark ortadan kaldırılacaktır. 11. Soru: Kullanıcı Şifresi verisi formatı sadece hekimin KDS şifresini içeriyor, ancak biz diğer MSVS servisleri için Password: Firma Kodu formatı ile firmalara verilmiş olan kodları da gönderiyorduk. Firma Kodu nu gönderecek miyiz? Sonraki sürümde firma kodunu ayrı bir alan olarak alınacaktır. ntegrasyon ve uyumluluk açısından şimdilik yalnızca şifree olarak göndermeye devam edilmelidir. 14: Soru: Receteklee metoduna The value '' cannot be parsed as thee type 'Boolean' şeklindee bir hata alıyorum. 23
AnaTaniMi alanı boolean bir alan olduğundann bu alana gönderilecek değerin true, false gibi bir değer olması gerekiyor. XML verisinde bu değer şu şekilde verilmiş olduğundan hata alınmaktadır. <sag:anatanimi< </sag:anatanimi. 15. Soru: Delphi kullanıcısıyım, e Recete sistemini nasıl entegre olabilirim. Örnek olarak bir Delphi forumunda http://delphiforumu.com/questions/14/delphi ile ws yönelik birr bilgi standartlarini kullanan web servislerine erismek web servis bağlantısı yapmayaa verilmiş. Örnekten farklı olarak bizim yapımızda Transport Security (https) yapısı kullanılıyor. 16. Soru: ReceteCiktisiGetir metodunu kullanabiliyormuyuz? czane ve çıktı web servislerimiz, eczanelerinn ağırlıklı olarak SGK webb sitesini kullanımdan dolayı şimdilik kapalıdır. 13. İletişim Adres : T.C. Sağlık Bakanlığı Mithatpaşa Cad. No: 3 06434 Sıhhiye S / ANKARA Telefon : 0 312 585 24 43 e posta : erecete@saglik.gov.tr 24