Versiyon 1.5
02.02.2022
Doküman Onay Sayfası
AD-SOYAD UNVAN TARİH İMZA
HAZIRLAYAN Nedime Başak
Kırçıl Test Uzmanı 23.09.2020
GÖZDEN
GEÇİREN Oğuz DEMİR Analist 23.09.2020
ONAYLAYAN Hatice ÖZTÜRK ERDOĞAN
Birim Sorumlusu
/ Proje Yöneticisi 23.09.2020
Değişiklik Tarihçesi
Sürüm
No Tarih
Değişen Sayfa/
Tablo/
Şekil
*E
*S
*D
Değişiklik Açıklaması Değişikliği Yapan
1.0 04.01.2019 E İlk Yayın Gizem AKSÖYEK
1.1 28.02.2019 D
Değiştirme, metotların ekran görüntüsü ve
açıklamaları detaylandırıldı
Ferah DEMİRKAYA, Deniz BALAHAN
1.2 07.03.2019 E
Erişkinler İçin Islak İmzalı Engellilik Sağlık Kurulu Raporu ekran bilgileri eklendi.
Ferah DEMİRKAYA, Deniz BALAHAN
1.3 11.03.2019 E
Webservis ile Hbysler tarafından yapılabilecek işlemler
Deniz BALAHAN
1.4 21.09.2020 E,
D
Başhekim rapor sorgulama ekranı eklendi,
güncellemeler yapıldı.
Nedime Başak Kırçıl
1.5 16.01.2022 E Başhekim Rapor
Sorgulama ekranına erişim adresi ve Token bilgileri eklendi.
Elif UÇHAN
*E: Ekleme S: Silme D: Değiştirme
İÇİNDEKİLER
1. Amaç ... 6
2. Kapsam ... 6
3. Süreç İşleyişi ... 7
4. Tanımlar ve Kısaltmalar ... 8
5. Erişim Bilgileri ve Profil Düzenleme İşlemleri ... 8
5.1. Erişim Adresleri ... 8
5.2. Başhekim Engelli Raporu Sorgulama Ekranı ... 9
5.3. Token Bilgileri ... 10
6. Metotlar ... 10
6.1. Servis metotları ... 12
6.1.1. Başvuru Api’leri ... 12
6.1.2. Yeni Başvuru ... 12
6.1.3. Başvuru Güncelleme... 13
6.1.4. Başvuru Getir ... 16
6.1.5. Başvuru Sil ... 18
6.1.6. Başvuru Kontrol Edilmesi ... 20
6.1.7. Tüm Başvuruların Listelenmesi ... 22
6.1.8. Kurula Gönderilmesi ... 24
6.2. Engelli Api’leri ... 26
6.2.1. Şerhli ve Şerhsiz Raporlar ... 26
6.2.2. Şerhli Rapor ... 28
6.2.3. Şerhsiz Rapor ... 29
6.2.4. PDF_id ile Rapor ... 29
6.2.5. Rapor Referans Numarası ile Şerhli ve Şerhsiz Raporlar ... 30
6.2.6. Rapor Referans Numarası ile Şerhli Rapor ... 32
6.2.7. Rapor Referans Numarası ile Şerhsiz Rapor ... 32
6.2.8. Toplam Rapor Sayısı ... 33
6.2.9. Kurul Detayları ... 34
1. Amaç
Bakanlığımıza bağlı sağlık kuruluşlarınca verilen tüm raporların (sürücü, doğum, engelli, istirahat, durum bildirir raporu vb.) elektronik ortamda, e-imzalı olarak verilmesini sağlamak amacıyla, Sağlık Bilgi Sistemleri Genel Müdürlüğünce “e-Rapor Sistemi” geliştirilmektedir.
Bahsi geçen sistemin hizmete girmesi ile vatandaş memnuniyetinin ve hizmet kalitesinin artırılması, bürokratik işlemlerin azaltılması, mükerrer rapor yazımlarının ortadan kaldırılması, usulsüz raporların önüne geçilmesi ve ilgili kurumlarla elektronik ortamda e-imzalı olarak paylaşım imkânı sağlanması hedeflenmektedir.
e-Rapor bünyesinde geliştirilen bileşenler 3359 sayılı “Sağlık Hizmetleri Temel Kanunu”, 663 sayılı “Sağlık Bakanlığı ve Bağlı Kuruluşların Teşkilat ve Görevleri Hakkında Kanun Hükmünde Kararname” ve “Yataklı Tedavi Kurumları İşletme Yönetmeliği” hükümleri çerçevesinde düzenlenmiştir. Resmi Gazetede yayımlanan 3069230692 sayılı Erişkinler İçin Engellilik Değerlendirmesi Hakkında Yönetmelik doğrultusunda geliştirilmiştir.
Erişkinler İçin Engellilik Sağlık Kurulu Engelli Raporunun alınışı, geçerliliği, değerlendirilmesi ve sağlık kurulu raporu verebilecek yetkili sağlık kurumlarının tespiti ile ilgili usul ve esasları belirlemek; engelle ilgili derecelendirmelere, sınıflandırmalara ve tanımlamalara gereksinim duyulan alanlarda ortak bir uygulama geliştirmek ve uluslararası sınıflandırma ve ölçütlerin kullanımının yaygınlaştırılmasını sağlamak amacıyla hazırlanmıştır.
e-Rapor/e-Erişkinler İçin Engellilik Sağlık Kurulu Raporunun oluşturulması için hastane bilgi yönetim sistemleri (HBYS) ile gerekli olan entegrasyonun hızlı ve doğru yapılabilmesi planlanmaktadır.
2. Kapsam
Ülke genelinde Erişkinler İçin Engellilik Sağlık Kurulu Raporu vermeye yetkili tüm sağlık kurum ve kuruluşları ile HBYS yazılım üreticilerinin entegrasyon süreçlerini kapsar.
Ulusal engelli veri bankasına kayıtlı ıslak imzalı raporların ve e-Rapor sistemi üzerinden alınmış elektronik imzalı engelli raporlarının başhekim ve başhekim yardımcıları tarafından sorgulanabileceği ekranlar yapılmış olup entegrasyon ve kullanıcı kılavuzları güncellenmiştir.
3. Süreç İşleyişi
Kullanıcı girişleri ve kullanıcı yetki kontrolü HBYS vasıtasıyla alınan “Token” ile sisteme giriş yapılır. Test ortam girişleri https://eraportest.saglik.gov.tr/ linkinden sağlanır.
e-Rapor Sisteminde, alınan token rol bazlı olup sekretarya, hekim ve kurul başkanı ekranlarına erişilmesini sağlar. (Daha detaylı süreç işleyişi için bkz. e-Erişkinler İçin Engellilik Sağlık Kurulu Raporu Kullanıcı Kılavuzu)
Bu doküman, e-Rapor/ e-Erişkinler İçin Engellilik Sağlık Kurulu Raporu Bileşenine hastane bilgi yönetim sistemlerinin entegrasyonun doğru ve hızlı yapılmasını sağlamak amacıyla hazırlanmıştır. Sekreter ekranları kapsamında HBYS firması tarafından web servis metodu ile yeni kayıt oluşturma veya güncelleme işlemleri yapıldıysa kurula atama gibi işlemler de web servis ile yapılabilir, eğer işlemler ekran üzerinden yapıldıysa diğer işlemlere de ekran üzerinden devam edilebilir.
Devam eden bölümlerde bu bileşene ait özel tanımlamalar ve açıklamalar yer almaktadır.
4. Tanımlar ve Kısaltmalar Kısaltmalar Açıklaması
TCKN T.C. kimlik numarası
HBYS Hasta Bilgi Yönetim Sistemi KPS Kimlik Paylaşım Sistemi
Tablo 1 Tanımlar ve Kısaltmalar
5. Erişim Bilgileri ve Profil Düzenleme İşlemleri 5.1. Erişim Adresleri
Ekran Bilgileri Erişim Adresleri
Sekreter İndex Test Ortamı:
https://eraportest.saglik.gov.tr/DisabledWeb/Dis/SecInd ex?Authorization=token
Sekreter hasta kayıt ekranı Test Ortamı:
https://eraportest.saglik.gov.tr/DisabledWeb/Dis/Patien tApplication?Authorization=token
Sekreter kurul tanımlama ekranı Test Ortamı:
https://eraportest.saglik.gov.tr/CouncilWeb/Council/Co uncilDescription?Authorization=token
Sekreter kurula hekim atama ekranı
Test Ortamı:
http://eraportest.saglik.gov.tr/CouncilWeb/Council/Doc torAssignment?Authorization=token
Sekreter kurula hasta atama ekranı
Test Ortamı:
http://eraportest.saglik.gov.tr/CouncilWeb/Council/Pati entAssignment?Authorization=token
Kurul Hekimi işlemleri ekranı (Hekimin kurula atanmış olması gerekmekte)
Test Ortamı:
http://eraportest.saglik.gov.tr/CouncilWeb/Council/Cou ncilPatientSelect?Authorization=token
Erişkinler için Engellilik Sağlık Kurulu Raporu Index ekranı
https://eraportest.saglik.gov.tr/disabledweb/ManualDis abledReport/Index?Authorization= token
Erişkinler için Sağlık Kurulu Raporu Hasta Kayıt ekranı
https://eraportest.saglik.gov.tr/disabledweb/ManualDis abledReport/Create?Authorization= token
Başhekim Sürücü Sağlık Kurulu Rapor Süreci Sorgulama Ekranı Test
Test Ortamı:
https://eraportest.saglik.gov.tr/councilweb/Council/Counci lHeadDoctor?Authorization={TOKEN}
Başhekim Sürücü Sağlık Kurulu Rapor Süreci Sorgulama Ekranı CANLI
https://erapor.saglik.gov.tr/councilweb/Council/CouncilHe adDoctor?Authorization={TOKEN}
Tablo 2 Erişim Adresleri
5.2. Başhekim Engelli Raporu Sorgulama Ekranı
Erişkinler için Ulusal Engelli Veri Bankası ve Elektronik İmzalı Engellilik Sağlık Kurulu Raporları https://eraportest.saglik.gov.tr/disabledweb/headdoc/observe?authorization=token
adresinden sorgulanabilmektedir. Ekrana yalnızca başhekim ve başhekim yardımcıları tarafından erişilebilmektedir. Başhekim rolü ile token alınması gerekmektedir.
5.3. Token Bilgileri
Token Alma Parametre Bilgileri Token
almak için erişim adresi
https://eraportest.saglik.gov.tr/AuthApi/connect/token?username=x&passwo rd=x&applicationCode=x&identityNumber=x&role=x
Bu bir POST işlemidir, GET metodu değildir.
Usernam e
Uss kullanıcı adınız (Çkys kurum kodu)
password Hastanenin Uss şifresi applicati
onCode
Uss deki uygulama kodunuz
Role* Sekreterya 5DDEB487-A0C2-47D6
Hekim ve Kurul Başkanı 6AAB18C7-B16B-4A04
Başhekim 417A9319-6430-490C
identityN umber
Doktor veya sekretere ait T.C. Kimlik Numarası
Tablo 3 Token Alma Parametre Bilgileri
6. Metotlar
Engelli entegrasyon metod detaylarını https://eraportest.saglik.gov.tr/ExternalApi/swagger/
index.html adresindeki DisExamination(Başvuru api’si) ve Dis (Engelli api’si) üzerinden ulaşabilirsiniz.
Swagger Authorize Ekranı
Metotların tamamı için ön kullanım şartı “Authorize” butonuna tıklayarak açılan alanda Value kısmına “Bearer {token}” girilerek devam edilmeli.
Swagger Authorize Ekranı Value Girişi
6.1. Servis metotları 6.1.1. Başvuru Api’leri
Uygulama metotlarının birçoğu parametre olarak patientAppId kullanılması gerekmektedir.
Aslında bu bir başvuru numarasıdır. Bu başvuru numarası 6.1.2. de bulunan metod ile size dönen cevabın içerisinde bulunmaktadır.
6.1.2. Yeni Başvuru
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/CreateApplication Post Metodu kullanılmalıdır.
“Try it out” butonu tıklanır.
Açılan Description ve Edit Value alanlarında body’de DisabledPatientApplicationDto nesnesi gerekmektedir. “Execute” butonu tıklanır.
Response nesnesinin data’sı patientAppId’dir .
6.1.3. Başvuru Güncelleme
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/UpdateApplication Post Metodu kullanılır.
“Try it out” butonu tıklanır.
Açılan Description ve Edit Value alanlarında body’de DisabledPatientApplicationDto nesnesi gerekmektedir.
Response alanında bulunan patientAppId alanı yeni başvuruda dönülen patientAppId’dir.
6.1.4. Başvuru Getir
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/GetApplicationWithPatient AppId/{patientAppId} url’in sonunda bulunan patientappId’dir bu metod size DisabledPatientApplicationDto nesnesi dönmektedir.
“Try it out” butonu tıklanır.
Açılan Description alanında bulunan patientappId’dir bu metod size DisabledPatientApplicationDto nesnesi dönmektedir.
6.1.5. Başvuru Sil
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/DeleteApplication/{patient AppId} url’in sonunda bulunan patientappId’dir.
“Try it out” butonu tıklanır.
Açılan Description alanında bulunan patientappId’dir execute edildiğinde başvuru silinmektedir.
6.1.6. Başvuru Kontrol Edilmesi
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/ApplicationIsExist/{patientA ppId} url’in sonunda bulunan patientappId’dir.
“Try it out” butonu tıklanır.
Son 30 (otuz) gün içinde hastaya ait herhangi bir hastaneden başvuru bilgisnin kontrolü yapılır.
Response’un data kısmı true ise başvuru var, false ise başvuru yoktur.
6.1.7. Tüm Başvuruların Listelenmesi
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/GetAllApplication/{patientA ppCouncilSituation} url’in sonunda bulunan kurul durumudur enum şeklinde ve üç tipi vardır.
“Try it out” butonu tıklanır.
PatientAppCreated(Başvuru oluşturuldu), SendCouncil( Kurula gönderildi) , CouncilComplete(
Kurul tamamlandı) şeklinde başvurularınızı çekebilirsiniz.
Bu metod size PatientApplicationCompositeDto nesnesi dönmektedir. İçersinde ReportPdfIdSerhli ve ReportPdfIdSerhSiz alanları mevcuttur, bu alanlarla şerhli ve şerhsiz pdf’ler alınabilir.
6.1.8. Kurula Gönderilmesi
https://eraportest.saglik.gov.tr/ExternalApi/api/DisExamination/SendToCouncil/{patientApp Id} eğer başvuru oluşturma veya güncelleme sırasında kurula gönderilmemişse bu metod ile kurul ekranında görünümünü sağlayabilirsiniz.
“Try it out” butonu tıklanır.
Başvuru sırasında 6.1.2.de veya 6.1.3.de (Yeni Başvuru veya Güncelleme İşleminde) gönderilen
“DisabledPatientApplicationDto“ nesnesinde bulunan “patientAppCouncilSituation” nı
“SendCouncil” olarak gönderirseniz, hasta kurula atanmış olur, 6.1.8. maddesini kullanmanıza gerek kalmaz.
6.2. Engelli Api’leri
6.2.1. Şerhli ve Şerhsiz Raporlar
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportAllPdfWithPatientAp pId/{patientAppId} Kurul tarafından imzalanmış şerhsiz ve varsa şerhli raporu size
dönmektedir.
“Try it out” butonu tıklanır.
PatientAppId girilip execute edildiğinde kurul tarafından imzalanmış şerhsiz ve varsa şerhli raporu dönmektedir.
6.2.2. Şerhli Rapor
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportSerhliPdfWithPatient AppId/{patientAppId}
“Try it out” butonu tıklanır.
PatientAppId girilip execute edildiğinde kurul tarafından imzalanmış şerhli raporları dönmektedir.
6.2.3. Şerhsiz Rapor
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportSerhsizPdfWithPatien tAppId/{patientAppId}
“Try it out” butonu tıklanır.
PatientAppId girilip execute edildiğinde kurul tarafından imzalanmış şerhsiz raporları dönmektedir.
6.2.4. PDF_id ile Rapor
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReporWithPdfId/{pdfId}
6.2.1. veya 6.2.2. veya 6.2.3. de dönen cevabın içerisinde bulunan data nesnesindeki “Id” alanı
“pdfId” yi vermektedir.
“Try it out” butonu tıklanır.
pdfId alanı girilip execute edildiğinde istenilen raporu getirmektedir.
6.2.5. Rapor Referans Numarası ile Şerhli ve Şerhsiz Raporlar
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportAllPdfWithRefNumbe r/{refNumber} 6.2.1. veya 6.2.2. veya 6.2.3. de dönen cevabın içerisinde bulunan data nesnesindeki “reportReferenceNumber“ alanı “refNumber” yi vermektedir.
“Try it out” butonu tıklanır.
refNumber alanı girilip execute edildiğinde ilgili rapor dönülmektedir.
6.2.6. Rapor Referans Numarası ile Şerhli Rapor
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportSerhliWithRefNumbe r/{refNumber} 6.2.1. veya 6.2.2. de dönen cevabın içerisinde bulunan data nesnesindeki
“reportReferenceNumber” alanı “refNumber” ı vermektedir.
“Try it out” butonu tıklanır.
refNumber alanı girilip execute edildiğinde ilgili rapor dönülmektedir.
6.2.7. Rapor Referans Numarası ile Şerhsiz Rapor
https://eraportest.saglik.gov.tr/ExternalApi/api/Dis/GetDisabledReportSerhsizWithRefNumb er/{refNumber} 6.2.1. veya 6.2.3. de dönen cevabın içerisinde bulunan data nesnesindeki
“reportReferenceNumber” alanı “refNumber” ı vermektedir.
“Try it out” butonu tıklanır.
refNumber alanı girilip execute edildiğinde ilgili rapor dönülmektedir.
6.2.8. Toplam Rapor Sayısı
https://eraportest.saglik.gov.tr/ExternalApi/Hbys/GetCountsOfReports?startDate={}&endDa te={} çalıştırılan bu metot e-rapor üzerindeki rapor sayılarını dönmektedir.
“Try it out” butonu tıklanır.
startDate, endDate alanları girilip execute edildiğinde verilen tarih aralığı için rapor sayıları dönülmektedir.
6.2.9. Kurul Detayları
https://eraportest.saglik.gov.tr/ExternalApi/Hbys/CouncilsInformation?startDate={}&endDat e={}&councilType={} Hbys tokenı ile erişilen bu metot kurul bilgilerini dönmektedir.
“Try it out” butonu tıklanır.
startDate, endDate girilir ve councilType seçilir, execute edildiğinde kurul bilgileri dönülmektedir.
7. BAŞHEKİM KURUL SÜRECİNİ SORGULAMA
Hastanede gerçekleştirilen tüm sağlık kurulu rapor süreçleri, Başhekim/Başhekim Yardımcısı tarafından görüntülenebilmektedir.
Başhekim test ekranına
https://eraportest.saglik.gov.tr/councilweb/Council/CouncilHeadDoctor?Authorization=token adresinden ulaşılmaktadır.
Test süreci tamamlandıktan sonra erişilecek adres aşağıdadır:
https://erapor.saglik.gov.tr/councilweb/Council/CouncilHeadDoctor?Authorization=token
