Cette page a été traduite par l'API Cloud Translation.

Ordre

Une commande est une confirmation de transaction (un reçu). Elle peut contenir plusieurs lignes, chacune étant représentée par une offre acceptée par le client.

Cas d'utilisation

Ordre de base

Exemple minimal de 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 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) La partie qui accepte la commande (par exemple, Amazon.com est le 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 propre au marchand pour la transaction.
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 vendu
acceptedOffer.itemOffered.name	Texte	Nom du produit (obligatoire)
acceptedOffer.itemOffered.sku	Texte	(Recommandé pour les fiches de confirmation/les réponses de recherche) L'unité de gestion des stocks (SKU, Stock Keeping Unit, unité de gestion des stocks), 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/les réponses de recherche) URL du produit. Il s'agit généralement de la page de destination du produit sur le site Web du marchand.
acceptedOffer.itemOffered.image	URL	(recommandé pour les fiches de confirmation/les réponses dans les résultats de recherche) URL d'une image du produit. Il s'agit généralement d'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 commandées pour lesquelles l'offre ou les spécifications 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 service, ou des produits ou services inclus dans l'offre.
acceptedOffer.seller	Organisation ou personne	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 recherche) Il s'agit d'alternatives plus détaillées que "price" ou "priceCurrency". Sert également à spécifier les taxes et les frais de livraison. Accepte également un tableau d'objets.
url	URL	(recommandé pour les cartes de confirmation/les réponses dans les résultats de recherche) URL de la commande. Il s'agit généralement d'un lien vers le site Web du marchand, sur lequel l'utilisateur peut obtenir plus d'informations sur une commande.
orderStatus	OrderStatus	(Recommandé pour les fiches de confirmation/les réponses dans la recherche) État actuel de la commande.
paymentMethod	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).
orderDate	Date et heure	Date à laquelle la commande a été passée.
isGift	Booléen	L'offre a-t-elle été acceptée pour offrir à quelqu'un d'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	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 l'élément PostalAddress.
billingAddress.streetAddress	Texte	Adresse postale. Par exemple, 1600 Amphitheatre Pkwy.
billingAddress.addressLocality	Texte	Localité. Exemple : Lyon.
billingAddress.addressRegion	Texte	Région. Par exemple, CA.
billingAddress.addressCountry	Texte ou Pays	Le pays. par exemple, USA. Vous pouvez également indiquer le code pays ISO 3166-1 alpha-2 à deux lettres.