Délai de traitement et frais (anciens uniquement)

Ce tutoriel vous explique comment:

  1. Description générale des cas d'utilisation des frais et du délai de traitement pris en charge
  2. Instructions spécifiques pour spécifier le délai de traitement des commandes et les frais pour les action_link dans vos flux
  3. Exigences en termes de précision

Pour obtenir un exemple de flux complet qui indique l'utilisation du délai de traitement des commandes et des frais, consultez l'exemple d'EPA de redirection de commande.

Cas d'utilisation des frais et du délai de traitement

Cas d'utilisation des frais

Nous proposons plusieurs méthodes pour spécifier les frais. Les points ci-dessous décrivent les différents cas d'utilisation compatibles, ainsi que des exemples de langage semblables à ce que l'utilisateur verra dans l'interface utilisateur.

  • Frais fixes: "Frais de livraison 5 $" ou "Frais de service 5 $"
  • Frais de pourcentage: "Frais de livraison 5%" ou "Frais de service 5%"
  • Fourchettes de frais: "Frais de livraison entre 2 et 10 $" ou "Frais de service entre 3 et 6 %"
  • Intervalles ouverts: "Frais de livraison à partir de 5%" ou "Frais de service jusqu'à 20 $"

Comme indiqué dans les exemples ci-dessus, les frais peuvent être spécifiés en tant que frais de livraison ou frais de service. Vous pouvez également spécifier plusieurs frais (par exemple, "Frais de service 5 % à 10%, Frais de livraison 5 $").

Les cas d'utilisation qui nécessitent la mise à jour des frais tout au long de la journée ou leur modification en fonction des informations sur l'utilisateur ne sont pas acceptés.

Cas d'utilisation du délai de traitement

Nous acceptons plusieurs formats pour spécifier l'heure de disponibilité afin de vous assurer de fournir des données précises. Les points ci-dessous décrivent les différents cas d'utilisation compatibles, ainsi que des exemples de langage semblables à ce que l'utilisateur verra sur l'interface utilisateur.

  • Heures fixes: "Livraison sous 30 min" ou "Retrait sous 15 min"
  • Périodes: "Livraison sous 30 à 60 min" ou "Retrait sous 15 à 20 min"
  • Plage horaire ouverte: "Livraison sous plus de 10 min" ou "Retrait sous moins d'1 h"

Le délai de traitement peut être spécifié pour le retrait et la livraison à l'aide d'un format commun (décrit ci-dessous). Comme indiqué dans les exemples ci-dessus, le texte présenté aux utilisateurs reflète le type de traitement spécifié dans le lien d'action.

Les cas d'utilisation qui nécessitent la mise à jour des heures tout au long de la journée ou leur modification en fonction des informations sur l'utilisateur ne sont pas acceptés.

Spécifier le délai de traitement des commandes via des flux

Le délai de traitement des commandes pour les liens d'action est inclus dans le message du flux Merchant action_link, dans le champ food_ordering_metadata. Pour chaque action_link associé au marchand, vous devez fournir des informations de traitement à l'aide de l'un des chemins de message.

Délai de traitement fixe

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Ce message doit respecter le format suivant:

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

Délai de traitement de la plage

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Ce message doit respecter le format suivant:

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

Spécifier des frais via des flux

Comme pour le délai de traitement de la commande, les frais peuvent être inclus dans le message action_link sous le champ food_ordering_metadata. Pour chaque action_link associé à un marchand, vous pouvez fournir des informations sur les frais à l'aide du chemin de message:

merchant.action_link.food_ordering_metadata.fee_details

Vous trouverez ci-dessous plusieurs exemples de cas d'utilisation.
  • Frais de livraison fixes de 1,99 $: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Frais de livraison de 5,6%. 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • Les frais de service varient de 1,99 $à 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"
        }
      }
    }
  }
]
  • Les frais de service varient entre 1,2% et 2,7 %. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • Deux frais : des frais de service de 5 $et des frais de livraison de 1,2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Précision des frais et du délai de traitement

Précision des frais

Lorsque vous fournissez des données sur les frais pour un marchand, nous vous demandons de fournir une représentation précise de vos frais. Vous devez inclure tous les frais de livraison et de service qui peuvent s'appliquer à une commande.

Nous sommes conscients que les frais peuvent varier au fil du temps et d'un utilisateur à l'autre. C'est pourquoi nous proposons la possibilité de spécifier des frais sous forme de plages, y compris des plages ouvertes. Lorsque les frais peuvent varier de manière significative, assurez-vous que la fourchette fournie englobe les frais qu'un utilisateur peut voir lors de sa transaction.

Si vous ne savez pas exactement ce qui est requis dans votre cas, contactez votre contact Actions Center.

Précision du délai de traitement des commandes

Nous sommes conscients que les détails du délai de traitement des commandes varient en fonction de divers facteurs. y compris les suivants :

  • Modification du délai de traitement des commandes en fonction de leur taille
  • Modifications apportées au délai de traitement des commandes en fonction du temps nécessaire pour passer commande et effectuer le paiement
  • Latence entre le moment où les modifications du délai de traitement des commandes sont mises à jour via les flux
  • Adresse de livraison de l'utilisateur.

Chacun de ces facteurs peut entraîner des situations où le délai de traitement de la commande affiché initialement à l'utilisateur n'est pas le délai exact qu'il verra au moment du règlement. L'objectif de l'implémentation du délai de traitement n'est pas de les éliminer complètement, mais de fournir des informations claires aux utilisateurs aussi souvent que possible.

Les partenaires doivent fournir une implémentation qui permet d'afficher un délai de traitement précis aux utilisateurs aussi souvent que possible, dans la mesure du possible. Si la variabilité des délais est importante en raison de ces facteurs, nous vous suggérons de fournir une plage de dates qui englobe cette variabilité. De plus, si le délai de traitement change en raison des détails de la commande, cela doit être clairement indiqué aux utilisateurs lorsqu'ils arrivent dans votre parcours de commande.

Si vous ne savez pas exactement ce qui est requis dans votre cas, contactez votre contact Actions Center.