Ana içeriğe atla
PATCH
Satış faturasını kısmi güncelle
Gövdede yalnızca değiştirmek istediğiniz alanları gönderirsiniz; gönderilmeyen alanlar mevcut değerini korur. Kurallar ve örnekler: kısmi güncelleme.
  • Yalnızca Satış faturası güncelleme sayfasındaki açıklayıcı alanlar değiştirilebilir; diğer her alan (satırlar, cari, tarih, fatura numarası, tutarlar, …) reddedilir (0002).
  • Gönderilmeyen alan değişmez; null gönderilen alan temizlenir.
  • Listeler (PaymentMeans, ReferencedDespatches, CustomerIdentitySchemes) birleştirilmez: gönderdiğiniz liste tüm listenin yerini alır.

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

invoiceId
string<uuid>
gerekli

Satış faturası ID.

Gövde

Description
null | string

Açıklama. En fazla 1000 karakter.

DocumentNumber
null | string

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

ShipmentDefinitionCode
null | string

GET /api/v1/definitions/shipment-definitions'tan sevkiyat tanımı kodu.

SharingCode
null | string

Faturayı kimlerin 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.

PrintDescription
boolean

Açıklamanın fatura belgesinde yazdırılıp yazdırılmayacağı.

Consolidated
boolean

Faturanın birden fazla irsaliyeyi/siparişi birleştirip birleştirmediği. Serbest biçimli bir bayraktır, API tarafından doğrulanmaz.

ReturnedInvoiceNumber
null | string

Bu faturanın malını iade ettiği faturanın numarası (Alış/Satış İade). Serbest metindir, var olan bir faturaya karşı doğrulanmaz.

ReturnedInvoiceDate
null | string<date>

Bu faturanın iade ettiği faturanın tarihi. Yalnızca tarih (yyyy-MM-dd), saat içermez.

Örnek:

"2026-10-15"

OrderReferenceNumber
null | string

Referans sipariş numarası (serbest metin, yalnızca bilgi amaçlı).

OrderReferenceDate
null | string<date>

Referans siparişin tarihi. Yalnızca tarih (yyyy-MM-dd), saat içermez.

Örnek:

"2026-10-15"

BranchNumber
null | string

Şube numarası (bilgi amaçlı).

BranchTitle
null | string

Şube unvanı (bilgi amaçlı).

BranchAddress
null | string

Şube adresi (bilgi amaçlı).

InvestmentIncentiveDocumentNumber
null | string

Yatırım teşvik belgesi numarası.

InvestmentIncentiveDocumentDate
null | string<date>

Yatırım teşvik belgesi tarihi. Yalnızca tarih (yyyy-MM-dd), saat içermez.

Örnek:

"2026-10-15"

EnergyPeriodStart
null | string<date-time>

Enerji dönemi başlangıç tarihi/saati, enerji sektörü faturaları için.

EnergyPeriodEnd
null | string<date-time>

Enerji dönemi bitiş tarihi/saati, enerji sektörü faturaları için.

DeliveryInfo
null | object

Export delivery information. Stored and returned as sent, not validated.

PaymentMeans
object[]

Ödeme yöntemleri. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz.

ReferencedDespatches
object[]

Referans irsaliyeler. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz.

CustomerIdentitySchemes
object[]

Cari kimlik şemaları. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz.

PublicSectorSpendingUnit
null | object

Public sector (Kamu) payer spending unit. Stored and returned as sent, not validated.

SgkInfo
null | object

SGK (social security) invoice information. Stored and returned as sent, not validated.

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.