Ce tutoriel couvre:
- Description détaillée des cas d'utilisation liés aux frais et au délai de traitement
- Instructions spécifiques sur la manière de spécifier la durée et les frais de traitement des commandes pour les flux de services.
- Attentes concernant la précision
Pour obtenir un exemple de flux complet illustrant l'utilisation du délai et des frais de traitement des commandes, consultez l'exemple de l'EPA de redirection des commandes.
Frais
Nous proposons plusieurs méthodes pour spécifier les frais, par exemple:
- Frais fixes : "Frais de livraison : 5 €" ou "Frais de service : 5 €"
- Frais en pourcentage : "Frais de livraison : 5%" ou "Frais de service : 5%".
- Fourchettes de frais : "Frais de livraison : 2 à 10 €" ou "Frais de service : 3 à 6 %"
- Plages ouvertes "Frais de livraison : 5 % minimum" ou "Frais de service : 20 $maximum"
Les frais peuvent être indiqués sous forme de frais de livraison ou de 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 pour lesquels des frais doivent être modifiés en fonction des informations sur l'utilisateur ne sont pas pris en charge.
Exemples de frais
Frais de livraison et de retrait
L'application est compatible avec les types de frais "DELIVERY" et "SERVICE".Diffusion
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Service
{
"fee": {
"fee_id": "12345/service_fee",
"fee_type": "SERVICE",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Différents types de frais
Vous trouverez ci-dessous quelques exemples faciles à utiliser pour spécifier un type de frais choisi.Fixed (Corrigé)
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Pourcentage du panier
{
"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"
]
}
}
Plage
{
"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"
]
}
}
Délai de traitement
Nous autorisons différents formats pour indiquer les heures de disponibilité afin de vous assurer de fournir des données exactes. Les points suivants décrivent les différents cas d'utilisation pris en charge, ainsi que des exemples de langage semblables à ce que l'utilisateur verra sur l'interface.
- Horaires fixes: "Livraison dans 30 min" ou "Retrait dans 15 min"
- Périodes: "Livraison dans 30 min à 1 h" ou "Retrait dans 15-20 min"
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).
Les cas d'utilisation qui nécessitent que les ATA soient modifiées en fonction des informations sur l'utilisateur ne sont pas pris en charge.
Exemples de délais de traitement
Le délai de traitement de la commande pour les liens d'action est inclus dans le message ETA du flux de services, dans le champ FoodOrderingService.
Fixed (Corrigé)
{
"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"
}
},
Période
{
"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"
}
},
Précision des frais et des délais de traitement
Précision des frais
Lorsque vous fournissez des données sur les frais à un marchand, nous attendons de vous qu'ils fournissent une représentation précise de ces 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 en fonction des utilisateurs. C'est pourquoi nous offrons la possibilité de spécifier des frais sous forme de plages, y compris les plages ouvertes. Dans les cas où les frais peuvent varier considérablement, assurez-vous que la plage fournie comprend les frais qu'un utilisateur peut voir lors de sa transaction.
Si vous n'êtes pas sûr des exigences spécifiques à votre cas, adressez-vous à votre contact du centre d'actions.
Précision du délai de traitement des commandes
Nous sommes conscients que les caractéristiques des délais de traitement des commandes évoluent en fonction de différents facteurs. y compris les suivants :
- Modifications du délai de traitement des commandes en fonction de la taille de la commande
- Modifications du délai de traitement des commandes en fonction du temps nécessaire à la finalisation de la commande et du paiement
- Délai entre la mise à jour du délai de traitement des commandes via les flux
- Adresse de livraison de l'utilisateur.
N'importe lequel de ces facteurs peut entraîner des situations dans lesquelles le délai de traitement de la commande affiché initialement auprès de l'utilisateur ne correspond pas à l'heure de traitement exacte qu'il verra au moment du règlement. L'objectif de la mise en œuvre 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 permettant d'afficher un délai de traitement précis auprès des utilisateurs aussi souvent que possible, dans la mesure du possible. Si ces facteurs présentent une variabilité importante du temps en raison de ces facteurs, nous vous suggérons de fournir une plage de dates englobant 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 lors de l'arrivée dans votre flux de commande.
Si vous n'êtes pas sûr des exigences spécifiques à votre cas, adressez-vous à votre contact du centre d'actions.
Mises à jour opportunes des frais et des heures d'arrivée prévues
Le traitement des modifications effectuées via une importation de flux normale peut prendre au moins deux heures. Ceci est particulièrement important si vous prévoyez de modifier fréquemment les heures d'arrivée prévues.
Les partenaires sont vivement encouragés à implémenter des mises à jour en temps réel, qui permettent à un appel d'API de modifier le flux de service (y compris les frais et les heures d'arrivée prévues) dans un délai maximal de cinq minutes.