Ana içeriğe atla
Cari, ürün ya da fatura gibi kayıtlar Noyax’ta tanımlı kayıtlara (ilçe, döviz, birim, …) ID ile değil kod ya da adla referans verir. Örneğin adres için ilçe adı District alanında gönderilir. Geçerli kod ve adları tanım endpoint’lerinden alırsınız.

Hangi değer nereden gelir?

Ülke ve il listeleri, ilçeyi bulmak için kullanılır: ülke → il (country) → ilçe (city).

Örnek: adres için ilçe bulmak

1

İli bulun

2

İlçeyi bulun

3

Adreste kullanın

Dönen ilçenin adını adresin District alanına yazın (gerekiyorsa ilini de City alanına).

Bilinmesi gerekenler

  • Tanımlar şirket bazlıdır. Listeler X-CompanyID ile gönderilen şirketin kayıtlarını döner. Bir şirketin kod ya da adı başka bir şirkette kullanılamaz.
  • Yetki: /definitions altındaki listeler her geçerli API anahtarıyla okunabilir. Tanım eklemek, güncellemek ya da silmek için anahtarın tanım yazma yetkisi olmalıdır. Aynı yetki cari, ürün ve stok tanımları için de geçerlidir (cari/ürün parametre tanımları, ürün grupları, depolar ve bölümler); bunların listeleri de her geçerli anahtarla okunabilir.
  • Önbelleğe alın. Tanımlar nadiren değişir. Her kayıt öncesinde tekrar sorgulamak yerine kendi tarafınızda saklayıp örneğin günde bir kez yenileyin; istek limitlerinizi korur.

Yazma kuralları

KDV oranları ve cari grupları API üzerinden yalnızca okunur. Tanımlar PUT ile tamamen, PATCH ile kısmen güncellenir.