/accounting/contacts, /accounting/cash-accounts, /accounting/invoices ve /accounting/payments kaynaklarında yürütülür. İstekleri işlem referanslarından seçin.
İzinleri hazırlayın
Bu dört kaynak için açık izin gerekir. Genel erişim veya yönetici yetkisi bu izinlerin yerine geçmez. Okuma ve yazma ayrıdır; belge hesaplama çağrısı
transactions:read kullanır. İşlem makbuzunu okumak için ilgili modülün read veya write izni yeterlidir.
GET /accounting/options bu modüllerden herhangi birinde açık read/write izniyle kullanılabilir. Para birimi ve birim kataloğu ile KDV hesaplama sınırlarını döndürür. cash veya payments izni varsa aktif nakit/banka hesaplarının güvenli, sayfalı listesi de gelir. Hesap yetkisi olmayan anahtarda bu liste boştur.
İstek alanları
- Kimlikler 24 karakterli kayıt kimliğidir. İlişkili cari, hesap, ürün, depo ve belge aynı firmaya ait olmalıdır. Bulunmayan veya bu kaynakta kullanılamayan kimlik
404döndürür. - Belirtilmeyen alanları varsayılanlarıyla değerlendirin. Bilinmeyen alanlar kabul edilmez;
companyId,companiesId, kullanıcı kimliği, hesaplanan toplam veya sistem durumu gönderilmez. PATCHyalnız gönderilen alanları değiştirir. BelgePUTçağrısı tam gövdedir; atlanan isteğe bağlı alanlar varsayılanlarına döner.- Tarihler
YYYY-MM-DDbiçimindedir.fromvetogünleri dahildir. Belge vadesi belge tarihinden önce olamaz. Saat ve saat dilimi göndermeyin. - Arşivleme hareket silmez ve bakiye sıfırlamaz. Yeni mali işlemde kullanılan kartlar aktif olmalıdır. Varsayılan kartlar değişiklik, arşiv ve silmeye karşı korunur.
Tutar ve kur
Ondalıkları sayı veya noktalı metin olarak gönderin:
"1234.50" geçerlidir. Virgül, binlik ayırıcı, negatif girdi, üstel gösterim ve fazla basamak reddedilir. Hesaplanan belge ve TRY tutarları da tutar sınırı içinde kalmalıdır. Cevaplar sayıdır; son sıfırlar korunmayabilir.
exchangeRate, 1 birim işlem para biriminin TRY karşılığıdır. TRY için 1 kullanılır; diğer para birimlerinde açık pozitif kur gerekir. Güncel kur otomatik alınmaz. Para birimlerini GET /accounting/options ile okuyun.
Para tutarları kuruş hassasiyetinde, yarım ve üzeri yukarı yuvarlanır. Hesaplama sırası:
- Miktar × KDV hariç birim fiyat, 2 basamağa yuvarlanır.
- Satır indirimi düşülür. Aynı satırda
discountAmountvediscountPercentbirlikte gönderilmez. - Belge indirimi satırların kalan matrahına orantılı dağıtılır. Artan kuruşlar en büyük kesir payına, eşitlikte satır sırasına verilir.
- Her satırın KDV’si kalan matrah üzerinden hesaplanıp 2 basamağa yuvarlanır.
withholdingPercentvarsa KDV tutarına uygulanır; kesilen KDV ödenecek tutardan düşer.- Ödenecek tutar, satır sonuçlarının toplamıdır. TRY karşılığı bu tutar × kayıtlı kur ile 2 basamağa yuvarlanır.
2 × 100, %10 satır indirimi ve %20 KDV sonucunda matrah 180, KDV 36, ödenecek tutar 216 olur. Bu KDV’nin %50 tevkifatı varsa kesilen tutar 18, ödenecek tutar 198 olur. Bu oranlar hesaplama örneğidir; kullanılacak vergi oranını işleminize göre belirleyin.
KDV ve KDV tutarından tevkifat desteklenir. Diğer vergi türlerini, özel matrahı, fiyatın KDV dahil olduğunu belirten alanları veya dışarıdan hesaplanmış toplamları göndermeyin. Birim fiyat KDV hariçtir.
Bakiyeleri okuyun
balances her para birimini ayrı gösterir. baseCurrencyCode=TRY, baseBalance ise kayıtlı kurlarla hesaplanan karşılıktır. USD ve EUR bakiyelerini doğrudan toplamayın.
Caride pozitif bakiye alacak, negatif bakiye borçtur. Kasada girişler pozitif, çıkışlar negatiftir. Bakiye eksiye düşebilir; bu uçlar kullanılabilir banka bakiyesi veya fiziksel nakit yeterliliği garantisi vermez.
Ekstrede
opening, from öncesini; closing, to gününün sonuna kadar olan bütün hareketleri içerir. Bu alanlar yalnız dönen sayfanın toplamı değildir. signedAmount yerel para, baseAmount işaretli TRY etkisidir. Teklifler cari bakiyesine katılmaz; yalnız arşivlemek gerçekleşmiş mali hareketin etkisini kaldırmaz.
Sürüm ve güvenli tekrar
Bu kaynaklardaki her yazmadaIdempotency-Key zorunludur. Aynı firma ve işlem türünde aynı anahtar farklı kimlik, gövde, sorgu veya If-Match ile kullanılırsa 409 IDEMPOTENCY_PAYLOAD_CONFLICT döner. Anahtarlarınızı sisteminize özel iş referanslarıyla üretin ve kalıcı saklayın; kişisel veri koymayın.
Düzenleme, silme, arşiv, geri çıkarma ve iptalde kayıt sürümü de gerekir:
If-Match kayıttan okuduğunuz version değeridir. Eksik/bozuk başlık 428 RECORD_VERSION_REQUIRED, eski sürüm 409 RECORD_CHANGED üretir. Başarılı düzenlemede yeni sürümü saklayın. Kasa açılışı oluştururken kasa kartının; açılış iptalinde açılış hareketinin; transfer iptalinde source hareketinin sürümü kullanılır.
Başarılı tekrar 200, replayed:true ve sonuç kimlikleri döndürür. İlk çağrının result ayrıntısı tekrarlanmaz; kimlikle kaydı veya ekstreyi okuyun. Geçerli bir sonraki düzenleme için yeni iş anahtarı ve güncel sürüm kullanılır.
İstek yazma başlamadan reddedilmişse makbuz failed_before_dispatch olabilir. Aynı içerik yalnız hata giderildikten ve sonuç kontrol edildikten sonra aynı anahtarla tekrar değerlendirilebilir. Gövdeyi veya sürümü düzeltiyorsanız, önceki isteğin kayıt değiştirmediğini doğrulayıp yeni iş niyeti için farklı anahtar kullanın.
409 OPERATION_TARGET_LOCKED, 502, 503 veya bağlantı kesilmesinde işlem takibini izleyin. Birden fazla kayıt içeren yazmada kısmi sonuç olabilir; otomatik tekrar, süreye göre kilit açma veya tüm kayıtlar için tek atomik işlem garantisi yoktur. Belirsiz işlem çözülene kadar aynı firmadaki diğer mali yazmalar da 409 alabilir.
Sayfalama
Yeni liste ve ekstrelerdepage=1, limit=25 varsayılandır; limit üst sınırı 100, page üst sınırı 100000’dir. Liste sırası tarih/kimlik azalan, ekstre sırası tarih/kimlik artandır. Eşzamanlı ekleme/düzeltmeler sayfaları etkileyebilir; sabit bir anlık görüntü garantisi yoktur.
Cari akışı · Kasa akışı · Alış-satış · Ödeme ve mahsup
Mahsuplaşmada yuvarlama sınırı
Mahsuplaşma hem belge para birimindeki açık tutarı hem TRY karşılığını aşamaz. Yuvarlama nedeniyle yalnız birinin kapanacağı dağıtım409 ALLOCATION_ROUNDING_MISMATCH ile reddedilir. Örneğin 1,00 döviz tutarlı, kuru 1,005 olan belgenin TRY toplamı 1,01’dir; çok sayıda 0,01 tutarlı ödeme kendi yuvarlamalarıyla farklı TRY toplamı oluşturabilir. Farkı fazla tahsilatla kapatmayın; mevcut ödeme dağılımlarını kontrol edip gerektiğinde kontrollü iptal ve toplu yeni ödeme kullanın.