> 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/expense/expenseinfo.md).

# ExpenseInfo

Bu nesne, gider pusulası üst bilgilerini barındıran nesnedir. Nesne ile ilgili detaylar aşağıda anlatılmıştır.

```csharp
public class ExpenseInfoDto
{
    public Guid UUID { get; set; }
    public Guid TemplateUUID { get; set; }
    public string TemplateBase64String { get; set; }
    public ExpenseTypeCode DocumentType { get; set; }
    public string ExpenseSerieOrNumber { get; set; }
    public DateTime IssueDate { get; set; }
    public string CurrencyCode { get; set; }
    public double? ExchangeRate { get; set; }
    public bool IsCargoDelivery { get; set; }
    public ExpenseCarrierInfoDto CarrierInfo { get; set; }
    public bool IsReturnerSameAsReceiver { get; set; }
    public ReturnerInfoDto ReturnerInfo { get; set; }
    public ServiceProviderInfo ServiceProviderInfo { get; set; }
    public ExpenseVerificationInfoDto VerificationInfo { get; set; }
    public ReturnDocumentInfoDto ReturnDocumentInfo { get; set; }
    public List<AdditionalDocumentReferenceDto> AdditionalDocumentReferences { get; set; }
}
```

### UUID

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

> Guid veri tipinde gider pusulasının takibi için kullanılacak unique numaradır.

```javascript
Expense.ExpenseInfo.UUID = 'b8787efb-639d-4efc-85b5-953bf1dbaac0';
```

{% hint style="info" %}
Alanın boş gönderilmesi durumunda sistem tarafından yeni bir UUID gider pusulasına eklenecektir.
{% endhint %}

### TemplateUUID

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

> Bu alan gider pusulasına eklenecek olan XSLT’nin UUID'si için kullanılır. UUID'ye ait XSLT gider pusulasına eklenir.

```javascript
Expense.ExpenseInfo.TemplateUUID = '94e8b735-1361-4d6f-a4a6-3745b62239c8';
```

{% hint style="info" %}

* TemplateUUID alanının **dolu** ve TemplateBase64String alanının <mark style="color:red;">**boş olması durumunda**</mark> girilen TemplateUUID bilgisine ait tasarım gider pusulasına eklenecektir.
* TemplateBase64String alanının **dolu olması** durumunda TemplateUUID alanına <mark style="color:red;">**bakılmaksızın**</mark> TemplateBase64String bilgisi gider pusulasının tasarımı olarak eklenecektir.
* TemplateUUID ve TemplateBase64String <mark style="color:red;">**alanları boş geçilirse**</mark> gider pusulasına **varsayılan** tasarım eklenecektir.
  {% endhint %}

### TemplateBase64String

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

> Gider pusulasına eklenecek tasarımın Base64'ü buraya eklenir.

{% hint style="info" %}

* TemplateUUID alanının **dolu** ve TemplateBase64String alanının <mark style="color:red;">**boş olması durumunda**</mark> girilen TemplateUUID bilgisine ait tasarım gider pusulasına eklenecektir.
* TemplateBase64String alanının **dolu olması** durumunda TemplateUUID alanına <mark style="color:red;">**bakılmaksızın**</mark> TemplateBase64String bilgisi gider pusulasının tasarımı olarak eklenecektir.
* TemplateUUID ve TemplateBase64String <mark style="color:red;">**alanları boş geçilirse**</mark> gider pusulasına **varsayılan** tasarım eklenecektir.
  {% endhint %}

### DocumentType

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

> Gider pusulasının tipinin girileceği alandır.

```csharp
public enum ExpenseTypeCode
{
    SATIS,
    IADE
}
```

```javascript
Expense.ExpenseInfo.DocumentType = "SATIS";
```

{% hint style="info" %}

* SATIS: Standart gider pusulası düzenlemek için kullanılır.
* IADE: Satışı yapılan malın iadesi için gider pusulası düzenlemek için kullanılır. Bu tipte ReturnDocumentInfo alanının doldurulması gerekir.
  {% endhint %}

### ExpenseSerieOrNumber

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

> Bu alana 16 haneli e-Gider Pusulası numarasını, 3 haneli seri bilgisini girebilirsiniz. 16 haneli numara girmeniz durumunda herhangi bir işlem yapılmaz, belge numarası olarak girdiğiniz değer belirlenir. Eğer 3 haneli seri girerseniz portal üzerinde tanımlı olan bu seri üzerinden numara üretilir.

```javascript
//Manuel Belge Numarası
Expense.ExpenseInfo.ExpenseSerieOrNumber = "EGP2026000000001";

//Seri Bilgisi
Expense.ExpenseInfo.ExpenseSerieOrNumber = "EGP";
```

{% hint style="info" %}
Portal da kayıtlı EGP serisine otomatik olarak sıradaki numara verilir.
{% endhint %}

### IssueDate

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

> Bu alana gider pusulası tarihi ve saati girilir.

```javascript
Expense.ExpenseInfo.IssueDate = "2026-01-23T10:20:39.846Z";
```

### CurrencyCode

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

> Bu alan gider pusulasının para biriminin girileceği alandır. Alabileceği değerler kod listeleri bölümünde [Para Birim Kodları](https://developer.nilvera.com/kod-listeleri.md#para-birim-kodlari) altında belirtilmiştir.

```javascript
Expense.ExpenseInfo.CurrencyCode = "TRY";
```

### ExchangeRate

<mark style="color:blue;">`double`</mark>  <mark style="color:orange;">`Kısmi Zorunlu`</mark>

> Bu alan gider pusulasının Türk lirasından farklı bir para biriminde düzenlendiğinde döviz kurunun girileceği alandır.

```javascript
Expense.ExpenseInfo.ExchangeRate = 32.50;
```

{% hint style="info" %}
CurrencyCode alanına TRY dışında bir para birimi girilmesi durumunda bu alanın doldurulması gerekir.
{% endhint %}

### IsCargoDelivery

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

> Gider pusulasına konu malın kargo ile teslim edilip edilmediğinin belirtildiği alandır.

```javascript
Expense.ExpenseInfo.IsCargoDelivery = true;
```

{% hint style="info" %}
Alanın true gönderilmesi durumunda CarrierInfo alanında taşıyıcı firma bilgilerinin girilmesi gerekir.
{% endhint %}

### CarrierInfo

<mark style="color:blue;">`ExpenseCarrierInfoDto`</mark>  <mark style="color:orange;">`Kısmi Zorunlu`</mark>

> Malın taşınmasını gerçekleştiren taşıyıcı (kargo) firmaya ait bilgilerin girileceği alandır.

```csharp
public class ExpenseCarrierInfoDto
{
    public string Name { get; set; }
    public string TaxNumber { get; set; }
    public string TaxOffice { get; set; }
    public string Address { get; set; }
    public string District { get; set; }
    public string City { get; set; }
    public string PostalCode { get; set; }
    public string Country { get; set; }
    public string Phone { get; set; }
    public string Fax { get; set; }
    public string Email { get; set; }
    public string WebSite { get; set; }
    public string AuthCertificateNumber { get; set; }
}
```

> **Name:** Taşıyıcı firmanın ünvanının girileceği alandır.

> **TaxNumber:** Taşıyıcı firmanın vergi numarasının girileceği alandır.

> **TaxOffice:** Taşıyıcı firmanın vergi dairesinin girileceği alandır.

> **Address, District, City, PostalCode, Country:** Taşıyıcı firmanın adres bilgilerinin girileceği alanlardır.

> **Phone, Fax, Email, WebSite:** Taşıyıcı firmanın iletişim bilgilerinin girileceği alanlardır.

> **AuthCertificateNumber:** Taşıyıcı firmanın yetki belgesi numarasının girileceği alandır.

```javascript
Expense.ExpenseInfo.CarrierInfo = {
    Name: "Örnek Kargo A.Ş.",
    TaxNumber: "1234567890",
    TaxOffice: "Selçuk",
    Address: "Örnek Mah. Örnek Sok. No:1",
    District: "Selçuklu",
    City: "Konya",
    Country: "Türkiye"
};
```

{% hint style="info" %}
IsCargoDelivery alanının true gönderilmesi durumunda doldurulması gerekir.
{% endhint %}

### IsReturnerSameAsReceiver

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

> Malı iade eden kişinin alıcı (CustomerInfo) ile aynı kişi olup olmadığının belirtildiği alandır.

```javascript
Expense.ExpenseInfo.IsReturnerSameAsReceiver = false;
```

{% hint style="info" %}
Alanın false gönderilmesi durumunda iade eden kişiye ait bilgilerin ReturnerInfo alanında girilmesi gerekir.
{% endhint %}

### ReturnerInfo

<mark style="color:blue;">`ReturnerInfoDto`</mark>  <mark style="color:orange;">`Kısmi Zorunlu`</mark>

> Malı iade eden kişiye ait bilgilerin girileceği alandır.

```csharp
public class ReturnerInfoDto
{
    public string Name { get; set; }
    public string Surname { get; set; }
    public string Identifier { get; set; }
    public string Address { get; set; }
    public string District { get; set; }
    public string City { get; set; }
}
```

> **Name:** İade eden kişinin adının girileceği alandır.

> **Surname:** İade eden kişinin soyadının girileceği alandır.

> **Identifier:** İade eden kişinin T.C. Kimlik Numarasının girileceği alandır.

> **Address, District, City:** İade eden kişinin adres, ilçe ve şehir bilgilerinin girileceği alanlardır.

```javascript
Expense.ExpenseInfo.ReturnerInfo = {
    Name: "Ahmet",
    Surname: "Yılmaz",
    Identifier: "11111111111",
    Address: "Örnek Mah. Örnek Sok. No:1",
    District: "Selçuklu",
    City: "Konya"
};
```

{% hint style="info" %}
IsReturnerSameAsReceiver alanının false gönderilmesi durumunda doldurulması gerekir.
{% endhint %}

### ServiceProviderInfo

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

> Hizmet sağlayıcıya ait ünvan ve vergi numarası bilgilerinin girileceği alandır.

```csharp
public class ServiceProviderInfo
{
    public string Name { get; set; }
    public string TaxNumber { get; set; }
}
```

> **Name:** Hizmet sağlayıcının ünvanının girileceği alandır.

> **TaxNumber:** Hizmet sağlayıcının vergi numarasının girileceği alandır.

```javascript
Expense.ExpenseInfo.ServiceProviderInfo = {
    Name: "Örnek Hizmet A.Ş.",
    TaxNumber: "1234567890"
};
```

### VerificationInfo

<mark style="color:blue;">`ExpenseVerificationInfoDto`</mark>  <mark style="color:orange;">`Kısmi Zorunlu`</mark>

> İade işleminde alıcının onayının hangi yöntemle alındığına dair doğrulama bilgilerinin girileceği alandır.

```csharp
public class ExpenseVerificationInfoDto
{
    public CustomerVerificationType Type { get; set; }
    public string Phone { get; set; }
    public string Code { get; set; }
}

public enum CustomerVerificationType
{
    SMS,
    IADEKODU
}
```

> **Type:** Doğrulama yönteminin girileceği alandır. SMS veya IADEKODU değerlerini alabilir.

> **Phone:** Doğrulama kodunun gönderildiği telefon numarasının girileceği alandır.

> **Code:** Alıcıdan alınan doğrulama kodunun girileceği alandır.

```javascript
Expense.ExpenseInfo.VerificationInfo = {
    Type: "SMS",
    Phone: "5551234567",
    Code: "123456"
};
```

{% hint style="info" %}
SMS ile doğrulama için E-GİDER API altındaki SMS Doğrulama uçları ile alıcıya 6 haneli doğrulama kodu gönderilip doğrulanabilir.
{% endhint %}

### ReturnDocumentInfo

<mark style="color:blue;">`ReturnDocumentInfoDto`</mark>  <mark style="color:orange;">`Kısmi Zorunlu`</mark>

> İadeye konu olan malın satışında düzenlenen belgeye ait bilgilerin girileceği alandır.

```csharp
public class ReturnDocumentInfoDto
{
    public ExpenseReturnDocumentType DocumentType { get; set; }
    public string DocumentNumber { get; set; }
    public DateTime IssueDate { get; set; }
}

public enum ExpenseReturnDocumentType
{
    EARSIV_FATURA,
    SATIS_FISI,
    BELGESIZ
}
```

> **DocumentType:** Satış belgesinin türünün girileceği alandır. EARSIV\_FATURA, SATIS\_FISI veya BELGESIZ değerlerini alabilir.

> **DocumentNumber:** Satış belgesinin numarasının girileceği alandır.

> **IssueDate:** Satış belgesinin tarihinin girileceği alandır.

```javascript
Expense.ExpenseInfo.ReturnDocumentInfo = {
    DocumentType: "EARSIV_FATURA",
    DocumentNumber: "EAR2026000000001",
    IssueDate: "2026-01-20T10:20:39.846Z"
};
```

{% hint style="info" %}
DocumentType alanı IADE olarak gönderilen gider pusulalarında doldurulması gerekir.
{% endhint %}

### AdditionalDocumentReferences

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

> Gider pusulası içerisine ek dosya ya da farklı bilgileri eklemek için kullanabileceğiniz alandır. Birden fazla dosya girilebilir.

```csharp
public class AdditionalDocumentReferenceDto
{
    public string ID { get; set; }
    public DateTime? IssueDate { get; set; }
    public string DocumentType { get; set; }
    public string DocumentTypeCode { get; set; }
    public string DocumentDescription { get; set; }
    public AttachmentDto Attachment { get; set; }
}

public class AttachmentDto
{
    public string Base64Data { get; set; }
    public string MimeCode { get; set; }
    public string FileName { get; set; }
}
```

> **ID:** Eklenen dosyanın yada diğer bilginin değeri buraya girilebilir.

> **IssueDate:** Eklenen belgenin tarihi. (Not: Bir belge değil sadece değer girişi olarak kullanılacaksa da gider pusulası tarihi olarak girilebilir.)

> **DocumentType:** Eklenen belgenin tipi veya sabit değer serbest metin şeklinde yazılabilir.

> **DocumentTypeCode:** Eklenen belgenin tipi veya sabit değer serbest metin şeklinde yazılabilir.

> **DocumentDescription:** Eklenen belgeye ait açıklamanın girileceği alandır.

> **Attachment:** Eğer bir dosya girilecekse, dosya bu alana girilebilir.<br>
>
> * **Base64Data:** Eklenen dosyanın Base64 encode edilmiş hali buraya girilir.
> * **MimeCode:** Eklenen dosyanın MimeCode değeri buraya girilir. (Örn : image/png)
> * **FileName:** Eklenen dosyanın adı buraya girilebilir.

```javascript
Expense.ExpenseInfo.AdditionalDocumentReferences = [
    {
        ID: "EK-001",
        IssueDate: "2026-01-23T10:20:39.846Z",
        DocumentType: "Ek Belge",
        DocumentTypeCode: "EKBELGE",
        DocumentDescription: "İade tutanağı",
        Attachment: {
            Base64Data: "JVBERi0xLjQK...",
            MimeCode: "application/pdf",
            FileName: "iade-tutanagi.pdf"
        }
    }
];
```

{% hint style="info" %}
Yalnızca ' doc, docx, ppt, pptx, pdf, jpg, jpeg, png ' Tipinde Dosyalar Yüklenebilir.
{% endhint %}
