Hub per sviluppatoriStato dell'APISupporto

Guida ai casi d'uso dell'API Sollecitazioni v1

Invia sollecitazioni coerenti e di alta qualità agli acquirenti.

Versione API: v1

Cos'è l'API Sollecitazioni?

Puoi usare API per le sollecitazioni dei partner di vendita (API Solicitations) per creare applicazioni che consentano ai venditori di inviare richieste coerenti e di alta qualità agli acquirenti. I venditori possono richiedere sia una recensione del prodotto che il feedback del venditore inviando un'unica email basata su un modello.

Tutorial 1: Configurare l'API Solicitations

Questa guida illustra come configurare l'API Solicitations prima di richiedere un feedback.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

The Solicitations API implementation flowchart

Fase 1. Abbonati al ORDER_CHANGE notifica

Per ulteriori informazioni, fare riferimento a Tutorial: iscriviti alla notifica ORDER_CHANGE.

Fase 2. Convalida il OrderStatus parametro

I flussi di lavoro di Amazon Simple Queue Service (SQS) ricevono il payload di ORDER_CHANGE notifica. Puoi usare Amazon SQS per convalidare il OrderStatus parametro. Verificare che il OrderStatus il valore è cambiato in Shipped. Elimina le ridondanze per accertarti che sia già stata inviata una richiesta per un ordine specifico. Per ulteriori informazioni su come effettuare il polling della coda SQS, consulta Tutorial: Configurazione delle notifiche (flusso di lavoro Amazon Simple Queue Service).

Fase 3 Controlla il EarliestDeliveryDate e LatestDeliveryDate parametri

È possibile richiedere una sollecitazione entro un periodo di cinque giorni dopo il EarliestDeliveryDate a 30 giorni dopo il LatestDeliveryDate. La chiamata all'API Solicitations al di fuori di questo lasso di tempo comporterà errori API imprevisti.

Fase 4. Memorizza gli identificatori chiave

Archivia o memorizza nella cache il amazonOrderId e MarketplaceId parametri. Questi identificatori sono necessari per sollecitare revisioni future.

Ora sei pronto per richiedere un feedback.

Tutorial: Sollecitare un feedback per un ordine

Questo tutorial mostra come sollecitare la recensione di un prodotto e il feedback del venditore per un ordine. Verifica innanzitutto che un ordine sia disponibile per la sollecitazione, quindi crea la richiesta di sollecitazione.

Prerequisiti

Per completare questo tutorial, hai bisogno di:

Passaggio 1. Verifica che un ordine sia disponibile per la sollecitazione

Chiama l'operazione getSolicitationActionsForOrder, passando i seguenti parametri:

Parametro del percorso

Parametro Descrizione Obbligatorio
amazonOrderId

Un identificativo di ordine Amazon. Specifica l'ordine per il quale desideri un elenco dei tipi di sollecitazione disponibili.

Tipo: stringa

Parametro di query

Parametro Descrizione Obbligatorio
marketplaceIds

Un identificativo del marketplace. Specifica il marketplace in cui è stato effettuato l'ordine. È possibile specificare un solo marketplace.

Tipo: array [stringa]

Esempio di richiesta

GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777 ?marketplaceIds=ATVPDKIKX0DER

Esempi di risposta

Esempio di risposta quando non sono disponibili azioni di sollecitazione:

{ "_links": { "actions": [], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [] } }

Esempio di risposta quando sono disponibili azioni di sollecitazione:

{ "_links": { "actions": [ { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } ], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [ { "_links": { "schema": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" }, "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } }, "_embedded": { "schema": { "_links": { "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" } }, "type": "object", "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review", "description": "Request seller feedback and product review", "properties": {}, "required": [], "$schema": "http://json-schema.org/draft-04/schema#", "x-ui-hidden": true } }, "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review" } ] } }

Passaggio 2. Crea una richiesta di recensione del prodotto

Se l'azione productReviewAndSellerFeedback è elencata nella risposta, chiama l'operazione createProductReviewAndSellerFeedbackSolicitation, trasmettendo i seguenti parametri:

Parametro del percorso

Parametro Descrizione Obbligatorio
amazonOrderId

Un identificativo di ordine Amazon. Specifica l'ordine per il quale viene inviata una sollecitazione.

Tipo: stringa

Parametro di query

Parametro Descrizione Obbligatorio
marketplaceIds

Un identificativo del marketplace. Specifica il marketplace in cui è stato effettuato l'ordine. È possibile specificare un solo marketplace.

Tipo: array [stringa]

Esempio di richiesta

POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback ?marketplaceIds=ATVPDKIKX0DER

Esempi di risposta

Esempio di risposta per un ordine non idoneo:

{}

Esempio di risposta per un ordine non idoneo:

{ "errors": [ { "code": "Unauthorized", "message": "The requested solicitation is not available for this amazonOrderId.", "details": "" } ] }

Best practice

Quando richiedi recensioni, assicurati di:

  • Richiedi recensioni per gli ordini che sono stati consegnati.
  • Richiedi un feedback entro il periodo di tempo consentito.

Tieni presente che non puoi:

  • Cerca selettivamente recensioni positive.
  • Richiedi modifiche alle recensioni esistenti.
  • Offri premi o incentivi per le recensioni.

Per ulteriori informazioni su come gestire in modo etico le sollecitazioni, consulta la Politica anti-manipolazione per le recensioni dei clienti.

Trasforma i feedback negativi in opportunità

Quando ricevi recensioni negative, il tuo impegno per risolvere il problema dell'acquirente può cambiare la narrazione. Una volta risolto il problema dell'acquirente, chiama il createNegativeFeedbackRemoval operazione dal API di messaggistica. I venditori possono utilizzare questa operazione per chiedere all'acquirente di rimuovere il feedback sfavorevole. Ciò offre ai venditori una seconda possibilità e sottolinea il loro impegno per la soddisfazione del cliente.


Questa pagina ti è stata utile?