> For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.nilvera.com/nilvera-model/archiveinvoice/invoicelines.md).

# InvoiceLines

> Fatura kalemlerinin(Mal / Hizmet) tüm detaylarının girileceği alandır.

<pre class="language-csharp"><code class="lang-csharp">public class EArchiveInvoiceLineDto
{
     public string Index { get; set; }
     public string SellerCode { get; set; }
     public string BuyerCode { get; set; }
     public string Name { get; set; }
     public string Description { get; set; }
     public decimal Quantity { get; set; }
     public string UnitType { get; set; }
     public decimal Price { get; set; }
     public decimal AllowanceTotal { get; set; }
     public decimal KDVPercent { get; set; }
     public decimal KDVTotal { get; set; }
     public List&#x3C;TaxDto> Taxes { get; set; }
     public string ManufacturerCode { get; set; }
     public string BrandName { get; set; }
     public string ModelName { get; set; }
     public string Note { get; set; }
     public string AdditionalInfoId { get; set; }
     public string SerialID { get; set; }
<strong>     public string ProductTraceID { get; set; }
</strong><strong>     public string BuyerDIBLineCode { get; set; }
</strong>     public string SellerDIBLineCode { get; set; }
     public string GTIPNo { get; set; }
     public string OzelMatrahReason { get; set; }
     public decimal OzelMatrahTotal { get; set; }
     public decimal VatAmountWithoutTevkifat { get; set; }
     public InvestmentIncentiveExpenseType InvestmentIncentiveExpenseType { get; set; }
     public TechSupportDto TechSupport { get; set; }
     public AdditionalItemIdentificationDto AdditionalItemIdentification { get; set; }
}
</code></pre>

### Index

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Fatura kaleminin sıra numarasının belirtileceği alandır.

### SellerCode

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürünün satıcı kodunun girileceği alandır.

### BuyerCode

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürünün alıcı kodunun girileceği alandır.

### Name

<mark style="color:blue;">`string`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Ürünün adının girileceği alandır.

### **Description**

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürünün açıklamasının girileceği alandır.

### Quantity

<mark style="color:blue;">`decimal`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Miktarın girileceği alandır.

### UnitType

<mark style="color:blue;">`string`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Birim tipinin girileceği alandır. Alabileceği değerler kod listeleri bölümünde [<mark style="color:blue;">Birim Kodları</mark>](https://developer.nilvera.com/kod-listeleri.md#birim-kodlari) altında belirtilmiştir.

### Price

<mark style="color:blue;">`decimal`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Ürün fiyatının girileceği alandır.

### AllowanceTotal

<mark style="color:blue;">`decimal`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> İskonto tutarının girileceği alandır.

### KDVPercent

<mark style="color:blue;">`decimal`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürünün KDV oranının girileceği alandır.

{% hint style="info" %}
**KDV Oranları:** 0,1, 10 ve 20'dir.

KDV Oranı 0 olması durumunda vergi muafiyet sebebi belirtilmelidir. Vergi muafiyet nesnesi için Bkz.  [<mark style="color:blue;">TaxExemptionReasonInfo</mark>](https://developer.nilvera.com/kod-listeleri.md#kdv-muafiyet-sebepleri)
{% endhint %}

### KDVTotal

<mark style="color:blue;">`decimal`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürünün KDV toplamının girileceği alandır.

### Taxes

<mark style="color:blue;">`List`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ürüne eklenecek diğer vergilerin girileceği alandır. Alabileceği değerler kod listeleri bölümünde [<mark style="color:blue;">Vergi Kodları</mark>](https://developer.nilvera.com/kod-listeleri.md#vergi-kodlari-listesi) altında belirtilmiştir.

```csharp
public class TaxDto
{
     public string TaxCode { get; set; }
     public decimal Total { get; set; }
     public decimal Percent { get; set; }
     public string ReasonCode { get; set; }
     public string ReasonDesc { get; set; }
}
```

> **TaxCode:** Vergi kodunun girileceği alandır.  <mark style="color:blue;">`string`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> **Total:** Vergi toplamının girileceği alandır.  <mark style="color:blue;">`decimal`</mark>  <mark style="color:orange;">`Vergiye göre değişiklik gösterir.`</mark>

> **Percent:** Vergi oranının girileceği alandır.  <mark style="color:blue;">`decimal`</mark>  <mark style="color:orange;">`Vergiye göre değişiklik gösterir.`</mark>

{% hint style="info" %}
Girilen vergi kod listeleri bölümünde [<mark style="color:blue;">Tevkifat Kodları</mark>](https://developer.nilvera.com/kod-listeleri.md#kdv-tevkifat-kodlari) altında yer alıyor ise aşağıda bulunan alanların doldurulması zorunludur.

**ReasonCode:** Kodun girileceği alandır.

**ReasonDesc:** Kodun açıklamasının girileceği alandır.
{% endhint %}

> **Örn:** Eğer girilen vergi <mark style="color:red;">**KDV Tevkifatına**</mark> ait ise;

```javascript
ArchiveInvoice.InvoiceLines[0].Taxes = [
    {
        TaxCode: "9015",
        Total: 1.72, //1.72 örnek olarak verilmiştir.
        Percent: 40,
        ReasonCode: "601",
        ReasonDesc: "Yapım İşleri İle Bu İşlerle Birlikte İfa Edilen Mühendislik"
    }
]
```

### **ManufacturerCode**

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Üretici kodunun girileceği alandır.

### **BrandName**

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Marka adının girileceği alandır.

### **ModelName**

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Model adının girileceği alandır.

### **Note**

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Notun ekleneceği alandır.

### AdditionalInfoId

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Ek bilgi (ID) girilmek istenilirse bu alan kullanılır.

### SerialID

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Şarj anlık faturalarında seri numarası, yatırım teşvik faturalarında ise InvestmentIncentiveExpenseType (Harcama Tipi) değeri "MachineAndSoftware" olduğunda Makine ID bu alana girilmelidir.

### ProductTraceID

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Yatırım teşvik faturalarında InvestmentIncentiveExpenseType (Harcama Tipi) değeri "MachineAndSoftware" olduğunda Makine Teçhizat Sıra No bu alana girilmelidir.

### BuyerDIBLineCode

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> İhraç kayıtlı faturalarda KDVExemptionReasonCode değeri "702" (DİİB ve Geçici Kabul Rejimi Kapsamındaki Satışlar) olduğunda Alıcı Satır Kodu bu alana girilir.

{% hint style="info" %}
Alıcı satır kodu 11 haneden oluşmalıdır.
{% endhint %}

### SellerDIBLineCode

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> İhraç kayıtlı faturalarda KDVExemptionReasonCode değeri "702" (DİİB ve Geçici Kabul Rejimi Kapsamındaki Satışlar) olduğunda Satıcı Satır Kodu bu alana girilir.

### GTIPNo

<mark style="color:blue;">`string`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> E-Arşiv istisna faturalarında, GTIP (Gümrük Tarife İstatistik Pozisyonu) numarasının girilmesi gereken alandır.&#x20;

> İhraç kayıtlı faturalarda ise `KDVExemptionReasonCode` değerinin **702 (DİİB ve Geçici Kabul Rejimi Kapsamındaki Satışlar)** olması durumunda GTIP numarası bu alana girilmelidir.

### OzelMatrahReason

<mark style="color:blue;">`string`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Özel matrah nedeninin girileceği alandır. Alabileceği değerler kod listeleri bölümünde Özel Matrah Kodları altında belirtilmiştir.

{% hint style="info" %}
Fatura tipi <mark style="color:red;">**“OZELMATRAH”**</mark> olması durumunda doldurulacaktır.
{% endhint %}

### OzelMatrahTotal

<mark style="color:blue;">`decimal`</mark>  <mark style="color:red;">`Zorunlu`</mark>

> Özel matrah tutarının girileceği alandır.

{% hint style="info" %}
Fatura tipi <mark style="color:red;">**“OZELMATRAH”**</mark> olması durumunda doldurulacaktır.
{% endhint %}

{% hint style="info" %}
Satış bedeli tek kalemde girilecektir. Kalemde gösterilen KDV "Özel Matrah Tutarı" üzerinden hesaplanacaktır.
{% endhint %}

### VatAmountWithoutTevkifat

<mark style="color:blue;">`decimal`</mark>  <mark style="color:orange;">`Seçimli`</mark>

{% hint style="info" %} <mark style="color:red;">**TEVKİFAT İADE**</mark> faturalarında tevkifatsız KDV tutarın girileceği alandır.
{% endhint %}

{% hint style="info" %}
Fatura tipi <mark style="color:red;">**“TEVKIFATIADE”**</mark> veya <mark style="color:red;">**"YTBTEVKIFATIADE"**</mark> olması durumunda doldurulacaktır.
{% endhint %}

### InvestmentIncentiveExpenseType

<mark style="color:blue;">`enum`</mark>  <mark style="color:orange;">`Seçimli`</mark>

> Yatırım teşvik faturalarında, harcama tipinin belirtildiği alandır.

```csharp
public enum InvestmentIncentiveExpenseType
{
    MachineAndSoftware = 1,
    Construction = 2,
    LandAndPlotSale = 3,
    Other = 4
 }
```

### TechSupport

<mark style="color:orange;">`Seçimli`</mark>

> Fatura tipi TEKNOLOJIDESTEK olan faturalarda, satışı yapılan cihaza (telefon, tablet, bilgisayar) ait bilgilerin girileceği alandır.

```csharp
 public class TechSupportDto
 {
     public List<string> IMEINumbers { get; set; }
     public bool IsTabletOrPc { get; set; }
 }
```

{% hint style="warning" %}
Bu alan yalnızca **InvoiceType** değeri **TEKNOLOJIDESTEK** olan faturalarda dikkate alınır. Diğer fatura tiplerinde gönderilse bile faturaya yansıtılmaz.
{% endhint %}

> **IMEINumbers:** Satışı yapılan telefona ait IMEI numaralarının girileceği alandır. Birden fazla IMEI numarası girilebilir. Girilen numaralar faturada ilgili kalemin **AdditionalItemIdentification** alanına **SchemeID = "TELEFON"** olacak şekilde, `;` ile birleştirilerek `(IMEI)numara1;(IMEI2)numara2;(IMEI3)numara3` formatında eklenir.

> **IsTabletOrPc:** Satışı yapılan ürünün tablet veya bilgisayar olması durumunda **true** gönderilir. **true** gönderildiğinde ilgili kalemin **AdditionalItemIdentification** alanına **SchemeID = "TABLET\_PC"** bilgisi eklenir.

```javascript
// Telefon satışı (birden fazla IMEI)
ArchiveInvoice.InvoiceLines[0].TechSupport = {
    IMEINumbers: ["356938035643809", "356938035643817"],
    IsTabletOrPc: false
};
// Fatura XML'ine yansıyan değer -> SchemeID: "TELEFON", ID: "(IMEI)356938035643809;(IMEI2)356938035643817"

// Tablet / bilgisayar satışı
ArchiveInvoice.InvoiceLines[1].TechSupport = {
    IsTabletOrPc: true
};
// Fatura XML'ine yansıyan değer -> SchemeID: "TABLET_PC"
```

### AdditionalItemIdentification

<mark style="color:orange;">`Seçimli`</mark>

```csharp
public class AdditionalItemIdentificationDto
{
    public string TagNumber { get; set; }
    public string OwnerName { get; set; }
    public string OwnerTaxNumber { get; set; }
}
```

> **TagNumber:** Hal Kayıt Sistemi Satış ve Komisyoncu faturalarında künye numarasının girildiği alandır.

> **OwnerName:** Hal Kayıt Sistemi Satış faturalarında mal sahibinin ünvanının belirtildiği alandır.

> **OwnerTaxNumber:** Hal Kayıt Sistemi Satış faturalarında mal sahibinin vergi kimlik numarasının veya T.C. kimlik numarasının belirtildiği alandır.
