👍
Avantajlar
Daha Az API Çağrısı: Birleştirilmiş endpoint'ler sayesinde sipariş başına birden fazla çağrı yapmaya gerek kalmıyor. Kolay PII Erişimi: Restricted Data Token (RDT) oluşturma yerine access token ile sipariş detaylarına erişebilirsiniz. Esnek Veri Çekme: includedData parametresi ile sadece ihtiyacınız olan veriyi alabilirsiniz Geliştirilmiş Bilgiler: Paket takibi, finansal dökümler gibi detaylı bilgilere ulaşabilirsiniz.
Sayfalandırma: 24 saatlik nexttoken geçerliliği

Temel Değişiklikler

1. Endpoint Değişiklikleri

v0 Operasyon	v2026-01-01 Operasyon	Açıklama
`GetOrders`	`searchOrders`	Sipariş listesi
`GetOrder`	`getOrder`	Tek sipariş detayı
`GetOrderItems`	`getOrder`	Item'lar artık otomatik dahil
`GetOrderBuyerInfo`	`getOrder` + `includedData=BUYER`	Alıcı bilgileri
`GetOrderAddress`	`getOrder` + `includedData=RECIPIENT`	Teslimat adresi
`GetOrderItemsBuyerInfo`	`getOrder` + `includedData=BUYER`	Item bazında alıcı bilgileri

2. PII Erişimi

❌ Eski Yöntem (v0): Her PII verisi için Restricted Data Token (RDT) oluşturulması gerekiyordu

✅ Yeni Yöntem (v2026-01-01): Sadece uygun rollere sahip olmanız yeterli- RDT gerekmez

3. `includedData` Parametresi

Bu parametre ile hangi verileri almak istediğinizi belirtebilirsiniz:

Değer	İçerik	Dönen Alanlar
`BUYER`	Alıcı bilgileri	`Order.buyer`
`RECIPIENT`	Teslimat adresi ve tercihleri	`Order.recipient`
`FULFILLMENT`	Kargo ve gönderim detayları	`Order.fulfillment`, `Order.orderItems.fulfillment`
`PROCEEDS`	Gelir ve finansal döküm	`Order.proceeds`, `Order.orderItems.proceeds`
`EXPENSE`	Maliyet bilgileri	`Order.orderItems.expense`
`PROMOTION`	İndirim ve promosyon bilgileri	`Order.orderItems.promotion`
`CANCELLATION`	İptal bilgileri	`Order.orderItems.cancellation`
`PACKAGES`	Paket ve takip bilgileri	`Order.packages`

Parametre Eşleştirmeleri

Sorgu Parametreleri

v0	v2026-01-01	Notlar
`MarketplaceIds`	`marketplaceIds`
`LastUpdatedAfter`	`lastUpdatedAfter`
`OrderStatuses`	`fulfillmentStatuses`	⚠️ Değerler değişti
`FulfillmentChannels`	`fulfilledBy`	⚠️ Değerler değişti
`NextToken`	`paginationToken`	⚠️ 24 saat geçerlilik süresi
`PaymentMethods`	❌ Kaldırıldı	-
`BuyerEmail`	❌ Kaldırıldı	-

Durum Değerleri

Fulfillment Status (Eski: Order Status)

v0	v2026-01-01
`Pending`	`PENDING`
`Unshipped`	`UNSHIPPED`
`PartiallyShipped`	`PARTIALLY_SHIPPED`
`Shipped`	`SHIPPED`
`Canceled`	`CANCELLED`
`Unfulfillable`	`UNFULFILLABLE`

Fulfillment Channel

v0	v2026-01-01	Açıklama
`MFN`	`MERCHANT`	Satıcı tarafından gönderilir
`AFN`	`AMAZON`	Amazon tarafından gönderilir (FBA)

Yeni Özellikler

1. Paket Takibi (Yeni!)

packages[] array'i ile detaylı paket takip bilgilerine erişebilirsiniz:

{
  "packages": [
    {
      "packageReferenceId": "PKG001",
      "carrier": "DHL",
      "trackingNumber": "999AA10123456784",
      "packageStatus": {
        "status": "IN_TRANSIT",
        "detailedStatus": "OUT_FOR_DELIVERY"
      },
      "shipTime": "2026-02-13T10:30:00Z"
    }
  ]
}

includedData=PACKAGES parametresi gereklidir.

2. Programs Array

programs[] array'inde verilen programlar:

Sipariş Seviyesi Programlar

v0	v2026-01-01 Array Değeri
`IsPrime = true`	`PRIME`
`IsBusinessOrder = true`	`AMAZON_BUSINESS`
`IsPremiumOrder = true`	`PREMIUM`
`IsISPU = true`	`IN_STORE_PICK_UP`
-	`AMAZON_EASY_SHIP`

Fiyat Yapısı Değişiklikleri

Önemli Değişiklik: Vergi İşleme

Özellik	v0	v2026-01-01
Item Price	Vergi dahil VEYA hariç olabilir (belirsiz)	✅ Net ayrım: Vergi ayrı gösteriliyorsa fiyat vergisiz, gösterilmiyorsa vergili
Netlik	Verginin dahil olup olmadığı belli değil	`type=TAX` breakdown ile açık ayrım

Yeni: Unit Price

{
  "product": {
    "price": {
      "unitPrice": {
        "amount": "25.00",
        "currencyCode": "TRY"
      }
    }
  }
}

Fiyat Yapısı

{
  "proceeds": {
    "proceedsTotal": { "amount": "29.16" },
    "breakdowns": [
      {
        "type": "ITEM",
        "subtotal": { "amount": "25.00" }
      },
      {
        "type": "SHIPPING",
        "subtotal": { "amount": "5.00" }
      },
      {
        "type": "TAX",
        "subtotal": { "amount": "2.16" },
        "detailedBreakdowns": [
          { "subtype": "ITEM", "value": { "amount": "2.00" } },
          { "subtype": "SHIPPING", "value": { "amount": "0.16" } }
        ]
      }
    ]
  }
}

Fiyat Alanları Eşleştirme

v0	v2026-01-01 Filter	includedData
`ItemPrice`	`type == ITEM`	`PROCEEDS`
`ShippingPrice`	`type == SHIPPING`	`PROCEEDS`
`ItemTax`	`type == TAX` AND `subtype == ITEM`	`PROCEEDS`
`ShippingTax`	`type == TAX` AND `subtype == SHIPPING`	`PROCEEDS`
`PromotionDiscount`	`type == DISCOUNT`	`PROCEEDS`
`CODFee`	`type == COD_FEE`	`PROCEEDS`
`GiftWrapPrice`	`type == GIFT_WRAP`	`PROCEEDS`