DespatchType 2, mal kabul) ve çıkış irsaliyeleri (DespatchType -2, sevk) aynı endpoint’leri kullanır. İrsaliyeler stok hareketi yarattığı için, ürünün stok izleme yöntemine göre bir satır Lot ya da seri no girdileri de taşıyabilir.
Zorunlu alanlar
DespatchType:2giriş (mal kabul),-2çıkış (sevk). İrsaliye oluşturulduktan sonra değiştirilemez.DespatchNumber: şirkette aynıDespatchTypeiçinde benzersiz, en fazla 20 karakter. Oluştururken"Next"gönderilirse numara otomatik üretilir: giriş irsaliyeleri için ALİRSNO serisi; çıkış irsaliyelerinde SATİRSNO serisi, ya da şirket e-irsaliye kullanıyorsa şirketin e-irsaliye numaralandırması (sabit bir önek, yıl ve 9 haneli sıra numarası, örn.EDD2026000000014; sıra, çıkış irsaliyelerinde aynı önek ve yılla başlayan en büyük numaradan devam eder, bu yüzden her yıl 1’den başlar). Güncellemede"Next"gönderilemez.Date: irsaliye tarihi. Saat de gönderirseniz irsaliye saati olarak yazılır, göndermezseniz o anki saat kullanılır.CustomerCode: kullanıcının görebildiği bir cari.Lines: en az bir satır.
CurrencyCode’unu gönderir. Belgenin dövizi satırlardan türetilir (satırların tek bir dövizi varsa o, birden fazlaysa şirketin varsayılan dövizi) ve yanıtta CurrencyCode olarak döner. AverageExchangeRate de gönderilmez, satırlardan doldurulur (istekte gönderilen değer yok sayılır): satırların hepsi aynı dövizdeyse satır kurlarının tutarla ağırlıklandırılmış ortalaması (AmountExcludingTax × ExchangeRate toplamı / AmountExcludingTax toplamı), dövizler farklıysa 1. Bkz. dövizler.
DueDays (vade günü) irsaliyeyle birlikte saklanır. ShipmentDefinitionCode (isteğe bağlı) sevkiyat tanımlarından gelir.
Cariden alınan bilgiler
İrsaliyenin adresi, unvanı, vergi numarası ve vergi dairesi istekte alan olarak yer almaz. Bunlar, irsaliyenin kaydedildiği anda cariden kopyalanır (carinin fatura adresi varsa o, yoksa ilk adresi) ve cari sonradan değişse bile irsaliyede sabit kalır — bu yüzden yalnızca yanıtlarda görünürler (Address, CustomerTitle, TaxNumber, TaxOffice). Güncellemede bu değerler yalnızca CustomerCode değiştiyse yeniden hesaplanır; değişmediyse mevcut değerler korunur.
Satırlar
- Ürün
ProductCode(ürün kodu) ya daECommerceProductCode(e-ticaret entegrasyon kodu) ile verilir; ikisinden biri zorunludur. İkisi de gönderilirseProductCodekullanılır.UnitCodezorunludur. Birim, ürünün kendi birimlerinden biri olmalıdır (ana birimi ya da 2./3. birimi). Quantitysıfırdan büyük olmalı;UnitPricenegatif olamaz ve KDV hariç olmalıdır.VatIncludedyok sayılır (mevcut istekler çalışmaya devam etsin diye kabul edilir).CurrencyCodeher satırda zorunludur.ExchangeRate, satırın dövizi şirketin varsayılan döviziyse1olmalı; değilse zorunlu ve 0’dan büyük olmalıdır.Discounts, satırın indirim oranlarının listesidir, sırasıyla art arda uygulanır.LineGroupNameisteğe bağlıdır, satır grupları tanımından gelir.WarehouseNamezorunludur ve şirketin depolarından biri olmalıdır.
Ana birim miktarı
Satır miktarı (Quantity) satırın birimindedir. Yanıttaki MainUnitQuantity, aynı miktarın ürünün ana birimi cinsinden karşılığıdır ve tıpkı sipariş satırlarındaki gibi API tarafından hesaplanır: UnitCode ana birimse miktarın kendisi, değilse birimin çarpanına bölünmüş hali. Çıkış irsaliyesinde eksi, giriş irsaliyesinde artı işaretle döner.
İrsaliyeyi güncelleme
Yalnızca açıklayıcı alanlar (Description, DocumentNumber, ActualDispatchDate, ShipmentDefinitionCode, SharingCode) güncellenebilir; satırlar ve stoğu ya da cariyi etkileyen her şey irsaliye oluşturulduktan sonra sabittir. Bkz. İrsaliye güncelleme. Bir irsaliyeyi düzeltmek için silinip yeniden oluşturulur; e-irsaliye olarak gönderilmiş irsaliye silinemez (7019).
Lot ve seri no takibi
Bir satırdaLots mi SerialNumbers mi kullanılacağı, ürünün stok tipine göre belirlenir (Ürün detayı ile okunan StockType):
Lot’lar (
LotNo, Quantity, UnitCode, ve yalnızca giriş irsaliyesinde SupplierLotNo/ExpiryDate/Description):
- Giriş, Lot izlenen 4 stok tipinde de aynı şekilde: her girdi yeni bir Lot oluşturur (
LotNoher zaman sizin tarafınızdan verilir, şirkette benzersizdir) ve ona karşılık gelen bir giriş hareketi yazılır. - Çıkış, stok tipi 3 (Lot): hangi Lot’tan ne kadar düşüleceğini
LotNoveQuantityile siz belirtirsiniz. - Çıkış, stok tipi 4/6/7 (FIFO/LIFO/FEFO):
Lotsboş bırakılır — API Lot’ları otomatik seçer (FIFO’da en eski önce, FEFO’da son kullanma tarihi en yakın önce, LIFO’da en yeni önce), miktar karşılanana kadar bir lottan diğerine geçerek düşer. - Bir çıkış işleminde zaten kullanılmış bir Lot kaldırılamaz ya da tüketilen miktarın altına düşürülemez; işlem iptal edilir.
SerialNumbers, düz metin listesi, her birim için bir tane): giriş irsaliyesinde her girdi yeni bir seri no kaydeder (aynı seri no zaten kayıtlı ve çıkışı yapılmamışsa reddedilir); çıkış irsaliyesinde her girdi, çıkışı henüz yapılmamış mevcut bir seri no olmalıdır ve çıkışı yapılmış olarak işaretlenir. Bu irsaliyenin çıkışını yaptığı bir seri no satırdan kaldırılamaz.
Kritik stok
Bir ürünün bir depo için kritik stok tanımında işlemi durdur seçili kontroller varsa, o depoda stok hareketi yapan satırların her kaydı ve silinmesi denetlenir. İşlem sonunda oluşacak stok, seçili her kontrole uymalıdır; uymuyorsa işlemin tamamı reddedilir:
Sonuç isteğin bütünü için hesaplanır: her ürün ve depo için, isteğin öncesindeki stok ile tüm satırlar uygulandıktan sonraki stok karşılaştırılır. Stoğu değişmeyen ürün ve depo denetlenmez. Giriş satırını silmek stoğu azaltır, çıkış satırını silmek artırır; silmeler de denetlenir. Kural yalnızca oluşacak stoğa bakar: stoğu bir sınırın dışında bırakan hareket, o sınıra yaklaştırsa bile reddedilir. “İşleme devam” ya da “uyar” seçili kontroller hiçbir şeyi engellemez.
Sipariş bağlantısı
Noyax uygulamasında bir sipariş satırından oluşturulan irsaliye satırı o satıra bağlıdır. API bu bağlantıyı hiçbir zaman oluşturmaz ya da değiştirmez: API ile oluşturulan irsaliyeler siparişlere bağlı değildir.Paylaşım
SharingCode irsaliyeyi kimlerin görebileceğini sınırlar: boşsa herkes görür, doluysa kullanıcının paylaşım kodlarından biri olmalıdır. Kullanıcının göremediği irsaliyeler 404 döner.