Costi e tempi di evasione degli ordini

Questo tutorial illustra:

1. Una descrizione generale della tariffa e sono supportati i casi d'uso relativi ai tempi di evasione
2. Istruzioni specifiche su come specificare tempi di evasione degli ordini e commissioni per Feed di servizio.
3. Aspettative di accuratezza

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

Tariffe

Offriamo diversi modi per specificare le commissioni, ad esempio:

• Tariffa fissa: "Tariffa di spedizione 5 $" o "Commissione di servizio 5 $"
• Tariffa percentuale: "Tariffa di consegna 5%" o "Commissione di servizio 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 sono supportati i casi d'uso che richiedono una variazione delle tariffe in base alle informazioni sull'utente.

Esempi di commissioni

Spese di consegna e ritiro

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

{
  "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

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

{
  "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"
    ]
  }
}

{
  "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à e garantire fornendo dati accurati. I seguenti punti descrivono i diversi casi d'uso supportati, insieme con alcuni linguaggi di esempio simili a quelli che l'utente vedrà sul frontend.

• Orari fissi: "Consegna tra 30 min" o "Ritiro tra 15 minuti"
• Intervalli di tempo: "Consegna tra 30 min-1 h" o "Ritiro tra 15-20 min"

È possibile specificare i tempi di evasione degli ordini sia per il ritiro che per la consegna utilizzando un formato comune (descritti 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 feed dei servizi ETA nell'ambito del FoodOrderingService .

{
    "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"
    }
},

{
    "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"
    }
},

Finestre temporali di evasione ordine

Con ServiceHours, i tempi di evasione possono essere impostati per una finestra temporale specifica. Il valore predefinito lead_time impostato in Uso di FoodOrderingService al di fuori degli orari di servizio.

{
  "data": [
    {
      "service": {
        "service_id": "merchant-1-service-delivery",
        "service_type": "DELIVERY",
        "parent_entity_id": "merchant-1",
        "lead_time": {
          "min_lead_time_duration": "1200s"
        },
        "action_link_id": "merchant-1-takeout-delivery-action"
      }
    },
    {
      "service_hours": {
        "hours_id": "merchant-1-advance-hours-delivery",
        "service_ids": ["merchant-1-service-delivery"],
        "asap_hours": [
          {
            "time_windows": {
              "time_windows": {
                "open_time": {
                  "hours": 11
                },
                "close_time": {
                  "hours": 13,
                  "minutes": 30
                }
              }
            },
            "lead_time": {
              "min_lead_time_duration": "2400s"
            }
          }
        ]
      }
    }
  ]
}

Tariffa e accuratezza dei tempi di evasione

Accuratezza della commissione

Quando fornisci i dati sulle commissioni di un commerciante, ci aspettiamo che tu fornisca una dichiarazione accurata. delle tue 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 possibilità di specificare le tariffe come intervalli, inclusi intervalli aperti. Nei casi in cui le tariffe possono variare assicurarsi che l'intervallo fornito comprenda le tariffe che un utente potrebbe vedere durante la transazione.

Se hai dubbi su ciò che è richiesto nello specifico nel tuo caso, contatta il tuo Contatto Actions Center.

Precisione dei tempi di evasione degli ordini

Sappiamo che le specifiche dell'evasione degli ordini dell'orario 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 Acquisto rapido
• 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ò determinare l'evasione dell'ordine visualizzato inizialmente dall'utente non è l'ora esatta di evasione al momento del pagamento. L'obiettivo dell'implementazione del tempo di evasione non è eliminarli completamente, ma fornire informazioni chiare agli utenti il più spesso possibile.

I partner sono tenuti a fornire un'implementazione che porti a tempi di evasione degli ordini mostrati agli utenti il più spesso possibile, nel miglior modo possibile base. Se le tempistiche variano notevolmente a causa di questi fattori, ti consigliamo fornisci un intervallo di tempi che comprende questa variabilità. Inoltre, se i tempi di evasione cambiano a causa dei dettagli dell'ordine, Questo dovrebbe essere mostrato chiaramente agli utenti quando arrivi nel tuo flusso di ordinazione.

Se hai dubbi su quale sia in caso di necessità, rivolgiti al tuo contatto di Actions Center.

Aggiornamenti tempestivi a tariffe e orari di arrivo stimati

Qualsiasi modifica effettuata tramite un normale caricamento di un feed può richiedere almeno 2 ore da elaborare. Ciò è particolarmente importante se prevedi di cambiare l'orario di arrivo stimato spesso.

I partner sono vivamente invitati a implementare gli aggiornamenti in tempo reale, che consente a una chiamata API di modificare il feed di servizio (inclusi tariffe e orari di arrivo stimati) entro 5 minuti o meno.