Skip to main content
Cari, ürün ya da fatura gibi kayıtlar bazı alanlarda serbest metin yerine Noyax’ta tanımlı bir kaydın ID’sini ister. Örneğin adres için ilçe adı değil DistrictId gönderilir. Bu ID’leri tanım endpoint’lerinden alırsınız.

​
Hangi ID nereden gelir?

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

​
Örnek: adres için ilçe bulmak

1

İli bulun

2

İlçeyi bulun

3

Adreste kullanın

Dönen ilçenin Id değerini adresin DistrictId alanına yazın.

​
Bilinmesi gerekenler

  • Tanımlar şirket bazlıdır. Listeler X-CompanyID ile gönderilen şirketin kayıtlarını döner. Bir şirketin ID’si başka bir şirkette kullanılamaz.
  • Yetki: /definitions altındaki listeler her geçerli API anahtarıyla okunabilir. Ülke, il, ilçe ve sevkiyat tanımı eklemek, güncellemek ya da silmek için anahtarın herhangi bir modülde yazma yetkisi olmalıdır. Cari tanımları (/customers/groups, /customers/parameter-definitions) cari okuma yetkisi ister.
  • Ö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; günlük istek limitinizi korur.

​
Yazma kuralları

KDV oranları ve cari tanımları API üzerinden yalnızca okunur. Güncellemeler tam değiştirme şeklinde çalışır; gönderilmeyen alanlar temizlenir.