Commande

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.