Ana içeriğe atla
POST
Ürün oluştur
Ürün ve bütün alt kayıtlar tek transaction’da yazılır: kayıtlardan biri geçersizse hiçbiri kaydedilmez, bütün hatalar tek Message’da döner.

Alan kuralları

Zorunlu alanlar, tip listeleri ve grup kuralları.

Fiyatlar

Fiyat/indirim kuralları ve kapsam.
  • Code, Name ve UnitCode zorunludur; diğer alanlar isteğe bağlıdır.
  • Code yerine "Next" gönderilirse kod ÜRÜN seri tanımından üretilir.
  • Parameters ve CriticalStock, ilgili parametre ve kritik stok kayıtlarıyla aynı kuralları kullanır. Prices’ta UnitCode yalnızca ürünün kendi UnitCode’si olabilir; ürün henüz oluşturulmadığı için 2./3. birim yoktur.
  • İstenmeyen alt kayıt listesi için [] gönderilir. Başarılı yanıt 201 Created döner; Location header’ı yeni ürünü gösterir.

Asgari istek

Yalnızca zorunlu alanlarla çalışan bir istek. Kod ve adları kendi şirketinizdekilerle değiştirin.

Hata kodları

Bu endpoint’in dönebileceği kodlar. Her endpoint için geçerli olan genel hatalar (kimlik doğrulama, yetki, istek header’ları, istek limitleri) burada tekrarlanmaz.

Yetkilendirmeler

Authorization
string
header
gerekli

Access token obtained from the Noyax auth service with your API key.

Başlıklar

X-UserID
integer<int32>
gerekli

İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır.

Gerekli aralık: x >= 1
X-CompanyID
integer<int32>
gerekli

Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır.

Gerekli aralık: x >= 1
X-PeriodID
integer<int32>

Muhasebe döneminin ID'si. İsteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Gövde

Code
null | string
gerekli

Zorunlu. Ürün kodu, şirket içinde benzersiz olmalıdır. "Next" gönderilirse kod "ÜRÜN" seri tanımından üretilir (yalnızca oluştururken). En fazla 50 karakter.

Örnek:

"URN-0001"

Name
null | string
gerekli

Zorunlu. Ürün tanımı. En fazla 255 karakter.

Örnek:

"VİDA 5X40 GALVANİZ"

UnitCode
null | string
gerekli

Zorunlu. GET /api/v1/definitions/units'ten ana birimin kodu: birimin evrensel kodu (ör. ADET için C62) ya da birimin evrensel kodu yoksa adı (ör. KOLİ).

Örnek:

"C62"

Barcode
null | string

Ana birimin barkodu. En fazla 30 karakter.

Örnek:

"8690000000017"

ProductType
integer<int32>

Ürün tipi: 1 İlk madde, 2 Yarı mamül, 3 Mamül, 4 Ticari mal, 5 Hizmet. Varsayılan 4.

Örnek:

4

StockType
integer<int32>

Stok tipi: 1 Stok takibi yok, 2 Stok takibi var, 3 Lot, 4 FIFO, 5 Seri, 6 LIFO, 7 FEFO. Varsayılan 1.

Örnek:

2

VatRate
null | integer<int32>

Yüzde olarak KDV oranı, GET /api/v1/definitions/vat-rates'teki oranlardan biri.

Örnek:

20

AdditionalTaxes
object[]

Ürünün ek vergileri (ör. ÖTV), en fazla 3 kayıt; liste sırasıyla ürünün 1., 2. ve 3. ek vergisi olarak saklanır. Bir vergi kodu yalnızca bir kez kullanılabilir. Üründe ek vergi yoksa boş bırakın.

IsOutOfUse
boolean

Ürünün kullanım dışı olup olmadığı. Kullanım dışı ürünler saklanır ama yeni kayıtlarda önerilmez.

Örnek:

false

ManufacturerCode
null | string

Üretici kodu. En fazla 50 karakter.

SupplierCode
null | string

Tedarikçi kodu. En fazla 50 karakter.

Group1
null | string

GET /api/v1/products/groups'tan grup 1 detayının adı. Grup 1 detaylarının üstü olmaz, hepsi seçilebilir.

Group2
null | string

Grup 2 detayının adı. Ya üstü olmamalı ya da üstü Group1 detayı olmalı.

Group3
null | string

Grup 3 detayının adı. Ya üstü olmamalı ya da üstü Group2 detayı olmalı.

Group4
null | string

Grup 4 detayının adı. Ya üstü olmamalı ya da üstü Group3 detayı olmalı.

Group5
null | string

Grup 5 detayının adı. Ya üstü olmamalı ya da üstü Group4 detayı olmalı.

ShelfNumber
null | string

Raf numarası. En fazla 20 karakter.

Örnek:

"A-12"

Description
null | string

Açıklama. En fazla 255 karakter.

SerialNumberIndex
integer<int32>

Seri takibinde kullanılan seri no indeksi.

ECommerceProductCode
null | string

E-ticaret entegrasyonunun kullandığı ürün kodu. En fazla 50 karakter.

IsFavourite
boolean

Ürünün favori olarak işaretlenip işaretlenmediği.

Örnek:

false

Gtip
null | string

İhracat faturalarında kullanılan GTİP numarası. En fazla 20 karakter.

Örnek:

"7318159000"

DeliveryTerm
null | string

İhracat faturalarında kullanılan teslim şekli kodu (Incoterms, ör. EXW, FCA, CIF). En fazla 10 karakter.

Örnek:

"EXW"

PackagingType
null | string

İhracat faturalarında kullanılan paketleme tipi kodu. En fazla 10 karakter.

Örnek:

"BX"

TransportMode
integer<int32>

İhracat faturalarında kullanılan taşıma modu: 0 belirtilmemiş, 1 Denizyolu, 2 Demiryolu, 3 Karayolu, 4 Havayolu, 5 Posta, 6 Çok araçlı, 7 Sabit taşıma tesisleri, 8 İç su yolu. Bu liste, sevkiyat tanımındaki TransportMode listesinden farklıdır.

Örnek:

3

Brand
null | string

Marka. En fazla 100 karakter.

Model
null | string

Model. En fazla 100 karakter.

OriginCountryCode
null | string

İhracat faturalarında kullanılan menşei ülke kodu (ISO 3166-1 alpha-2). En fazla 10 karakter.

Örnek:

"TR"

Parameters
object[]

Özel parametre değerleri.

Prices
object[]

Fiyatlar/indirimler. UnitId, ürünün kendi UnitId'si olmalıdır; oluşturma sırasında ürünün henüz 2./3. birimi yoktur.

CriticalStock
object[]

Kritik stok tanımları, depo başına bir tane. StockType 1 (stok takibi yok) iken gönderilemez.

Yanıt

Created

Success
boolean
gerekli

İşlemin başarılı olup olmadığı.

Örnek:

true

ResultCode
string
gerekli

Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir.

Örnek:

"0000"

Data
object
gerekli

Response data. Null when Success is false.

Message
null | string

Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir.