Cari kodu üretimi - Noyax API

Cari oluştururken CustomerCode alanına "Next" gönderirseniz kod, şirketinizin Noyax’ta tanımlı cari numarası serisinden otomatik üretilir. Üretilen kod yanıttaki CustomerCode alanında döner.

{
  "CustomerCode": "Next",
  "Name": "Örnek Ticaret A.Ş.",
  "TaxNumber": "1234567890"
}

Kod nasıl oluşur?

Seri, sırayla birleştirilen parçalardan oluşur. Her parçanın bir tipi ve uzunluğu vardır:

Parça	Değer
Artırımlı	Serideki sıradaki numara
Yıl, Ay, Gün, Saat, Dakika	İşlem anının ilgili değeri
Çeyrek yıl	`1`-`4`
Kullanıcı ID	`X-UserID`
Rol ID	Kullanıcının rolünün ID’si
Sabit değer	Tanımlandığı gibi yazılır
Rastgele	Büyük harf onaltılık karakterler (`0`-`9`, `A`-`F`)

Parça tanımlı uzunluktan kısaysa soluna 0 eklenir, uzunsa son karakterleri alınır.
Sıradaki numara yalnızca cari başarıyla kaydedilirse bir artar. Hatalı bir istek numara harcamaz.
Aynı anda gelen istekler aynı numarayı alamaz.

Örnek: Seri “artırımlı (6 hane) + yıl (4 hane)” ve sıradaki numara 38 ise kod 0000382026 olur.

Hatalar

Kod	Mesaj	Sebep
`1080`	`Serial number definition 'CARİ NO' not found for this company.`	Şirkette cari numarası serisi tanımlı değil. Kodu kendiniz gönderin ya da Noyax’ta seriyi tanımlayın
`1081`	`Serial number 'CARİ NO' has no detail definitions.`	Serinin parçaları tanımlı değil
`1082`	`Unsupported serial number part type: N.`	Seride API’nin üretemediği bir parça tipi (Parametre 1 / Parametre 2) var
`1083`	`Generated customer code (N characters) exceeds the serial number maximum length (M).`	Üretilen kod serinin azami uzunluğunu aşıyor
`1084`	`Generated customer code '...' is already used in this company.`	Üretilen kod şirkette başka bir caride kullanılıyor. Serideki sıradaki numarayı kontrol edin
`1085`	`Customer code could not be generated. Please try again.`	Rastgele parça içeren seride, birkaç denemeye rağmen kullanılmayan bir kod üretilemedi

"Next" yalnızca oluşturmada kullanılabilir. Güncellemede gönderilirse 400 ve 1003 döner.