> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Veri, para ve kimlik kuralları

> Muhasip kayıt kimliklerini, tutarları, vergi toplamlarını, tarihleri ve belge ilişkilerini doğru taşıyın.

## Kimlikler birbirinin yerine geçmez

| Kimlik | Kullanım |
| - | - |
| `id`, `_id` | Kaynağa ait Muhasip kayıt kimliği; çoğunlukla 24 onaltılık karakter |
| `UUID`, `uuid`, `ettn` | Belgenin ilgili sağlayıcı veya e-belge kimliği |
| `operationId` | 64 küçük harfli onaltılık karakter; API işlem makbuzu kimliği |
| `paymentId`, `orderId` | Tahsilat veya sipariş bağlamındaki kimlik |

Bir banka hareketinin kimliğini ödeme kimliği olarak kullanmayın. Kaynak alanındaki büyük/küçük harf ve adı koruyun. Sağlayıcının ETTN üretmediği durumda kendiniz UUID üretip belge gönderilmiş kabul etmeyin.

## Tutar, para birimi ve kur

JSON’daki sayısal alanları sayı olarak gönderin; `1.200,50` gibi görüntüleme biçimleri kullanmayın. Ondalık hassasiyetini ve kur alanlarını ilgili işlem şemasına göre kullanın. Gerekli kuru ve tutarları isteği göndermeden önce doğrulayın.

* `currencyCode` belgenin para birimidir; gösterim simgesi değildir.
* `exchangeRate` veya kaydedilmiş kur yalnız ilgili işlem desteklediğinde kullanılır. TRY dışındaki bilinmeyen kuru `1` ile tamamlamayın.
* Satır miktarı, birim fiyat, indirim ve vergi tutarları birbiriyle tutarlı olmalıdır. `total` ve benzer toplam alanlarını sözleşmedeki biçimde taşıyın.
* Banka fatura onayı aynı para birimi ve doğrulanmış kur koşullarına tabidir; kur farkı gerektiren işlemler `422` ile reddedilir.

Örneğin 1 adet, 100 birimlik hizmet ve yüzde 20 vergi için satır tutarı 100, vergi 20, ödenecek tutar 120 olur. Bu bir aritmetik örnektir; uygulanacak vergi oranı veya mevzuat tavsiyesi değildir. Belgenizin gerçek vergi kodunu ve oranını kullanın.

## Vergiler

Vergi kodunu metin olarak koruyun; `0015` değerini `15` sayısına çevirmeyin. Belge modelindeki satır vergileri ile belge toplam vergilerini birlikte değerlendirin. GİB, fatura sağlayıcısı ve pazaryeri aktarımı aynı alan modelini kullanmak zorunda değildir. Tevkifat/istisna veya özel profil için ilgili şemanın desteklediği alanlar dışına çıkmayın.

## Tarihler ve sayfalama

Gün filtrelerinde `YYYY-MM-DD`, saat içeren alanlarda açık saat dilimiyle ISO 8601 kullanın. Pazaryeri sipariş sorgusunda `date[0]` ve `date[1]` alanları ISO gün ister; sayısal epoch değeri göndermeyin. GİB belge iptalindeki `belgeTarihi` gibi özel alanlar farklı biçim isteyebilir.

Her kaynağın başlangıç/bitiş dahil olma kuralı aynıdır varsaymayın. Örneğin banka hareketinin bitiş sınırı açıklaması işlem sayfasında belirtilir. [Sayfalama ve filtreler](/rehberler/sayfalama-ve-filtreler)

## Cevap ve ilişki güvenliği

Örneklerdeki kimlikler temsilîdir. Gerçek entegrasyonda dönen kimlikleri ilişkileriyle saklayın. Bağlantı sırrının cevapta bulunmaması hata değildir; fatura anahtarı, GİB tokenı ve pazaryeri parolası gibi sırlar dışarı verilmez. Kendi iş verilerinizi ve belge içeriğini de genel loglara taşımayın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.