> 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/marketplace/invoices.md).

# Invoices

```csharp
 public class InvoiceSend
 {
     public Guid UUID { get; set; }
     public string Serie { get; set; }
     public Guid TemplateUUID { get; set; }
     public DateTime IssueDate { get; set; }
     public decimal? ExchangeRate { get; set; }
     public string KDVExemptionReasonCode { get; set; }
     public Guid StoreUUID { get; set; }
 }
```

### InvoiceSend Sınıfı Özellikleri ve Açıklamaları

> `InvoiceSend` nesnesi, siparişi faturaya dönüştürmek için kullanılan nesnesidir.

<table><thead><tr><th width="142">Alan</th><th width="603">Açıklama</th></tr></thead><tbody><tr><td><strong>UUID</strong></td><td>Siparişin UUID değeri</td></tr><tr><td><strong>Serie</strong></td><td>Fatura serisi</td></tr><tr><td><strong>TemplateUUID</strong></td><td>Fatura şablonu UUID değeri.  Boş geçilirse faturaya varsayılan tasarım eklenecektir.</td></tr><tr><td><strong>IssueDate</strong></td><td>Fatura tarihi ve saati</td></tr><tr><td><strong>ExchangeRate</strong></td><td>Döviz kuru</td></tr><tr><td><strong>KDVExemptionReasonCode</strong></td><td>Faturadaki 0 KDV için vergi muafiyet sebebi. Alabileceği değerler kod listeleri bölümünde <a href="https://developer.nilvera.com/kod-listeleri#kdv-muafiyet-sebepleri">KDV Muafiyet Sebepleri</a> altında belirtilmiştir.</td></tr><tr><td><strong>StoreUUID</strong></td><td>Siparişin bulunduğu mağaza UUID değeri</td></tr></tbody></table>

***

```csharp
public class SendModelResponse
{
    public bool IsSuccess { get; set; }
    public string OrderNumber { get; set; }
    public InvoiceDetail InvoiceDetail { get; set; }
    public List<ErrorNilvera> ErrorDetail { get; set; }
}
```

### SendModelResponse Sınıfı Özellikleri ve Açıklamaları

> `SendModelResponse` nesnesi, sipariş faturaya dönüştükten sonraki yanıt nesnesidir.

<table><thead><tr><th width="142">Alan</th><th width="606">Açıklama</th></tr></thead><tbody><tr><td><strong>IsSuccess</strong></td><td>Faturanın başarıyla oluşturulup oluşturulmadığını belirtir.</td></tr><tr><td><strong>OrderNumber</strong></td><td>Sipariş numarası</td></tr><tr><td><strong>InvoiceDetail</strong></td><td>Fatura detayı <a href="#invoicedetail-sinifi-ozellikleri-ve-aciklamalari"><code>InvoiceDetail</code></a></td></tr><tr><td><strong>ErrorDetail</strong></td><td>Hata oluşmuşsa hata detayı bulunur.</td></tr></tbody></table>

***

```csharp
public class InvoiceDetail
{
    public string InvoiceNumber { get; set; }
    public string UUID { get; set; }
}
```

### InvoiceDetail Sınıfı Özellikleri ve Açıklamaları

> `InvoiceDetail` nesnesi, yanıttaki fatura detaylarını verir.

<table><thead><tr><th width="167">Alan</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>InvoiceNumber</strong></td><td>Fatura numarası</td></tr><tr><td><strong>UUID</strong></td><td>Faturaya ait UUID değeri</td></tr></tbody></table>

***

```csharp
 public class OrderResponsePagination
{
    public int Page { get; set; }

    public int PageSize { get; set; }

    public int? TotalCount { get; set; }

    public int? TotalPages { get; set; }

    public IEnumerable<OrderResponse> Content { get; set; }
}
```

### OrderResponsePagination Sınıfı Özellikleri ve Açıklamaları

> `OrderResponsePagination` sipariş sayfalama bilgilerini ve listesini getiren nesnedir.

<table><thead><tr><th width="150">Alan</th><th width="504">Açıklama</th><th width="94">Değer</th></tr></thead><tbody><tr><td><strong>Page</strong></td><td>Mevcut sayfa numarasıdır. Sayfalama yapılan veride hangi sayfanın döndüğünü belirtir.</td><td>1</td></tr><tr><td><strong>PageSize</strong></td><td>Bir sayfada kaç kayıt bulunduğunu belirtir.</td><td>10</td></tr><tr><td><strong>TotalCount</strong></td><td>Tüm sayfalardaki toplam kayıt sayısını gösterir.</td><td>100</td></tr><tr><td><strong>TotalPages</strong></td><td>Toplam sayfa sayısını ifade eder.</td><td>2</td></tr><tr><td><strong>Content</strong></td><td>Sipariş listesi <a href="#orderresponse-sinifi-ozellikleri-ve-aciklamalari"><code>OrderResponse</code></a></td><td></td></tr></tbody></table>

***

```csharp
 public class OrderResponse
{
    public int ID { get; set; }
    public string UUID { get; set; }
    public string OrderNumber { get; set; }
    public string CustomerName { get; set; }
    public string CustomerTaxNumber { get; set; }
    public OrderStatus Status { get; set; }
    public DateTime OrderDate { get; set; }
    public decimal TotalPrice { get; set; }
    public string CurrencyCode { get; set; }
    public bool IsSend { get; set; }
    public string CargoName { get; set; }
    public string CargoNumber { get; set; }
    public string CargoTrackingLink { get; set; }
    public string PaymentMethod { get; set; }
    public DateTime PaymentDate { get; set; }
    public string InvoiceNumber { get; set; }
    public string InvoiceUUID { get; set; }
    public bool IsExport { get; set; }
    public bool IsException { get; set; }
    public InvoiceType InvoiceType { get; set; }
    public InvoiceUploadStatus InvoiceUploadStatus { get; set; }
    public string InvoiceUploadStatusDescription { get; set; }

}
```

### OrderResponse Sınıfı Özellikleri ve Açıklamaları

> `OrderResponse` nesnesi, sipariş nesnesidir.

<table><thead><tr><th width="193">Alan</th><th width="348">Açıklama</th><th width="206">Değer</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Sipariş ID</td><td>123</td></tr><tr><td><strong>UUID</strong></td><td>Sipariş UUID</td><td>A3F7C9E1-5B2D-4F8A-9C6E-1D2B7E4A9F30</td></tr><tr><td><strong>OrderNumber</strong></td><td>Sipariş numarası</td><td>10210390000</td></tr><tr><td><strong>CustomerName</strong></td><td>Alıcı adı</td><td>string</td></tr><tr><td><strong>CustomerTaxNumber</strong></td><td>Alıcı TCKN</td><td>11111111111</td></tr><tr><td><strong>Status</strong></td><td>Sipariş durumu</td><td>Delivered</td></tr><tr><td><strong>OrderDate</strong></td><td>Sipariş tarihi</td><td>2026-01-01T12:00:00.000</td></tr><tr><td><strong>TotalPrice</strong></td><td>Toplam sipariş tutarı</td><td>5499</td></tr><tr><td><strong>CurrencyCode</strong></td><td>Para birimi</td><td>TRY</td></tr><tr><td><strong>IsSend</strong></td><td>Sipariş faturalandırıldıysa bu alan true döner.</td><td>false</td></tr><tr><td><strong>CargoName</strong></td><td>Kargo firması adı</td><td>Trendyol Express</td></tr><tr><td><strong>CargoNumber</strong></td><td>Kargo numarası</td><td>4829176503948217</td></tr><tr><td><strong>CargoTrackingLink</strong></td><td>Kargo linki</td><td>string</td></tr><tr><td><strong>PaymentMethod</strong></td><td>Ödeme tipi</td><td>KREDIKARTI/BANKAKARTI</td></tr><tr><td><strong>PaymentDate</strong></td><td>Sipariş ödeme tarihi</td><td>2026-01-01T12:00:00.000</td></tr><tr><td><strong>InvoiceNumber</strong></td><td>Fatura numarası</td><td>ABC2026000000002</td></tr><tr><td><strong>InvoiceUUID</strong></td><td>Fatura UUID değeri</td><td>A3F7C9E1-5B2D-4F8A-9C6E-1D2B7E4A9F30</td></tr><tr><td><strong>IsExport</strong></td><td>Yurtdışı siparişi ise true olur.</td><td>true</td></tr><tr><td><strong>IsException</strong></td><td>KDV 0 ise true gelir.</td><td>false</td></tr><tr><td><strong>InvoiceType</strong></td><td>Fatura tipi</td><td>SATIS</td></tr><tr><td><strong>InvoiceUploadStatus</strong></td><td>Faturanın mağazaya yüklenme durumu</td><td>None</td></tr><tr><td><strong>InvoiceUploadStatusDescription</strong></td><td>Faturanın mağazaya yüklenme durumunda bir hata oluştuysa hata açıklaması burada yer alır.</td><td>null</td></tr></tbody></table>

***

```csharp
public class OrderDetailResponse
{
    public int ID { get; set; }
    public string OrderNumber { get; set; }
    public DateTime OrderDate { get; set; }
    public StoreType StoreType { get; set; }
    public string CurrencyCode { get; set; }
    public OrderStatus Status { get; set; }
    public decimal? TotalPrice { get; set; }
    public IEnumerable<OrderLineDto> OrderLines { get; set; }
    public CustomerResponse Customer { get; set; }
    public bool IsSend { get; set; }
    public string WebSite { get; set; }
    public string PaymentMethod { get; set; }
    public string PaymentMethodName { get; set; }
    public DateTime? PaymentDate { get; set; }
    public string TransporterRegisterNumber { get; set; }
    public DateTime? TransportDate { get; set; }
    public string CargoName { get; set; }
    public string CargoNumber { get; set; }
    public string CargoTrackingLink { get; set; }
    public string InvoiceUUID { get; set; }
    public string StoreUUID { get; set; }
    public bool IsExport { get; set; }
    public InvoiceType InvoiceType { get; set; }
    public InvoiceUploadStatus InvoiceUploadStatus { get; set; }
}
```

### OrderDetailResponse Sınıfı Özellikleri ve Açıklamaları

> `OrderDetailResponse` nesnesi, sipariş detayı nesnesidir.

<table><thead><tr><th width="202">Alan</th><th width="322">Açıklama</th><th width="226">Değer</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Sipariş ID</td><td>123</td></tr><tr><td><strong>OrderNumber</strong></td><td>Sipariş numarası</td><td>10210390000</td></tr><tr><td><strong>OrderDate</strong></td><td>Sipariş tarihi</td><td>2026-01-01T12:00:00.000</td></tr><tr><td><strong>StoreType</strong></td><td>Mağaza tipi</td><td>Trendyol</td></tr><tr><td><strong>CurrencyCode</strong></td><td>Para birimi</td><td>TRY</td></tr><tr><td><strong>Status</strong></td><td>Sipariş durumu</td><td>Delivered</td></tr><tr><td><strong>TotalPrice</strong></td><td>Toplam sipariş tutarı</td><td>100</td></tr><tr><td><strong>OrderLines</strong></td><td>Sipariş kalemleri <a href="#orderlinedto-sinifi-ozellikleri-ve-aciklamalari"><code>OrderLineDto</code></a></td><td></td></tr><tr><td><strong>Customer</strong></td><td>Alıcı bilgileri <a href="#customerresponse-sinifi-ozellikleri-ve-aciklamalari"><code>CustomerResponse</code></a></td><td></td></tr><tr><td><strong>IsSend</strong></td><td>Sipariş faturalandırıldıysa bu alan true döner.</td><td>false</td></tr><tr><td><strong>WebSite</strong></td><td>Mağaza url</td><td>string</td></tr><tr><td><strong>PaymentMethod</strong></td><td>Ödeme tipi</td><td>KREDIKARTI/BANKAKARTI</td></tr><tr><td><strong>PaymentMethodName</strong></td><td>Ödeme tipi DIGER olduğunda açıklama döner.</td><td></td></tr><tr><td><strong>PaymentDate</strong></td><td>Sipariş ödeme tarihi</td><td>2026-01-01T12:00:00.000</td></tr><tr><td><strong>TransporterRegisterNumber</strong></td><td>Kargo firması VKN</td><td>9860000000</td></tr><tr><td><strong>TransportDate</strong></td><td>Kargo tarihi</td><td>2026-01-01T12:00:00.000</td></tr><tr><td><strong>CargoName</strong></td><td>Kargo firması adı</td><td>Trendyol Express</td></tr><tr><td><strong>CargoNumber</strong></td><td>Kargo numarası</td><td>4829176503948217</td></tr><tr><td><strong>CargoTrackingLink</strong></td><td>Kargo linki</td><td>string</td></tr><tr><td><strong>InvoiceUUID</strong></td><td>Fatura UUID değeri</td><td>A3F7C9E1-5B2D-4F8A-9C6E-1D2B7E4A9F30</td></tr><tr><td><strong>StoreUUID</strong></td><td>Mağaza UUID değeri</td><td>A3F7C9E1-5B2D-4F8A-9C6E-1D2B7E4A9F30</td></tr><tr><td><strong>IsExport</strong></td><td>Yurtdışı siparişi ise true olur.</td><td>true</td></tr><tr><td><strong>InvoiceType</strong></td><td>Fatura tipi</td><td>SATIS</td></tr><tr><td><strong>InvoiceUploadStatus</strong></td><td>Faturanın mağazaya yüklenme durumu</td><td>None</td></tr></tbody></table>

<pre class="language-csharp"><code class="lang-csharp"><a data-footnote-ref href="#user-content-fn-1">public </a>class OrderLineDto
{
public int ID { get; set; }
public long OrderID { get; set; }
public string ProductName { get; set; }
public string Sku { get; set; }
public int Quantity { get; set; }
public decimal Price { get; set; }
public decimal TotalAmount { get; set; }
public string CurrencyCode { get; set; }
public decimal TaxPercent { get; set; }
}
</code></pre>

***

### OrderLineDto Sınıfı Özellikleri ve Açıklamaları

> `OrderLineDto` nesnesi, sipariş detayındaki satırların nesnesidir.

| Alan             | Açıklama      | Değer  |
| ---------------- | ------------- | ------ |
| **ID**           | Satır ID      | 123    |
| **OrderID**      | Sipariş ID    | 123    |
| **ProductName**  | Ürün adı      | string |
| **Sku**          | SKU stok kodu | string |
| **Quantity**     | Miktar        | 1      |
| **Price**        | Birim fiyat   | 100    |
| **TotalAmount**  | Satır tutarı  | 120    |
| **CurrencyCode** | Para birimi   | TRY    |
| **TaxPercent**   | KDV oranı     | 20     |

***

```csharp
public class CustomerResponse
{
    public string TaxNumber { get; set; }
    public string City { get; set; }
    public string District { get; set; }
    public string Name { get; set; }
    public string TaxDepartment { get; set; }
    public string Address { get; set; }
    public string Country { get; set; }
    public string PostalCode { get; set; }
    public string Phone { get; set; }
    public string Email { get; set; }
}
```

### CustomerResponse Sınıfı Özellikleri ve Açıklamaları

> `CustomerResponse` nesnesi, sipariş alıcı bilgisi nesnesidir.

<table><thead><tr><th width="165">Alan</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>TaxNumber</strong></td><td>Müşteriye ait Vergi Kimlik Numarası (VKN) veya TCKN</td></tr><tr><td><strong>City</strong></td><td>Müşteri adresi şehir</td></tr><tr><td><strong>District</strong></td><td>Müşteri adresi ilçe</td></tr><tr><td><strong>Name</strong></td><td>Müşterinin adı veya firma unvanı</td></tr><tr><td><strong>TaxDepartment</strong></td><td>Müşterinin bağlı olduğu vergi dairesi adı</td></tr><tr><td><strong>Address</strong></td><td>Müşteri adresi</td></tr><tr><td><strong>Country</strong></td><td>Müşteri adresi ülke</td></tr><tr><td><strong>PostalCode</strong></td><td>Adres posta kodu</td></tr><tr><td><strong>Phone</strong></td><td>Müşteri telefon</td></tr><tr><td><strong>Email</strong></td><td>Müşteri e-posta</td></tr></tbody></table>

[^1]: