UDENTIVA Умная платформа управления стоматологией

ПЕРЕДАЧА ДАННЫХ И СХЕМЫ VIEW

Передача данных (Export API)

Контролируемая передача данных только для чтения. Только оператор платформы (SuperUser) определяет для клиники подключение + ключ; ключ извлекает данные этой клиники из выбранных наборов данных «VEM» (view Минимальной модели данных). Кросс-тенантный доступ отсутствует. Соответствует обязательству по переносимости данных (Ст. 14 Постановления № 39682).

Как это работает?

Определяет SuperUser

Оператор платформы (супер-админ) создаёт подключение для клиники и выбирает, какие наборы данных (VEM Görüntüsü) будут выгружены. Генерируется одноразовый ключ 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)

Запрос

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 Görüntüsü — схемы View

Каждый выгружаемый набор данных — это VEM Görüntüsü (view минимальной модели данных) с фиксированными колонками. Ниже для каждого набора приведены полная схема колонок, типы данных и (при наличии) соответствие полю 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 view работают с security_invoker + встроенным фильтром арендатора — при отсутствии контекста не возвращается ни одной строки.

Только для чтения: только GET. Ключ хранится только в виде SHA-256 хеша; открытый ключ показывается один раз при создании. Деактивация/отзыв вступает в силу немедленно.

Поддаётся аудиту: каждая выборка данных (подключение, набор данных, количество строк, IP) записывается в журнал доступа.

Вся модель безопасности →

Другие ресурсы

Пациенты Записи на приём и календарь Одонтограмма и лечение Инкассация и финансы Склад Снимки Лаборатория Lead и CRM Медицинский туризм Отчётность и BI Webhooks

Хотите настроить передачу данных?

Экспортные подключения создаёт оператор платформы с согласия вашей клиники.

Связаться