T-SOFT/Storefront API/Sipariş İadeleri

Sipariş İadeleri

Bu kaynak, kimliği doğrulanmış müşterinin bir siparişi için iade talebi oluşturmaya yarar. Uç nokta storefront/account/2026-01 önekindedir ve kimliği doğrulanmış müşteri token'ı gerektirir (yalnızca okuma token'ı yetmez).

Yetki:storefront:account — müşteri token'ı zorunlu.

Bu kaynak yalnızca oluşturma (POST) destekler. Mevcut iade taleplerini listelemek için orders kaynağının returns ilişkisini (include=returns) kullan.

İade oluşturma

POST /order-returns

curl -s -X POST 'https://<domain>/api/v3/storefront/account/2026-01/order-returns' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -H 'Authorization: Bearer <CUSTOMER_TOKEN>' \
  -d '{
    "data": {
      "type": "order-returns",
      "attributes": {
        "orderId": 9012,
        "description": "Ürün beklediğim gibi değildi.",
        "firstName": "Ayşe",
        "lastName": "Yılmaz",
        "email": "ayse@example.com",
        "address": "Örnek Mah. 123 Sok. No:4 İstanbul",
        "iban": "TR000000000000000000000000",
        "cargoCompanyId": 2,
        "pickDate": "2026-07-20",
        "lines": [
          { "orderProductId": 55501, "quantity": 1, "reasonId": 3 }
        ]
      }
    }
  }'

Yazma alanları (istek gövdesi)

Aşağıdaki alanlar yalnızca yazılır (write-only) ve iade talebi oluşturma payload'ını oluşturur:

Alan	Açıklama	Yazılabilir
`orderId`	İade edilecek siparişin id'si	Evet
`description`	Genel iade açıklaması	Evet
`firstName`	İade eden kişinin adı	Evet
`lastName`	İade eden kişinin soyadı	Evet
`email`	İletişim e-postası	Evet
`address`	İade gönderim/iletişim adresi	Evet
`iban`	Ücret iadesi için IBAN	Evet
`cargoCompanyId`	İade kargo firması id'si	Evet
`pickDate`	Kargo alım tarihi (bkz. İade Alım Tarihleri)	Evet
`lines`	İade satırları: `orderProductId`, `quantity`, `reasonId`	Evet

Yanıt alanları (salt okunur)

Oluşturulan iade kaydı aşağıdaki salt okunur alanları döner:

Alan	Açıklama	Yazılabilir
`status`	İade durumu (görünen metin)	Salt-okunur
`statusId`	İade durum id'si	Salt-okunur
`reason`	İade nedeni	Salt-okunur
`reasonId`	İade neden id'si	Salt-okunur
`note`	İade notu	Salt-okunur
`applicationDate`	Başvuru tarihi (Unix timestamp)	Salt-okunur
`cargoPickDate`	Kargo alım tarihi	Salt-okunur
`shipmentCode`	İade gönderim kodu	Salt-okunur

İlişkiler

İlişki	Tip	Anlamı
`items`	`order-return-items`	İade satırları (hasMany, salt okunur)