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 kendiCurrencyCode’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 daECommerceProductCode(e-ticaret entegrasyon kodu) ile verilir; ikisinden biri zorunludur. İkisi de gönderilirseProductCodekullanılır.UnitCodezorunludur. Birim, ürünün kendi birimlerinden biri olmalıdır (ana birimi ya da 2./3. birimi). Quantitysıfırdan büyük olmalı;UnitPricenegatif olamaz ve KDV hariç olmalıdır.VatIncludedyok 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.LineGroupNameisteğe bağlıdır, satır grupları tanımından gelir.WarehouseName, stok takibi yapılan ürünlerde (StockType2-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 (StockType1 ya da stok tipi boş) satır hiçbir zaman stok hareketi oluşturmaz;WarehouseNamegönderilse de yok sayılır.CurrencyCodeher satırda zorunludur.ExchangeRate, satırın dövizi şirketin varsayılan döviziyse1olmalı; değilse zorunlu ve 0’dan büyük olmalıdır (entegratörden gelir, API hesaplamaz).WithholdingCodeveWithholdingNumerator/WithholdingDenominatorsatırın tevkifatını,WithheldVatAmounttevkif edilen KDV tutarını taşır; gönderdiğiniz gibi kaydedilir veWithheldVatAmountdiğer satır tutarları gibi denetlenir. BaşlıktakiApplyWithholding,WithholdingCode,WithholdingNumeratorveWithholdingDenominatorsatırlardan doldurulur: herhangi bir satırdaWithholdingCodevarsa tevkifat uygulanır; kod, pay ve payda tevkifatlı satırların hepsinde aynıysa o değerler, değilse boş,1ve1olur.AdditionalTaxes, satırın ek vergileridir (ör. ÖTV): her biriCode(zorunlu),Rate,Amount,Basetaşı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.
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ırLots 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
ProfileIdveInvoiceTypeCodeyalnı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
InvoiceTypeCodeIADEya daTEVKIFATIADEolmalıdır; satış faturasında bu iki değer kullanılamaz (3029). ProfileIdveInvoiceTypeCodeikisi birlikte gönderildiğinde,InvoiceTypeCodeGİB’in oProfileIdiçin izin verdiği değerlerden biri olmalıdır (aşağıdaki tabloya bakınız).- Bir satırda
VatRate0ise, fatura e-belgeyse (e-Fatura ya da e-Arşiv, yukarıdakiEInvoiceType’a bakınız)VatExemptionCodedoldurulmalıdır. - Satış faturasında herhangi bir satırda
VatExemptionCodedoluysaInvoiceTypeCodeISTISNA,IHRACKAYITLIya daSGKolmalıdır. InvoiceTypeCodeIHRACKAYITLIolan satış faturasında KDV’li olupVatExemptionCode’u boş olan satıra701yazı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 daProfileId/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.