e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU

HBYS ENTEGRASYON KILAVUZU

YZL-SB-TK-04
14.11.2019
Sürüm 1.0
 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 2 / 9

Doküman Onay Sayfası

AD-SOYAD UNVAN TARİH İMZA

Nedime Başak Kırçıl Test Uzmanı

HAZIRLAYAN 14.11.2019
Beyza Can Test Uzmanı

Hatice Öztürk
GÖZDEN GEÇİREN Proje Yöneticisi 14.11.2019
Erdoğan

ONAYLAYAN Sema Bağcı Birim Sorumlusu 14.11.2019

 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 3 / 9

İçindekiler
1. AMAÇ .......................................................................................................................... 4
2. KAPSAM ...................................................................................................................... 4
3. KISALTMALAR ............................................................................................................. 4
4. SÜREÇ İŞLEYİŞİ ............................................................................................................ 5
5. ERİŞİM BİLGİLERİ VE PROFİL DÜZENLEME İŞLEMLERİ ................................................ 8
5.1. ERİŞİM ADRESLERİ ...................................................................................................... 8
5.2. TOKEN BİLGİLERİ......................................................................................................... 8
5.3. WEB SERVİSLERİ ERİŞİM ADRESLERİ ........................................................................... 9
 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 4 / 9

1. Amaç

Bakanlığımıza bağlı sağlık kuruluşlarınca verilen tüm raporların (doğum, engelli, sürücü,
istirahat, durum bildirir, psikoteknik, yatağa bağımlı kişiler için durum bildirir tek hekim raporu
vb.) elektronik ortamda, e-imzalı olarak verilmesini sağlamak amacıyla, Genel
Müdürlüğümüzce “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 kolay paylaşım imkânı sağlanması hedeflenmektedir.

Ülke genelinde verilen tüm ‘Durum Bildirir Tek Hekim’ raporlarını kapsar. eRapor Sistemi,
Bakanlığımız tarafından yayımlanan Sağlık Raporlarına İlişkin Usul ve Esaslarda belirlenen
niteliklere göre geliştirilmektedir.

2. Kapsam

Ülke genelinde verilen tüm ‘Durum Bildirir Tek Hekim’ raporlarını kapsar. e-Rapor Sistemi,
Bakanlığımız tarafından yayımlanan Sağlık Raporlarına İlişkin Usul ve Esaslarda belirlenen
niteliklere göre geliştirilmektedir.

3. Kısaltmalar

Kısaltmalar Açıklaması

TCKN T.C. Kimlik Numarası

KPS Kimlik Paylaşım Sistemi

HBYS Hastane Bilgi Yönetim Sistemi

USS Ulusal Sağlık Sistemi

Tablo 1 Kısaltmalar
 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 5 / 9

4. Süreç İşleyişi

e-Rapor sistemi üzerinden alınacak token bilgisi ile Uzman Hekim rolü kullanılarak sisteme giriş
yapılabilir, gerekli yetki ve sorumluluk alanına göre yazılım üreticilerinin (HBYS) ilgili ekranlara
yönlendirmesi gerekmektedir. Token alınması için erişilecek test servis adresi aşağıda
sunulmuştur.

Gerçek Ortam Alan Adı: erapor.saglik.gov.tr/AuthApi/connect/token?

https://eraportest.saglik.gov.tr/AuthApi/connect/token?username=x&password=x&grant_ty
pe=password&applicationCode=x&identityNumber=x&role=6AAB18C7-B16B-4A04
Yukarıdaki link Post metodu ile çalıştırılmalıdır.
Username: USS Kullanıcı adı (ÇKYS kurum kodu)

Password: Kurum USS şifresi

Application Code: USS uygulama kodu

IdentityNumber: Uzman Hekim T.C. kimlik numarası

Role: Uzman Hekim (6AAB18C7-B16B-4A04)

Hekim HBYS üzerinden Durum Bildirir Tek Hekim Raporları butonuna tıklar, yazılım üreticisi
(HBYS) ilgili geliştirme ile hekim için Durum Bildirir Tek Hekim Raporları Sistemi üzerinden
token alır ve Durum Bildirir Tek Hekim Raporları Kayıt Ekranını açar.

Rapor oluşturma ekranı için aşağıdaki URL’in HBYS üzerine eklenmesi gerekmektedir.
https://eraportest.saglik.gov.tr/healthstatusweb/SingleDoctor/CreateReport? Authorization= aldığınız token
 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 6 / 9

Şekil 1 Kayıt Ekranı

Vatandaşın adı/soyadı, baba adı, doğum tarihi, cinsiyeti ve adresi KPS’den otomatik olarak
çekilmektedir. Telefon, Kurum ve Görevi manuel olarak doldurulur. Vatandaşa ait geçmiş
raporlar var ise Geçmiş Rapor Bilgisi alanında listelenir. Bu bilgiler ise e-Rapor’dan otomatik
olarak alınır.

Kayıt ekranı için hasta TCKN url üzerinden gönderilmek istenirse kullanılacak metot:

https://eraportest.saglik.gov.tr/healthstatusweb/singledoctor/createreport?Authorization=
AldığınızToken&patientId=x

PatientId= Kişi TCKN

Reason= Veriliş Nedeni (int olarak gönderilecek, Tablo 4)

 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 7 / 9

Şekil 2 Tarafımdan Verilmiş Raporlar Ekranı

Tarafımdan Verilmiş Raporlar ekranında uzman hekimin oluşturduğu raporların Rapor No,
Hastanın T.C. Kimlik Numarası, Rapor Referans Numarası, Hasta Adı ve Tarih listelenmektedir.

Görüntüle butonuna tıklandığında hastaya ait raporun ön izlemesi görüntülenir.

İmzala butonuna tıklandığında ilgili raporun hekim tarafından imzalanabilmesi için e-imza
modülü aktif hale gelir.

Sil butonu ile istenilen rapor silinir.

Tarafımdan Verilmiş Raporlar sayfasına ulaşabilmek için;

https://eraportest.saglik.gov.tr/healthstatusweb/singledoctor/doctorindex?authorization=to
ken

url adresinden erişim sağlanmaktadır.

 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 8 / 9

5. Erişim Bilgileri ve Profil Düzenleme İşlemleri

5.1. Erişim Adresleri

Ekran Bilgileri Erişim Adresleri

Durum Bildirir Tek https://eraportest.saglik.gov.tr/healthstatusweb/singledoctor/cre
atereport?
Hekim Raporu
Oluşturma Test Ekranı
Durum Bildirir Tek https://eraportest.saglik.gov.tr/healthstatusweb/singledoctor/d
Hekim Raporu Index octorindex?
Test Ekranı
Durum Bildirir Tek https://erapor.saglik.gov.tr/healthstatusweb/singledoctor/create
Hekim Raporu report?
Oluşturma Ekranı
Durum Bildirir Tek https://erapor.saglik.gov.tr/healthstatusweb/singledoctor/do
Hekim Raporu Index ctorindex?
Ekranı
Tablo 2 Erişim Adresleri

5.2. Token Bilgileri

Token almak https://eraportest.saglik.gov.tr/AuthApi/connect/token?username=x&passw

için erişim ord=x&grant_type=password&applicationCode=x&identityNumber=x&role=6AA

adresi B18C7-B16B-4A04

Username USS Kullanıcı adı (ÇKYS kurum kodu)

Password Kurumun USS şifresi

ApplicationCo USS uygulama kodu

de
 HİZMETE ÖZEL
e-RAPOR / DURUM BİLDİRİR TEK HEKİM RAPORU HBYS
ENTEGRASYON KILAVUZU
Revizyon
Kodu Yayınlama tarihi Revizyon No Sayfa
Tarihi
YZL.SB.TK.04 14.10.2016 14.10.2016 1 Sayfa 9 / 9

IdentityNumbe Hekime ait T.C. Kimlik numarası

r

Role Uzman Hekim 6AAB18C7-B16B-4A04

Tablo 3 Token Alma Parametre Bilgileri

5.3. Web Servisleri Erişim Adresleri

e-Durum Bildirir Tek Hekim Rapor Bileşeni verilerinden ters entegrasyon ile rapor bilgisi
çekebilmek için kullanılacak [HttpGet] metotlar aşağıda belirtilmiştir.

e-Durum Bildirir Tek Hekim Rapor Bileşeni için ilgili metotlar kullanılırken reportType=5 olarak
girilmelidir.

Hasta Bilgisi ile sorgulamak için:

https://erapor.saglik.gov.tr/externalapi/api/Hbys/HastaninDurumBildirirRaporlari?hastaTCK
N={tcno}

Enum Kod Açıklama

Reason 0 Genel Durum Değerlendirmesi Kararı

1 Yivsiz Av Tüfeği Kararı

2 İş Sağlığı Ve Güvenliği Kararı

3 Akli Meleke Kararı

Tablo 4 Enum Tanımları