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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.nilvera.com/nilvera-model/marketplace/invoices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.