Délai d'exécution et frais

Ce tutoriel couvre:

1. Une description générale des frais les cas d'utilisation liés au temps de traitement
2. Des instructions spécifiques sur la façon de spécifier la durée et les frais de traitement des commandes pour Flux de services :
3. Attentes concernant la précision

Pour obtenir un exemple de flux complet illustrant l'utilisation des frais et du temps de traitement des commandes, consultez la Exemple de l'EPA de redirection de commande.

Frais

Nous proposons plusieurs méthodes pour spécifier les frais, par exemple:

• Frais fixes : "Frais de livraison : 5 $" ou "Frais de service de 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 % au minimum" ou "Frais de service jusqu'à 20 $"

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 $").

Non pris en charge : cas d'utilisation pour lesquels des frais peuvent être modifiés en fonction des informations sur l'utilisateur.

Exemples de frais

Frais de livraison et de retrait

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

Différents types de frais

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

Délai de traitement

Nous autorisons différents formats pour indiquer le temps de disponibilité en fournissant des données précises. Les points suivants décrivent les différents cas d'utilisation pris en charge, ainsi que avec un exemple de langage semblable à ce que l'utilisateur verra sur l'interface.

• Heures 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 flux Services ETA , dans le cadre du 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"
    }
},

Périodes de traitement

Avec ServiceHours, les heures de traitement peuvent être définies pour une période spécifique. La valeur par défaut lead_time défini dans FoodOrderingService est utilisé en dehors des plages horaires de service.

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

Frais et précision du délai de traitement

Précision des frais

Lorsque vous fournissez des données sur les frais à un marchand, nous attendons de vous que vous fournissiez des informations exactes 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 en fonction des utilisateurs. C'est pourquoi nous proposons possibilité de spécifier des frais sous forme de plages, y compris de plages ouvertes ; Dans les cas où les frais peuvent varier vous assurer que la fourchette fournie comprend les frais qu'un utilisateur peut voir pendant la transaction.

En cas de doute sur les exigences spécifiques à votre cas, contactez votre Contact du centre d'actions.

Précision du délai de traitement des commandes

Nous comprenons que les spécificités du traitement des commandes en fonction de divers 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 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 conduire à des situations où le traitement de la commande l'heure affichée initialement pour l'utilisateur ne correspond pas exactement à l'heure de traitement que vous verrez au moment du règlement. L'objectif de l'implémentation du temps de traitement n'est pas de les éliminer complètement, mais de fournir aux utilisateurs des informations claires aussi souvent que possible.

Les partenaires doivent fournir une implémentation qui permette à délai de traitement affiché auprès des utilisateurs aussi souvent que possible, dans la mesure du possible à la base. Si ces facteurs peuvent entraîner des variations importantes des délais, vous fournissez une plage de fois qui englobe cette variabilité. De plus, si le délai de traitement change en raison des détails de la commande, celui-ci doit être clairement indiqué aux utilisateurs lors de leur arrivée dans votre flux de commande.

Si vous n'êtes pas sûr de savoir est obligatoire dans votre cas, adressez-vous à votre contact du centre d'actions.

Mises à jour opportunes des frais et des heures d'arrivée prévues

Au moins deux heures peuvent être nécessaires pour effectuer des modifications via une importation de flux standard à traiter. Ce point est particulièrement important si vous prévoyez de modifier les heures d'arrivée prévues. fréquemment.

Les partenaires sont vivement encouragés à mettre en œuvre des mises à jour en temps réel, qui permet à 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.