Ana içeriğe atla
PUT
Siparişi güncelle
Tek tek alan değiştirecekseniz kısmi güncellemeyi kullanın: PATCH yalnızca gönderdiğiniz alanları değiştirir. Güncelleme tam değiştirme şeklinde çalışır ve satırlar da değişir: siparişin mevcut satırları kaldırılır, istekteki satırlar onların yerine kaydedilir (hepsi tek transaction’da). Siparişte kalmasını istediğiniz her satırı gönderin.
  • OrderType değiştirilemez (6015) ve OrderNumber "Next" olamaz (6003).
  • CreateCustomerMovement cari hareketi belirler: true hareketi oluşturur ya da siparişle eşitler, false mevcut hareketi siler. Bir tahsilat ya da ödemeyle kapatılmış hareket değiştirilemez ya da silinemez (6016, 6017). Bkz. cari hareket.
  • Onaylar ve durum değişmez.
  • API satır tutarlarını hesaplamaz, ama birbirini tuttuğunu denetler (6120); toplamlar ve AverageExchangeRate yeni satırlardan doldurulur.

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

Yol Parametreleri

orderId
string<uuid>
gerekli

Sipariş ID'si.

Gövde

OrderType
integer<int32>
gerekli

Zorunlu. 1: Alış siparişi (tedarikçiye verilen), 2: Satış siparişi (müşteriden alınan). Cari hareketi olan siparişte değiştirilemez.

Örnek:

2

OrderNumber
null | string
gerekli

Zorunlu. Sipariş numarası, şirkette aynı OrderType için benzersiz. Oluştururken "Next" gönderilirse şirketin o tip için sipariş numarası serisinden üretilir. En fazla 10 karakter.

Örnek:

"SIP0000125"

Date
null | string<date-time>
gerekli

Zorunlu. Sipariş tarihi. Tarih kısmı sipariş tarihi olarak saklanır; saat gönderilirse sipariş saati olarak saklanır, gönderilmezse şimdiki saat kullanılır.

Örnek:

"2026-09-21T10:30:00"

CustomerCode
null | string
gerekli

Zorunlu. Cari kodu (GET /api/v1/customers'taki carinin CustomerCode değeri). Sipariş carinin adresiyle yazılır: carinin fatura adresi varsa o, yoksa ilk adresi.

Örnek:

"C-0001"

Lines
object[]
gerekli

Zorunlu, en az bir satır. Güncellemede satırlar değiştirilir: siparişin mevcut satırları kaldırılır, yerine bunlar kaydedilir.

DocumentNumber
null | string

Belge numarası (serbest metin). En fazla 20 karakter.

Örnek:

"2026-15"

Description
null | string

Açıklama. En fazla 1000 karakter.

DueDays
integer<int32>

Gün cinsinden vade. 0'dan küçük olamaz. CreateCustomerMovement true ise cari hareketin vadesi Date + DueDays'tir (0 ise vade tarihi yoktur).

Örnek:

30

DeliveryDate
null | string<date>

Teslim tarihi. Yalnızca tarih (yyyy-MM-dd), saat içermez.

Örnek:

"2026-10-15"

SharingCode
null | string

Siparişi kimin görebileceğini sınırlayan paylaşım kodu. Boşsa herkes görebilir; doluysa kullanıcının paylaşım kodlarından biri olmalıdır.

DiscountTotal
number<double>

Toplam indirim: satırların DiscountAmount toplamı. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

100

SubTotal
number<double>

Ara toplam: satırların AmountExcludingTax toplamı. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

900

VatTotal
number<double>

Tevkifat sonrası toplam KDV: satırların VatAmount toplamından WithholdingTotal düşülür. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

225

AdditionalTaxTotal
number<double>

Toplam ek vergi: satırların ek vergi tutarlarının toplamı. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

225

WithholdingTotal
number<double>

Toplam tevkif edilen KDV: satırların WithheldVatAmount toplamı. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

0

GrandTotal
number<double>

Genel toplam: satırların AmountIncludingTax toplamından WithholdingTotal düşülür. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz. CreateCustomerMovement true ise cari hareketin tutarıdır.

Örnek:

1350

CreateCustomerMovement
boolean

Siparişin cari hareketi olup olmadığı. true ise alış siparişi carinin hesabına GrandTotal tutarında alacak, satış siparişi borç hareketi oluşturur ve her güncellemede eşitler. false ise siparişin cari hareketi yoktur; güncellemede false mevcut hareketi kaldırır. Bir tahsilat ya da ödemeyle kapatılmış hareketler değiştirilemez ya da kaldırılamaz.

Örnek:

true

AverageExchangeRate
number<double>

Ağırlıklı ortalama kur: bütün satırların dövizi aynıysa Σ(AmountExcludingTax × ExchangeRate) / Σ AmountExcludingTax; satırların dövizleri farklıysa 1'dir ve toplamlar her satırın ExchangeRate'iyle varsayılan dövize çevrilir. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

Örnek:

1

Yanıt

OK

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.