Entegrasyon notları

18 Ekim 2026

Gereken mali çağrılarda Idempotency-Key kullanın ve dönen işlem kimliğini saklayın. Tekrar cevabı sonuç kimlikleriyle sınırlı olabilir.
Okuma ve yazma izinlerini ayrı tanımlayın. Firma ve IP erişim koşullarını kontrol edin.
POS listesinde isDefault=true varsayılan hesabı, false ek hesapları seçer.
Online işlem ayarını kaydederken status boolean olarak zorunludur; güncellemede atlanan domain korunur.
Faturada type=view taslak oluşturur. Veri değiştiren GET istekleri yazma izni gerektirir.
Banka hareketini faturaya mahsupta yalnız açık ve daha önce ödeme almamış faturanın tam tutarı desteklenir. Kısmi ödeme ve kur farkı gerektiren işlemler 422 döndürür.
Fatura iptalinde banka hareketine bağlı veya birden çok faturaya mahsup edilmiş ödeme varsa 409 döner ve iptal başlatılmaz.
GİB e-Arşiv’de belge kimliğini kesin ETTN üzerinden doğrulayın.