Commande

Une commande est une confirmation de transaction (un reçu) qui peut contenir plusieurs lignes, chacune représentée par une offre 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>

Action "Afficher la 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 d'e-mails. Collez votre code de balisage, puis cliquez sur le bouton Valider pour analyser le contenu et obtenir 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	Organization ou Person	(obligatoire) Partie qui prend la commande (par exemple, Amazon.com est un marchand pour de nombreux vendeurs). Accepte également une chaîne (par exemple, "Amazon.com").
merchant.name	Texte	(Obligatoire) Nom de l'organisation.
merchant.sameAs	URL	URL Freebase du marchand.
orderNumber	Texte	(obligatoire) Identifiant de la transaction spécifique au marchand.
priceCurrency	Texte	(Obligatoire) Devise (au format ISO 4217 à trois lettres) du prix de la commande.
price	Nombre ou texte	(Obligatoire) Prix total de l'ensemble de la transaction.
acceptedOffer	Offre	(Obligatoire) Offres incluses dans la commande. Accepte également un tableau d'objets.
acceptedOffer.itemOffered	Produit ou Réservation	(obligatoire) Article mis en vente.
acceptedOffer.itemOffered.name	Texte	(obligatoire) Nom du produit.
acceptedOffer.itemOffered.sku	Texte	(recommandé pour les cartes de confirmation/les réponses dans la recherche) SKU (Stock Keeping Unit), c'est-à-dire un identifiant spécifique à un marchand pour un produit ou un service, ou le produit auquel l'offre se rapporte.
acceptedOffer.itemOffered.url	URL	(recommandé pour les fiches de confirmation/réponses dans la recherche) URL du produit, généralement la page de destination du produit sur le site Web du marchand.
acceptedOffer.itemOffered.image	URL	(recommandé pour les cartes de confirmation/les réponses dans la recherche) URL d'une image du produit, généralement une image sur le site Web du marchand.
acceptedOffer.itemOffered.color	Texte	Couleur du produit.
acceptedOffer.price	Nombre ou texte	(Obligatoire) Prix unitaire du produit.
acceptedOffer.priceCurrency	Texte	(Obligatoire) Devise (au format ISO 4217 à trois lettres) du prix.
acceptedOffer.eligibleQuantity	QuantitativeValue	(obligatoire) Intervalle et unité de mesure des quantités de commande pour lesquelles l'offre ou la spécification de prix sont valides.
acceptedOffer.eligibleQuantity.value	Nombre	(obligatoire) Valeur de la caractéristique du produit.
acceptedOffer.priceSpecification	PriceSpecification	Une ou plusieurs spécifications de prix détaillées, indiquant le prix unitaire et les frais de livraison ou de paiement.
acceptedOffer.priceSpecification.price	Nombre ou texte	Prix total de l'ensemble de la transaction.
acceptedOffer.priceSpecification.priceCurrency	Texte	Devise (au format ISO 4217 à trois 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.seller	Organization ou Person	Partie auprès de laquelle la commande a été passée. Accepte également une chaîne (par exemple, "").
acceptedOffer.seller.name	Texte	Nom de l'organisation.
priceSpecification	PriceSpecification	(Recommandé pour les fiches de confirmation/les réponses de recherche) Autres alternatives plus détaillées à price/priceCurrency. Également utilisé pour spécifier les taxes et les frais de port. Accepte également un tableau d'objets.
url	URL	(recommandé pour les cartes de confirmation/les réponses de recherche) URL de la commande, généralement un lien vers le site Web du marchand où l'utilisateur peut obtenir plus d'informations sur une commande.
orderStatus	OrderStatus	(recommandé pour les fiches de confirmation/les réponses de recherche) État actuel de la commande.
paymentMethod	PaymentMethod	Nom de la carte de crédit ou d'un autre mode de paiement pour la commande.
paymentMethodId	Texte	Identifiant du mode de paiement utilisé (par exemple, les quatre derniers chiffres de la carte de crédit).
orderDate	Date et heure	Date à laquelle la commande a été passée.
isGift	Booléen	L'offre a été acceptée en tant que cadeau pour une personne autre que l'acheteur.
remise	Nombre ou texte	Toute remise appliquée.
discountCurrency	Texte	Devise (au format ISO 4217 à trois lettres) de la remise.
client	Person ou Organization	Partie qui passe la commande.
customer.name	Texte	Nom de la personne.
billingAddress	PostalAddress	Adresse de facturation de la commande.
billingAddress.name	Texte	Nom de l'adresse postale.
billingAddress.streetAddress	Texte	Adresse postale. Par exemple, 1600 Amphitheatre Pkwy.
billingAddress.addressLocality	Texte	Localité. Par exemple, Mountain View.
billingAddress.addressRegion	Texte	Région. (par exemple, CA).
billingAddress.addressCountry	Texte ou Pays	Pays. Par exemple, "USA". Vous pouvez également fournir le code pays à deux lettres ISO 3166-1 alpha-2.