Amazon üzerinden aldığınız siparişlerinizi listeyebilmenizi sağlayan metottur.
Servis kullanım detaylarını Sipariş Listeleme bölümünden inceleyebilirsiniz.
❗️
- Siparişlerinizde müşteri, adres ve fatura bilgilerinin listelenebilmesi için yetki alınmalıdır. Yetki tanımlanması için, gönderdiğiniz isteklerde RDT (Restricted Data Token) ile işlem yapmanız gereklidir. Bu token'ı yaratmak için tıklayınız.
- RDT (Restricted Data Token) yaratmak için örnek isteği inceleyebilirsiniz.
- Siparişlerinizin toplam tutarı ve sipariş durumu gibi bilgileri listeleyebilmek için Sipariş Listeleme yöntemini kullanmanız gereklidir. İşlem sonucunda, her bir sipariş için ayrı AmazonOrderId oluşacaktır.
- Siparişteki ürün bilgilerini almak için AmazonOrderId parametresini kullanarak Siparişteki Siparişteki Ürün Bilgileri Metodu ile işlem yapmalısınız.
- Siparişlerinizin bir sonraki sayfasını listeleyebilmeniz için yetki alınmalıdır. Yetki tanımlanması için, gönderdiğiniz isteklerde RDT (Restricted Data Token) ile işlem yapmanız gereklidir. Bu token'ı yaratmak için tıklayınız.
- RDT (Restricted Data Token) yaratmak için örnek isteği inceleyebilirsiniz.
- Bir sonraki sayfadaki siparişleri listeleyebilmeniz için önceki listeleme isteğinden dönen NextToken değerini Sipariş Listeleme Metodunda bulunan parametreyle göndermelisiniz.
- Bir sonraki sayfadaki siparişleri listelemek için örnek isteği inceleyebilirsiniz.
❗️
🚧
| Değer | Açıklama | Veri Türü |
|---|
| CreatedAfter | Belirtilen tarihten sonraki siparişlerin listelenmesi için kullanılabilecek parametredir. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-16 | string |
| CreatedBefore | Belirtilen tarihten önceki siparişlerin listelenmesi için kullanılabilecek parametredir. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-30 | string |
| LastUpdatedAfter | Belirtilen tarihten sonra güncellenen siparişlerin listelenmesi için kullanılabilecek parametredir. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-16 | string |
| LastUpdatedBefore | Belirtilen tarihten önce güncellenen siparişlerin listelenmesi için kullanılabilecek parametredir. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-30 | string |
| OrderStatuses | Sipariş statülerini belirten parametredir. Sipariş statü açıklamalarını incelemek için tıklayınız. | string, array |
| MarketplaceIds | Amazon satış ortağı mağaza ID'sini temsil eder. ID listesine buradan erişebilirsiniz. TR: A33AVAJ2PDY3EV | string, array |
| FulfillmentChannels | Amazon deposundan gönderilen siparişleri listelemek için AFN (Fulfillment by Amazon) filtresini; kendi deponuzdan gönderilen siparişleri listelemek için MFN (Fulfilled by the seller) filtresini kullanmalısınız. | string, array |
| BuyerEmail | Alıcı email adresi. | string |
| SellerOrderId | Satıcı tarafından atanan sipariş numarası. | string |
| MaxResultsPerPage | Bir sayfada listelenebilecek maksimum sipariş sayısı. (Tek sayfada en fazla 100 sipariş gelmektedir.) | integer |
| EasyShipShipmentStatuses | Amazon Kolay Gönderi, gönderim durumları. Gönderim durumları açıklamalarını incelemek için tıklayınız. Amazon Kolay Gönderi ile gönderilmesi gerekiyorsa bu bilgi dolu olarak gelir. | string, array |
| NextToken | Sayfalamada bir sonraki sayfaya geçiş için kullanılan parametredir. | string |
| AmazonOrderIds | Amazon tarafından atanan sipariş numarasıdır. Formatı 3-7-7 karakterden oluşur. Tek seferde en fazla 50 sipariş numarası gönderilebilir. | string, array |
🚧
| Değer | Açıklama |
|---|
| PendingAvailability | Ödemesi henüz onaylanmamış ve ileri tarihli verilmiş siparişler |
| Pending | Ödemesi henüz onaylanmamış siparişler |
| Unshipped | Ödemesi onaylanmış ve gönderilmemiş siparişler |
| PartiallyShipped | Kısmi kargolanmış siparişler |
| Shipped | Kargolanmış siparişler |
| Canceled | İptal olmuş siparişler |
🚧
| Değer | Açıklama |
|---|
| PendingPickUp | Satıcı deposundan alınması beklenen sipariş |
| PendingDropOff | Elden teslim alınmayı bekleyen sipariş |
| LabelCanceled | Etiketi iptal edilen sipariş |
| PickedUp | Teslim alınan sipariş |
| DroppedOff | Elden teslim edilen sipariş |
| Delivered | Alıcıya teslim edilen sipariş |
| RejectedByBuyer | Alıcı tarafından reddedilen sipariş |
| Undeliverable | Teslim edilemeyen sipariş |
| ReturningToSeller | Satıcıya iade edilmesi için yola çıkan sipariş |
| ReturnedToSeller | Satıcıya iade edilen sipariş |
| Lost | Taşınırken kaybolan sipariş |
| OutForDelivery | Teslim için dağıtıma çıkarılan sipariş |
| Damaged | Taşınırken hasar gören sipariş |
Amazon üzerinden aldığınız bir siparişi Amazon tarafından atanan sipariş numarası (AmazonOrderId) ile listeyebilmenizi sağlayan metoddur.
❗️
- Siparişlerinizde müşteri, adres ve fatura bilgilerinin listelenebilmesi için yetki alınmalıdır. Yetki tanımlanması için, gönderdiğiniz isteklerde RDT (Restricted Data Token) ile işlem yapmanız gereklidir. Bu token'ı yaratmak için tıklayınız.
- RDT (Restricted Data Token) yaratmak için örnek isteği inceleyebilirsiniz.
- Siparişin toplam tutarı ve sipariş durumu gibi bilgileri listeleyebilmek için Tekli Sipariş Listeleme yöntemini kullanmanız gereklidir. İşlem sonucunda, her bir sipariş için ayrı AmazonOrderId oluşacaktır.
- Siparişteki ürün bilgilerini almak için AmazonOrderId parametresini kullanarak Siparişteki Ürün Bilgileri Metodu ile işlem yapmalısınız.
🚧
| Değer | Açıklama | Veri Türü |
|---|
| AmazonOrderId (Zorunlu) | Amazon tarafından atanan sipariş numarasıdır. Formatı 3-7-7 karakterden oluşur. Tek seferde en fazla 50 sipariş numarası gönderilebilir. | string |
| PurchaseDate (Zorunlu) | Sipariş verilme tarihi. | string |
| LastUpdateDate (Zorunlu) | Siparişin son güncellenme tarihi. | string |
| OrderStatus (Zorunlu) | Sipariş statülerini belirten parametredir. Sipariş statü açıklamalarını incelemek için tıklayınız. | enum |
| SellerOrderId | Satıcı tarafından atanan sipariş numarası. | enum |
| FulfillmentChannel | Amazon deposundan gönderilen siparişlerde AFN (Fulfillment by Amazon); kendi deponuzdan gönderilen siparişlede MFN (Fulfilled by the seller) dönecektir. | enum |
| OrderTotal | Siparişin toplam tutarı. Money modelini incelemek için tıklayınız. | money |
| NumberOfItemsShipped | Kargolanmış ürün adedi. | integer |
| NumberOfItemsUnshipped | Gönderilmemiş ürün adedi. | integer |
| MarketplaceId | Amazon satış ortağı mağaza ID'sini temsil eder. ID listesine buradan erişebilirsiniz. TR: A33AVAJ2PDY3EV | string |
| EasyShipShipmentStatus | Amazon Kolay Gönderi, gönderim durumları. Gönderim durumlarının açıklamalarını incelemek için tıklayınız. | enum |
| EarliestShipDate | En erken sipariş gönderim tarihi. Yalnızca satış ortağı gönderimli siparişlerde döner. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-20 | string |
| LatestShipDate | En geç sipariş gönderim tarihi. Yalnızca satış ortağı gönderimli siparişlerde döner. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-23 | string |
| EarliestDeliveryDate | En erken teslimat tarihi. Yalnızca satış ortağı gönderimli siparişlerde döner. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-21 | string |
| LatestDeliveryDate | En geç teslimat tarihi. Yalnızca satış ortağı gönderimli ve PendingAvailability (Ödemesi henüz onaylanmamış ve ileri tarihli verilmiş siparişler), Pending (Ödemesi henüz onaylanmamış siparişler) veya Canceled (İptal olmuş siparişler) durumlarında olmayan siparişlerde döner. ISO 8601 formatında gönderilmelidir. Örn: 2023-04-24 | string |
| IsPrime | Amazon Prime siparişiyse true döner. Amazon Prime dışındaki siparişler için false dönecektir. | boolean |
| IsEstimatedShipDateSet | Tahmini gönderim tarihi ayarlanmış ve Sourcing on Demand (Talep üzerine oluşturulan siparişler) siparişlerde true döner.. | boolean |
| DefaultShipFromLocationAddress | Siparişin kargolanacağı depo adres bilgilerini içerir. | |
| BuyerInvoicePreference | Fatura türü. INDIVIDUAL (Bireysel Fatura) veya BUSINESS (Kurumsal Fatura) olarak döner. | enum |
| BuyerTaxInformation | Vergi bilgileri. Kurumsal faturalarda dönecektir. Detaylar için tıklayınız. | string |
| ShippingAddress | Siparişin gönderim adresi. | |
| BuyerInfo | Siparişteki müşteri bilgileri. Detaylar için tıklayınız. | |
| AutomatedShippingSettings | Siparişin Amazon Lojistik ile gönderilip gönderilmediği bilgisini verir. HasAutomatedShippingSettings: True dönüyorsa sipariş Amazon deposundan gönderime uygundur. | boolean, string |
🚧
| Değer | Açıklama | Veri Türü |
|---|
| CurrencyCode | Para birimi. ISO 4217 formatında gelmektedir. Örn: TRY | string |
| Amount | Toplam tutar. | string |
🚧
| Değer | Açıklama | Veri Türü |
|---|
| BuyerLegalCompanyName | Alıcı şirket unvanı. | string |
| BuyerTaxRegistrationId | Alıcı şirketin vergi numarası. | string |
| BuyerTaxOffice | Alıcı şirketin vergi dairesi. | string |
🚧
| Değer | Açıklama | Veri Türü |
|---|
| AmazonOrderId | Amazon tarafından atanan sipariş ID'si. Formatı: 3-7-7 karakterden oluşur. | string |
| BuyerEmail | Müşteri e-posta adresi. | string |
| BuyerName | Müşteri isim ve soy ismi. | string |
📘
📘
❗️
❗️
NextToken değeri, 100 adetten daha fazla siparişiniz varsa sipariş listeleme response'unda dönecektir.
Sipariş listesinden dönen NextToken parametresini urlencode ederek göndermeniz gerekmektedir.
❗️
❗️
