> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# İçe aktarma
> Başka bir klinik yazılımındaki verilerinizi Flextell'e aktarmayı, aktarım seçeneklerini, hataları ve atlanan kayıtları anlatır.
Önceki klinik yazılımınızı kullanıyorsanız hastalarınızı, randevularınızı ve diğer kayıtlarınızı Flextell'e tek seferde taşıyabilirsiniz. Bu sayfa kaynak kurulumunu, aktarımı başlatmayı ve sonucu izlemeyi anlatır.
Ekran: **Bağlantılar → İçe Aktar**. Sayfayı görmek için rolünüzde **İçe Aktarım → Görüntüle** izni olmalıdır. İzinleri [Roller](/panel/sistem/roller) sayfasından yönetebilirsiniz.
## İçe aktarma nedir
İçe aktarma, Flextell'i eski yazılımınızın API'sine bağlar ve oradaki kayıtları arka planda Flextell'e kopyalar. Siz bağlantı bilgilerini girer, hangi veri türlerinin taşınacağını seçersiniz. Aktarım siz sayfayı kapatsanız da sürer.
Desteklenen kaynaklar:
| Kaynak | Firma | Aktarılabilen veri türleri |
| - | - | - |
| **Estesoft Stella** | Estesoft | Kullanıcı, Tedavi, Oda, Ürün, Hasta, Lead, Banka Hesabı, Satış, Fatura, Muhasebe İşlemi, Hasta Notu, Hasta Dosyaları, Randevu |
| **Dr.DENTES** | Dr.DENTES | Kullanıcı, Tedavi, Hasta, Randevu |
İçe aktarma, CSV veya Excel dosyası yükleyerek çalışmaz. Yalnızca yukarıdaki yazılımların API'si üzerinden veri alınır. Listede olmayan bir yazılımdan taşınma için destek ekibiyle iletişime geçin.
Aktarılan kayıtlar Flextell'de normal kayıtlar gibi çalışır. Aktarılan bir hastanın veya Lead'in sayfasında **İçe Aktarılmış Kayıt** başlıklı bir bilgi şeridi görürsünüz: "Bu kayıt (kaynak adı) sisteminden içe aktarılmıştır." Bu şerit [Hasta kartı](/panel/hastalar/hasta-karti) ve [Lead kartı](/panel/leadler/lead-karti) sayfalarında yer alır.
## Kaynak kurulumu
Her kaynak bir kart olarak listelenir. Kartta logo, kaynak adı, firma adı, açıklama ve duruma göre **Yeni** ve **Kurulu** etiketleri bulunur. Bir aktarım çalışıyorsa kartta durumu ve ilerleme çubuğu da görünür.
### Bağlantı bilgilerini girme
**Bağlantılar → İçe Aktar** sayfasında kaynağın kartında **Şimdi Kur**'a tıklayın. Bu işlem için **Kur** izni gerekir.
Kaynak adıyla başlayan **Kurulumu** penceresi (örneğin **Estesoft Stella Kurulumu**) açılır. Aşağıdaki tablodaki alanların hepsi zorunludur. Boş bırakırsanız "Base URL zorunludur." gibi bir uyarı çıkar.
**Kaydet**'e tıklayın. **Bağlantı bilgileri kaydedildi** bildirimi görünür ve karta **Kurulu** etiketi gelir.
| Kaynak | Gereken bilgiler |
| - | - |
| Estesoft Stella | **Base URL**, **Kullanıcı Adı**, **Şifre**, **API Key** |
| Dr.DENTES | **Base URL**, **API Key** |
Flextell bağlantı bilgilerini kaydederken denemez. Hatalı bilgi girdiyseniz bunu aktarımı başlattığınızda fark edersiniz.
**Dr.DENTES için ön koşul:** API erişimi ve adresi için önce Dr.DENTES ile iletişime geçmeniz gerekir. Ayrıca Flextell'in sunucu IP adresinin Dr.DENTES API izin listesine eklenmesini sağlamalısınız. Bu yapılmazsa aktarım başlar başlamaz **Başarısız** olur.
### Bağlantı bilgilerini güncelleme ve kurulumu kaldırma
* **Güncelleme:** Kartta **Bağlantı**'ya tıklayın. Bu düğme **Güncelle** izni gerektirir. **Bağlantısını Güncelle** başlıklı pencere (başlığın başında kaynak adı yer alır) açılır. Güvenlik nedeniyle kayıtlı değerler gösterilmez, alanlar boş gelir. Tüm alanları yeniden doldurup **Güncelle**'ye tıklayın.
* **Kaldırma:** Kartta çöp kutusu simgesine (**Kurulumu Kaldır**) tıklayın ve onaylayın. Bu işlem **Kaldır** izni gerektirir. Kayıtlı bağlantı bilgileri silinir. Daha önce aktarılan kayıtlar Flextell'de kalır. Çalışan bir aktarım varken kurulumu kaldırmayın, aktarım hata verir.
## Aktarımı başlatma
Kurulu kaynağın kartında **İçe Aktar**'a tıklayın. Bu işlem **Başlat** izni gerektirir. Kaynakta zaten çalışan bir aktarım varsa düğme pasiftir.
**İçe Aktarmasını Başlat** başlıklı pencerede (başlığın başında kaynak adı yer alır) **Veri Türleri** listesinden aktarılacak türleri işaretleyin. En az bir tür seçmelisiniz, aksi hâlde "En az bir veri türü seçin." uyarısı çıkar.
**İçe Aktarma Modu** alanından aktarım biçimini seçin. Ayrıntılar bir sonraki bölümde.
**İçe Aktarmayı Başlat**'a tıklayın. **İçe aktarma başlatıldı** bildirimi aktarım numarasıyla (örneğin `#123`) görünür. Aktarım **İçe Aktarma Geçmişi** tablosuna eklenir.
Başlatma izni, sistemdeki en geniş etkiye sahip izinlerden biridir: hasta, randevu, satış, fatura, Lead ve kullanıcı kayıtları oluşturabilir. Bu izni yalnızca sorumlu kişilere verin.
## Veri türleri ve aktarım modu
### Veri türleri
Türleri hangi sırayla işaretlediğinizin önemi yoktur. Flextell bunları her zaman aşağıdaki sırayla işler, çünkü bazı türler diğerlerine bağlıdır.
| Sıra | Veri türü | Bilmeniz gerekenler |
| - | - | - |
| 1 | **Kullanıcı** | E-posta adresi sistemde varsa mevcut kullanıcıyla eşleşir, yoksa yeni kullanıcı oluşturulur. Mevcut kullanıcıların şifresi ve e-postası değiştirilmez. |
| 2 | **Tedavi** | Stella'dan gelen tedaviler 0 fiyatla ve pasif oluşturulur. Aktarımdan sonra fiyatlarını girip aktif yapın. Aynı tedaviyi yeniden aktarırsanız fiyatı 0'a, durumu pasife dönebilir; fiyatları girdikten sonra Tedavi türünü tekrar seçmeyin. |
| 3 | **Ürün** | Ürünler 0 fiyatla oluşturulur (birim: ADET). |
| 4 | **Oda** | Dr.DENTES'te Oda türü yoktur. Randevu aktarılırken diş ünitesi numaraları **Ünite 1**, **Ünite 2** gibi odalara dönüşür. |
| 5 | **Hasta** | Stella'da telefonu olmayan yeni hastalar atlanır. Telefonu zaten kayıtlı bir hasta varsa o kayıtla eşleşir. |
| 6 | **Lead** | Yeni Lead'ler aktif pipeline'ın giriş aşamasına yerleşir. Mevcut Lead'ler aşamasını korur. |
| 7 | **Hasta Notu** | İlgili hasta önce aktarılmış olmalıdır. |
| 8 | **Randevu** | İlgili hasta önce aktarılmış olmalıdır. Saatler klinik saat dilimine göre yorumlanır. |
| 9 | **Banka Hesabı** | Hesaplar TRY olarak oluşturulur. |
| 10 | **Satış** | İlgili hasta önce aktarılmış olmalıdır. |
| 11 | **Fatura** | Faturanın hastası önce aktarılmış olmalıdır; fatura, varsa ilgili satışa bağlanır. Stok düşümü yapılmaz. |
| 12 | **Muhasebe İşlemi** | Yalnızca bir kez aktarılır, sonradan güncellenmez. |
| 13 | **Hasta Dosyaları** | Her zaman en sonda işlenir ve yalnızca daha önce aktarılmış hastaların dosyalarını alır. |
Hasta, Randevu, Satış gibi birbirine bağlı türleri aynı aktarımda seçin. Hasta daha önce başka bir aktarımda taşındıysa o eşleşme korunur, bu durumda yalnızca bağlı türü seçmeniz yeterlidir.
Aktarılan hasta, randevu, satış, not ve dosyalar kaynak sistemdeki oluşturma ve değiştirme tarihlerini korur.
### Dr.DENTES için ek kurallar
* Aktarılan randevular, bugünden 120 ay öncesinden 12 ay sonrasına kadar olan aralığı kapsar. İptal edilmiş randevular da gelir.
* Hekimler kullanıcı olarak aktarılır. E-posta adresi veya adı olmayan hekim atlanır.
* Aynı ada sahip bir tedaviniz varsa dokunulmaz (fiyatı ve durumu korunur). Yoksa pasif ve 0 fiyatla oluşturulur.
* Aynı telefonu paylaşan aile üyeleri birleştirilmez. İkinci hasta kartı telefonsuz kaydedilir ve numara adres alanına `Telefon No: ...` notu olarak yazılır.
### Aktarım modu
**İçe Aktarma Modu** alanı yalnızca kaynak birden fazla modu destekliyorsa görünür.
| Mod | Ne yapar |
| - | - |
| **Sadece değişenler** | Son içe aktarmadan bu yana değişen kayıtları getirir. Varsayılan seçimdir. |
| **Tam içe aktarma** | Filtre uygulamadan tüm kayıtları yeniden tarar. |
"Sadece değişenler" modu Stella'da şu türlerde uygulanır: Hasta, Randevu, Satış, Hasta Notu, Muhasebe İşlemi ve Fatura. Diğer türler her seferinde baştan okunur. Dr.DENTES her zaman tam eşitleme yapar.
Aynı kaydı yeniden aktarmak çoğaltma yapmaz. Flextell kaynak sistemdeki kayıt numarasını hatırlar ve eşleşen kaydı günceller. Bu eşleşmeler kurulumu kaldırıp yeniden kursanız bile korunur.
### Seçenek: ziyareti olmayan hastaların dosyaları
**Hasta Dosyaları** seçiliyse **Ziyareti olmayan hastaların dosyalarını atla** anahtarı görünür. Açıkken kaynak sistemde son ziyaret tarihi olmayan hastaların dosyaları çekilmez. Bu içe aktarmada hiç hasta işlenmediyse güvenli geri dönüş olarak tüm hastalar işlenir.
## İlerleme ve geçmiş
Sayfanın alt bölümündeki **İçe Aktarma Geçmişi** tablosu tüm aktarımları, yeniden eskiye sıralı gösterir.
| Sütun | Açıklama |
| - | - |
| **İçe Aktarma** | Kaynağın adı |
| **Durum** | Aktarımın durumu (aşağıdaki tablo) |
| **İlerleme** | Yüzde, işlenen/toplam sayısı ve ilerleme çubuğu |
| **İşlenen** | `işlenen / toplam` |
| **Başlangıç**, **Bitiş** | Başlangıç ve bitiş zamanı |
**Durum** süzgeciyle tabloyu daraltabilir, **Durum** ve **İşlenen** sütunlarına göre sıralayabilirsiniz. Üstteki **Kaynak ara...** kutusu yalnızca kaynak kartlarını süzer, tabloyu değil.
| Durum | Anlamı |
| - | - |
| **Bekliyor** | Aktarım oluşturuldu, henüz başlamadı. |
| **İşleniyor** | Aktarım çalışıyor. |
| **Tamamlandı** | Tüm veri türleri işlendi. |
| **Başarısız** | Ciddi bir hata oluştu veya aktarım 15 dakika boyunca hiç ilerlemedi. |
| **İptal Edildi** | Bir kullanıcı aktarımı iptal etti. |
İlerleme kendiliğinden yenilenmez. Güncel durumu görmek için sayfa başlığındaki yenile düğmesine tıklayın. Aktarım süresi kaynaktaki veri miktarına ve kaynak yazılımın hız sınırlarına göre değişir.
**Tamamlandı** durumu her veri türünün sorunsuz aktarıldığı anlamına gelmez. Bir veri türü hata verse bile aktarım **Tamamlandı** olarak kapanabilir. Aktarımdan sonra hasta, randevu ve satış sayılarını kaynak sistemle karşılaştırın.
### Aktarımı iptal etme
Aktarım **Bekliyor** veya **İşleniyor** durumundayken satırın menüsünden **İçe Aktarmayı İptal Et**'i seçin. Bu işlem **İptal Et** izni gerektirir. Onay penceresinde **İçe Aktarmayı İptal Et**'e tıklayın, "#123 numaralı içe aktarma iptal edildi" gibi (kendi aktarım numaranızla) bir bildirim görünür. İptal edilen aktarımda o ana kadar aktarılmış kayıtlar Flextell'de kalır. Aktarımı yeniden başlatmanız gerekir.
Aynı kaynakta aynı anda yalnızca bir aktarım çalışabilir. Biri sürerken yenisini başlatırsanız "Bu içe aktarma kaynağı için zaten bir aktarım çalışıyor." hatası alırsınız.
## Hatalar ve atlanan kayıtlar
Aktarım sırasında tek bir kayıt sorun çıkarırsa Flextell o kaydı kaydeder (hata) veya nedenini belirterek atlar, sonra diğer kayıtlara devam eder. Aktarım bu yüzden durmaz.
Panel bu listeleri şu anda göstermez. Hata ve atlanan kayıt listeleri API üzerinden alınır, ayrıntılar için [İçe aktarma API kaynağı](/api/kaynaklar/ice-aktarma) sayfasına bakın. Bunun için **İçe Aktarım Detayı** izni gerekir. Panelde yalnızca durum ve ilerleme sayıları görünür.
Atlanan kayıtların başlıca nedenleri:
| Atlama nedeni | Ne zaman olur | Ne yapmalısınız |
| - | - | - |
| `missing_phone` | Stella'da yeni hastanın telefonu yok | Kaynak sistemde telefonu tamamlayıp yeniden aktarın |
| `customer_not_found` | Not, fatura veya muhasebe işleminin hastası aktarılmamış | Önce **Hasta** türünü aktarın |
| `missing_customer_mapping` | Randevu veya satışın hastası aktarılmamış ya da kaynakta silinmiş | Önce **Hasta** türünü aktarın |
| `empty_note_content` | Hasta notu boş | Gerekmez |
| `account_not_found` | Muhasebe işleminin hesabı eşleşmedi | Önce **Banka Hesabı** türünü aktarın |
| `customer_id_missing` | Faturada hasta bilgisi yok | Kaynak sistemde kontrol edin |
| `stella_record_unreachable_5xx` | Stella o fatura aralığı için hata döndürdü | Aktarımı yeniden başlatın |
| `missing_url` | Hasta dosyasının adresi yok | Gerekmez |
| `no_recorded_visit` | Ziyareti olmayan hastanın dosyaları (seçenek açıkken) | Gerekmez, seçeneği kapatarak yeniden aktarın |
| `missing_email`, `missing_name` | Dr.DENTES hekiminin e-postası veya adı yok | Kaynak sistemde tamamlayın |
| `missing_patient` | Dr.DENTES'te hasta kartı ve telefonu olmayan randevu | Kaynak sistemde kontrol edin |
Kök nedeni düzelttikten sonra aktarımı yeniden başlatın. Eşleşen kayıtlar güncellenir, çoğaltma olmaz.
### Aktarım Başarısız olursa
* **Dr.DENTES:** Çoğunlukla API anahtarı, adres veya IP izin listesi sorunudur. **Bağlantı** düğmesinden bilgileri güncelleyin ve Dr.DENTES'ten IP izninin verildiğini doğrulayın.
* **Stella:** Önce **Base URL**, **Kullanıcı Adı**, **Şifre** ve **API Key** değerlerini kontrol edin.
* Bir aktarım 15 dakika boyunca hiç ilerlemezse sistem onu otomatik olarak **Başarısız** yapar. Başarısızlık görünür olana kadar bu süre geçebilir.
* Sorun sürerse aktarım numarasını (örneğin `#123`) destek ekibine iletin.
## İlgili sayfalar
Bağlantılar menüsündeki diğer bağlantılar.
Aktarılan hastaların kartı ve İçe Aktarılmış Kayıt şeridi.
İçe Aktarım izinlerini rollere atama.
Aktarımları, hataları ve atlanan kayıtları API ile alın.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.