Une commande est une confirmation de transaction (un reçu) et peut contenir plusieurs lignes, chacune étant représentée par une offre ayant été acceptée par le client.
Cas d'utilisation
Ordre de base
Exemple minimal pour une commande
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "29.99",
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
}
}
</script>
Microdonnées
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
</div>
Afficher l'action de commande
Vous pouvez ajouter un bouton View Order
à vos commandes en définissant la propriété url
. Pour créer un lien direct vers une application mobile, ajoutez également un ViewAction
:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"orderStatus": "http://schema.org/OrderProcessing",
"priceCurrency": "USD",
"price": "29.99",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
},
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
}
}
</script>
Microdonnées
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
Commande avec informations de facturation
Exemple de commande avec des informations de facturation détaillées
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "539.00",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": [
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Samsung Chromebook",
"sku": "B009LL9VDG",
"url": "http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/",
"image": "http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"
},
"price": "249.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "2"
},
"seller": {
"@type": "Organization",
"name": "Samsung Marketplace Store"
}
},
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
},
"seller": {
"@type": "Organization",
"name": "Google Store @ Amazon"
}
}
],
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
},
"orderStatus": "http://schema.org/OrderProcessing",
"paymentMethod": {
"@type": "PaymentMethod",
"name": "http://schema.org/CreditCard"
},
"paymentMethodId": "**** **** **** 1234",
"orderDate": "2027-11-07T23:30:00-08:00",
"isGift": "false",
"discount": "0.97",
"discountCurrency": "USD",
"customer": {
"@type": "Person",
"name": "John Smith"
},
"billingAddress": {
"@type": "PostalAddress",
"name": "Google",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"addressCountry": "USA"
}
}
</script>
Microdonnées
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="539.00"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Samsung Chromebook"/>
<meta itemprop="sku" content="B009LL9VDG"/>
<link itemprop="url" href="http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"/>
</div>
<meta itemprop="price" content="249.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="2"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Samsung Marketplace Store"/>
</div>
</div>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Google Store @ Amazon"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<div itemprop="paymentMethod" itemscope itemtype="http://schema.org/PaymentMethod">
<meta itemprop="name" content="http://schema.org/CreditCard"/>
</div>
<meta itemprop="paymentMethodId" content="**** **** **** 1234"/>
<meta itemprop="orderDate" content="2027-11-07T23:30:00-08:00"/>
<meta itemprop="isGift" content="false"/>
<meta itemprop="discount" content="0.97"/>
<meta itemprop="discountCurrency" content="USD"/>
<div itemprop="customer" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="billingAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Google"/>
<meta itemprop="streetAddress" content="1600 Amphitheatre Pkwy"/>
<meta itemprop="addressLocality" content="Mountain View"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
Tester le balisage
Vous pouvez valider votre balisage à l'aide de l'outil de test du balisage des e-mails. Collez votre code de balisage, puis cliquez sur le bouton Valider pour analyser le contenu et recevoir un rapport sur les éventuelles erreurs.
Spécification
Le tableau suivant répertorie toutes les propriétés disponibles pour ce type:
Propriété | Type | Description |
---|---|---|
marchand | Organisation ou Personne | (obligatoire) : partie prenant la commande (par exemple, Amazon.com est un marchand pour de nombreux vendeurs). Accepte également une chaîne (par exemple, "Amazon.com"). |
merchant.name [nom] | Texte | (obligatoire) Nom de l'organisation. |
merchant.sameAs | URL | URL Freebase du marchand. |
numérodecommande | Texte | (obligatoire) : identifiant propre à la transaction. |
priceCurrency | Texte | (obligatoire) La devise (au format ISO 4217 à trois lettres) du prix de la commande. |
price | Nombre ou texte | (obligatoire) : prix total de la transaction. |
Offre acceptée | Offre | (obligatoire) : offres incluses dans la commande. Accepte également un tableau d'objets. |
acceptedOffer.itemOffered | Produit ou Réservation | (obligatoire) : article vendu. |
acceptedOffer.itemOffered.nom | Texte | (obligatoire) Nom du produit. |
acceptedOffer.itemOffered.sku | Texte | (Recommandé pour les fiches de confirmation/Réponses de recherche) : code SKU (Stock Keeping Unit, unité de gestion des stocks), c'est-à-dire l'identifiant propre à un marchand pour un produit ou un service, ou le produit auquel l'offre fait référence. |
acceptedOffer.itemOffered.url | URL | (Recommandé pour les fiches de confirmation/Réponses de recherche) du produit, généralement la page de destination du produit sur le site Web du marchand. |
acceptedOffer.itemOffered.image | URL | (recommandé pour les fiches de confirmation/Réponses à la recherche) d'une image du Produit, généralement une image sur le site Web du marchand. |
acceptedOffer.itemOffered.couleur | Texte | Couleur du produit. |
acceptedOffer.price | Nombre ou texte | (obligatoire) : prix unitaire du produit. |
acceptedOffer.priceCurrency | Texte | (obligatoire) La devise (au format ISO 4217 à 3 lettres) du prix. |
acceptedOffer.eligibleQuantity | Valeur quantitative | (obligatoire) : intervalle et unité de mesure des quantités de commandes pour lesquelles l'offre ou les spécifications de prix sont valides. |
acceptedOffer.eligibleQuantity.valeur | Number | (obligatoire) Valeur de la caractéristique du produit. |
acceptedOffer.priceSpecification | Spécifications des prix | Une ou plusieurs spécifications de prix détaillées indiquant le prix unitaire et les frais de livraison ou de paiement. |
acceptedOffer.priceSpecification.prix | Nombre ou texte | Prix total de la transaction. |
acceptedOffer.priceSpecification.priceCurrency | Texte | Devise (au format ISO 4217 à 3 lettres) du prix de la commande. |
acceptedOffer.itemCondition | OfferItemCondition | Description textuelle de l'état du produit ou du service, ou des produits ou services inclus dans l'offre. |
acceptedOffer.vendeur | Organisation ou Personne | Partie avec laquelle la commande a été passée. Accepte également une chaîne (par exemple ""). |
acceptedOffer.seller.nom | Texte | Nom de l'organisation. |
priceSpecification | Spécifications des prix | (Recommandé pour les cartes de confirmation/Réponses à la recherche) Autres alternatives plus détaillées de price/priceCurrency. Permet également de spécifier les taxes et les frais de livraison. Accepte également un tableau d'objets. |
url | URL | (Recommandé pour les cartes de confirmation/Réponses aux recherches) de la commande. Il s'agit généralement d'un lien vers le site Web du marchand, sur lequel l'utilisateur peut obtenir de plus amples informations sur une commande. |
état de la commande | OrderStatus (état de la commande) | (recommandé pour les fiches de confirmation/Réponses à la recherche) : état actuel de la commande. |
Méthode de paiement | PaymentMethod | Nom de la carte de crédit ou autre mode de paiement utilisé pour la commande. |
paymentMethodId | Texte | Identifiant du mode de paiement utilisé (par exemple, les quatre derniers chiffres de la carte de crédit). |
date commande | DateTime | Date de la commande. |
cadeau | Booléen | L'offre a-t-elle été acceptée en cadeau pour quelqu'un d'autre que l'acheteur ? |
discount | Nombre ou texte | Toute remise est appliquée. |
discountCurrency | Texte | Devise (au format ISO 4217 à 3 lettres) de la remise. |
client | Personne ou Organisation | Partie passant la commande. |
customer.name | Texte | Nom de la personne. |
billingAddress | PostalAddress | Adresse de facturation de la commande. |
billingAddress.name | Texte | Nom de PostalAddress. |
billingAddress.streetAddress | Texte | Adresse postale. Exemple : 1600 Amphitheatre Pkwy. |
billingAddress.addressLocality | Texte | Localité. Par exemple, Mountain View. |
billingAddress.addressRegion | Texte | Région. Exemple : CA. |
billingAddress.addressCountry | Texte ou Pays | Pays. Par exemple : États-Unis. Vous pouvez également indiquer le code pays ISO 3166-1 alpha-2 à deux lettres. |