DİA bağlama

DİA, bulut tabanlı bir kurumsal yönetim (ERP) sistemidir; bağlantı DİA'nın resmî web servisiyle kurulur. Kurulacak hiçbir program yoktur.

Beta: DİA bağlantısı programın resmî kılavuzuna göre hazırlandı, ancak henüz gerçek bir hesapta uzun süre kullanılmadı. Panelde kartında Beta yazar. İlk aktarılan birkaç faturayı ve cari kaydı DİA tarafında kontrol etmenizi öneririz; bir uyumsuzluk görürseniz destek talebi açın, birlikte hemen düzeltelim.

Gerekenler

• Sunucu kodu — DİA'ya giriş yaptığınız adresteki ad: https://SUNUCUKODU.ws.dia.com.tr
• Kullanıcı adı ve şifre — DİA'da tanımlı, "Web Servis Çağırabilir" yetkisi açık bir kullanıcı. Kullanıcının cari, stok ve fatura ekranlarında da yetkisi olmalıdır (web servis, masaüstünde yapamadığınız işlemi yapamaz).
• API anahtarı — DİA'dan siz alırsınız; Senkronia adına ortak bir anahtar ya da iş ortaklığı yoktur. [email protected] adresine "Senkronia entegrasyon platformu ile cari, stok ve satış faturası aktarımı için web servis API anahtarı istiyorum" diye bir e-posta yazın; DİA yetkilisi dönüş yapıp anahtarı iletir. Anahtar yalnız girişte kullanılır.
• Firma kodu — isteğe bağlı. Boş bırakırsanız panel, kullanıcınızın yetkili olduğu firmayı DİA'dan okur (tek firmanız varsa o, birden çoksa DİA'daki öntanımlı firma) ve dönemi de öntanımlı dönemden alır. Başka bir firmayı bağlamak isterseniz DİA App > Firma Listesi'ndeki gerçek firma kodunu (görünen kod değil) yazın.
• Denemek için: DİA'nın ücretsiz Web Service Tester aracıyla (doc.dia.com.tr > Test Aracı) kullanıcı adı, şifre ve anahtarınızın çalıştığını panele girmeden önce görebilirsiniz.

Bilinmesi gerekenler

• Kontör: DİA, her web servis çağrısı için kendi kontörünüzden 0,0125 düşer (giriş ve çıkış hariç). Panel gereksiz çağrı yapmaz ve listelerde yalnız gereken kolonları çeker; kontör hareketlerinizi DİA'daki Kontör Hareketleri ekranından izleyebilirsiniz.
• Kullanıcınızda "İzin Verilen IP'ler" tanımlıysa listeye Senkronia sunucusunu (185.149.102.118) ekleyin; yoksa bağlantı reddedilir.
• Dönem: ayarlarda dönem kodu boş bırakılırsa DİA'daki öntanımlı dönem kullanılır. Yeni döneme geçtiğinizde DİA'daki öntanımlı dönemi güncellemeniz yeterlidir.

Bağlandıktan sonra

Sipariş ekranında Muhasebe kartı çıkar. Aktarımda panel:

1. Müşteriyi DİA'da vergi numarasıyla arar; bulamazsa kendi verdiği kodla arar, o da yoksa cari kart açar (mükerrer cari açılmaz),
2. Fatura satırlarındaki stok kodlarını denetler; DİA'da olmayan kart varsa açar,
3. Satış faturası kaydeder (kargo bedeli ve kapıda ödeme komisyonu ayrı satır, sipariş indirimi satırlara dağıtılmış hâlde).

Diğer kurallar

• Fiyatlar KDV hariç + KDV tutarı ayrı gönderilir; çevrimi panel yapar.
• Aynı sipariş iki kez aktarılmaz (idempotent).
• DİA'da anlık bildirim (webhook) yoktur; aktarım siparişten tetiklenir.
• Her müşteri kendi DİA hesabını bağlar; verileriniz kendi DİA sunucunuzda kalır.