Skip to main content
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 UnitId 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 UnitId yalnızca ürünün kendi UnitId’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.

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. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır.

Gerekli aralık: x >= 1

Gövde

Code
null | string

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

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

Örnek:

"VİDA 5X40 GALVANİZ"

UnitId
null | string<uuid>

Zorunlu. GET /api/v1/definitions/units ile dönen ana birimin ID'si.

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 tutma, 2 Stok tut, 3 Lot, 4 FIFO, 5 Seri, 6 LIFO, 7 FEFO. Varsayılan 1.

Örnek:

2

VatRateId
null | string<uuid>

GET /api/v1/definitions/vat-rates ile dönen KDV oranının ID'si.

AdditionalTaxCode1
null | string

Ek vergi kodu 1. En fazla 15 karakter.

AdditionalTaxRate1
number<double>

Yüzde olarak ek vergi oranı 1.

AdditionalTaxCode2
null | string

Ek vergi kodu 2. En fazla 15 karakter.

AdditionalTaxRate2
number<double>

Yüzde olarak ek vergi oranı 2.

AdditionalTaxCode3
null | string

Ek vergi kodu 3. En fazla 15 karakter.

AdditionalTaxRate3
number<double>

Yüzde olarak ek vergi oranı 3.

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.

GroupDetailId1
null | string<uuid>

GET /api/v1/products/groups ile dönen 1. grup detayının ID'si. Grup 1 detaylarının üstü olmadığı için hepsi seçilebilir.

GroupDetailId2
null | string<uuid>
  1. grup detayının ID'si. Ya üstü boş olmalı ya da üstü GroupDetailId1 ile seçilen detay olmalıdır.
GroupDetailId3
null | string<uuid>
  1. grup detayının ID'si. Ya üstü boş olmalı ya da üstü GroupDetailId2 ile seçilen detay olmalıdır.
GroupDetailId4
null | string<uuid>
  1. grup detayının ID'si. Ya üstü boş olmalı ya da üstü GroupDetailId3 ile seçilen detay olmalıdır.
GroupDetailId5
null | string<uuid>
  1. grup detayının ID'si. Ya üstü boş olmalı ya da üstü GroupDetailId4 ile seçilen detay olmalıdır.
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 tutulmuyor) 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.