Costi e tempi di evasione degli ordini

Questo tutorial illustra:

  1. Una descrizione generale dei casi d'uso di tariffe e tempi di evasione degli ordini supportati.
  2. Istruzioni specifiche su come specificare il tempo di evasione degli ordini e le commissioni per action_link nei tuoi feed
  3. Aspettative relative alla precisione

Per un esempio di feed completo che mostra l'utilizzo del tempo di evasione degli ordini e delle commissioni, consulta l'esempio di EPA relativo al reindirizzamento degli ordini.

Casi d'uso relativi a tariffe e tempi di evasione degli ordini

Casi d'uso relativi alle tariffe

Forniamo diversi modi per specificare le tariffe. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme ad alcuni linguaggi di esempio simili a quello che l'utente vedrà nel front-end.

  • Tariffa fissa: "Commissione di consegna 5 €" o "Commissione di servizio 5 €"
  • Tariffa percentuale: "Commissione di consegna 5%" o "Commissione di servizio 5%"
  • Intervalli di commissioni: "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 $"

Come mostrato negli esempi precedenti, le commissioni possono essere specificate come commissione di consegna o commissione di servizio. È anche possibile specificare più commissioni (ad es. "Commissione di servizio 5%-10%, Commissione di consegna 5 €").

Non sono supportati i casi d'uso che richiedono l'aggiornamento delle tariffe nel corso della giornata o la modifica in base alle informazioni sull'utente.

Casi d'uso relativi al tempo di evasione degli ordini

Sono ammessi diversi formati per specificare il tempo di disponibilità, in modo da garantire l'accuratezza dei dati forniti. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme ad alcuni esempi di linguaggio simile a quello che l'utente vedrà nel front-end.

  • Tempi fissi: "Consegna tra 30 minuti" o "Ritiro tra 15 minuti"
  • Intervalli di tempo: "Consegna tra 30 minuti e 1 ora" o "Ritiro tra 15-20 minuti"
  • Intervalli di tempo non disponibili: "Consegna tra più di 10 minuti" o "Ritiro in meno di 1 ora"

I tempi di evasione possono essere specificati sia per il ritiro che per la consegna utilizzando un formato comune (descritto di seguito). Come mostrato negli esempi precedenti, il testo mostrato agli utenti rifletterà il tipo di evasione degli ordini specificato nel link all'azione.

Non sono supportati i casi d'uso che richiedono tempi di aggiornamento durante la giornata o di modifiche in base alle informazioni sull'utente.

Specificare il tempo di evasione degli ordini tramite i feed

La data e l'ora di evasione degli ordini per i collegamenti delle azioni è inclusa nel messaggio del feed del commerciante action_link nell'ambito del campo food_ordering_metadata. Per ogni action_link associato al commerciante, devi fornire le informazioni di evasione utilizzando uno dei percorsi di messaggio.

Tempo di evasione degli ordini fisso

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Questo messaggio deve essere nel seguente formato:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

Tempo di completamento intervallo

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Questo messaggio deve avere il seguente formato:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

Specificare le tariffe tramite i feed

Analogamente all'ora di evasione dell'ordine, le tariffe possono essere incluse nel messaggio action_link nel campo food_ordering_metadata. Per ogni action_link associato a un commerciante, puoi fornire informazioni sulla tariffa utilizzando il percorso del messaggio:

merchant.action_link.food_ordering_metadata.fee_details

Di seguito sono riportati alcuni esempi dei diversi casi d'uso.
  • Una tariffa di consegna fissa di 1,99 $: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Una commissione di consegna percentuale del 5,6%. 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • La commissione di servizio è compresa tra 1,99 $e 9,99 $
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • La percentuale di commissione di servizio è compresa tra 1,2% e 2,7% 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • Due commissioni, una commissione di servizio di 5 $e una commissione di consegna dell'1, 2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Precisione di commissioni e tempi di evasione degli ordini

Accuratezza della commissione

Quando fornisci dati sulle commissioni a un commerciante, ci aspettiamo che tu fornisca una rappresentazione accurata delle tue commissioni. Devi includere tutte le commissioni di servizio e di consegna che possono essere applicate a un ordine.

Siamo consapevoli che le tariffe possono variare nel tempo e in base all'utente. Per questo motivo, offriamo la possibilità di specificare le tariffe come intervalli, inclusi intervalli aperti. Nei casi in cui le tariffe possano variare in modo significativo, assicurati che l'intervallo fornito includa le tariffe che un utente potrebbe visualizzare durante la transazione.

Se hai dubbi su quali siano i requisiti specifici del tuo caso, rivolgiti al tuo contatto del Centro azioni.

Precisione dei tempi di evasione degli ordini

Sappiamo che le specifiche relative al tempo di evasione degli ordini cambiano in base a una serie di fattori. Questi fattori includono:

  • Modifiche all'ora di evasione degli ordini in base al volume
  • Modifiche all'ora di evasione dell'ordine in base ai tempi di completamento dell'ordine e del pagamento
  • Latenza tra il momento in cui le modifiche all'ora 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 l'ora di evasione dell'ordine mostrata inizialmente all'utente non corrisponde all'ora esatta di evasione che vedrà al momento del pagamento. L'obiettivo dell'implementazione del tempo di evasione non è eliminarli completamente, ma fornire agli utenti informazioni chiare il più spesso possibile.

I partner sono tenuti a fornire un'implementazione che consenta di mostrare agli utenti i tempi di evasione degli ordini accurati il più spesso possibile e nel modo migliore possibile. Se esiste una significativa variabilità dei tempi a causa di questi fattori, ti suggeriamo di fornire un intervallo di orari che comprendano questa variabilità. Inoltre, se l'orario di evasione cambia a causa dei dettagli dell'ordine, dovrebbe essere mostrato in modo chiaro agli utenti al momento dell'arrivo nel flusso di ordinazione.

Se hai dubbi in merito ai requisiti specifici del caso, rivolgiti al tuo contatto del Centro azioni.