ابدأ مجانًا

نقل البيانات ومخططات VIEW

نقل البيانات (Export API)

نقل بيانات محكوم وللقراءة فقط. لا يستطيع سوى مشغّل المنصة (SuperUser) تعريف اتصال + مفتاح لعيادةٍ ما؛ ويسحب المفتاح بيانات تلك العيادة من مجموعات بيانات "VEM Görüntüsü" (view نموذج الحد الأدنى للبيانات) المحددة. لا يوجد وصول عابر للمستأجرين (cross-tenant). ويتوافق مع التزام قابلية نقل البيانات (اللائحة رقم 39682، المادة 14).

كيف يعمل؟

يُعرِّف SuperUser

يُنشئ مشغّل المنصة (super-admin) رابطًا لعيادة، ويختار مجموعات البيانات (عرض VEM) التي ستُنقَل. ويُولَّد مفتاح API لاستخدام واحد.

الوصول عبر المفتاح

يسحب نظام خارجي (مثل المحاسبة أو التقارير أو تصدير الجهات التنظيمية) بياناتٍ للقراءة فقط بترويسة Authorization: Bearer. لا يرى المفتاح سوى بيانات تلك العيادة.

مضبوط وقابل للتدقيق

يُسجَّل كل سحب. عند طلب الرابط يُعطَّل/يُلغى فورًا. البيانات ثابتة بمخطط العرض (view)؛ ولا تؤثّر تغييرات الجداول الداخلية على الخارج.

المصادقة

يجب أن يحمل كل طلب مفتاح تصدير. يُدعَم أسلوبان؛ ويُخزَّن المفتاح كتجزئة SHA-256 فقط.

Authorization: Bearer udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
— أو —X-Export-Key: udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

النقاط الطرفية

GET /export/v1 يُعيد مجموعات البيانات المصرّح بها للمفتاح ومعلومات الاستخدام (الاستكشاف) مفتاح التصدير

GET /export/v1/{dataset} يسحب مجموعة البيانات المحددة مقسّمة على صفحات (?limit=1000&offset=0) مفتاح التصدير

مثال استخدام

اسحب المرضى (VEM Görüntüsü)

الطلب

curl https://udentiva.com/export/v1/patients?limit=1000 \
  -H "Authorization: Bearer udx_xxxxxxxx"

الاستجابة

HTTP/1.1 200 OK
{
  "dataset": "patients",
  "count": 1000,
  "limit": 1000,
  "offset": 0,
  "rows": [ { "patient_id": "...", "tenant_id": "...", "first_name": "..." } ]
}

عرض VEM — مخططات View

كل مجموعة بيانات قابلة للنقل هي عرض VEM بأعمدة ثابتة (عرض نموذج الحد الأدنى للبيانات). في الأسفل يظهر لكل مجموعة مخطط الأعمدة الكامل وأنواع البيانات، وإن وُجد، ما يقابله من حقول VEM لوزارة الصحة. تُعاد حقول المال كأرقام عشرية (numeric)، والمعرّفات كـ uuid، والتواريخ بصيغة ISO-8601 (timestamptz).

Hastalar patients VEM: VEM_HASTA 32 العمود

Hasta demografik kaydı (silinmiş kayıtlar hariç). Özel nitelikli veri içerir; yalnız yetkili kontrollü aktarım içindir.

العمود	النوع	الوصف
patient_id	uuid	Hasta kimliği (birincil anahtar)
tenant_id	uuid	Klinik kimliği (kayıt bu kliniğe aittir)
national_id	text	TCKN / TC Kimlik Numarası
first_name	text	Ad (AD)
last_name	text	Soyad (SOYADI)
full_name	text	Tam ad (eski tek-alan)
nationality	text	Uyruk (UYRUK)
patient_type	text	Hasta tipi (HASTA_TIPI)
birth_date	date	Doğum tarihi
declared_birth_date	date	Beyan doğum tarihi (BEYAN_DOGUM_TARIHI)
gender	text	Cinsiyet (CINSIYET)
birth_place	text	Doğum yeri (DOGUM_YERI)
mother_tckn	text	Anne TCKN
father_tckn	text	Baba TCKN
mother_name	text	Anne adı
father_name	text	Baba adı
birth_order	smallint	Doğum sırası (DOGUM_SIRASI)
marital_status	text	Medeni hali (MEDENI_HALI)
occupation	text	Meslek (MESLEK)
education_level	text	Öğrenim durumu (OGRENIM_DURUMU)
blood_type	text	Kan grubu (KAN_GRUBU)
disability_status	text[]	Engellilik durumu (ENGELLILIK_DURUMU, dizi)
death_date	date	Ölüm tarihi (OLUM_TARIHI)
death_place	text	Ölüm yeri (OLUM_YERI)
passport_no	text	Pasaport numarası
yupass_no	text	YUPASS numarası
last_institution_code	text	Son kurum kodu
unidentified_info	text	Kimliksiz hasta bilgisi
phone	text	Telefon
email	text	E-posta
created_at	timestamptz	Oluşturulma zamanı
updated_at	timestamptz	Güncellenme zamanı

Başvurular visits VEM: VEM_HASTA_BASVURU 21 العمود

Hasta başvuru / muayene kaydı (başvuru protokolü, hekim, kabul bilgileri).

العمود	النوع	الوصف
visit_id	uuid	Başvuru kimliği
tenant_id	uuid	Klinik kimliği
branch_id	uuid	Şube kimliği
patient_id	uuid	Hasta kimliği
parent_visit_id	uuid	Bağlı olduğu başvuru
doctor_id	uuid	Hekim kodu (HEKIM_KODU)
assistant_doctor_id	uuid	Asistan hekim kodu
book_no	text	Defter numarası
daily_seq	integer	Günlük sıra numarası
priority	text	Muayene öncelik sırası
institution_code	text	Kurum kodu
online_protocol_no	text	Online protokol numarası
admission_protocol_no	text	Başvuru protokol numarası
admitted_at	timestamptz	Hasta kabul zamanı
admission_type	text	Kabul şekli
social_security_status	text	Sosyal güvence durumu
case_type	text	Vaka türü
referral_diagnosis	text[]	Sevk tanısı (dizi)
doctor_note	text	Hekim başvuru notu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Tanılar diagnoses VEM: VEM_BASVURU_TANI 11 العمود

Başvuruya bağlı tanılar (ICD-10).

العمود	النوع	الوصف
diagnosis_id	uuid	Tanı kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
icd10_code	text[]	Tanı kodu (ICD-10, dizi)
diagnosis_type	text	Tanı türü
is_primary	boolean	Birincil tanı mı
diagnosed_at	timestamptz	Tanı zamanı
doctor_id	uuid	Hekim kodu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Reçeteler prescriptions VEM: VEM_RECETE 12 العمود

Reçete başlığı (MEDULA e-reçete, e-imza durumu).

العمود	النوع	الوصف
prescription_id	uuid	Reçete kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
doctor_id	uuid	Hekim kimliği
prescription_type	text	Reçete türü
prescription_subtype	text	Reçete alt türü
medula_erecete_no	text	MEDULA e-reçete numarası
esign_status	text	Reçete e-imza durumu
sgk_follow_no	text	SGK takip numarası
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Reçete İlaçları prescription_items VEM: VEM_RECETE_ILAC 15 العمود

Reçetedeki ilaç kalemleri (barkod, doz, kullanım).

العمود	النوع	الوصف
item_id	uuid	Kalem kimliği
tenant_id	uuid	Klinik kimliği
prescription_id	uuid	Reçete kimliği
barcode	text	Barkod
drug_name	text	İlaç adı
box_count	integer	Kutu adedi
dose_unit	text	Doz birimi
usage_form	text	İlaç kullanım şekli
usage_count	integer	İlaç kullanım sayısı
usage_dose	text	İlaç kullanım dozu
usage_period	integer	İlaç kullanım periyodu
period_unit	text	Periyot birimi
note	text	İlaç açıklama
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Randevular appointments VEM: RANDEVU 19 العمود

Randevu kayıtları (MHRS, gelme durumu, iptal).

العمود	النوع	الوصف
appointment_id	uuid	Randevu kimliği
tenant_id	uuid	Klinik kimliği
branch_id	uuid	Şube kimliği
patient_id	uuid	Hasta kimliği
doctor_id	uuid	Hekim kimliği
unit_id	uuid	Ünite/koltuk kimliği
visit_id	uuid	Başvuru kimliği
start_at	timestamptz	Başlangıç
end_at	timestamptz	Bitiş
status	text	Durum
priority	text	Öncelik
appointment_type	text	Randevu türü
appointment_subtype	text	Randevu alt türü
mhrs_hrn	text	MHRS HRN kodu
attendance_status	text	Randevu gelme durumu
cancelled_at	timestamptz	İptal zamanı
cancel_reason	text	İptal nedeni
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Hizmet Kataloğu services VEM: HIZMET 6 العمود

Klinik hizmet/işlem kataloğu ve fiyatları.

العمود	النوع	الوصف
service_id	uuid	Hizmet kimliği
tenant_id	uuid	Klinik kimliği
code	text	Hizmet kodu
name	text	Hizmet adı
price	numeric	Birim fiyat (para; ondalık)
updated_at	timestamptz	Güncellenme

Tedavi Kalemleri treatment_items VEM: HASTA_HIZMET 14 العمود

Tedavi planı kalemleri (uygulanan/planlanan işlemler, fatura durumu).

العمود	النوع	الوصف
item_id	uuid	Kalem kimliği
tenant_id	uuid	Klinik kimliği
plan_id	uuid	Tedavi planı kimliği
service_id	uuid	Hizmet kimliği
visit_id	uuid	Başvuru kimliği
tooth_no	text	Diş numarası (FDI)
surface	text	Yüzey
price	numeric	Fiyat (para)
status	text	Plan durumu
service_status	text	Hasta hizmet durumu
billing_status	text	Hizmet fatura durumu
side_info	text	Taraf bilgisi
performed_at	timestamptz	İşlem zamanı
updated_at	timestamptz	Güncellenme

Diş Durumları tooth_states VEM: DIS_ISLEM 13 العمود

Odontogram diş durumları (FDI, append-only).

العمود	النوع	الوصف
tooth_state_id	uuid	Diş durumu kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
tooth_no	integer	Diş numarası (FDI)
surface	text	Yüzey
condition	text	Durum/işlem
dental_action_type	text	Diş işlem türü
medula_tooth_code	text	Diş kodu (MEDULA)
result_code	text	Sonuç kodu
result_message	text	Sonuç mesajı
recorded_at	timestamptz	Kayıt zamanı
updated_at	timestamptz	Güncellenme

Faturalar invoices VEM: FATURA 14 العمود

Fatura başlıkları (MEDULA teslim, bütçe kodu, dönem).

العمود	النوع	الوصف
invoice_id	uuid	Fatura kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
visit_id	uuid	Başvuru kimliği
total	numeric	Toplam tutar (para)
status	text	Durum
invoice_type	text	Fatura türü
invoice_no	text	Fatura numarası
period	text	Fatura dönemi
medula_delivery_no	text	MEDULA teslim numarası
budget_code	text	Bütçe kodu
einvoice_status	text	e-Fatura durumu
created_at	timestamptz	Oluşturulma
updated_at	timestamptz	Güncellenme

Fatura Kalemleri invoice_lines VEM: FATURA_KALEM 8 العمود

Fatura satırları (açıklama, miktar, tutar).

العمود	النوع	الوصف
line_id	uuid	Satır kimliği
tenant_id	uuid	Klinik kimliği
invoice_id	uuid	Fatura kimliği
description	text	Açıklama
qty	numeric	Miktar
unit_price	numeric	Birim fiyat (para)
line_total	numeric	Satır toplamı (para)
updated_at	timestamptz	Güncellenme

Tahsilatlar payments VEM: TAHSILAT 8 العمود

Ödeme/tahsilat kayıtları.

العمود	النوع	الوصف
payment_id	uuid	Tahsilat kimliği
tenant_id	uuid	Klinik kimliği
patient_id	uuid	Hasta kimliği
invoice_id	uuid	Fatura kimliği
amount	numeric	Tutar (para)
method	text	Ödeme yöntemi
paid_at	timestamptz	Tahsilat zamanı
updated_at	timestamptz	Güncellenme

نموذج الأمان

معرّفة من قبل SuperUser: تُنشأ الروابط في مستوى تحكّم المنصة فقط؛ ولا يمكن اكتشاف نقاط النهاية هذه في الـ API العام. ولا تستطيع العيادات نفسها توليد المفاتيح.

مقفلة على المستأجر + fail-closed: كل مفتاح مرتبط بعيادة واحدة. تعمل عروض التصدير (export views) بخاصية security_invoker مع فلتر مستأجر مضمّن — فإن غاب السياق، لا يُعاد أي صف.

للقراءة فقط: GET فقط. يُخزَّن المفتاح كـ SHA-256 hash فقط؛ ويُعرَض المفتاح الصريح مرة واحدة عند الإنشاء. ويسري التعطيل/الإلغاء فورًا.

قابل للتدقيق: كل عملية سحب بيانات (الاتصال، مجموعة البيانات، عدد الصفوف، IP) تُكتب في سجل الوصول.

نموذج الأمان الكامل →

موارد أخرى

المرضى المواعيد والتقويم المخطط السنّي (Odontogram) والعلاج التحصيل والمالية المخزون التصوير المختبر Lead وCRM السياحة الصحية التقارير وذكاء الأعمال (BI) Webhooks

هل ترغب في إعداد نقل بيانات؟

يُعرِّف مشغّل المنصة روابط التصدير بموافقة عيادتك.

تواصل معنا