Ana içeriğe atla
Alış faturası, bir başlık ve bir ya da daha fazla satırdan oluşur. Fatura tipi hiçbir zaman istekte bir alan değildir: çağırdığınız endpoint’e göre sabittir. Dört fatura endpoint grubu vardır — Alış, Satış, Alış İade ve Satış İade — aynı alanları, numaralandırma mekanizmasını ve sonuç kodlarını paylaşır; farklar ilgili sayfalarda belirtilmiştir.
API satır tutarlarını hesaplamaz, ama birbirini tuttuğunu denetler. Satır tutarları, indirim tutarları, KDV, ek vergiler ve tevkifat gönderdiğiniz gibi kaydedilir (irsaliye satırlarıyla aynı alanlar); tutarları Noyax’ın kurallarına uymayan satır reddedilir (3126). Fatura toplamları, AverageExchangeRate ve başlıktaki tevkifat alanları satırlardan doldurulur; bunlar için gönderilen değerler yok sayılır. Faturanın dövizini (satırlardan türetilir) ve satırın ana birim miktarını da API hesaplar. Satırın AdditionalTaxes listesi ürünün ek vergileriyle aynı kurallara uyar: en fazla 3, her Code zorunlu ve listedeki kodlardan biri, bir kod satırda yalnızca bir kez kullanılabilir.

Zorunlu alanlar

  • InvoiceNumber: şirkette bu fatura tipi içinde benzersiz, en fazla 20 karakter. Oluştururken "Next" gönderilirse numara ALFATNO seri numarasından otomatik üretilir. Güncellemede "Next" gönderilemez.
  • Date: fatura tarihi. Saat de gönderirseniz fatura 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, her satırda kendi CurrencyCode’u.
DueDays (vade günü) faturayla birlikte saklanır. ShipmentDefinitionCode (isteğe bağlı) sevkiyat tanımlarından gelir. Fatura dövizi ve EInvoiceType istekte yer almaz, API tarafından belirlenir: CurrencyCode başlıkta değil her satırda gönderilir; faturanın 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/CurrencyId olarak döner. AverageExchangeRate satırlardan doldurulur, istekte gönderilen değer yok sayılır (bkz. dövizler). EInvoiceType yanıtta döner: alış ve satış iade faturalarında ve şirket e-Fatura kullanmıyorsa 0; e-Fatura kullanan şirketin satış ya da alış iade faturasında cari e-Fatura mükellefiyse ya da ProfileId IHRACAT ise 1 (e-Fatura), değilse 2 (e-Arşiv).

Cariden alınan bilgiler

Faturanın adresi, unvanı, vergi numarası ve vergi dairesi istekte alan olarak yer almaz. Bunlar, faturanın kaydedildiği anda cariden kopyalanır (carinin fatura adresi varsa o, yoksa ilk adresi) ve cari sonradan değişse bile faturada sabit kalır — bu yüzden yalnızca yanıtlarda görünürler (Address, CustomerTitle, TaxNumber, TaxOffice).

Satırlar

  • Ürün ProductCode (ürün kodu) ya da ECommerceProductCode (e-ticaret entegrasyon kodu) ile verilir; ikisinden biri zorunludur. İkisi de gönderilirse ProductCode kullanılır. UnitCode zorunludur. Birim, ürünün kendi birimlerinden biri olmalıdır (ana birimi ya da 2./3. birimi).
  • Quantity sıfırdan büyük olmalı; UnitPrice negatif olamaz ve KDV hariç olmalıdır. VatIncluded yok sayılır (mevcut istekler çalışmaya devam etsin diye kabul edilir).
  • Discounts, satırın indirim oranlarının listesidir, sırasıyla art arda uygulanır.
  • LineGroupName isteğe bağlıdır, satır grupları tanımından gelir.
  • WarehouseName, stok takibi yapılan ürünlerde (StockType 2-7) zorunludur ve şirketin depolarından biri olmalıdır; bu satırlar stok hareketi oluşturur (aşağıya bakınız). Stok takibi yapılmayan ürünlerde (StockType 1 ya da stok tipi boş) satır hiçbir zaman stok hareketi oluşturmaz; WarehouseName gönderilse de yok sayılır.
  • CurrencyCode her satırda zorunludur. ExchangeRate, satırın dövizi şirketin varsayılan döviziyse 1 olmalı; değilse zorunlu ve 0’dan büyük olmalıdır (entegratörden gelir, API hesaplamaz).
  • WithholdingCode ve WithholdingNumerator/WithholdingDenominator satırın tevkifatını, WithheldVatAmount tevkif edilen KDV tutarını taşır; gönderdiğiniz gibi kaydedilir ve WithheldVatAmount diğer satır tutarları gibi denetlenir. Başlıktaki ApplyWithholding, WithholdingCode, WithholdingNumerator ve WithholdingDenominator satırlardan doldurulur: herhangi bir satırda WithholdingCode varsa tevkifat uygulanır; kod, pay ve payda tevkifatlı satırların hepsinde aynıysa o değerler, değilse boş, 1 ve 1 olur.
  • AdditionalTaxes, satırın ek vergileridir (ör. ÖTV): her biri Code (zorunlu), Rate, Amount, Base taşır; en fazla 3 tane gönderilebilir. Code, ek vergi kodlarından biri olmalı ve satırda yalnızca bir kez kullanılabilir (3124, 3125). Satırda ek vergi yoksa boş bırakın.
Yanıttaki MainUnitQuantity, Quantity’nin ürünün ana birimine çevrilmiş halidir; irsaliye satırlarıyla aynı hesaplama: UnitCode ana birimse miktarın kendisi, değilse birimin çarpanına bölünmüş hali. Mal girişinde (alış ve satış iade faturası) artı, çıkışında (satış ve alış iade faturası) eksi işaretle döner.

Stok hareketi, Lot ve seri no takibi

Stok takibi yapılan bir ürünün satırı, fatura kaydedilirken stok hareketi de oluşturur (alış faturasında giriş). Ürünün stok tipine göre satır Lots ya da SerialNumbers taşır; kurallar irsaliyedekiyle aynıdır (Lot izlenen bir ürün LotNo/Quantity/UnitCode ister, FIFO/LIFO/FEFO bir ürünün giriş girdileri yeni lot oluşturur, seri izlenen bir ürünün girdileri yeni seri no kaydeder). Stok hareketi, ürünün “işlemi durdur” seçili kritik stok kontrollerine de tabidir (4401, 4402, 4403).

Faturayı güncelleme

Yalnızca açıklayıcı alanlar güncellenebilir (Description, DocumentNumber, ShipmentDefinitionCode, SharingCode, PrintDescription, Consolidated, iade/sipariş referansları, şube ve yatırım teşvik bilgileri, enerji dönemi ve ek yapısal alanlar). Satırlar, cari, tarih ve saat, fatura numarası, vade, tutarlar ve vergiler fatura oluşturulduktan sonra sabittir: bkz. Alış faturası güncelleme. Bunları düzeltmek için fatura silinip yeniden oluşturulur ya da iade faturası kesilir. GİB’e gönderilmiş fatura silinemez (3027), ama açıklayıcı alanları yine de güncellenebilir.

Sipariş ve irsaliye bağlantısı

Noyax uygulamasında bir sipariş ya da irsaliye aktarılarak oluşturulan fatura satırı o sipariş/irsaliye satırına bağlı kalır; irsaliyeden aktarılan satır kendi stok hareketini üretmez, irsaliyenin hareketi geçerlidir. API böyle aktarımlar oluşturmaz: API ile oluşturulan faturalar siparişlere ya da irsaliyelere bağlı değildir ve deposu olan her satır kendi stok hareketini üretir.

Cari hareket

Her alış faturası koşulsuz olarak bir cari hareket kaydı oluşturur (alacak, çünkü alış faturası şirketin tedarikçiye olan borcunu artırır) — Sipariş’in isteğe bağlı CreateCustomerMovement’ının aksine burada bir seçenek yoktur. Bu hareket bir tahsilat/ödeme ile zaten kapatılmışsa faturanın carisi, tutarı ve dövizi artık değiştirilemez ve fatura silinemez (3015). Hareketin tutarı faturanın GrandTotal değeridir; InvoiceTypeCode IHRACKAYITLI olan satış faturasında tecil edilen vergiler düşülür (bkz. satış faturaları).

Kaydet kontrolleri

  • ProfileId ve InvoiceTypeCode yalnızca satış ve alış iade faturasında kullanılır; alış ve satış iade faturasında yok sayılır. Şirket e-Fatura kullanıyorsa satış ve alış iade faturasında ikisi de zorunludur; kullanmıyorsa ikisi de isteğe bağlıdır.
  • Alış iade faturasında InvoiceTypeCode IADE ya da TEVKIFATIADE olmalıdır; satış faturasında bu iki değer kullanılamaz (3029).
  • ProfileId ve InvoiceTypeCode ikisi birlikte gönderildiğinde, InvoiceTypeCode GİB’in o ProfileId için izin verdiği değerlerden biri olmalıdır (aşağıdaki tabloya bakınız).
  • Bir satırda VatRate 0 ise, fatura e-belgeyse (e-Fatura ya da e-Arşiv, yukarıdaki EInvoiceType’a bakınız) VatExemptionCode doldurulmalıdır.
  • Satış faturasında herhangi bir satırda VatExemptionCode doluysa InvoiceTypeCode ISTISNA, IHRACKAYITLI ya da SGK olmalıdır.
  • InvoiceTypeCode IHRACKAYITLI olan satış faturasında KDV’li olup VatExemptionCode’u boş olan satıra 701 yazılır.
  • Şirket e-Fatura kullanıyorsa, satış ve alış iade faturasında seçilen carinin vergi numarası, fatura ünvanı ve vergi dairesi dolu olmalıdır.

Ek yapılandırılmış alanlar

Fatura, daha az sık karşılaşılan senaryolar (ihracat, kamu, SGK, ilaç/tıbbi cihaz, Hal) için bir dizi tamamen isteğe bağlı ek alan kabul eder. Bunların hiçbiri API tarafından doğrulanmaz ya da ProfileId/InvoiceTypeCode ile herhangi bir şekilde eşleştirilmez: ne gönderirseniz olduğu gibi kaydedilir ve döner; kendi ProfileId’nize uygun olanları göndermek sizin sorumluluğunuzdadır. Başlık: DeliveryInfo (ihracat teslimat adresi ve şartları), PaymentMeans (ödeme yöntemleri), ReferencedDespatches (faturanın referans verdiği irsaliyeler), CustomerIdentitySchemes (ek cari kimlik numaraları, ör. MUSTERINO, TICARETSICILNO), PublicSectorSpendingUnit (ödemeyi yapacak kamu harcama birimi) ve SgkInfo (SGK fatura detayları). Satır: ExportInfo (satırın ihracat teslimat/paketleme detayları), MedicineDeviceInfo (ilaç/tıbbi cihaz takip satırları), HalInfo (hal künye bilgisi) ve ProductInfo (model, marka, menşei ülke ve diğer tanımlayıcılar).

Paylaşım

SharingCode faturayı 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 faturalar 404 döner.