En bref. OfferShippingDetails associe les frais, les destinations et les délais de livraison à une Offer au moyen de shippingDetails.

Définition : OfferShippingDetails est un type de données structurées Schema.org qui décrit les destinations, les frais et les délais de livraison d’une offre de produit. Il est rattaché à une Offer par la propriété shippingDetails.

Points clés

Au 17 octobre 2026, la documentation de Google sur les fiches de marchand exige deliveryTime, shippingDestination et shippingRate pour l’enrichissement relatif aux modalités de livraison.
La documentation de Google sur les conditions de livraison des marchands recommande de définir les conditions de livraison habituelles de l’entreprise sous Organization ; les dérogations propres à un produit utilisent OfferShippingDetails sous Offer.
La définition du type sur Schema.org permet d’utiliser plusieurs objets décrivant les modalités de livraison pour représenter différentes destinations ou différentes combinaisons de frais et de délais.

Comment décrire les frais et les destinations de livraison ?

Une Offer décrit les conditions de vente d’un produit. Ses modalités de livraison associent une destination à un tarif. Selon les exigences de Google relatives aux propriétés de livraison, shippingRate contient un MonetaryAmount : une valeur monétaire accompagnée d’une devise. Google exige value ou maxValue, ainsi que currency. La devise correspond à celle de l’offre. Pour une livraison gratuite, la valeur est 0.

La destination utilise DefinedRegion, un type qui désigne une zone géographique. Sa propriété obligatoire addressCountry contient un code pays à deux lettres. Sans région ni code postal, la destination couvre l’ensemble du pays. Google documente des restrictions propres à chaque pays pour les zones plus restreintes et les codes postaux.

La définition de Schema.org donne des exemples de destinations distinctes pour l’Alaska et Hawaï, les États-Unis continentaux et la France. Elle décrit aussi la possibilité de proposer une livraison moins chère et plus lente en parallèle d’un service plus cher et plus rapide. Des objets distincts permettent de maintenir l’association entre chaque destination, tarif et option de livraison.

Comment représenter les délais de traitement et de transport ?

Les exigences de Google relatives aux délais de livraison définissent ShippingDeliveryTime comme l’intervalle entre la réception d’une commande et la réception des marchandises par le client. handlingTime décrit le délai avant que les marchandises quittent l’entrepôt ; transitTime décrit le délai de transport qui suit.

Chaque intervalle utilise QuantitativeValue, un objet qui exprime une quantité. Google exige un nombre minimal et un nombre maximal de jours, exprimés par des entiers positifs ou nuls, avec unitCode défini sur DAY ou d.

Cet extrait JSON reproduit les valeurs de livraison de l’exemple de Google : 3,49 USD pour les États-Unis, un délai de traitement de 0 à 1 jour et un délai de transport de 1 à 5 jours. Il s’insère dans l’objet Offer existant du produit et fait partie du balisage complet du produit.

{
  "shippingDetails": {
    "@type": "OfferShippingDetails",
    "shippingRate": {
      "@type": "MonetaryAmount",
      "value": 3.49,
      "currency": "USD"
    },
    "shippingDestination": {
      "@type": "DefinedRegion",
      "addressCountry": "US"
    },
    "deliveryTime": {
      "@type": "ShippingDeliveryTime",
      "handlingTime": {
        "@type": "QuantitativeValue",
        "minValue": 0,
        "maxValue": 1,
        "unitCode": "DAY"
      },
      "transitTime": {
        "@type": "QuantitativeValue",
        "minValue": 1,
        "maxValue": 5,
        "unitCode": "DAY"
      }
    }
  }
}

Quelle place dans la configuration des livraisons d’une boutique ?

Le guide de Google sur les conditions de livraison des marchands place les conditions habituelles dans ShippingService, imbriqué sous Organization au moyen de hasShippingService. Ce format prend en charge des conditions fondées sur le poids du produit, ses dimensions et le lieu de livraison. Les conditions de livraison définies au niveau de l’offre prennent en charge un ensemble plus restreint de propriétés.

Le guide sur les fiches de marchand donne la priorité aux flux Merchant Center définis au niveau du produit sur les paramètres du compte et le balisage de la page lorsque les configurations se recoupent. Les paramètres de Merchant Center ou de Search Console priment sur le balisage au niveau du produit, qui prime lui-même sur le balisage au niveau de l’organisation. Le même guide recommande le test des résultats enrichis (Rich Results Test) pour la validation et l’inspection de l’URL (URL Inspection) pour vérifier comment Google voit la page déployée.

Termes associés

Questions fréquentes

Comment indiquer une livraison gratuite ?

Définissez shippingRate.value sur 0 et précisez la devise, conformément aux exigences de Google relatives à la livraison. Ajoutez la destination et le délai de livraison requis pour l’enrichissement.

Pouvez-vous décrire plusieurs options de livraison ?

Oui. La définition de Schema.org prend en charge plusieurs objets avec des tarifs et des délais différents, y compris des services plus lents et plus rapides pour une même destination.

Où placer des conditions qui s’appliquent à toute la boutique ?

Le guide de Google sur les conditions de livraison des marchands place les conditions habituelles de l’entreprise sous Organization au moyen de hasShippingService. Utilisez les modalités définies au niveau de l’offre pour les dérogations propres à un produit.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Données structurées OfferShippingDetails