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

# EDespatchAnswer

İrsaliye Yanıtı Modeli

> Gelen bir e-İrsaliyeye irsaliye yanıtı (kabul / kısmi kabul / red) oluşturmak için kullanılan modeldir. Bu model **E-İrsaliye API › Gelen İrsaliyeler › İrsaliyeye Yanıt Oluşturur** (`POST /edespatch/Purchase/SendAnswer`) ucuna istek gövdesi olarak gönderilir.

```csharp
public class PurchaseDespatchSendAnswerCommand
{
    public Guid DespatchUUID { get; set; }
    public List<DespatchAnswerLineDto> DespatchAnswerLines { get; set; }
    public string[] Notes { get; set; }
    public string Serie { get; set; }
    public DateTime DeliveryDateTime { get; set; }
    public Guid TemplateUUID { get; set; }
    public bool AcceptAll { get; set; }
    public bool RejectAll { get; set; }
}
```

{% hint style="info" %}
İrsaliyenin tamamı kabul ediliyorsa **AcceptAll**, tamamı reddediliyorsa **RejectAll** alanı `true` gönderilir. Kısmi kabul / red durumunda bu iki alan `false` bırakılır ve her kalem için **DespatchAnswerLines** doldurulur.
{% endhint %}

#### DespatchUUID

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

> Yanıt verilecek gelen irsaliyenin UUID (ETTN) bilgisidir. Gelen irsaliyelerin UUID bilgisine E-İrsaliye API › Gelen İrsaliyeler › Gelen İrsaliyeleri Listeler ucu ile ulaşılabilir.

#### AcceptAll

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

> `true` gönderildiğinde irsaliyedeki tüm kalemler eksiksiz teslim alınmış olarak kabul edilir.

#### RejectAll

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

> `true` gönderildiğinde irsaliyedeki tüm kalemler reddedilir.

{% hint style="warning" %}
**AcceptAll** ve **RejectAll** alanları aynı anda `true` gönderilmemelidir. Tümünü red durumunda red nedeninin **Notes** alanına yazılması önerilir.
{% endhint %}

#### DespatchAnswerLines

<mark style="color:blue;">`List`</mark> <mark style="color:orange;">`Koşullu`</mark>

> Kalem bazında teslim alınan, eksik, reddedilen ve fazla gelen miktarların girildiği alandır. Kısmi kabul / red durumunda doldurulması gerekir. Detayları **aşağıdaki DespatchAnswerLines Detayı bölümünde anlatılmıştır.**

#### DeliveryDateTime

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

> Malların teslim alındığı tarih ve saatin girildiği alandır.

#### Serie

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

> Yanıt belgesinin numaralandırılacağı yanıt serisinin girildiği alandır. Tanımlı seriler **Yanıt Serileri** uçları ile yönetilir.

#### TemplateUUID

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

> Yanıt belgesine eklenecek tasarımın (XSLT) UUID bilgisidir. Tanımlı tasarımlar **Yanıt Şablonları** uçları ile yönetilir.

#### Notes

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

> Yanıt belgesine eklenecek notların girildiği alandır. Birden fazla not girilebilir. Kısmi kabul veya red durumlarında açıklama girilmesi önerilir.

### DespatchAnswerLines Detayı

> Kısmi kabul / red durumunda her irsaliye kalemi için teslim alınan, eksik, reddedilen ve fazla gelen miktarlar bu yapı ile gönderilir.

```csharp
public class DespatchAnswerLineDto
{
    public int Index { get; set; }
    public UnitCodeValueDto Received { get; set; }
    public UnitCodeValueDto Short { get; set; }
    public UnitCodeValueDto Rejected { get; set; }
    public UnitCodeValueDto Oversupply { get; set; }
    public string RejectReason { get; set; }
    public string SellerCode { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public decimal QuantityPrice { get; set; }
    public decimal LineTotal { get; set; }
}

public class UnitCodeValueDto
{
    public string UnitCode { get; set; }
    public decimal Value { get; set; }
}
```

{% hint style="info" %}
**Received**, **Short**, **Rejected** ve **Oversupply** alanları aynı yapıdadır (`UnitCodeValueDto`): **UnitCode** alanına birim kodu (örn. `C62` - Adet, `KGM` - Kilogram), **Value** alanına miktar girilir. Alabileceği birim kodları kod listeleri bölümündeki birim kodları altında belirtilmiştir.
{% endhint %}

#### Index

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

> Yanıt verilen irsaliye kaleminin sıra numarasıdır. Gelen irsaliyedeki kalem sırası ile eşleşmelidir.

#### Received

<mark style="color:blue;">`object`</mark> <mark style="color:orange;">`Koşullu`</mark>

> Kalemden teslim alınan (kabul edilen) miktar ve birimidir.

#### Short

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

> Kalemden eksik gelen miktar ve birimidir.

#### Rejected

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

> Kalemden reddedilen miktar ve birimidir.

#### Oversupply

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

> Kalemden fazla gelen miktar ve birimidir.

#### RejectReason

<mark style="color:blue;">`string`</mark> <mark style="color:orange;">`Koşullu`</mark>

> Red nedeninin açıklamasıdır. **Rejected** alanı dolu gönderildiğinde girilmesi önerilir.

#### SellerCode

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

> Satıcının ürüne verdiği koddur.

#### Name

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

> Mal / hizmet adıdır.

#### Description

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

> Kalemle ilgili açıklamadır.

#### QuantityPrice

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

> Kalemin birim fiyatıdır.

#### LineTotal

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

> Kalemin toplam tutarıdır.

**Örnek**

```json
"DespatchAnswerLines": [
    {
        "Index": 1,
        "Received": { "UnitCode": "C62", "Value": 8 },
        "Short": { "UnitCode": "C62", "Value": 1 },
        "Rejected": { "UnitCode": "C62", "Value": 1 },
        "RejectReason": "Hasarlı ürün"
    },
    {
        "Index": 2,
        "Received": { "UnitCode": "KGM", "Value": 105 },
        "Oversupply": { "UnitCode": "KGM", "Value": 5 }
    }
]
```

### Örnekler

**Tümünü kabul**

```json
{
    "DespatchUUID": "b8787efb-639d-4efc-85b5-953bf1dbaac0",
    "AcceptAll": true,
    "DeliveryDateTime": "2024-01-15T14:30:00"
}
```

**Tümünü red**

```json
{
    "DespatchUUID": "b8787efb-639d-4efc-85b5-953bf1dbaac0",
    "RejectAll": true,
    "Notes": ["Ürünler sipariş ile uyuşmadığı için reddedilmiştir."]
}
```

**Kısmi kabul**

```json
{
    "DespatchUUID": "b8787efb-639d-4efc-85b5-953bf1dbaac0",
    "AcceptAll": false,
    "RejectAll": false,
    "DeliveryDateTime": "2024-01-15T14:30:00",
    "Notes": ["2 adet ürün hasarlı geldiği için iade edilmiştir."],
    "DespatchAnswerLines": [
        {
            "Index": 1,
            "Received": { "UnitCode": "C62", "Value": 8 },
            "Rejected": { "UnitCode": "C62", "Value": 2 },
            "RejectReason": "Hasarlı ürün"
        }
    ]
}
```
