ETA'dan Veri Almak ve ETA'ya Veri Yazmak: V.11 API, ODBC ve Transfer

Şöyle bir durum düşünün. Firmanız yıllardır ETA kullanıyor, muhasebe ve stok oturmuş durumda. Web sitesinden sipariş gelmeye başladı, saha ekibi tahsilatı telefondan girmek istiyor, yönetim de her sabah güncel satış raporunu görmek istiyor. Üç istek de aynı soruya çıkıyor: ETA'daki veriye dışarıdan nasıl ulaşılır ve ETA'ya dışarıdan nasıl kayıt gönderilir?

Bu sorunun cevabı tek bir cümle değil, çünkü okumak ile yazmak ETA'da iki ayrı yoldan yürüyor. Bu yazı o iki yolu, hangi işin hangisinden geçtiğini ve başlamadan önce neyi teyit etmeniz gerektiğini anlatıyor.

Önce Hangi ETA Kurulu?

ETA tarafında ürün adları birbirine yakın olduğu için ilk karışıklık burada çıkar. ETA:SQL ve ETA:V.8-SQL, ETA'nın DOS ve Windows dönemindeki paketlerinin ardından geliştirdiği SQL tabanlı ürün hattıdır. ETA:V.11 ise daha yeni üründür; SB, standart V.11 ve PRO olmak üzere farklı ölçeklerde sunulur. ETA:SQL ve ETA:V.8-SQL, MS SQL Server üzerinde çalışır. V.11 için sürüme özel gereksinimler kurulumda teyit edilir.

ETA modüler bir üründür. Stok, Cari, Fatura, Muhasebe, Sipariş, İrsaliye, Kasa, Banka, Üretim gibi modüllerin yanında Transfer ve Veri Aktarma da ayrı birer modül olarak listelenir. Bu ayrıntı önemlidir, çünkü ETA:SQL ve V.8-SQL'de dışarıdan veri göndermenin resmi yolu bu iki modülden geçer ve ikisi de lisansınızda bulunmayabilir.

ETA:V.11'de ise tablo değişiyor. ETA Bilgisayar, V.11 için "ETAV11 REST API" adıyla bir programlama arayüzü yayımlıyor; belgesi ETA Bilgi Merkezi'nde herkese açık. Bu API'yi kullanmak için güncel sürüm, lisansta API Entegrasyon opsiyonu ve kullanıcı lisansı gerekiyor; ETA'nın 2026 fiyat listelerinde bu opsiyon V.11, V.11 Pro ve V.11 SB'nin üçünde de yer alıyor. ETA:SQL ve V.8-SQL için bu API'nin geçerli olduğuna dair bir belge bulamadık.

Yani "ETA kullanıyoruz" demek, entegrasyonun nasıl kurulacağını belirlemeye yetmez. Ürün adı, sürüm ve lisanslı modül listesi bilinmeden yöntem seçilemez.

Okuma: ODBC ve Açık Veritabanı

ETA'nın bu alandaki duruşu, benzer programların çoğundan farklıdır. Üretici, açık veritabanı kullanımını ve ODBC sürücüsünü kendi tanıtımında öne çıkarır. Excel, Word ve Access gibi programlarla doğrudan bağlantı kurulabildiği, başka firmaların yazılımlarıyla birlikte çalışılabildiği açıkça belirtilir.

Bunun pratik anlamı şudur: raporlama için veriyi doğrudan okumak ETA'da tartışmalı bir alan değildir. Satış analizi, stok yaşlandırma, cari yaşlandırma ya da yönetim paneli gibi işler bu yoldan kurulabilir.

Okuma tarafında dikkat edilmesi gereken üç nokta vardır.

Şirket kodu ve çalışma dönemi

ETA'da veri düzeninin merkezinde iki kavram bulunur: şirket ve çalışma dönemi. Şirketler etasqlsys aracıyla açılır, her şirkete çalışma dönemleri tanımlanır ve takip "şirket kodu + dönem" ikilisiyle yürür. Kurulum sırasında bir ana veritabanı adı sorulur, bağlantı parametreleri de ETASQLCON aracıyla yönetilir.

Bu ayrımın fiziksel olarak nasıl kurulduğu, yani ayrı veritabanı mı, ayrı tablo seti mi yoksa kolon bazlı bir ayrım mı olduğu kamuya açık kaynaklarda net biçimde belgelenmiş değildir. Bu yüzden hangi şirketin ve hangi dönemin verisine hangi bağlantıdan erişileceği, varsayımla değil kurulumunuz üzerinde netleştirilir. Bu adım atlanırsa rapor hata vermez, yanlış toplam üretir.

Tablo adları bir kalıba oturur

ETA'da tablo adları rastgele değildir. Kartlar KART, fiş başlıkları FIS, hareket satırları HAR ekiyle biter. CARKART, FATFIS, STKHAR gibi adlar bu kalıbın örnekleridir. Bu kalıbı bilmek bir kurulumu incelerken yön bulmayı kolaylaştırır. Yine de kesin tablo listesi sürümden sürüme değişebildiği için, kullanılacak adlar kurulumun kendisinden çıkarılır.

Ağır sorgu canlı sistemi yormamalı

Aynı veritabanı hem ETA kullanıcılarına hem rapor sorgularına hizmet eder. Gün ortasında çalışan ağır bir rapor, programı kullanan kişiyi bekletir. Bu yüzden sık sorulan özetler belirli aralıklarla üretilip hazır tutulur, her ekran açılışında baştan hesaplanmaz.

Yazma: Transfer ve Veri Aktarma Modülleri

ETA:SQL ve V.8-SQL'de dışarıdan veri göndermenin resmi yolu dosya tabanlıdır ve iki modül üzerinden yürür: Transfer Modülü ve Veri Aktarma Modülü. Desteklenen biçimler TXT, XLS, CSV ve XML'dir. V.11'de de API belgesinde yer almayan kayıtlar, örneğin muhasebe fişi, bu yoldan gönderilir.

Bu yoldan aktarılabilen veriler arasında stok kartı ve fiyat bilgileri, cari kartlar, hesap planı, fatura hareketleri ile nakit, çek ve senet hareketleri bulunur. Akış tek yönlü değildir. ETA'dan dışarıya da veri çıkarılabilir; stok ve fiyat bilgisinin yazarkasa ve POS cihazlarına aktarılması bu yolla yapılır.

XML ile muhasebe fişi

Dışarıda oluşan muhasebe fişleri XML olarak aktarılabilir. Menü yolu şöyledir: Veri Aktarma, Aktarma İşlemleri, ETA Dosya Aktarımı, Fiş Aktarma, Muhasebe Fişi, Dosyadan Fişe Aktarma (xml). Entegrasyon tarafında yapılacak iş, kaynak sistemin verisini beklenen XML yapısına çevirmek, göndermeden önce doğrulamak ve aktarımın sonucunu izlenebilir kılmaktır.

Metin dosyası ve tanım dosyası

Metin dosyasıyla transferde ETA'nın kendine özgü bir yaklaşımı vardır. Metin tipi olarak "Eta Tanımlı" seçildiğinde, dosyanın nasıl okunacağını anlatan bir tanım dosyası devreye girer. Bu dosya .dfn uzantılıdır. Nakit, çek, senet ya da cari hareket verisini taşıyan metin dosyaları bu tanıma göre okunur.

Bu yapının entegrasyon açısından bir faydası vardır: dosya düzeni değiştiğinde yapılacak iş çoğu zaman kod değişikliği değil, tanım güncellemesidir.

Doğrudan veritabanına yazmak

ETA'da veritabanının açık olması, oraya kayıt yazmanın desteklendiği anlamına gelmez. Üreticinin açık veritabanı vurgusu okuma bağlamında geçer. Doğrudan veritabanına yazmanın desteklenen bir kullanım olduğuna dair bir belge bulamadık. Bu durumda doğru yol, belgelenmemiş bir yöntemi varsaymak değil, ürünün kendi aktarım modüllerini kullanmaktır.

V.11'de Yazma: ETAV11 REST API

V.11 API'si oturumla çalışır. Önce şirket kodu, dönem ve işyeri bilgisiyle giriş yapılır, dönen süreli anahtar sonraki isteklerde kullanılır. Her oturum bir kullanıcı lisansı tutar; iş bitince oturumun kapatılması gerekir, yoksa ofisteki bir kullanıcı programa girmekte zorlanabilir.

23 Ekim 2026'da okuduğumuz v3.1 belgesinde stok, cari, kasa ve banka kartları ile stok, cari ve kasa fişleri; fatura, irsaliye ve sipariş belgeleri yer alıyor. Fatura, irsaliye ve siparişte kayıttan önce çalışan bir Kontrol metodu var: ETA'nın hesapladığı tutarlar ya da bulduğu hata kayıt yapılmadan döner. Dış sistemden gelen belgeyi önce bu metoda göndermek, tutar farkını muhasebeye ulaşmadan yakalamanın en kolay yoludur.

Varsayılan ayarda aynı IP adresinden dakikada 60 istek kabul ediliyor. Bu yüzden toplu raporlama API yerine ODBC ile yapılır, API kayıt bazında yazma için kullanılır.

Hangi İş Hangi Yoldan?

Bu tablonun dışında kalan bir istek varsa, örneğin anlık çift yönlü senkron, önce bunun ETA'nın sunduğu yollarla karşılanıp karşılanmadığına bakılır. Dosya tabanlı aktarım belirli aralıklarla çalışır; saniyeler içinde güncellenen bir akış beklentisi baştan konuşulmalıdır.

Başlamadan Önce Kontrol Listesi

ETA entegrasyonu planlarken aşağıdaki bilgilerin hazır olması, keşif görüşmesini kısaltır:

1. Ürün ve sürüm adı: ETA:SQL, ETA:V.8-SQL ya da ETA:V.11
2. Tanımlı şirket sayısı ve çalışma dönemleri
3. Lisanslı modüller: V.11'de API Entegrasyon opsiyonu, tüm sürümlerde Transfer ve Veri Aktarma
4. Verinin yönü: yalnızca okuma mı, yazma da var mı
5. Güncelleme sıklığı beklentisi: günde bir, saatte bir ya da daha sık
6. ETA sunucusuna erişim biçimi: yerel ağ, uzak bağlantı, güvenlik duvarı kuralları

Üçüncü madde projenin yönünü tek başına değiştirebilir. API opsiyonu ya da aktarım modülü lisansta yoksa yazma tarafı baştan farklı planlanır. Lisans kapsamını yetkili ETA bayinizle teyit etmeniz gerekir.

Tipik Hatalar

Bu tür projelerde tekrar eden hatalar genellikle teknik beceri eksikliğinden değil, atlanan bir teyitten kaynaklanır.

• Dönem filtresini unutmak. Yıl değiştiğinde rapor eski dönemi göstermeye devam eder ve kimse hata mesajı görmez.
• Tablo adını tahmin etmek. Kalıp yön gösterir, ama kesin ad kurulumdan okunmalıdır.
• Aktarım sonucunu kontrol etmemek. Dosya gönderildi diye kayıt oluşmuş sayılmaz. Reddedilen satırların listelenmesi gerekir.
• Aynı dosyayı iki kez göndermek. Mükerrer kayıt oluşmaması için gönderilen her parti işaretlenir.
• Sürüm yükseltmesini plana yazmamak. Yükseltme sonrası dosya yapıları ve bağlantı parametreleri birkaç örnek kayıtla doğrulanmalıdır.

Sıkça Sorulan Sorular

ETA'nın REST API'si var mı?

ETA:V.11 için var. ETA Bilgisayar "ETAV11 REST API" adlı bir REST API yayımlıyor ve belgesi ETA Bilgi Merkezi'nde herkese açık. Kullanmak için güncel V.11 sürümü, API Entegrasyon opsiyonu ve kullanıcı lisansı gerekiyor. ETA:SQL ve V.8-SQL için bu API'nin geçerli olduğuna dair belge bulamadık; bu sürümlerde okuma ODBC ile, yazma Transfer ve Veri Aktarma modülleriyle yapılır.

ETA verisini Excel'e canlı bağlayabilir miyim?

Evet. ODBC bağlantısı üreticinin tanıtımında yer alan bir özelliktir ve Excel bu bağlantı üzerinden veri çekebilir. Rapor birden fazla kişi tarafından kullanılacaksa, yetkiye göre farklı görünüm ya da geçmişe dönük karşılaştırma gerekiyorsa araya bir rapor katmanı koymak daha sağlıklı olur.

Web sitemden gelen sipariş ETA'ya otomatik düşebilir mi?

Düşebilir. V.11'de API Entegrasyon opsiyonu varsa sipariş, kayıttan önce Kontrol metoduyla doğrulanıp API üzerinden tek tek yazılır. Eski sürümlerde sipariş verisi ETA'nın beklediği dosya biçimine çevrilir ve aktarım modülüyle belirli aralıklarla içeri alınır. Her iki durumda da ilgili opsiyonun ya da modülün lisansınızda olması gerekir.

Birden fazla şirketimiz var, tek raporda birleştirilebilir mi?

Birleştirilebilir. Her şirket ve dönem için veri ayrı ayrı okunur, rapor katmanında bir araya getirilir. Hangi rakamın hangi şirket ve dönemden geldiği raporda izlenebilir olmalıdır.

ETA bayisi misiniz?

Hayır. D'Cloud Software hiçbir yazılım üreticisinin bayisi ya da çözüm ortağı değildir. Lisans, kurulum ve ürün eğitimi yetkili bayinizin alanıdır. Bizim yaptığımız iş, ürünün belgelenmiş yolları üzerinden çalışan yazılımı geliştirmektir.

Teslimden sonra destek nasıl işliyor?

Teslim sonrası 15 gün ücretsiz hata düzeltme sözleşmeye yazılır. Sürüm yükseltmesi sonrası doğrulama gibi tekrar eden işler ayrı bir bakım maddesinde tanımlanır.

Sonuç

ETA'da okuma ile yazma arasındaki çizgi nettir. Okuma için ODBC ve açık veritabanı erişimi üreticinin kendi öne çıkardığı bir özelliktir. Yazma için V.11'de REST API, ETA:SQL ve V.8-SQL'de Transfer ve Veri Aktarma modülleri belgelenmiş yoldur. Projenin ilk adımı kod yazmak değil, sürümü, şirket ve dönem yapısını, API opsiyonunu ve lisanslı modülleri teyit etmektir.

ETA kurulumunuzu web sitenize, saha uygulamanıza ya da bir yönetim paneline bağlamak istiyorsanız, mevcut durumunuzu birlikte değerlendirmek için iletişime geçin.