Ana içeriğe atla
POST
Satış iade faturası oluştur
Fatura, satırları, satırların indirimleri ve stok hareketi olan satırların Lot/seri no girdileri tek bir transaction’da yazılır: herhangi biri geçersizse hiçbir şey kaydedilmez ve tüm hatalar tek bir Message’da döner. Satır hataları satır numarasıyla başlar, ör. Line 2: Quantity must be greater than 0.

Alan kuralları

Numaralandırma, stok hareketi yönü, cari hareket yönü.

Hesaplamalar

Tutarların ve toplamların nasıl hesaplandığı (fatura satırları sipariş/irsaliye satırlarıyla aynı alanları kullanır).
API satır tutarlarını hesaplamaz, ama birbirini tuttuğunu denetler (3126); bkz. hesaplamalar. Fatura toplamları, AverageExchangeRate ve başlıktaki tevkifat alanları satırlardan doldurulur. UnitPrice’ı KDV hariç gönderin.
  • InvoiceNumber yerine "Next" gönderirseniz numara SATİADEFATNO serisinden üretilir.
  • Cari CustomerCode ile ya da elinizde yalnızca o varsa vergi numarasıyla (CustomerTaxNumber) verilir; ikisinden biri zorunludur, ikisi de gönderilirse CustomerCode kullanılır. Vergi numarası birden fazla cariye aitse istek belirsiz olduğu için reddedilir (0580); bu durumda CustomerCode gönderin.
  • Carinin adresi, unvanı, vergi numarası ve vergi dairesi cariden kopyalanır, istekte kabul edilmez.
  • Fatura her zaman bir cari hareket kaydı (alacak) oluşturur.
  • Başarılı yanıt 201 Created’dır; Location header’ı yeni faturayı gösterir.

Asgari istek

Yalnızca zorunlu alanlarla çalışan bir istek; satır tutarları birbirini tutar (API bunu denetler), başlık toplamları satırlardan doldurulur. Kod ve adları kendi şirketinizdekilerle değiştirin. WarehouseName stok takibi yapılan ürünlerde zorunludur; Lot ya da seri no izlenen bir üründe satır Lots ya da SerialNumbers da taşımalıdır. Satış iade faturasında ProfileId ve InvoiceTypeCode kullanılmaz.

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

Gövde

InvoiceNumber
null | string
gerekli

Zorunlu. Fatura numarası, şirkette bu fatura tipi içinde benzersizdir (satış ve alış iade faturaları tek numaralandırmayı paylaşır). Oluştururken "Next" gönderirseniz ilgili numara serisinden ya da uygun olduğunda e-Fatura veya e-Arşiv numaralandırmasından otomatik üretilir. En fazla 20 karakter.

Örnek:

"FAT2026000125"

Date
null | string<date-time>
gerekli

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"

Lines
object[]
gerekli

Zorunlu, en az bir satır. Satırlar fatura oluşturulduktan sonra değiştirilemez.

CustomerTaxNumber
null | string

Carinin vergi numarası (VKN ya da TCKN); cariyi bulmak için CustomerCode yerine kullanılabilir. Yalnızca CustomerCode boşsa dikkate alınır; bu vergi numarasına sahip birden fazla cari varsa CustomerCode gönderin.

Örnek:

null

DocumentNumber
null | string

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

Description
null | string

Açıklama. En fazla 1000 karakter.

CustomerCode
null | string

Cari kodu (GET /api/v1/customers yanıtındaki CustomerCode). Oluştururken CustomerCode ya da CustomerTaxNumber gönderin; ikisinden biri zorunludur, ikisi de gönderilirse CustomerCode kullanılır. Faturanın adres, unvan ve vergi alanları kaydedildiği anda cariden kopyalanır ve istekte kabul edilmez.

Örnek:

"C-0001"

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

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.

Örnek:

1350

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ğı.

ApplyWithholding
boolean

Tevkifat uygulanıp uygulanmadığı: bir satırda WithholdingCode varsa true. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

WithholdingCode
null | string

Tevkifatlı bütün satırlarda kod, pay ve payda aynıysa satırların tevkifat kodu, değilse boş. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

WithholdingNumerator
integer<int32>

Satırların ortak tevkifat payı; satırlar farklıysa ya da tevkifat yoksa 1. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

WithholdingDenominator
integer<int32>

Satırların ortak tevkifat paydası; satırlar farklıysa ya da tevkifat yoksa 1. Satırlardan doldurulur; istekte gönderilen değer kullanılmaz.

WithholdingTotal
number<double>

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

Örnek:

0

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

ProfileId
null | string

e-belgenin UBL profil kimliği (ör. "TEMELFATURA", "TICARIFATURA"). Satış ve alış iade faturasında kullanılır, şirket e-Fatura kullanıyorsa zorunludur; alış ve satış iade faturasında yok sayılır. ProfileId ve InvoiceTypeCode birlikte gönderilirse InvoiceTypeCode bu ProfileId için izin verilen değerlerden biri olmalıdır.

InvoiceTypeCode
null | string

e-belgenin UBL fatura tipi kodu (ör. "SATIS", "IADE"). Satış ve alış iade faturasında kullanılır, şirket e-Fatura kullanıyorsa zorunludur; alış ve satış iade faturasında yok sayılır. Alış iade faturasında 'IADE' ya da 'TEVKIFATIADE' zorunludur, satış faturasında bu ikisi kullanılamaz. 'IHRACKAYITLI' satış faturasında KDV'li ve VatExemptionCode'u boş satıra 701 yazılır.

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>

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.

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

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.