HBYS Entegrasyonu: Yatış ve Taburcu (ADT) Olayları Nasıl Akar?
Kısaca
SelfAsist, HBYS ile X-Api-Key ile korunan bir REST API üzerinden entegre olur. HBYS yatış (A01) olayını gönderdiğinde hasta adı ve protokol numarası ilgili odaya yazılır; taburcu (A03) olayında oda terminal temizliğe alınır ve temizlik görevi otomatik atanır.
Hemşire çağrı sistemi ile hastane bilgi yönetim sistemi (HBYS) birbirinden habersiz çalıştığında, aynı bilgi iki kez girilir: hasta HBYS'de yatırılır, ardından biri çağrı sisteminde odanın dolu olduğunu işaretler; hasta taburcu olur, ardından biri temizlik ekibini arar. HBYS entegrasyonu, bu çift girişi ortadan kaldırarak HBYS'deki yatış ve taburcu olaylarının çağrı sistemine kendiliğinden akmasını sağlar.
Bu yazı, entegrasyonu planlayan bilgi işlem ekipleri ve HBYS firmalarıyla görüşecek yöneticiler için hazırlandı.
ADT olayı nedir?
ADT, sağlık bilişiminde Admission, Discharge, Transfer (yatış, taburcu, nakil) olaylarının kısaltmasıdır. Kökeni HL7 standardındaki mesaj tiplerine dayanır ve olaylar genellikle kodlarla anılır: A01 yatışı, A03 taburcuyu ifade eder. HL7'de bunların dışında başka olay tipleri de tanımlıdır; ancak bir çağrı sistemi için en çok değer üreten iki olay yatış ve taburcudur.
SelfAsist bu olayları REST API üzerinden JSON biçiminde kabul eder. Yani HBYS'nin klasik HL7 mesaj altyapısı kurmasına gerek yoktur; olay gerçekleştiğinde ilgili uç noktaya basit bir HTTP isteği göndermesi yeterlidir.
SelfAsist HBYS entegrasyonu hangi olayları işler?
| Olay | HBYS'de ne olur? | SelfAsist'te ne olur? |
|---|---|---|
| Oda listesi | - | Kurumun oda listesi API ile alınabilir; eşleme için kullanılır |
| A01 – Yatış | Hasta bir odaya yatırılır | Hasta adı ve protokol numarası ilgili odaya yazılır |
| A03 – Taburcu | Hasta taburcu edilir | Oda terminal (derin) temizliğe alınır, temizlik görevi otomatik atanır |
Yatış olayı, personelin hangi odada hangi hastanın yattığını çağrı ekranında görmesini sağlar. Böylece "312 numaradan çağrı" yerine hastanın adı ve protokol numarasıyla birlikte bir çağrı gelir; aynı odada birden fazla hasta varsa veya vardiya yeni devralındıysa bu bilgi yanlış anlamaları azaltır.
Taburcu olayı ise operasyonel açıdan en hızlı geri dönüşü verir. Oda boşaldığı anda temizlik ekibine görev gider ve odanın yeniden kullanıma hazırlanma süreci kimsenin telefon açmasını beklemeden başlar. Bu sürecin ayrıntıları için terminal temizlik yazımıza bakabilirsiniz.
Entegrasyon teknik olarak nasıl kurulur?
- API anahtarı oluşturun. Kurum yöneticisi SelfAsist panelinden HBYS için bir API anahtarı üretir. HBYS her istekte bu anahtarı X-Api-Key başlığında gönderir.
- Odaları eşleyin. HBYS'deki oda veya yatak kodları ile SelfAsist'teki oda tanımlarının birbirine karşılık gelmesi gerekir. Oda listesi API'si bu eşlemeyi doğrulamak için kullanılabilir.
- Olay gönderimini kurun. HBYS tarafında yatış ve taburcu işlemleri tamamlandığında ilgili uç noktaya istek gönderecek tetikleyici yazılır. Bu adım genellikle HBYS firmasının veya kurumun yazılım ekibinin işidir.
- Test ortamında deneyin. Birkaç test odasıyla yatış ve taburcu senaryolarını uçtan uca çalıştırın; odaya yazılan bilgiyi ve oluşan temizlik görevini kontrol edin.
- Hata senaryolarını planlayın. Eşleşmeyen oda kodu, ağ kesintisi veya tekrar gönderilen olay gibi durumlarda HBYS tarafının nasıl davranacağını belirleyin.
- Canlıya alın ve izleyin. İlk günlerde HBYS kayıtları ile SelfAsist'teki oda durumlarını örneklem olarak karşılaştırın.
En sık karşılaşılan sorun teknik değil, veri eşlemesidir. HBYS'de "3-12A" olarak geçen yatağın SelfAsist'te "312" olarak tanımlanması gibi küçük farklar, olayların yanlış odaya düşmesine veya hiç işlenmemesine neden olabilir. Entegrasyona başlamadan önce ortak bir oda kodlama tablosu üzerinde anlaşmak zaman kazandırır.
Bir başka pratik konu, olayların tekrar gönderilmesidir. Ağ kesintisi sonrası HBYS aynı taburcu olayını ikinci kez gönderebilir. Test sürecinde bu senaryoyu da denemek, canlı kullanımda gereksiz görev oluşup oluşmadığını önceden görmeyi sağlar.
Entegrasyon projesinde kim ne yapar?
HBYS entegrasyonu üç tarafın birlikte çalıştığı bir projedir. Sorumlulukların baştan yazılması, projenin "kimin işi" belirsizliğinde beklemesini önler.
| Taraf | Başlıca sorumluluklar |
|---|---|
| Kurum (bilgi işlem ve hemşirelik hizmetleri) | Entegrasyon kararını vermek, oda kodlama tablosunu onaylamak, test senaryolarını sahada doğrulamak |
| HBYS firması veya kurum yazılım ekibi | Yatış ve taburcu anında API çağrısını tetiklemek, anahtarı güvenli saklamak, hata durumlarını kayıt altına almak |
| SelfAsist | API belgelerini ve test sürecini sağlamak, oda eşleme ve olay işleme konusunda teknik destek vermek |
Projenin süresi teknik zorluktan çok tarafların takvimine bağlıdır. HBYS tarafında olay tetikleyicisi eklemek genellikle küçük bir geliştirmedir; ancak test ortamının hazırlanması, oda kodlarının eşlenmesi ve canlıya geçiş onayı zaman alabilir. Bu nedenle entegrasyonu, çağrı sisteminin pilot kullanımıyla paralel yürütmek iyi bir yaklaşımdır: Ekip sistemi kullanmaya alışırken entegrasyon da arka planda hazırlanır.
Canlıya geçişten sonra sahadaki ilk geri bildirim genellikle hemşirelerden gelir: Odaya yazılan hasta adının doğru olup olmadığı, taburcu sonrası oluşan temizlik görevinin zamanında gelip gelmediği. Bu geri bildirimleri toplamak için ilk haftalarda kısa bir kontrol rutini belirlemek faydalıdır.
Güvenlik ve veri minimizasyonu nasıl sağlanır?
Entegrasyon üzerinden akan veri, çağrı sisteminin işini yapması için gereken en az bilgiyle sınırlıdır: oda, hasta adı ve protokol numarası. Tanı, tedavi veya ilaç bilgisi aktarılmaz; zaten SelfAsist bir klinik kayıt sistemi değildir. API anahtarı kurum bazında üretilir ve gerektiğinde yenilenebilir. Anahtarın yalnızca HBYS sunucusunda saklanmasını ve kişisel bilgisayarlarda, e-postalarda dolaşmamasını öneririz.
Kişisel verilerin işlenmesine dair genel ilkeleri KVKK açısından hasta çağrı verileri yazımızda ele aldık.
HBYS dışında hangi entegrasyonlar mümkün?
HBYS ADT entegrasyonu SelfAsist'te çalışır durumdaki entegrasyondur. Bunun yanında platform, kuruma özel projelerle devreye alınabilecek bağlantılara hazır olarak tasarlanmıştır:
- Webhook: Çağrı olaylarının kurumun başka bir sistemine bildirilmesi. Yapılandırılabilir; kurulum projesiyle canlıya alınır.
- Santral / SIP-DECT: Çağrıların kurum içi telsiz telefonlara yönlendirilmesi. Mevcut santral altyapısına göre proje bazlı planlanır.
- Kapı üstü lamba (MQTT): Fiziksel koridor lambalarının bir IoT ağ geçidi üzerinden sürülmesi. Donanım ve kablolama projesine bağlıdır.
Bu bağlantıların her biri kurumun mevcut altyapısına göre ayrı bir değerlendirme gerektirir; "tak-çalıştır" olarak değil, kurulum projesi olarak ele alınmalıdır. Entegrasyon seçeneklerinin özetini entegrasyon bölümünde bulabilirsiniz.
Kısacası entegrasyon kapsamı bilinçli olarak dar tutulmuştur: çağrı sisteminin ihtiyaç duyduğu bilgiyi alır, gerisini HBYS'ye bırakır.
Entegrasyon olmadan başlamak mümkün mü?
Evet. SelfAsist, HBYS bağlantısı olmadan da tam olarak çalışır: odalar panelden tanımlanır, taburcu sonrası oda yetkili personel tarafından tek dokunuşla terminal temizliğe alınır. Pek çok kurum için doğru sıra, önce çağrı ve görev akışını oturtmak, ardından HBYS entegrasyonuyla çift girişi kaldırmaktır. HBYS firmanızla birlikte entegrasyonu planlamak için demo talep edin; teknik ekibinize API belgelerini ve test sürecini birlikte anlatalım.
Sık sorulan sorular
SelfAsist HBYS ile hangi yöntemle entegre olur?
Entegrasyon, X-Api-Key başlığıyla korunan bir REST API üzerinden yapılır. HBYS yatış ve taburcu olaylarını bu API'ye gönderir ve oda listesini alabilir.
Yatış olayında hangi bilgiler aktarılır?
A01 yatış olayında hasta adı ve protokol numarası ilgili odaya yazılır. Tanı, tedavi veya ilaç bilgisi aktarılmaz.
Taburcu olayından sonra ne olur?
A03 taburcu olayıyla oda terminal temizlik bekliyor durumuna alınır ve temizlik görevi görevdeki uygun personele otomatik atanır.
Santral ve kapı lambası entegrasyonu hazır çalışıyor mu?
Webhook, santral/SIP-DECT ve kapı üstü lamba (MQTT) bağlantıları yapılandırılabilir durumdadır; canlı bağlantı kuruma özel kurulum projesiyle devreye alınır.