T-SOFT/Admin API/İadeler

İadeler

Kapsam: okuma için read_returns, güncellemek için write_returns.

İade talepleri

Uç	Metot	Kapsam
`order/order-returns`	`GET`	`read_returns`
`order/order-returns/{id}`	`GET`	`read_returns`
`order/order-returns/{id}`	`PATCH`, `DELETE`	`write_returns`

GET /order/order-returns

curl 'https://magaza.com/api/v3/admin/2026-01/order/order-returns?filter[returnStatusId]=1&sort=-createdAt' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json'

Alan	Açıklama
`orderId`, `orderNumber`	Sipariş
`returnStatusId`	İade durumu (İade durumları)
`returnReasonId`, `returnReason`	İade nedeni
`returnPaymentType`, `returnIban`	Geri ödeme yöntemi ve IBAN
`customerName`, `customerEmail`, `customerPhone`, `customerAddress`	Müşteri bilgisi
`shipmentId`, `shipmentCode`, `cargoCompany`	İade gönderisi
`note`	Not
`createdAt`	Talep zamanı

Filtreler: search, orderNumber, shipmentCode, customerName, customerEmail, returnStatusId, returnReasonId, cargoCompany, returnPaymentType, createdAt. İlişkiler: status, reason, order.

Durum güncelleme

PATCH /order/order-returns/{id}

curl -X PATCH 'https://magaza.com/api/v3/admin/2026-01/order/order-returns/77' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{"data": {"type": "order-returns", "id": "77", "attributes": {"returnStatusId": 3, "shipmentCode": "IADE-TRK-998"}}}'

İade talebi yalnız güncellenebilir; yeni talebi müşteri vitrinden açar.

İade durumları

order/order-return-statuses (yalnız okuma, read_returns). Alanlar: name, isActive, isApproved, isStatic. Durum kimlikleri mağazaya göre değişir; sabit kodlamayın.