Resmî Sistem Entegrasyonları

Türkiye'de birçok sektörde yazılım, zorunlu kamu sistemlerine bağlanmadan çalışamaz: e-Devlet, Medula provizyon, UYAP, İTS karekod, KBS kimlik bildirimi, ÇKS ve SGK. Bu entegrasyonların katı kuralları, sık değişen şemaları ve hata toleransı düşük akışları vardır; biz bu zorlu yüzeyde gerçek üretim deneyimine sahibiz.

Uzmanla görüşün

Türkiye'de yazılım, resmî sisteme bağlanmadan çalışmaz

Eczanede karekod okutulmadan ilaç satılmıyor. Poliklinikte Medula'ya provizyon gitmeden fatura kesilmiyor, otelde misafir KBS'ye bildirilmeden konaklama kapanmıyor, avukat UYAP'a bağlanmadan dosyasını takip edemiyor. Türkiye'de birçok sektörde yazılımın işi tam burada başlıyor: mevzuatın zorunlu tuttuğu sisteme bağlanmadan ürün ayakta durmuyor.

Bunu doküman okuyarak öğrenmedik. Sağlık tarafında Medula, İTS ve e-Nabız; hukuk ve mali müşavirlikte UYAP; konaklamada KBS; tarımda ÇKS; optik ve işitme merkezlerinde SGK hak sorgusu; lojistik ve perakendede Amazon SP-API bugün canlı çalışıyor. Hangisinin hangi sektörde koştuğunu aşağıda tek tek yazdık.

Zorunlu resmî sistemlerle canlı entegrasyon
Belgelendirme ve başvuru sürecini biz yürütürüz
Her sistem bağımsız bir adaptör: biri değişince diğerleri durmaz
Sandbox erişimi daha proje başlarken istenir

Uzun ve sade bir tezgâhın üstünde asılı bir okuyucu kolu; kolun lambası yanmış, altındaki kutuyu okuyor ve tezgâha gömülü alçak kapak açılarak kutunun karşı tarafa geçmesine izin veriyor, karşıda bekleyen figür elini uzatmış; tezgâhın ilerisinde ikinci bir kutu hâlâ kapalı kapağın arkasında duruyor — Bazı işler onaysız ilerleyemez: kutu okutulmadan tezgâhtan geçmez.

Resmî sistem entegrasyonunu zorlaştıran şeyler

Belgelendirme. Çoğu sistemin API dokümanı halka açık değil; kurumsal başvuru, sözleşme ve onay gerekiyor.

Test ortamı ayrı bir başvuru işi — sandbox kimliği çoğu zaman haftalar sonra geliyor.

Şema haber verilmeden değişebiliyor: bir alan adı, bazen bir alanın zorunlu olup olmadığı.

Hata toleransı düşük. Eksik bildirim reddedilir, bazı sistemlerde doğrudan cezaya bağlanır.

Kimlik doğrulama e-imza ya da istemci sertifikasıyla yapılıyor; sertifikanın kendi yönetim yükü var.

Mevzuat değişince entegrasyon da değişir — bunu izlemek birinin işi olmalı.

Canlı çalıştırdığımız sistemler

Her biri farklı bir sektörde, bugün kullanılan bir kurulumun içinde çalışıyor.

e-Devlet

Kimlik doğrulama ve e-imza tabanlı onay; kurumsal kurulumların giriş katmanında durur.

Medula

Provizyon ve fatura akışı — poliklinik yazılımımızın günlük işi.

İTS

İlaç karekod takibi. Eczane tarafında satışın önündeki zorunlu adım.

e-Nabız

Ulusal sağlık kaydı; sağlık tarafındaki kurulumların ortak bağlantı noktası.

UYAP

Dava, dosya ve duruşma bilgisi; avukatlık bürosu için kurduğumuz sistemde çalışır.

KBS

Misafir kimlik bildirimi. Otel yönetim sisteminde giriş kaydıyla birlikte hazırlanır.

ÇKS

Çiftçi kayıt sistemine hazır veri; tarım tarafında.

Amazon SP-API

Pazaryeri sipariş ve stok akışı; lojistik ve perakende kurulumlarında.

Bomboş beyaz zeminde tek başına duran bir pano; yüzünde her biri farklı biçimde oyulmuş bir dizi anahtar deliği var, bir figür bunlardan birine uyan anahtarı sokuyor ve panonun üst kenarındaki rafta yerine oturmuş birkaç anahtar daha duruyor, her biri başka bir form — Her resmî sistemin kendi ağzı vardır; her birine ayrı bir uç takılır.

Resmî entegrasyonun altında yaşayan üç disiplin

Belgelendirme ve başvuru süreci

Bir resmî sisteme bağlanmak koddan önce evrakla başlar: yetkilendirme dilekçesi, sözleşme, bazen yerinde denetim. Bu iş günlerle değil haftalarla ölçülüyor. Daha önce yürüttüğümüz için hangi belgenin hangi sırayla isteneceğini baştan biliyoruz; takvime sonradan çıkan bir sürpriz olarak girmiyor.

Dilekçe ve sözleşme sırası önceden bilinir
Beklenen süre takvime en baştan yazılır

Boydan boya mühür pencereleri dizili uzun bir tezgâh; bir figür tek bir evrak tomarını pencereden pencereye taşıyor, her pencerede bir kol tomara yeni bir mühür basıyor ve ancak son pencereden sonra memur karşılığında küçük bir anahtar uzatıyor

Test ortamı ve sandbox erişimi

Çoğu resmî servisin canlı ortamına doğrudan girilmez. Önce test kimlik bilgisiyle senaryolar geçilir: başarı, hata ve —en çok atlanan— zaman aşımı. O kimlik bilgisinin kendisi de ayrı bir başvuru istiyor, o yüzden ilk hafta talep ediliyor; geç istenirse geliştirme hazır olur, ortam olmaz.

Sandbox kimlik bilgisi ilk haftada talep edilir
Zaman aşımı senaryosu da test edilir, yalnız mutlu yol değil

Aynı duvarda yan yana duran birbirinin tıpatıp aynı iki kapı, biri halatlı bir dikmeyle kapatılmış; figürün elindeki iri anahtar yalnız o kapıya uyuyor ve açık kapının ardında aynı oda görünüyor — tertemiz, boş, üstünde çalışılacak sandıklarla dolu

Sürüm ve şema değişimini izleme

Resmî bir servisin alan adı, zorunlu alanı ya da kimlik doğrulama yöntemi haber verilmeden değişebiliyor. Her entegrasyonu bağımsız bir adaptör olarak yazmamızın sebebi bu: değişiklik yalnız o adaptörü ilgilendirir, uygulamanın geri kalanı yerinde kalır. Duyuruları izler, değişikliği önce test ortamında karşılarız.

Her entegrasyon bağımsız bir adaptör
Değişiklik canlıya çıkmadan test ortamında karşılanır

Bir ilan panosunda asılı sayfa yenisiyle değişmiş, eskisi yere savruluyor; panonun üstündeki küçük çan çalmış ve figür iki sayfayı yan yana tutarken diğer elinde bir adaptör parçası duruyor

Hangi sistem nerede çalışıyor

Aşağıdaki her satır, bugün kullanılan bir kurulumun içinden.

Poliklinik yönetimi

Medula provizyon ve fatura entegrasyonu günlük akışın içinde çalışır.

Eczane yönetimi

İTS karekoduyla ilaç ve ürün takibi; okutulmadan satış ilerlemez.

Optik & işitme merkezi

SGK hak sorgusu çalışır; e-Nabız sağlık tarafının ortak bağlantı noktasıdır.

Avukatlık & mali müşavirlik

UYAP dava/dosya entegrasyonu ve beyanname servisleriyle mesleğin resmî omurgasına bağlanır.

Otel & konaklama (PMS)

Giriş yapan misafirin kimlik bilgisi, KBS bildirimine hazır biçimde kaydedilir.

Tarım işletmesi

ÇKS ve destekleme başvurusuna hazır, dışa aktarılabilir kayıt üretir.

Lojistik & perakende

Amazon SP-API üzerinden sipariş çekilir, stok ve fiyat eşitlenir.

Kalın bir duvarın bu yanındaki el kranktan, mühürlü bir delikten geçen gergin bir kablo uzanıyor; figür kranki çevirdiğinde duvarın öbür yanındaki ağır çark onunla aynı anda dönüyor ve ikinci bir figür ikisini birden görebileceği yerde duruyor — Bağlantı bir şema değildir: kolu çevirince öbür taraftaki çark da dönüyor.

Bir resmî sistem entegrasyonunu nasıl kuruyoruz

Başvuru & belgelendirme

Hangi belgenin, hangi sözleşmenin ve hangi yetkilendirmenin gerekeceğini biliyoruz; başvuru daha kod yazılmadan başlar.

Sandbox ile uçtan uca test

Sağlayıcının test kimlik bilgileriyle başarıyı da, hatayı da, zaman aşımını da birlikte geçeriz.

Adaptör olarak yazma

Entegrasyon çekirdeğe gömülmez, bağımsız bir modül olur; mevzuat değişince yalnız o modül güncellenir.

Canlıya alma & izleme

Kontrollü bir geçişle devreye alır, hata oranını ve şema değişikliğini izlemeye bağlarız.

Sürüm takibi & bakım

Kurumun duyurduğu değişiklikleri izler, adaptörü SLA'lı bakımla güncel tutarız.

Üzerine kurduğumuz teknoloji

Protokol

SOAP
REST
XML

Güvenlik

e-İmza
sertifika
mTLS

Entegrasyon

Kamu servis adaptörleri
izleme & uyarı

Backend

.NET 9
PostgreSQL

Adaptör

Her resmî sistem bağımsız bir modül

Sandbox

Canlıdan önce test ortamı şart

Katmanlı

service / bll / dal mimarisi

.NET 9

Modern çekirdek yığın

Sık sorulanlar

Bu sistemlere gerçekten bağlandınız mı, yoksa dokümanı mı okudunuz?

Medula, İTS, UYAP, KBS, ÇKS ve Amazon SP-API entegrasyonları bugün kullanılan kurulumların içinde çalışıyor — sağlık, hukuk, konaklama, tarım, lojistik ve perakende tarafında. Zaten dokümanla öğrenilmeyen kısmı, test ortamında geçen haftalar.

Test ortamına erişim ne kadar sürer?

Kuruma göre değişiyor; birkaç günden birkaç haftaya kadar çıkabiliyor. Bu yüzden başvuruyu projenin en başında, geliştirme başlamadan yapıyoruz.

Kurum bir şeyi değiştirirse ne olur?

Her entegrasyon bağımsız bir adaptör olarak yazıldığı için bir alan adı ya da kural değiştiğinde yalnız o adaptör güncellenir; uygulamanın geri kalanı etkilenmez. Değişiklik duyurularını izliyor, canlıya çıkmadan önce test ortamında doğruluyoruz.

Hangi sektörde hangi resmî sistem zorunlu?

Sağlıkta Medula ve İTS, hukukta UYAP, konaklamada KBS, tarımda ÇKS genelde zorunlu; e-Devlet ve e-imza ise birçok sektörde kimlik doğrulama katmanı olarak kullanılıyor. Sizin tarafınızda hangisinin zorunlu olduğunu ilk görüşmede birlikte netleştiririz.

e-imza/sertifika sürecini de siz mi yönetiyorsunuz?

Sertifikayı bir e-imza sağlayıcısından siz temin ediyorsunuz; biz onu sisteme entegre edip mTLS ve imza doğrulama akışını kuruyoruz.

Sistemin canlıya çıkması ne kadar sürer?

Kapsama göre değişir; genel aralık 3 hafta – 5 ay. Belgelendirme ve test ortamı süresi bu takvimin içinde, sonradan eklenen bir kalem değil.

Hangi resmî sisteme bağlanmanız gerekiyor?

Sektörünüzde hangi sistemin zorunlu olduğunu ve nereden başlanacağını birlikte çıkaralım. Görüşmenin sonunda bir şey imzalamak zorunda değilsiniz.