Ana içeriğe atla

​
Kimlikler birbirinin yerine geçmez

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

​
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.