Guida ai casi d'uso dell'API Vendite v1
Casi d'uso per l'API di vendita.
Versione API: v1
Cos'è l'API Vendite?
L'API per i partner di vendita per le vendite (API Vendite) fornisce ai venditori informazioni sull'andamento delle vendite. Tale andamento si ottiene restituendo metriche aggregate degli ordini per un determinato periodo di tempo, suddivise per granularità e tipo di acquirente. Fai riferimento a Riferimento API Vendite per informazioni dettagliate sulle operazioni dell'API Vendite e sui tipi di dati e schemi associati.
Prerequisiti
Per completare correttamente questo tutorial, devi disporre di quanto segue:
- Autorizzazione dal partner di vendita per il quale stai effettuando chiamate. Per ulteriori informazioni, vedi Autorizzazione delle applicazioni API per i partner di vendita.
- Il ruolo Prezzi assegnato al tuo profilo sviluppatore.
- Il ruolo Prezzi selezionato nella pagina di registrazione dell'app per la tua applicazione.
Tutorial: Ricevere informazioni sulle prestazioni di vendita
Questa sezione ti guiderà attraverso la procedura per ricevere informazioni sulle prestazioni di vendita utilizzando l'API Vendite.
Ottieni informazioni sulle prestazioni di vendita
Chiama l'operazione getOrderMetrics
con i seguenti parametri per ricevere metriche aggregate degli ordini per un determinato intervallo:
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. Ad esempio Type: < stringa > array |
Sì |
interval |
A time interval used for selecting order metrics. This takes the form of two dates separated by two hyphens (first date is inclusive; second date is exclusive). Dates are in ISO 8601 format and must represent absolute time (either Z notation or offset notation). Esempio: Tipo: stringa |
Sì |
granularityTimeZone |
Un fuso orario compatibile con IANA per determinare il limite del giorno. Obbligatorio quando si specifica un valore di granularità superiore a Ora. Il valore Esempio: Stati Uniti/Pacifico per calcolare i limiti del giorno, tenendo conto dell'ora legale, per la zona Stati Uniti/Pacifico. Tipo: stringa |
No |
granularity |
Il valore Esempio: giorno per ottenere una ripartizione giornaliera dell'intervallo di richiesta, in cui il limite del giorno è definito dal valore Type: enum (Granularity) |
Sì |
buyerType |
Filtra i risultati in base al tipo di acquirente specificato, Esempio: Type: enum (BuyerType) |
No |
fulfillmentNetwork |
Filtra i risultati in base alla rete logistica specificata, Esempio: Tipo: stringa |
No |
firstDayOfWeek |
Specifica il giorno in cui inizia la settimana quando Esempio: Type: enum (FirstDayOfWeek) |
No |
asin |
Filtra i risultati in base all'ASIN specificato. Se si specificano Esempio: Tipo: stringa |
No |
sku |
Filtra i risultati in base all'o SKU specificato. Se si specificano Esempio: Tipo: stringa |
No |
Esempio di richiesta
GET https://sellingpartnerapi-na.amazon.com/sales/v1/orderMetrics?marketplaceIds=&interval=&granularityTimeZone=&granularity=&buyerType=&fulfillmentNetwork=&firstDayOfWeek=&asin=&sku="
Risposta
Parametro | Descrizione | Obbligatorio |
interval |
L'intervallo di tempo in base alla granularità richiesta (esempio, Ora, Giorno, ecc.) Se questo è il primo o l'ultimo intervallo dell'elenco, potrebbe contenere dati incompleti, se l'intervallo richiesto non è in linea con la granularità richiesta (ad esempio con l'intervallo di richiesta Tipo: stringa |
Sì |
unitCount |
Il numero di unità negli ordini in base ai filtri specificati. Tipo: intero |
Sì |
orderItemCount |
Il numero di articoli dell'ordine in base ai filtri specificati. Tipo: intero |
Sì |
orderCount |
Il numero di ordini in base ai filtri specificati. Tipo: intero |
Sì |
averageUnitPrice |
Il prezzo medio di un articolo in base ai filtri specificati. La formula è totalSales/unitCount. Type: Money |
Sì |
totalSales |
Il totale delle vendite di prodotti ordinati per tutti gli ordini in base ai filtri specificati. Type: Money |
Sì |
Esempio di risposta
{
"request": {
"parameters": {
"granularity": {
"value": "Day"
}
}
},
"response": {
"payload": [
{
"interval": "2019-08-01T00:00-07:00--2018-08-02T00:00-07:00",
"unitCount": 1,
"orderItemCount": 1,
"orderCount": 1,
"averageUnitPrice": {
"amount": "22.95",
"currencyCode": "USD"
},
"totalSales": {
"amount": "22.95",
"currencyCode": "USD"
}
},
{
"interval": "2019-08-02T00:00-07:00--2018-08-03T00:00-07:00",
"unitCount": 1,
"orderItemCount": 1,
"orderCount": 1,
"averageUnitPrice": {
"amount": "2.05",
"currencyCode": "USD"
},
"totalSales": {
"amount": "2.05",
"currencyCode": "USD"
}
}
]
}
}
Updated 5 months ago