Aksiyon Kontrolü ve Talep Gönderme

Sipariş için ürün incelemesi ve satıcı geri bildirimi istemek üzere Solicitations API'sini nasıl kullanacağınızı aşağıdaki adımları takip ederek öğrenebilirsiniz. Öncelikle siparişin talep için uygun olup olmadığını doğrulayın, ardından talep isteğini oluşturun.

Adım 1. Siparişin teklif için uygun olup olmadığını doğrulayın

getSolicitationActionsForOrder işlemini çağırın.

Adım 2. Ürün inceleme teklifi oluşturun

Yanıtta productReviewAndSellerFeedback işlemi listeleniyorsa, createProductReviewAndSellerFeedbackSolicitation işlemini çağırın.

API ve Seller Central etkileşimi

API aracılığıyla bir değerlendirme isteği gönderdiğinizde, API ve Seller Central arasındaki aşağıdaki farklılıklara dikkat edin:

API aracılığıyla gönderilen bir değerlendirme isteği, Seller Central'da siparişi işaretlemez.
API aracılığıyla bir istek gönderdikten sonra Seller Central üzerinden değerlendirme isterseniz, zaten bir inceleme isteği gönderildiğine dair bir hata mesajı alırsınız.
Aynı sipariş için ikinci bir API denemesi 403 durum kodu döndürür.
Talep göndermeden önce uygunluğu programatik olarak kontrol etmek için getSolicitationActionsForOrder işlemini kullanın.

Yorum talep ederken şunlara dikkat edin:

Teslim edilmiş siparişler için yorum isteyin.
İzin verilen süre içinde geri bildirim isteyin.

Şunları yapamazsınız:

Seçici olarak olumlu yorumlar istemek.
Mevcut yorumlarda değişiklik talep etmek.
Yorumlar için ödül veya teşvik teklif etmek.
Talepin içeriğini değiştirmek. Amazon mesajın tüm içeriğini kendisi yönetiyor. Eğer içeriği değiştirmek istiyorsanız Messaging API kullanmalısınız.

⚠️ Amazon'un politikası gereği alıcıdan doğrudan yorum veya feedback bırakması istenemez — bu nedenle Solicitations API kasıtlı olarak sabit bir şablon kullanıyor.

curl --location 'https://sellingpartnerapi-eu.amazon.com/solicitations/v1/orders/{{order-id}}?marketplaceIds=A33AVAJ2PDY3EV' \
--header 'Accept: application/hal+json' \
--header 'x-amz-access-token: Atza|' \
--header 'x-amz-date: 20260101T120000Z'

{
    "_links": {
        "actions": [
            {
                "href": "/solicitations/v1/orders/171-7571494-4418703/solicitations/productReviewAndSellerFeedback?marketplaceIds=A33AVAJ2PDY3EV",
                "name": "productReviewAndSellerFeedback"
            }
        ],
        "self": {
            "href": "/solicitations/v1/orders/171-7571494-4418703?marketplaceIds=A33AVAJ2PDY3EV"
        }
    },
    "_embedded": {
        "actions": [
            {
                "_links": {
                    "schema": {
                        "href": "/solicitations/v1/orders/171-7571494-4418703/solicitations/productReviewAndSellerFeedback/schema",
                        "name": "productReviewAndSellerFeedback"
                    },
                    "self": {
                        "href": "/solicitations/v1/orders/171-7571494-4418703/solicitations/productReviewAndSellerFeedback?marketplaceIds=A33AVAJ2PDY3EV",
                        "name": "productReviewAndSellerFeedback"
                    }
                },
                "_embedded": {
                    "schema": {
                        "_links": {
                            "self": {
                                "href": "/solicitations/v1/orders/171-7571494-4418703/solicitations/productReviewAndSellerFeedback/schema",
                                "name": "productReviewAndSellerFeedback"
                            }
                        },
                        "type": "object",
                        "name": "productReviewAndSellerFeedback",
                        "title": "Request a Review",
                        "description": "Request seller feedback and product review",
                        "disabled": false,
                        "disabledReason": null,
                        "properties": {},
                        "required": [],
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "x-ui-hidden": false
                    }
                },
                "name": "productReviewAndSellerFeedback",
                "title": "Request a Review"
            }
        ]
    }
}

{
    "_links": {
        "actions": [],
        "self": {
            "href": "/solicitations/v1/orders/171-1677621-6381909?marketplaceIds=A33AVAJ2PDY3EV"
        }
    },
    "_embedded": {
        "actions": []
    }
}

Yanıtı incelediğinizde, bu sipariş için productReviewAndSellerFeedback aksiyonu mevcut ve kullanılabilir durumda olduğunu görebilirsiniz. href alanı, POST isteğinde çağırmanız gereken endpoint'i gösteriyor.

Eğer disabled: true ve disabledReason dolu olsaydı solicitation gönderilemezdi. Örneğin:

-Sipariş henüz teslim edilmemiş
-Daha önce zaten gönderilmiş
-Alıcı iletişim tercihlerinden devre dışı bırakmış

curl --location --request POST 'https://sellingpartnerapi-eu.amazon.com//solicitations/v1/orders/171-7571494-4418703/solicitations/productReviewAndSellerFeedback?marketplaceIds=A33AVAJ2PDY3EV' \
--header 'Accept: application/hal+json' \
--header 'x-amz-access-token: Atza|' \
--header 'x-amz-date: 20260101T120000Z'

{}

createProductReviewAndSellerFeedbackSolicitation başarılı olduğunda response'da HTTP Status: 201 Created Body: dönecek.

⚠️ Hatırlatma: Aynı sipariş için bu operasyonu bir daha çağırırsanız 400 veya hata dönecektir — her sipariş için yalnızca bir kez gönderilebilir