Skip to main content
PATCH
Alış faturasını kısmi güncelle
Gövdede yalnızca değiştirmek istediğiniz alanları gönderirsiniz; gönderilmeyen alanlar mevcut değerlerini korur. Kurallar ve örnekler: kısmi güncelleme.
  • Gönderilmeyen bir alan değişmez; null gönderilen bir alan temizlenir.
  • Doğrulama birleştirilmiş kayıt üzerinde çalışır; zorunlu bir alanı null yaparsanız istek reddedilir.
  • Listeler birleştirilmez: Lines gönderilirse faturanın tüm satırlarının yerini alır, tam güncellemedekiyle aynı satır kimliği kuralıyla; gönderilmezse satırlar olduğu gibi kalır.
  • API toplamları yeniden hesaplamaz: satırları ya da tutarları değiştirirseniz ilgili toplamları da gönderin.

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ı, günlük limit) 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. Cari endpoint'lerinde isteğ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

Fatura ID'si.

Gövde

InvoiceNumber
null | string

Zorunlu. Fatura numarası, şirkette bu fatura tipi için benzersizdir. Oluştururken "Next" gönderirseniz ilgili numara serisinden ya da uygun olduğunda e-fatura numaralandırmasından otomatik üretilir. En fazla 20 karakter.

Örnek:

"9446A4D834"

DocumentNumber
null | string

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

Date
null | string<date-time>

Zorunlu. Fatura tarihi. Tarih kısmı fatura tarihi olarak kaydedilir; saat gönderilirse fatura saati olarak, gönderilmezse o anki saat kullanılır.

Örnek:

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

Description
null | string

Açıklama. En fazla 1000 karakter.

CustomerCode
null | string

Zorunlu. Cari kodu (GET /api/v1/customers'tan carinin CustomerCode'u). Faturanın adres, unvan ve vergi alanları kaydedildiği anda cariden kopyalanır, istekte kabul edilmez.

Örnek:

"C-0001"

CurrencyCode
null | string

Zorunlu. GET /api/v1/definitions/currencies'ten döviz kodu.

Örnek:

"TRY"

DueDays
integer<int32>

Gün olarak vade. 0'dan küçük olamaz.

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.

ShipmentDefinitionCode
null | string

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

DiscountTotal
number<double>

Toplam indirim tutarı. Entegratör tarafından gönderilir, API hesaplamaz.

SubTotal
number<double>

Ara toplam (satır tutarlarının vergisiz toplamı). Entegratör tarafından gönderilir, API hesaplamaz.

VatTotal
number<double>

Toplam KDV tutarı. Entegratör tarafından gönderilir, API hesaplamaz.

GrandTotal
number<double>

Genel toplam. Entegratör tarafından gönderilir, API hesaplamaz.

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.

PrintDescription
boolean

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

Cancelled
boolean

Faturanın iptal edilip edilmediği.

AverageExchangeRate
number<double>

Satırların ağırlıklı ortalama kuru. Entegratör tarafından gönderilir, API hesaplamaz. Her şey şirketin varsayılan dövizindeyse 1 kullanın.

Örnek:

1

ApplyWithholding
boolean

Bu faturaya tevkifat uygulanıp uygulanmadığı.

WithholdingCode
null | string

Tevkifat kodu. En fazla 10 karakter.

WithholdingNumerator
integer<int32>

Tevkifat oranının payı (ör. 9/10'daki 9).

WithholdingDenominator
integer<int32>

Tevkifat oranının paydası (ör. 9/10'daki 10).

WithholdingTotal
number<double>

Toplam tevkif edilen KDV tutarı. Satırların tevkif edilen KDV'lerinin toplamı olarak API tarafından hesaplanır.

AdditionalTaxTotal
number<double>

Toplam ek vergi tutarı. Entegratör tarafından gönderilir, API hesaplamaz.

EInvoiceType
integer<int32>

Bu fatura kaydının e-fatura sınıflandırması: 0 e-belge değil, 1 e-Fatura, 2 e-Arşiv, 3 e-Arşiv (internet), 4 gelen e-Fatura, 5 e-Müstahsil. Entegratör tarafından verilir; API yalnızca aralık kontrolü yapar ve satış/alış iade faturasında InvoiceNumber "Next" olduğunda hangi e-fatura numaralandırma serisinin kullanılacağını belirlemek için kullanır.

Örnek:

1

ProfileId
null | string

E-belgenin UBL profil ID'si (ör. "TEMELFATURA", "TICARIFATURA"). Gönderildiği gibi kaydedilir; doğrulanmaz ya da işlem yapılmaz.

InvoiceTypeCode
null | string

E-belgenin UBL fatura tipi kodu (ör. "SATIS", "IADE"). Gönderildiği gibi kaydedilir; doğrulanmaz ya da işlem yapılmaz.

WithholdingTaxRate
number<double>

Stopaj oranı, serbest meslek/müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir.

SocialSecurityRate
number<double>

Bağ-Kur oranı, serbest meslek/müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir.

MarketRate
number<double>

Borsa oranı, müstahsil tarzı faturalarda kullanılır. Gönderildiği gibi kaydedilir.

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-time>

Bu faturanın malını iade ettiği faturanın tarihi.

OrderReferenceNumber
null | string

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

OrderReferenceDate
null | string<date-time>

Referans siparişin tarihi.

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-time>

Yatırım teşvik belgesi tarihi.

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
object[]

İhracat teslimat bilgisi. Gönderildiği gibi kaydedilir ve döndürülür, doğrulanmaz.

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.

Lines
object[]

Zorunlu, en az bir satır. Güncellemede, satırların gönderildiği sıra kimliklerini belirler, irsaliyedeki gibi: mevcut bir satırla aynı pozisyondaki satır o satırla aynı kabul edilir (ürettiği depo hareketi, Lot/seri no ve sipariş/irsaliye bağlantısı kayıtları onunla birlikte taşınır).

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.