DİA entegrasyonu:
siparişin faturası kendiliğinden kesilir.

DİA entegrasyonu nedir, hangi işletmeye uygun düşer?

DİA, 2004'te kurulan DİA Yazılım Sanayi ve Ticaret A.Ş.'nin geliştirdiği, tamamen bulutta çalışan bir ERP ve ticari yazılım ailesidir. Şirketin kendi tanıtımına göre muhasebe, stok ve depo, satış ve satın alma ile üretim süreçleri tek sistemde toplanır; Ar-Ge birimi Ankara ODTÜ Teknokent'tedir. İtalyan TeamSystem grubu 8 Nisan 2026 tarihli basın bülteninde DİA Yazılım'ı bünyesine kattığını duyurdu; ürün adı ve servis adresleri DİA olarak sürüyor.

Pazaryeri satıcısı açısından iki özellik öne çıkar. Birincisi, veriler DİA'nın bulutunda durduğu için ofisteki bir sunucuyu internete açmanız gerekmez; bağlantı size özel SUNUCUKODU.ws.dia.com.tr adresi üzerinden kurulur. İkincisi, DİA Yazılım GİB'in yayımladığı e-Fatura ve e-Arşiv özel entegratör listelerinde yer alır; faturayı kestiğiniz program ile e-belgeyi ileten altyapı aynı firmadan gelebilir.

DİA'nın kendi pazaryeri modülü ile ayrı bir panel arasındaki fark

DİA'nın e-ticaret sayfası, pazaryeri siparişlerini DİA ERP'ye aktaran ve DİA stoklarını pazaryeri ürünleriyle eşleştiren kendi modülünü anlatıyor. Bu modülü kullanıyorsanız ikinci bir sipariş akışı kurmak çift kayıt riski doğurur; ikisinden birini seçmek gerekir. Yox İş Ortağım'ı DİA'nın yanında düşünmenin anlamlı olduğu durumlar şunlardır:

• Satış kanallarınız birkaç büyük pazaryeriyle sınırlı değil; panelde tanımlı 80 satış kanalından yurt dışı pazaryerlerini, e-ticaret altyapılarını ve katalog kanallarını aynı stok kartından yönetmek istiyorsunuz.
• Sipariş, kargo ve iade işini depo ekibi panelde yürütecek, muhasebe kaydı ise DİA'da kalacak.
• Kanal başına fiyat farkı, stok çakışmaları listesi ve hakediş mutabakatı gibi pazaryeri operasyonu araçlarına ihtiyacınız var.

Yox İş Ortağım DİA ile hangi işleri yapar, hangilerini yapmaz?

Panelin DİA ile yaptığı iş üç işlemle sınırlıdır: siparişi DİA'ya aktarmak, DİA'daki stok miktarını panele çekmek ve siparişin satış faturasını DİA üzerinden kesmek. Hangisini açacağınızı siz seçersiniz; örneğin yalnız stok çekmeyle başlayıp sipariş aktarımını ilk günlerde elle kontrol ettikten sonra otomatiğe alabilirsiniz.

Panelin DİA tarafında yapmadığı işler

• Cari kart aktarımı yoktur. Sipariş alıcı bilgileriyle gider; DİA'nın bu siparişten cari kart açması ya da mevcut karta bağlaması DİA tarafındaki ayarınıza bağlıdır, kurulumda birlikte bakarız.
• Ürün ya da stok kartı aktarılmaz. Ürünler stok koduyla eşleşir; kartlar DİA'da ve panelde ayrı ayrı tutulur.
• Panelden ayrı bir e-Fatura sağlayıcısıyla kesilen fatura DİA'ya fatura kaydı olarak aktarılmaz; DİA'ya yalnız sipariş gider.
• Panel DİA'daki muhasebe fişlerine, tahsilat kayıtlarına ya da mali raporlara dokunmaz; bu kayıtlar DİA'da ve mali müşavirinizle yürür.

DİA web servisi nasıl çalışır: oturum, firma-dönem ve kontör

DİA web servisi, JSON gövdeli REST çağrılarıyla veri okuma, ekleme, güncelleme ve silme yapılan bir arayüzdür; DİA'nın geliştirici dokümanı (doc.dia.com.tr) servisleri modül modül listeler. Bağlanan taraf önce login çağrısıyla oturum açar ve dönen oturum kimliğini (session_id) sonraki çağrılarda kullanır. Aşağıdaki tablo dokümandaki kuralları ve bunların DİA ERP entegrasyonu açısından anlamını özetler.

Firma ve dönem kodunun gerçek değeri

DİA'da firma ve dönemlerin ekranda görünen bir kodu, servislerde kullanılan bir de gerçek (sayısal) kodu vardır. Dokümana göre servise gönderilecek firma kodu Firmalar (sis3000) listesinde, dönem kodu ise firma kartının Dönem Bilgileri bölümünde bulunur. DİA Web Service Tester aracında Yetkili Firma Dönemler düğmesi (F7) de kullanıcının yetkili olduğu firmaları, dönemleri, şubeleri ve depoları tek listede gösterir. Görünen kodu girmek en sık rastlanan kurulum hatasıdır.

Kontör nasıl harcanır, nasıl izlenir

DİA web servis çağrıları kontörle ücretlendirilir: her çağrıda 0,0125 kontör düşer. Kalan bakiye DİA masaüstü uygulamasındaki Kontör Hareketleri (msj1900) ekranında görünür; yükleme aynı ekrandan yapılır ve hangi servisin ne zaman çağrıldığı izlenir. Örnek hesap: ayda 2.000 siparişin her biri için bir sipariş ekleme ve bir fatura ekleme çağrısı yapılırsa 4.000 × 0,0125 = 50 kontör eder; stok listeleme çağrıları buna ayrıca eklenir. Kontörün birim fiyatını DİA'dan ya da DİA iş ortağınızdan öğrenin.

DİA entegrasyonu için gereken bilgiler ve kullanıcı yetkileri

Panelin Muhasebe bölümünde DİA için altı alan bulunur. Sunucu kodu, kullanıcı adı ve şifre zorunludur; API anahtarı, firma kodu ve dönem kodu isteğe bağlı görünür. Yine de firma ve dönem kodunu girmenizi öneririz; boş kaldığında kaydın hangi firmaya yazılacağı DİA'daki öntanımlara kalır.

Entegrasyon kullanıcısını hazırlamak

DİA'nın e-ticaret entegrasyonu için yayımladığı yol haritası işe, firma yetkilisinin vereceği ayrı bir kullanıcıyla başlar. Bu kullanıcıya yalnız gereken yetkileri vermek hem güvenliği hem de hata ayıklamayı kolaylaştırır:

1. DİA'da entegrasyon için ayrı bir kullanıcı tanımlayın ve kullanıcı kartında Web Servis Çağırabilir seçeneğini işaretleyin.
2. Çalışılacak firmada Sipariş Ekleme, Fatura Ekleme ve Stok-Malzeme Listeleme yetkilerini açın; dokümanda her servis bu yetki kodlarından birine bağlıdır.
3. Kullanıcıya İzin Verilen IP'ler tanımlayacaksanız panelin bağlanacağı adresi kurulumda bizden isteyin.
4. API anahtarınız yoksa DİA'ya başvurun; anahtar, uygulama ve kullanım amacı bildirildikten sonra DİA'nın yetkili ekibi tarafından verilir.
5. Bu kullanıcıyla başka bir yerden oturum açmayın; login çağrısı aynı kullanıcının açık bağlantısını koparabildiği için iki taraf birbirini düşürebilir.

Pazaryeri siparişi DİA'ya nasıl ulaşır, fatura hangi aşamada kesilir?

Panelde bütün kanalların siparişleri tek listeye düşer ve Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim durumlarından geçer. DİA tarafındaki iki işlem bu durumlara bağlıdır ve ikisini ayrı ayrı açıp kapatabilirsiniz:

1. Sipariş Trendyol entegrasyonu ya da Hepsiburada bağlantısı gibi bir kanaldan resmî API ile panele gelir; satırlar barkod ya da stok koduyla panel ürün kartına eşlenir.
2. Sipariş Hazırlanıyor durumuna geçtiğinde otomatik fatura açıksa fatura kesme sıraya alınır. Panelde bağlı ayrı bir e-Fatura sağlayıcısı yoksa fatura DİA üzerinden düzenlenir ve sipariş Faturalandı olur.
3. Sipariş Faturalandı durumuna geçtiğinde otomatik ERP aktarımı açıksa sipariş DİA'ya, girdiğiniz firma ve döneme yazılır. Bu anahtar kapalıysa siparişleri listeden tek tek ya da toplu gönderirsiniz.
4. Her denemenin sonucu siparişin geçmişine yazılır; DİA hata döndürdüyse mesajı da orada görünür.

Otomatik fatura ve otomatik aktarım neden ayrı?

İki anahtarın ayrı olması geçiş döneminde esneklik verir. Faturayı bir süre daha DİA'da elle kesip yalnız stok çekmeyi açabilir, ya da faturayı panelden kesip siparişin DİA'ya yazılmasını ilk günlerde elle tetikleyebilirsiniz. Aynı siparişi hem elle hem otomatik girmek DİA'da çift kayıt doğurur; geçiş gününü ekibinizle netleştirin. Siparişin tutarını kanal kesintilerinden sonra kalan kârla karşılaştırmak için kâr hesaplama aracını kullanabilirsiniz.

Panelde ayrı bir e-Fatura sağlayıcısı bağlıysa

Panel faturayı önce bağlı e-Fatura sağlayıcısıyla keser, DİA'yı yalnız böyle bir sağlayıcı yoksa kullanır. e-Fatura sağlayıcısıyla kesilen faturanın PDF'i kanal destekliyorsa pazaryerine yüklenir; ama bu fatura DİA'ya kayıt olarak geçmez. DİA üzerinden kesilen faturada ise panel pazaryerine PDF yüklemez. İki programı birlikte bağlamak Kurumsal paket gerektirir; e-belge tarafını ayrı bir sağlayıcıyla yürütmek isterseniz Nilvera entegrasyonu sayfası o yolu anlatır.

DİA üzerinden kesilen fatura e-Fatura mı, e-Arşiv mi olur?

Belge türünü alıcı belirler. GİB'in yayımladığı 509 Sıra No'lu VUK Genel Tebliği'ne göre e-Fatura uygulamasına kayıtlı alıcıya e-Fatura, kayıtlı olmayan mükellefe ve bireysel alıcıya e-Arşiv Fatura düzenlenir. DİA'nın web servis dokümanı da e-Fatura kullanıcıları listesinde bulunmayan her carinin e-Arşiv olarak işlenebileceğini yazar. Bireysel alıcıya giden pazaryeri siparişlerinde belge bu yüzden e-Arşiv olur.

DİA'da kontrol edilecek e-belge ayarları

• e-Faturaların entegratöre otomatik gönderilmesi için DİA'daki efa.01.23 numaralı sistem parametresi açık olmalıdır.
• e-Arşiv faturaların entegratöre iletilmesi, DİA dokümanına göre web servis çağrısındaki ayrı bir parametreye bağlıdır; ilk faturada belgenin entegratöre ulaşıp ulaşmadığını birlikte kontrol ederiz.
• e-Fatura ve e-Arşiv için DİA'da kayıt numara şablonları tanımlı olmalıdır; uygun belge numarası bu şablonlardan üretilir.
• Panelden giden her satırda KDV oranı bulunur; DİA'daki stok kartının oranıyla aynı olduğunu ilk faturada doğrulayın. Dahil ve hariç tutarları KDV hesaplama aracıyla karşılaştırabilirsiniz.

İnternet satışı faturasında bulunması gereken bilgiler

Aynı tebliğe göre internet üzerinden satış yapan e-Arşiv mükellefleri bu faturaları elektronik ortamda iletmek zorundadır. Faturada satışın yapıldığı web adresi, ödeme şekli ve ödeme tarihi, mal satışında gönderiyi taşıyanın adı ya da unvanı ile VKN/TCKN'si ve malın gönderildiği tarih bulunur; e-Arşiv faturada ayrıca iade bölümü ve “Bu satış internet üzerinden yapılmıştır.” ifadesi yer alır. Bu alanların DİA'daki fatura tasarımınızdan nasıl dolacağını DİA iş ortağınızla kontrol edin. İnternetten ya da pazaryerlerinden satış yapanlar için e-Fatura ve e-Arşiv'e geçiş eşiği 2022 ve sonraki hesap dönemlerinde 500 bin TL brüt satış hasılatıdır; kendi durumunuzu mali müşavirinizle teyit edin.

Stok çekme: DİA'yı satış kanallarının tek stok kaynağı yapmak

Stok çekme açıldığında DİA'daki miktar panele okunur ve stok koduyla eşleşen ürünlerde bütün satış kanallarının stoğu aynı karttan güncellenir. Bu düzen ana stok kaynağının DİA olması demektir: depodaki giriş ve çıkışları DİA'ya işlediğiniz sürece pazaryerlerindeki miktar da onu izler. Aynı ürünün stoğunu hem DİA'da hem pazaryeri panelinde elle değiştirmek fark yaratır.

DİA'nın kendi dokümanı, e-ticaret tarafında stoğun en güncel halini görmek için listeleme servisinin belirli aralıklarla çağrılmasını (örnek olarak 20 dakikada bir) yaygın çözüm olarak anlatır; çok sayıda stok kartında listelemeyi parçalara bölmeyi de önerir. Bu nedenle DİA'daki bir stok hareketinin pazaryerine yansıması çekme aralığına bağlıdır. Hızlı tükenen ürünlerde DİA kayıtlarını gün içinde güncel tutmak ve panelin kritik stok uyarısını izlemek aradaki boşluğu daraltır.

Depo, varyant ve paket ürünlerde kod düzeni

• DİA'da birden fazla şube ve depo varsa satışa açık miktarın hangi depodan geldiğini baştan netleştirin; ilk stok çekmede panelde görünen miktarı DİA'daki depo miktarlarıyla birlikte karşılaştırırız.
• Varyantlı ürünlerde her beden ve renk için ayrı stok kodu kullanın; eşleşme yalnız kod üzerinden yapılır.
• 5'li ya da 10'lu paket ilanları panelde tek stok biriminden düşer, set satışında stok bileşenlerden azalır; DİA'da yalnız tekil ürünün kodunu tutmanız yeterlidir.
• DİA'daki stok kodu ile pazaryerindeki barkod farklıysa eşleşmeyi kurulumda bir kez yapın; panel mevcut ilanları okur ve siz onaylamadan hiçbir ilanı değiştirmez.

DİA entegrasyonu hangi Yox İş Ortağım paketinde, kurulum nasıl ilerler?

Muhasebe, e-Fatura ve ERP bağlantıları Profesyonel paketten itibaren açılır; Başlangıç ve Büyüme paketlerinde bu bağlantı yoktur. Panelde tanımlı 51 muhasebe, e-Fatura ve ERP programından biri olan DİA, paketinizdeki program hakkından birini kullanır.

Yıllık ödemede %20 indirim uygulanır; ürün, kullanıcı ve rapor limitleri paket karşılaştırmasında yer alır. Kurulum şu sırayla ilerler:

1. Yox İş Ortağım'a başvurun; ön görüşmede kanallarınızı, DİA'daki firma yapınızı ve faturayı nerede keseceğinizi konuşuruz.
2. Satış kanallarınızı resmî API bilgileriyle bağlayın; mevcut ilanlar okunur ve barkod ya da stok koduyla eşleşir.
3. DİA'da entegrasyon kullanıcısını, yetkileri ve API anahtarını hazırlayın.
4. Sunucu kodu, kullanıcı adı, şifre, API anahtarı, firma ve dönem kodunu panelin Muhasebe bölümüne girip bağlantıyı test edin.
5. Faturanın hangi aşamada ve hangi seriyle kesileceğini belirleyin; ilk siparişi ve ilk faturayı DİA'da birlikte kontrol ettikten sonra otomatik akışı açın.

DİA hata kodları ve canlıya geçmeden önce kontrol listesi

DİA web servisi her yanıtta bir code ve bir msg alanı döndürür; 200 dışındaki her kod işlemin yapılmadığını gösterir. Panel aktarım ya da fatura hatasında DİA'nın mesajını siparişin geçmişine yazar. Aşağıdaki kodlar DİA'nın hata takibi sayfasından alınmıştır.

Canlıya geçmeden önce kontrol listesi

• Firma ve dönem kodu gerçek (sayısal) değerle girildi mi?
• Entegrasyon kullanıcısında Web Servis Çağırabilir işareti ile sipariş, fatura ve stok yetkileri açık mı?
• Kontör bakiyesi ilk ayın sipariş hacmini karşılıyor mu?
• Yeni mali dönem açıldığında dönem kodunu panelde güncellemeyi takvime yazdınız mı?
• Test siparişinde satırlar doğru stok kartını buldu mu; tutar ve KDV pazaryerindeki siparişle aynı mı?
• Geçiş günü DİA'ya elle sipariş girişi durduruldu mu?

Sorularınız için iletişim sayfasından bize ulaşabilir, DİA dışındaki muhasebe ve pazaryeri bağlantılarını entegrasyon ana sayfasında inceleyebilirsiniz.