API Reference

Sipariş Listeleme Metodu Örnek İstek

Örnek İstek

Sipariş Listeleme

Örnek istek içerisinde 1 Ocak 2023 sonrası güncellenen siparişlerin listesini 100 adet ile sınırlayarak verir.

Sipariş listeleme yapabilmek için tarih filtresi olarak yaratılma tarihi (CreatedAfter) veya güncelleme tarihi (LastUpdatedAfter) parametrelerinden biri zorunlu olarak gönderilmelidir.

Sipariş Listeleme (Filtreli)

Filtreli sipariş listeleme örneği, 1 Ocak 2022 tarihi itibarıyla güncellenmiş ve sipariş durumları PartiallyShipped ve Shipped olan siparişleri listeler.

curl -L 'https://sellingpartnerapi-eu.amazon.com/orders/v0/orders?MarketplaceIds=A33AVAJ2PDY3EV&MaxResultsPerPage=100&LastUpdatedAfter=2023-01-01' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \
-d ''

curl -L 'https://sellingpartnerapi-eu.amazon.com/orders/v0/orders?MarketplaceIds=A33AVAJ2PDY3EV&MaxResultsPerPage=100&LastUpdatedAfter=2022-01-01&OrderStatuses=PartiallyShipped%2CShipped' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \
-d ''
{
    "payload": {
        "Orders": [
            {
                "BuyerInfo": {
                    "BuyerEmail": "[email protected]",
                    "BuyerName": "İsim Soyisim"
                },
                "AmazonOrderId": "406-1955923-0816306",
                "EarliestDeliveryDate": "2022-09-30T21:00:00Z",
                "EarliestShipDate": "2022-09-27T21:00:00Z",
                "SalesChannel": "Amazon.com.tr",
                "AutomatedShippingSettings": {
                    "HasAutomatedShippingSettings": false
                },
                "OrderStatus": "Shipped",
                "NumberOfItemsShipped": 1,
                "OrderType": "StandardOrder",
                "IsPremiumOrder": false,
                "IsPrime": false,
                "FulfillmentChannel": "MFN",
                "BuyerInvoicePreference": "INDIVIDUAL",
                "NumberOfItemsUnshipped": 0,
                "HasRegulatedItems": false,
                "IsReplacementOrder": "false",
                "IsSoldByAB": false,
                "LatestShipDate": "2022-09-29T20:59:59Z",
                "ShipServiceLevel": "MFN Std",
                "DefaultShipFromLocationAddress": {
                    "AddressLine2": "null",
                    "AddressLine1": "null",
                    "Municipality": "Bakirkoy",
                    "PostalCode": "34153",
                    "City": "Istanbul",
                    "CountryCode": "TR",
                    "Name": "null"
                },
                "IsISPU": false,
                "MarketplaceId": "A33AVAJ2PDY3EV",
                "LatestDeliveryDate": "2022-10-05T20:59:59Z",
                "PurchaseDate": "2022-09-27T07:41:40Z",
                "ShippingAddress": {
                    "AddressLine1": "No 100 D:50",
                    "Municipality": "Kağıthane",
                    "PostalCode": "34418",
                    "City": "İstanbul",
                    "CountryCode": "TR",
                    "County": "Seyrantepe Mh.",
                    "Name": "İsim Soyisim"
                },
                "IsAccessPointOrder": false,
                "PaymentMethod": "Other",
                "IsBusinessOrder": false,
                "OrderTotal": {
                    "CurrencyCode": "TRY",
                    "Amount": "5.00"
                },
                "PaymentMethodDetails": [
                    "Standard"
                ],
                "IsGlobalExpressEnabled": false,
                "LastUpdateDate": "2022-09-27T09:32:48Z",
                "ShipmentServiceLevelCategory": "Standard"
            }
        ]
    }
}
{
    "errors": [
        {
            "code": "InvalidInput",
            "message": "CreatedAfter or LastUpdatedAfter must be specified",
            "details": ""
        }
    ]
}

Sipariş Listeleme Sonraki Sayfa Örnek İstek

Örnek istek içerisinde NextToken değerini özel karakterler içerdiğinden dolayı NextToken değerini urlencode ederek göndermeniz gerekmektedir.

curl -L 'https://sellingpartnerapi-eu.amazon.com/orders/v0/orders?MarketplaceIds=A33AVAJ2PDY3EV&NextToken=33SUZfXDmK1%252FYYuZQbKv1QafEPREmauvizt1MIhPYZZK8W8ARbuFMsvb0ByyUvzoeXVVrtuvMDtTg2dsYWmzKd8ytOVgN7d%252FKyNtf5fepe0l%252BaJHP0mt8EuIzPzymQv22fe04vUB16WS68vI7Bqws%252BweLxD7b1CVTGhcoslYoLIzI3F6xMGhlqfL9sO7x3Jwllhc4XvGqg5e0zIeaOVNezxWEXvdeDL7x%252FixT5uCNYNcnXAst2ZwvVgUQRApWjaxhOkeyDADNpIwE7%252Bt4NjazwttdpzSyhUQZbUe4%252BQPlq74AncMBU8nFrsRtw80H5sHFkHI%252Bjnbw5FUevr%252B%252FtqpQU%252FkqnOXTANWmfJwx39dEJABwjYaQTTj30yXefE%252BnErIBfb2wNYma4fmGBZ5vIAAif7014%252F6WyIC%252FYcTvNcnDllPoHVKB7NbV61OyEkQXs581mVnQC1qkpnCz6VkhSdiYg%253D%253D' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \
-d ''

RDT Token Örnek İsteği

Siparişlere ait müşteri, kargo adresi ve vergi bilgilerini alabilmek için dataElements içerisinde kategorilerini belirtmeniz gereklidir. Örnek istekte tüm bilgiler talep edilmiştir.

Başarılı cevap içerisinde iletilen restrictedDataToken değerini sipariş listesi isteğini gönderirken x-amz-access-token parametresine geçmeniz gerekmektedir.

curl -L 'https://sellingpartnerapi-eu.amazon.com/tokens/2021-03-01/restrictedDataToken' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \
-d '{
    "restrictedResources": [
        {
            "method": "GET",
            "path":"/orders/v0/orders",
            "dataElements": ["buyerInfo","shippingAddress","buyerTaxInformation"]
        }
    ]
}'
{
    "expiresIn": 3600,
    "restrictedDataToken": "Atz.sprdt|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"
}

Doldurulması Gereken Güvenlik Parametreleri

Örnek isteği gönderip sonuç alabilmeniz için istek içerisinde bulunan ve aşağıda listesi verilen parametreleri doldurmanız gerekmektedir.

Güvenlik Parametreleri
{{access-token}}
{{security-token}}
{{request-date}}
{{authorization}}