UDENTIVA Plataforma Inteligente de Gestão Odontológica

Comece Grátis

MIGRAÇÃO DE DADOS E ESQUEMAS DE VIEW

Transferência de Dados (Export API)

Transferência de dados controlada e somente leitura. Apenas o operador da plataforma (SuperUser) define uma conexão + chave para uma clínica; a chave extrai os dados dessa clínica a partir dos conjuntos de dados "VEM" (view do Modelo de Dados Mínimo) selecionados. Não há acesso entre tenants. Está em conformidade com a obrigação de portabilidade de dados (Regulamento nº 39682, Art. 14).

Como funciona?

SuperUser define

O operador da plataforma (super-admin) cria um vínculo para uma clínica e seleciona quais conjuntos de dados (Visão VEM) serão exportados. Uma chave de API de uso único é gerada.

Acesso por chave

Um sistema externo (ex.: contabilidade, relatórios, exportação regulatória) obtém dados somente leitura com o cabeçalho Authorization: Bearer. A chave enxerga apenas os dados daquela clínica.

Controlado e auditável

Cada acesso é registrado. Quando solicitado, o vínculo é desativado/cancelado instantaneamente. Os dados são fixados pelo esquema da view; alterações nas tabelas internas não afetam o exterior.

Autenticação

Cada requisição deve carregar uma chave de exportação. Dois métodos são suportados; a chave é armazenada apenas como hash SHA-256.

Authorization: Bearer udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
— ou —X-Export-Key: udx_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

GET /export/v1 Retorna os conjuntos de dados permitidos e as informações de uso da chave (descoberta) Chave de exportação

GET /export/v1/{dataset} Extrai o conjunto de dados selecionado de forma paginada (?limit=1000&offset=0) Chave de exportação

Exemplo de Uso

Extrair pacientes (VEM)

Requisição

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

Resposta

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

Visão VEM — Esquemas de View

Cada conjunto de dados exportável é uma Visão VEM de colunas fixas (view de Modelo Mínimo de Dados). Abaixo está o esquema completo de colunas de cada conjunto, os tipos de dados e (quando houver) o campo correspondente do VEM do Ministério da Saúde. Os campos monetários retornam como decimal (numeric), os identificadores como uuid e as datas como ISO-8601 (timestamptz).

Hastalar patients VEM: VEM_HASTA 32 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

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

Coluna	Tipo	Descrição
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 coluna

Ödeme/tahsilat kayıtları.

Coluna	Tipo	Descrição
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

Modelo de Segurança

Definido pelo SuperUser: as conexões são criadas apenas no plano de controle da plataforma; esses endpoints não são detectáveis na API pública. As próprias clínicas não podem gerar chaves.

Bloqueado ao tenant + fail-closed: cada chave está vinculada a uma única clínica. As views de export operam com security_invoker + filtro de tenant embutido — sem contexto, nenhuma linha é retornada.

Somente leitura: apenas GET. A chave é armazenada apenas como hash SHA-256; a chave em texto puro é exibida uma única vez na criação. A desativação/revogação tem efeito imediato.

Auditável: cada extração de dados (conexão, conjunto de dados, número de linhas, IP) é gravada no log de acesso.

Todo o modelo de segurança →

Outros Recursos

Pacientes Agendamentos e calendário Odontograma & Tratamento Cobrança e Finanças Estoque Imagem Laboratório Lead & CRM Turismo de saúde Relatórios & BI Webhooks

Deseja configurar uma migração de dados?

Os links de exportação são definidos pelo operador da plataforma, com a aprovação da sua clínica.

Entre em Contato