AsyaTicari · Genel Muhasebe

Entegrasyon tanımları

Belgeler fişe dönüşürken hangi hesaba gideceğini belirleyen hesap kuralları ve olay türü başına fiş şablonları.

Genel Muhasebe → Entegrasyon tanımları Güncellendi: 18.11.2026

Bu ekran yakın zamanda değişti. 2026-11-19 tarihli kod değişikliğinden sonra görseller yeniden çekilecek; metin güncel, bazı görseller eski görünebilir.

Entegrasyon tanımları muhasebeleştirmenin kurallarını tutar. Her fiş satırının bir rolü vardır (cari, satış geliri, hesaplanan KDV, stok …). Hesap kuralları her rolün hangi hesaba gideceğini, Fiş şablonları ise bir olay türünde (satış faturası, tahsilat …) hangi rollerin borç / alacak çalışacağını belirler. Firmaya özel kural yoksa varsayılan kurallar çalışır.

Ekrana ulaşma

Sol menüden Genel Muhasebe → Entegrasyon tanımları'na tıklayın.

asyaticari · /muhasebe/entegrasyon
Entegrasyon tanımları ekranı
Şekil 1. Entegrasyon tanımları ekranı
  1. 1Hesap kuralları Fiş satırı rollerinin hangi hesaba gideceğini belirleyen kurallar.
  2. 2Fiş şablonları Olay türü başına fişin satır düzeni.
  3. 3Yeni kural Boş kural formu açar.
  4. 4Varsayılan kuralları düzenlemek için firmaya ko… Varsayılan kuralları firmaya kopyalar; sonra tek tek düzenlenebilir.
  5. 5Kural listesi Rol, koşullar, hesap deseni, öncelik.

Hesap kuralları

Bir rol için birden çok kural olabilir: en çok koşulu sağlayan kural kazanır, eşitlikte küçük öncelikli olan. Hesap kodunda desen kullanılabilir: {ayrac} alt hesap ayıracı, {cari.kod}, {malzeme.kod}, {kdv} gibi belge olguları.

Varsayılan kurallar çalışırken listede Düzenle düğmesi yoktur. Kuralları değiştirmek için önce Varsayılan kuralları düzenlemek için firmaya kopyala'ya basın.

Ekrandan bir bölümHesap kuralı formu
Hesap kuralı formu
Şekil 2. Hesap kuralı formu
  1. 1Olgu Koşulun baktığı belge olgusu (belge yönü, cari grubu, KDV oranı …).
  2. 2Değer Düz değer, a|b (biri), ABC* (ile başlar), * (dolu), - (boş).
  3. 3Koşul ekle Yeni koşul satırı ekler; koşulsuz kural her zaman uyar.
  4. 4Kaydet Kuralı kaydeder.
Hesap kuralı formu: ekrandaki alanlar
AlanGirişAçıklama
RolListeden seçimKuralın uygulanacağı fiş satırı rolü (cari, satış geliri, hesaplanan KDV …).
Hesap kodu / deseniMetinHesap kodu ya da desen; ör. 120{ayrac}{cari.kod} her cariye ayrı alt hesap üretir. En çok 64 karakter.
İpucu metni: «120{ayrac}{cari.kod}»
Öncelik (küçük önce)MetinAynı sayıda koşulu tutan kurallardan küçük öncelikli olan kazanır.
AçıklamaMetinKuralın ne için olduğu; önizlemede «Neden bu hesap» sütununda görünür.
Hesap yoksa açOnay kutusuDesenden çıkan hesap planda yoksa muhasebeleştirmede kendiliğinden açılır (üst hesabı olmalı).
EtkinOnay kutusuİşaretsiz kural uygulanmaz; listede soluk görünür.

Koşul değeri yazım biçimleri:

Yazım Örnek Anlamı
Düz değer belge.yon = Purchase Olgu tam bu değer (alış belgeleri).
a|b malzeme.tur = Finished\|SemiFinished Değerlerden biri.
ABC* cari.kod = C-* Bu metinle başlayan.
* hazine.hesap = * Olgu dolu.
- malzeme.id = - Olgu boş (ör. malzemesiz hizmet / masraf satırı).

Kural ekleme: adım adım

  1. Yeni kural'a basın, Rol'ü seçin.
  2. Hesap kodu / deseni'ni yazın (ör. 120{ayrac}{cari.kod}).
  3. Gerekirse Koşul ekle ile olgu ve değer girin.
  4. Desenden çıkan hesap planda yoksa açılsın istiyorsanız Hesap yoksa aç'ı işaretleyip Açılacak hesabın adı'nı yazın.
  5. Kaydet'e basın; ardından Muhasebeleştirme'de bir belgeyi Önizle ile deneyin.

Fiş şablonları

Fiş şablonları sekmesinde olay türünü seçince fişin satır düzeni görünür. Tutarı sıfır olan satır yazılmaz. Satırları ↑ / ↓ ile sıralar, Satır ekle ile eklersiniz; Şablonu kaydet firmaya özel şablon yazar, Varsayılana dön varsayılana döndürür.

Ekrandan bir bölümFiş şablonları
Fiş şablonları
Şekil 3. Fiş şablonları
  1. 1Rol Satırın rolü; hesabı Hesap kuralları belirler.
  2. 2Taraf Satırın borç ya da alacak tarafı.
  3. 3Tutar Tutarın belgeden hangi toplamdan alınacağı.
  4. 4Hesap bazında topla İşaretliyse aynı hesaba düşen satırlar tek satırda toplanır.

Şablon değişikliği sonraki muhasebeleştirmeleri etkiler; borç ve alacak dengesiz kalırsa muhasebeleştirme «Şablon dengesiz fiş üretti» hatası verir.

Sık karşılaşılan uyarılar

Uyarı Nedeni Çözüm
Hesap kodu / deseni gerekli (en çok 64 karakter). Desen boş ya da uzun. Deseni yazın.
Bilinmeyen koşul: … Koşulda tanınmayan olgu. Listeden olgu seçin.
Koşullar çok uzun. Koşullar 2000 karakteri aşıyor. Koşulları sadeleştirin.
Firmada kural var; varsayılanlar yalnız boş kural listesine yüklenir. Varsayılanlar ikinci kez kopyalanmak istendi. Mevcut kuralları düzenleyin.
Desenden geçersiz hesap kodu çıktı: … Desenle üretilen kod geçersiz. Deseni ve olgu değerlerini kontrol edin.
Geçersiz tutar kaynağı: … Şablon satırında geçersiz tutar. Listeden tutar seçin.