İ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;QueryEInvoiceLabelsoluştururken e-fatura etiketlerini sorgular. Liste her carinin e-posta adreslerini, telefon numaralarını ve grup üyeliklerini de döner;searchadda “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
AdditionalTaxeslistesiyle gönderilir (en fazla 3, UBL-TR kodları, her kod bir kez). Teklif, sipariş, irsaliye ve fatura satırlarında ürünProductCodeyerine e-ticaret koduyla (ECommerceProductCode) da verilebilir. Fatura oluştururken cariCustomerCodeyerine 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ı veAverageExchangeRatesatırlardan doldurulur.UnitPriceKDV hariçtir, isteğe bağlıGrossAmountbrüt tutardır. SatırınAdditionalTaxeslistesi (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 (EInvoiceType1), değilse e-Arşiv (2) olur. Satış ve alış iade faturaları tek numaralandırmayı paylaşır: şirket e-Fatura kullanmıyorsa SATFATNO serisi;InvoiceNumberikisi 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
RiskActiondeğeri2(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,sortByvesortDirection. - 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
0580ile döner. - Kısmi güncelleme: güncellenebilen her kaynakta
PATCHdesteklenir. - Hatalar: her yanıtta
ResultCodeveErrorsbulunur (sonuç kodları). Mükerrer değerde var olan kaydın ID’siExistingIdolarak döner. İstekte yer almayan alanPOST,PUTvePATCH’te0002ile reddedilir. Sığmayan değer500yerine400(0003/0004) döner;500yanıtları destek içinTraceIdtaşı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).