Ana içeriğe atla
Geriye uyumlu değişiklikler mevcut versiyonda yayımlanır; kırıcı değişiklikler yeni bir versiyonla gelir. Bkz. Versiyonlama.
v1

İlk sürüm

  • Cariler: listeleme, detay, oluşturma, güncelleme, silme; alt kayıtlarla (adres, telefon, link, yetkili, banka hesabı, grup, parametre). CustomerCode: "Next" kodu seriden üretir; QueryEInvoiceLabels oluştururken e-fatura etiketlerini sorgular. Liste her carinin e-posta adreslerini, telefon numaralarını ve grup üyeliklerini de döner; search adda “içerir”, cari kodu, vergi numarası ve e-posta adreslerinde tam eşleşmeyle arar.
  • Ürünler: fiyat, parametre, grup detayı ve kritik stok tanımlarıyla tam CRUD; alt kayıtlar ürünle aynı transaction’da oluşturulur. Ek vergiler AdditionalTaxes listesiyle gönderilir (en fazla 3, UBL-TR kodları, her kod bir kez). Teklif, sipariş, irsaliye ve fatura satırlarında ürün ProductCode yerine e-ticaret koduyla (ECommerceProductCode) da verilebilir. Fatura oluştururken cari CustomerCode yerine vergi numarasıyla (CustomerTaxNumber) da verilebilir. Ürün yanıtları varyantın ana ürününü döner (MainProductId, MainProductCode; ana üründe boş).
  • Değişen ürünler (GET /products/changes): ilk yüklemede bütün ürünler, sonra kartı, fiyatları, stoğu ya da ürün grupları en fazla son 24 saatte değişen ürünler; her biri kart özeti ve ürün grupları (ürün grubu olmayan varyantta ana ürünün grupları, GroupsFromMainProduct), süresi bitmemiş fiyatları (kendi fiyatı olmayan varyantta ana ürünün fiyatları, PricesFromMainProduct) ve lot/seri numaralarıyla depo bazında stokla, düzenli eşitleme için (değişen ürünler).
  • Tanımlar: ülke, il, ilçe, sevkiyat tanımı, döviz, birim, satır grubu, cari ve ürün parametre tanımları; KDV oranları ve cari grupları salt okunur.
  • Stok: depolar ve bölümler, ürün stok durumu raporu ve “işlemi durdur” seçili kritik stok kontrolleri: stoğu negatif (4402), minimumun altında (4401) ya da maksimumun üzerinde (4403) bırakacak bir irsaliye ya da fatura stok hareketi reddedilir.
  • Teklif, sipariş, irsaliye ve faturalar (alış, satış, alış iade, satış iade; her biri kendi endpoint grubunda): listeleme, detay, oluşturma, güncelleme, kısmi güncelleme ve silme. Satırlar, indirimler ve gerektiğinde Lot/seri no girdileri ile cari hareket aynı transaction’da yazılır. Satır tutarlarını entegratör gönderir, API hesaplamaz ama birbirini tuttuğunu denetler (5118/6120/7124/3126); başlık toplamları ve AverageExchangeRate satırlardan doldurulur. UnitPrice KDV hariçtir, isteğe bağlı GrossAmount brüt tutardır. Satırın AdditionalTaxes listesi (en fazla 3) ürünle aynı kod kurallarına uyar.
  • İrsaliye ve fatura güncellemesi (PUT/PATCH) yalnızca açıklayıcı alanları değiştirir; satırlar, cari, tarih, numara ve tutarlar güncellenemez (0002). GİB’e gönderilmiş fatura (3027) ve e-irsaliye olarak gönderilmiş irsaliye (7019) silinemez.
  • e-Belge numaralandırması: "Next" ile e-Fatura, e-Arşiv ya da e-irsaliye numaralandırmasından numaralanan fatura ve çıkış irsaliyesi, aynı önek ve yılla kullanılmış en büyük numaradan devam eder; numaralar Noyax’ta kesilenlerin gerisinde kalmaz ve sıra her yıl 1’den başlar. e-Fatura kullanan şirketin satış ya da alış iade faturası, cari e-Fatura mükellefiyse e-Fatura (EInvoiceType 1), değilse e-Arşiv (2) olur. Satış ve alış iade faturaları tek numaralandırmayı paylaşır: şirket e-Fatura kullanmıyorsa SATFATNO serisi; InvoiceNumber ikisi arasında benzersizdir.
  • Finans: cari işlemleri ve bakiye raporları; banka, banka hesabı ve geri ödeme planları; gelen/giden havale, açılış, virman ve kredi kartı tahsilat fişleri (Finans genel bakış). Kendi okuma/yazma yetkisi vardır.
  • Risk limiti: carinin RiskAction değeri 2 (işlemi durdur) ise, carinin risk limitini aşacak cari hareketli satış siparişi, satış faturası ya da alış iade faturası reddedilir (6020, 3028) (cariler).
  • Belge listesi filtreleri: tarih aralığı, cari, döviz, modifiedSince/createdSince, sortBy ve sortDirection.
  • Kod ya da adla referans: diğer kayıtlar ID ile değil kod ya da adla verilir (ürün kodu, cari kodu, döviz kodu, birim, depo, …). Bulunamayan değer alanın kendi hata koduyla, birden fazla kayda uyan değer 0580 ile döner.
  • Kısmi güncelleme: güncellenebilen her kaynakta PATCH desteklenir.
  • Hatalar: her yanıtta ResultCode ve Errors bulunur (sonuç kodları). Mükerrer değerde var olan kaydın ID’si ExistingId olarak döner. İstekte yer almayan alan POST, PUT ve PATCH’te 0002 ile reddedilir. Sığmayan değer 500 yerine 400 (0003/0004) döner; 500 yanıtları destek için TraceId taşır. Bilinmeyen adres, yöntem ve içerik tipi standart hata zarfıyla döner (0005, 0006, 0007).
  • Limitler: API anahtarı başına günlük istek limiti ve saniyelik istek limiti (limitler).