Commande

Une commande est une confirmation d'une transaction (un reçu), qui peut contenir plusieurs éléments de ligne, chacun représenté par une Offer acceptée par le client.

Cas d'utilisation

Commande 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 Afficher la commande à vos commandes en définissant la propriété url. Pour créer un lien direct vers une application mobile, ajoutez également une 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 de 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 erreurs éventuelles.

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 fiches de confirmation/réponses de la recherche) L'unité de gestion des stocks (SKU), c'est-à-dire un identifiant spécifique au 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 la recherche) URL du produit, généralement la page produit de destination sur le site Web du marchand.
acceptedOffer.itemOffered.image	URL	(Recommandé pour les fiches de confirmation/réponses de 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 est valide.
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/réponses de la recherche) Autres alternatives plus détaillées à price/priceCurrency. Également utilisé pour spécifier les taxes et les frais de livraison. Accepte également un tableau d'objets.
url	URL	(Recommandé pour les fiches de confirmation/réponses de la 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/réponses de la recherche) État actuel de la commande.
paymentMethod	PaymentMethod	Nom de la carte de crédit ou autre mode de paiement de la commande.
paymentMethodId	Texte	Identifiant du mode de paiement utilisé (par exemple, les quatre derniers chiffres de la carte de crédit).
orderDate	DateTime	Date à laquelle la commande a été passée.
isGift	Booléen	L'offre a-t-elle été acceptée comme cadeau pour une personne autre que l'acheteur ?
remise	Nombre ou Texte	Remise appliquée.
discountCurrency	Texte	Devise (au format ISO 4217 à trois lettres) de la remise.
client	Personne ou Organisation	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, États-Unis. Vous pouvez également fournir le code pays à deux lettres au format ISO 3166-1 alpha-2.