Questo tutorial illustra:
- Una descrizione generale di quali casi d'uso relativi a tariffe e tempi di evasione sono supportati
- Istruzioni specifiche su come specificare i tempi di evasione degli ordini e le commissioni per i feed di servizio.
- Aspettative di accuratezza
Per un esempio di feed completo che mostra l'utilizzo del tempo di evasione degli ordini e delle commissioni, consulta l'esempio di EPA di reindirizzamento dell'ordine.
Tariffe
Offriamo diversi modi per specificare le commissioni, ad esempio:
- Tariffa fissa: "Commissione di spedizione 5 $" o "Commissione di servizio 5 $"
- Tariffa percentuale: "Commissione di consegna al 5%" o "Commissione di servizio al 5%"
- Intervalli di commissione: "Commissioni di consegna 2-10 $" o "Commissioni di servizio 3%-6%"
- Intervalli aperti "Commissioni di consegna a partire dal 5%" o "Commissioni di servizio fino a 20 $"
Le commissioni possono essere specificate come spese di consegna o commissione di servizio. È anche possibile specificare più commissioni (ad es. "Commissione di servizio 5%-10%, Spese di consegna $5").
Non supportati sono casi d'uso che richiedono una variazione delle tariffe in base alle informazioni sull'utente.
Esempi di commissioni
Spese di consegna e ritiro
L'applicazione supporta i tipi di tariffa "delivery" e "SERVICE".Consegna
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Servizio
{
"fee": {
"fee_id": "12345/service_fee",
"fee_type": "SERVICE",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Diversi tipi di tariffa
Di seguito sono riportati alcuni esempi di facile utilizzo per specificare un determinato tipo di tariffa.Fisse
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Percentuale carrello
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"cart_percentage": {
"base_value": {
"currency_code": "USD",
"units": 3,
"nanos": 500000000
},
"percentage_of_cart_value": 10
},
"service_ids": [
"service/entity002"
]
}
}
chiavi
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"range_amount": {
"min_amount": {
"currency_code": "USD",
"units": 3,
"nanos": 500000000
},
"max_amount": {
"currency_code": "USD",
"units": 5,
"nanos": 600000000
}
},
"service_ids": [
"service/entity002"
]
}
}
Tempo di evasione ordine
Consentiamo diversi formati per specificare i tempi di disponibilità in modo da garantire dati accurati. I punti seguenti descrivono i diversi casi d'uso supportati, insieme ad alcuni linguaggi di esempio simili a ciò che l'utente vedrà sul frontend.
- Orari fissi: "Consegna tra 30 minuti" o "Ritiro tra 15 minuti"
- Intervalli di tempo: "Consegna tra 30 min-1 ora" o "Ritiro tra 15-20 min"
È possibile specificare i tempi di evasione sia per il ritiro che per la consegna utilizzando un formato comune (descritto di seguito).
Non supportati sono casi d'uso che richiedono la modifica degli orari di arrivo stimati in base alle informazioni dell'utente.
Esempi di tempi di evasione ordine
Il tempo di evasione degli ordini per i link di azione è incluso nel messaggio
ETA
del feed dei servizi, come parte del campo
FoodOrderingService.
Fisse
{
"service": {
"service_id": "service-id",
"service_type": "TAKEOUT",
"parent_entity_id": "entity-id",
"lead_time": {
"min_lead_time_duration": "900s"
},
"action_link_id": "action-link-id"
}
},
Intervallo di tempo
{
"service": {
"service_id": "service-id",
"service_type": "TAKEOUT",
"parent_entity_id": "entity-id",
"lead_time": {
"min_lead_time_duration": "900s"
"max_lead_time_duration": "1200s"
},
"action_link_id": "action-link-id"
}
},
Precisione dei tempi di evasione e delle commissioni
Accuratezza della commissione
Quando fornisci i dati sulle commissioni per un commerciante, ci aspettiamo che tu fornisca una rappresentazione accurata delle commissioni. Devi includere tutte le commissioni di consegna e di servizio applicabili a un ordine.
Siamo consapevoli che le tariffe possono variare nel tempo e da un utente all'altro. Per questo motivo offriamo la possibilità di specificare le tariffe come intervalli, inclusi gli intervalli aperti. Nei casi in cui le tariffe possono variare in modo significativo, assicurati che l'intervallo fornito comprenda le tariffe che un utente potrebbe vedere durante la transazione.
Se hai dubbi su cosa sia richiesto nello specifico nella tua richiesta, rivolgiti al tuo contatto di Actions Center.
Precisione dei tempi di evasione degli ordini
Sappiamo che le specifiche relative ai tempi di evasione degli ordini cambiano in base a una serie di fattori. tra cui:
- Modifiche ai tempi di evasione degli ordini in base al volume degli ordini
- Modifiche ai tempi di evasione degli ordini in base ai tempi necessari per completare l'ordine e il pagamento
- Latenza tra il momento in cui le modifiche all'orario di evasione degli ordini vengono aggiornate tramite i feed
- L'indirizzo di consegna dell'utente.
Ognuno di questi fattori può portare a situazioni in cui il tempo di evasione dell'ordine mostrato all'utente inizialmente non corrisponde a quello esatto che vedrà al momento del pagamento. L'obiettivo dell'implementazione dei tempi di evasione non è eliminarli del tutto, ma fornire informazioni chiare agli utenti il più spesso possibile.
I partner sono tenuti a fornire un'implementazione che consenta di mostrare agli utenti tempi di evasione degli ordini accurati il più spesso possibile, secondo il criterio del massimo impegno. Se esiste una variabilità significativa nei tempi a causa di questi fattori, ti suggeriamo di fornire un intervallo di date che comprenda questa variabilità. Inoltre, se i tempi di evasione cambiano a causa dei dettagli dell'ordine, questo cambiamento dovrebbe essere mostrato chiaramente agli utenti al momento dell'arrivo nel flusso di ordinazione.
Se hai dubbi su cosa sia richiesto nello specifico nel tuo caso, rivolgiti al tuo contatto del Centro azioni.
Aggiornamenti tempestivi a tariffe e orari di arrivo stimati
L'elaborazione di qualsiasi modifica mediante un normale caricamento di feed può richiedere almeno 2 ore. Questo è particolarmente importante se prevedi di modificare frequentemente gli orari di arrivo stimati.
I partner sono vivamente invitati a implementare gli aggiornamenti in tempo reale, che consentono una chiamata API di modificare il feed di servizio (comprese tariffe e orari di arrivo stimati) entro 5 minuti o meno.