Bakanlık entegrasyonu için ön hazırlık; kurumun SKRS kurum kodunun, USS ve SYS servis kullanıcılarının ve bunlara ait şifrelerin doğru ve güvenli biçimde tanımlanmasıdır. Bu bilgiler, evde sağlık yazılımının kurum adına Bakanlık servislerine bağlanmasını sağlar. Hazırlık eksik ya da hatalı yapılırsa e-Nabız gönderimleri gibi tüm entegrasyon adımları ilk denemede takılır.
Bu yazıda hangi bilgilerin gerektiğini, nasıl saklanması gerektiğini ve canlı ortama geçmeden önce neleri kontrol etmeniz gerektiğini anlatıyoruz. Kullanıcı bilgilerinin nasıl temin edileceği kurumun türüne ve Bakanlığın güncel süreçlerine göre değişebilir; bu konuda il sağlık müdürlüğünüzün ve Bakanlığın yönlendirmelerini esas alın.
USS ve SYS nedir?
USS (Ulusal Sağlık Sistemi), sağlık hizmeti sunucularının Bakanlığa veri iletmesine yönelik ulusal yapının adıdır. SYS ise e-Nabız'a sağlık verisi gönderiminde kullanılan Bakanlık web servisinin adı olarak karşımıza çıkar. Evde sağlık yazılımı açısından pratik anlamı şudur: kurum adına veri gönderebilmek için bu servislerde tanımlı bir kullanıcı adı ve şifreye ihtiyaç vardır.
Bu kullanıcılar kişiye değil kuruma aittir. Hekimin e-reçete için kullandığı Medula şifresi ya da e-imza kartı ise kişiseldir ve hekimin kendisine bağlıdır. Bu ayrımı baştan netleştirmek, yetki karışıklığını önler.
Hangi bilgilere ihtiyaç var?
| Bilgi | Kime ait? | Nerede kullanılır? |
|---|---|---|
| SKRS kurum kodu | Kurum | Tüm Bakanlık gönderimlerinde kurumu tanımlar |
| USS kullanıcı adı ve şifresi | Kurum | USS servislerine erişim |
| SYS kullanıcı adı ve şifresi | Kurum | e-Nabız veri gönderimi; SKRS listelerine erişimde de kullanılabilir |
| Ortam seçimi | Kurum | Test ya da canlı ortama gönderim |
| Hekim T.C., uzmanlık ve Medula e-reçete şifresi | Hekim | e-Reçete gönderimi |
| e-İmza kartı | Hekim | e-Reçete imzası |
Kurum kodunun ve kod listelerinin mantığını SKRS kodları yazımızda, e-Nabız paketlerini ise e-Nabız veri gönderimi yazımızda ayrıntılı anlattık.
Ön hazırlık için kontrol listesi
- Kurum kaydını doğrulayın: Kurumunuzun Bakanlık sistemlerinde doğru unvan ve kodla kayıtlı olduğunu kontrol edin. Evde sağlık biriminin tescil ve kayıt işlemleri tamamlanmış olmalıdır.
- Kurum kodunu not edin: SKRS kurum kodunu resmî kaynaktan alın; tahmin ya da eski bir yazışmadan kopyalama yapmayın.
- Servis kullanıcılarını temin edin: USS ve SYS kullanıcılarını Bakanlığın belirlediği süreçle edinin.
- Sorumlu kişiyi belirleyin: Bu bilgileri kimin saklayacağını, kimin değiştirebileceğini yazılı hâle getirin.
- Test ortamı bilgilerini ayırın: Test ve canlı ortam için farklı bilgi verildiyse karıştırmayın.
- Hekim bilgilerini toplayın: e-Reçete yazacak her hekimin T.C. kimlik numarası, uzmanlık bilgisi ve Medula şifresinin kendisi tarafından girilmesini planlayın.
- Deneme gönderimi yapın: Canlıya geçmeden test ortamında örnek kayıtlarla deneme yapın.
Servis şifreleri nasıl saklanmalı?
Servis kullanıcı bilgileri, kurum adına Bakanlığa veri gönderme yetkisi taşır. Bu bilgilerin bir e-posta yazışmasında, ortak bir masaüstü dosyasında ya da kâğıt üzerinde dolaşması ciddi bir risktir. İyi uygulamalar şunlardır:
- Şifreler yazılımda şifrelenmiş olarak saklanmalı, ekranda açık metin olarak gösterilmemelidir.
- Entegrasyon ayarlarına yalnız yetkili rollerin erişmesi sağlanmalıdır.
- Ayarlardaki her değişiklik denetim kaydına düşmelidir: kim, ne zaman, neyi değiştirdi.
- Bilgileri bilen personel kurumdan ayrıldığında şifre değişikliği değerlendirilmelidir.
- Aynı şifre başka sistemlerde kullanılmamalıdır.
Genel güvenlik ilkeleri için sağlık yazılımında veri güvenliği yazımıza göz atabilirsiniz.
Test ortamı ile canlı ortam arasındaki fark nedir?
Test ortamı, gönderimlerin gerçek kayıtlara yansımadan denendiği ortamdır. Canlı ortam ise gönderilen verinin gerçek hasta kaydına işlendiği ortamdır. Yeni bir entegrasyonu doğrudan canlı ortamda denemek, hatalı ya da deneme amaçlı verinin gerçek kayıtlara girmesine yol açabilir.
Bu nedenle önerilen sıra şudur: önce test ortamında kullanıcı bilgisi, kurum kodu ve eşlemeler doğrulanır; örnek paketler gönderilir; hata mesajları incelenip düzeltilir; ardından canlı ortama geçilir. Her Bakanlık servisinin test ortamı olmayabilir; böyle durumlarda ilk canlı gönderimleri dikkatle ve az sayıda kayıtla yapmak gerekir.
Sık karşılaşılan bağlantı sorunları nelerdir?
- Kimlik doğrulama hatası: Kullanıcı adı ya da şifre yanlış girilmiş, şifre değişmiş ya da test ortamı bilgisi canlıda kullanılıyor olabilir.
- Kurum bulunamadı: Kurum kodu hatalı, eski ya da kullanıcı bu kuruma tanımlı değil.
- Yetki hatası: Kullanıcı tanımlı ama ilgili servise ya da işlem türüne yetkisi yok.
- Erişim sorunu: Servis geçici olarak yanıt vermiyor ya da kurumun ağında bir kısıtlama var.
Bu hataların her biri farklı bir çözüm gerektirir; bu nedenle dönen mesajın tam metnini okumak, deneme yanılmadan daha hızlı sonuç verir. Kimlik doğrulama hatalarında bilgileri yeniden girmeden önce hangi ortamın seçili olduğunu kontrol etmek, en sık yapılan karışıklığı ortadan kaldırır.
Personel değişikliğinde ne yapılmalı?
Entegrasyon bilgileri çoğu kurumda bir ya da iki kişinin bilgisindedir. Bu kişiler izne çıktığında ya da kurumdan ayrıldığında süreç kilitlenmemelidir. Bilgilerin yazılımda şifreli tutulması, kişiye bağımlılığı azaltır; yine de kimin bu bilgilere erişim yetkisi olduğu düzenli gözden geçirilmelidir. Yeni bir hekim ekibe katıldığında ise personel kartına e-reçete bilgilerinin girilmesi, e-imza kartının ve ajanının hazırlanması işe başlama adımlarının parçası olmalıdır.
Hazırlık ne kadar sürer?
Süre, büyük ölçüde servis kullanıcılarının temin edilme hızına bağlıdır. Bilgiler elinizdeyse yazılımdaki tanımlar kısa sürede yapılır; zaman alan kısım genellikle test gönderimlerinde çıkan eşleme ve kod sorunlarının giderilmesidir. Bu nedenle entegrasyon hazırlığını, yazılımın günlük kullanıma alınmasıyla paralel başlatmak ve ilk hastaların izlem kayıtları oluşmadan önce test aşamasını tamamlamaya çalışmak iyi bir plandır.
Servis günlüğü neden önemli?
Servis günlüğü, yazılımın Bakanlık servislerine yaptığı her çağrının ve dönen yanıtın kaydıdır. Bir gönderim hata verdiğinde ilk bakılacak yer burasıdır: hangi kayıt, ne zaman, hangi ortama gönderildi ve ne yanıt döndü? Günlük olmadan sorun gidermek tahmine dayanır. Destek almanız gerektiğinde de günlükteki hata mesajını aktarmak, çözümü hızlandırır.
selfESYS'te entegrasyon ayarları
selfESYS'in entegrasyon ayarları ekranında SKRS kurum kodu, USS ve SYS kullanıcıları tanımlanır. Bu şifreler AES-256-GCM ile şifrelenerek saklanır. Test ya da canlı ortam seçilir; her servis çağrısı servis günlüğüne yazılır ve buradan izlenebilir.
- Entegrasyon ayarlarına erişim rol ve menü bazlı yetkiyle sınırlandırılır.
- Ayar değişiklikleri HMAC imzalı denetim kaydına düşer.
- Hekimin e-reçete bilgileri personel kartında tutulur; e-imza PIN'i sunucuda saklanmaz.
Bu hazırlık tamamlandığında e-Nabız, e-Rapor ve e-Reçete bağlantıları aynı temel üzerinde çalışır. Tüm bağlantıları entegrasyonlar sayfasında görebilirsiniz.
Sonuç
- Bakanlık entegrasyonu; SKRS kurum kodu, USS ve SYS servis kullanıcılarıyla başlar.
- Servis kullanıcıları kuruma, Medula şifresi ve e-imza kartı hekime aittir.
- Şifreler şifrelenmiş saklanmalı, erişim yetkiyle sınırlanmalı, değişiklikler kayıt altına alınmalıdır.
- Canlıya geçmeden test ortamında deneme yapılmalı, servis günlüğü düzenli izlenmelidir.
Entegrasyon ayarlarını kurumunuz için birlikte yapılandırmak isterseniz bizimle iletişime geçin.