Délai d'exécution et frais

Ce tutoriel décrit les éléments suivants:

  1. Description détaillée des cas d'utilisation liés aux frais et aux délais de traitement
  2. Instructions spécifiques sur la manière de spécifier les frais et le délai de traitement des commandes pour action_link(s) dans vos flux
  3. Attentes en termes d'exactitude

Pour obtenir un exemple de flux complet présentant les délais et les frais de traitement des commandes, consultez l'exemple de l'EPA de redirection des commandes.

Cas d'utilisation pour les frais et les délais de traitement

Cas d'utilisation de frais

Nous vous proposons plusieurs méthodes pour spécifier les frais. Les points ci-dessous décrivent les différents cas d'utilisation pris en charge, ainsi que des exemples de langage semblable à ce que verront l'utilisateur sur l'interface.

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

Comme indiqué dans les exemples ci-dessus, les frais peuvent être définis comme des frais de livraison ou des frais de service. Vous pouvez également indiquer plusieurs frais (par exemple, "Frais de service de 5 à 10 %, Frais de livraison de 5 $").

Les cas d'utilisation où les frais doivent être actualisés tout au long de la journée ou modifiés en fonction d'informations sur l'utilisateur ne sont pas acceptés.

Cas d'utilisation de temps de traitement

Nous autorisons différents formats pour indiquer 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 pris en charge, ainsi que des exemples de langage semblable à ce que verront l'utilisateur sur l'interface.

  • Délais fixes: "Livraison dans 30 min" ou "Retrait dans 15 min"
  • Périodes: "Livraison dans 30 min à 1 h" ou "Retrait en 15 à 20 min"
  • Plages horaires ouvertes: "Livraison dans plus de 10 minutes" ou "Retrait dans moins d'une heure"

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

Les cas d'utilisation dont les heures doivent être mises à jour au cours de la journée ou modifiés en fonction des informations sur l'utilisateur ne sont pas pris en charge.

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

Le délai de traitement de la commande pour les liens d'action est inclus dans le message action_link du flux Merchant Center, 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 du message.

Délai d'exécution fixe

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Ces messages doivent se présenter au format suivant:

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

Temps d'exécution de la plage

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Ce message doit se présenter au 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, vous pouvez inclure des frais 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 du message:

merchant.action_link.food_ordering_metadata.fee_details

Vous trouverez ci-dessous plusieurs exemples de différents cas d'utilisation.
  • Frais de livraison fixes de 1,99 $ :
    [
      {
        "type": "DELIVERY",
        "fee_amount": {
          "amount": {
            "currency_code": "USD",
            "units": "1",
            "nanos": "990000000"
          }
        }
      }
    ]
    
  • Des frais de livraison de 5,6 % sous forme de pourcentage.
    [
      {
        "type": "DELIVERY",
        "fee_amount": {
          "cart_percentage": {
            "value": "5.6"
          }
        }
      }
    ]
    
  • Des frais de service compris entre 1,99 et 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"
            }
          }
        }
      }
    ]
    
  • Un pourcentage des frais de service compris 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 à un marchand, nous attendons de vous 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 selon les utilisateurs. C'est pourquoi nous offrons la possibilité de définir des frais sous forme de plages, y compris des plages ouvertes. Dans les cas où les frais peuvent varier considérablement, assurez-vous que la fourchette indiquée englobe les frais qui peuvent être facturés à l'utilisateur lors de sa transaction.

Si vous n'êtes pas sûr de ce qui est nécessaire dans votre demande, adressez-vous à votre contact dans le Centre d'actions.

Précision du délai de traitement des commandes

Nous sommes conscients que les délais de traitement des commandes évoluent en fonction de divers facteurs. y compris les suivants :

  • Modifications du délai de traitement de la commande en fonction de la taille de la commande
  • Modifications du délai de traitement des commandes en fonction du délai de commande et de paiement
  • Latence entre la mise à jour des modifications du délai de traitement des commandes via les flux
  • Adresse de livraison de l'utilisateur.

Tous ces facteurs peuvent entraîner des situations dans lesquelles le délai de traitement de la commande présenté à l'utilisateur ne correspond pas exactement à celui qu'il verra lors du règlement. L'implémentation du délai de traitement n'a pas pour but de les éliminer complètement, mais de fournir des informations claires aux utilisateurs aussi souvent que possible.

Dans la mesure du possible, les partenaires sont tenus de fournir une mise en œuvre qui offre aux utilisateurs un délai de traitement précis, aussi souvent que possible. Si vous constatez une variabilité importante en raison de ces facteurs, nous vous suggérons de fournir une période incluant cette variabilité. En outre, si le délai de traitement change en raison des détails de la commande, cette information doit être clairement indiquée aux utilisateurs à l'arrivée dans le flux de commande.

Si vous n'êtes pas sûr des exigences spécifiques à votre cas, adressez-vous à votre contact dans le Centre d'actions.