Un ordine è la conferma di una transazione (una ricevuta) che può contenere più voci, ciascuna rappresentata da un'offerta accettata dal cliente.
Casi d'uso
Ordine di base
Esempio minimo di ordine
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>
Microdati
<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>
Visualizza azione ordine
Puoi aggiungere un pulsante View Order
ai tuoi ordini impostando la proprietà url
. Per collegarti direttamente a un'app mobile, aggiungi anche 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>
Microdati
<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>
Ordine con dettagli di fatturazione
Esempio di ordine con dati di fatturazione dettagliati
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>
Microdati
<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>
Verifica il codice di markup
Puoi convalidare il tuo markup utilizzando lo strumento Tester per il markup delle email. Incolla il codice di markup e fai clic sul pulsante Convalida per eseguire la scansione del contenuto e ricevere un report su eventuali errori presenti.
Specifica
La seguente tabella elenca tutte le proprietà disponibili per questo tipo:
Proprietà | Tipo | Descrizione |
---|---|---|
commerciante | Organization o Person | (Obbligatorio) La parte che accetta l'ordine (ad es. Amazon.com è un commerciante per molti venditori). Accetta anche una stringa (ad es. "Amazon.com"). |
merchant.name | Testo | (obbligatorio) Nome dell'organizzazione. |
merchant.sameAs | URL | L'URL Freebase del commerciante. |
orderNumber | Testo | (Obbligatorio) L'identificatore specifico del commerciante per la transazione. |
priceCurrency | Testo | (Obbligatorio) La valuta (nel formato ISO 4217 a tre lettere) del prezzo dell'ordine. |
prezzo | Numero o testo | (obbligatorio) Il prezzo totale dell'intera transazione. |
acceptedOffer | Offerta | (obbligatorio) Le offerte incluse nell'ordine. Accetta anche un array di oggetti. |
acceptedOffer.itemOffered | Prodotto o Prenotazione | (Obbligatorio) L'articolo venduto. |
acceptedOffer.itemOffered.name | Testo | (Obbligatorio) Nome del prodotto. |
acceptedOffer.itemOffered.sku | Testo | (consigliato per schede di conferma/risposte alla ricerca) Lo SKU (codice identificativo dell'articolo) ovvero un identificatore specifico del commerciante per un prodotto o un servizio oppure il prodotto a cui si riferisce l'offerta. |
acceptedOffer.itemOffered.url | URL | (consigliato per schede di conferma/risposte alla ricerca) URL del prodotto, in genere la pagina di destinazione del prodotto sul sito web del commerciante. |
acceptedOffer.itemOffered.image | URL | (consigliato per schede di conferma/risposte alla ricerca) URL di un'immagine del prodotto, in genere un'immagine sul sito web del commerciante. |
acceptedOffer.itemOffered.color | Testo | Il colore del prodotto. |
acceptedOffer.price | Numero o testo | (obbligatorio) Il prezzo unitario del prodotto. |
acceptedOffer.priceCurrency | Testo | (Obbligatorio) La valuta (nel formato ISO 4217 a tre lettere) del prezzo. |
acceptedOffer.eligibleQuantity | QuantitativeValue | (obbligatorio) L'intervallo e l'unità di misura delle quantità ordinazioni per le quali sono valide le specifiche dell'offerta o del prezzo. |
acceptedOffer.eligibleQuantity.value | Numero | (obbligatorio) Il valore della caratteristica del prodotto. |
acceptedOffer.priceSpecification | PriceSpecification | Una o più specifiche dettagliate di prezzo, che indicano il prezzo unitario e le spese di consegna o di pagamento. |
acceptedOffer.priceSpecification.price | Numero o testo | Il prezzo totale dell'intera transazione. |
acceptedOffer.priceSpecification.priceCurrency | Testo | La valuta (nel formato ISO 4217 a tre lettere) del prezzo dell'ordine. |
acceptedOffer.itemCondition | OfferItemCondition | Una descrizione testuale della condizione del prodotto o del servizio o dei prodotti o servizi inclusi nell'offerta. |
acceptedOffer.seller | Organization o Person | Parte con cui è stato effettuato l'ordine. Accetta anche una stringa (ad es. ""). |
acceptedOffer.seller.name | Testo | Nome dell'organizzazione. |
priceSpecification | PriceSpecification | (consigliato per schede di conferma/risposte alla ricerca) Qualsiasi alternativa più dettagliata a price/priceCurrency. Utilizzato anche per specificare le tasse e le spese di spedizione. Accetta anche un array di oggetti. |
url | URL | (consigliato per schede di conferma/risposte alla ricerca) URL dell'ordine, in genere un link al sito web del commerciante in cui l'utente può recuperare ulteriori dettagli su un ordine. |
orderStatus | OrderStatus | (consigliato per schede di conferma/risposte alla ricerca). Lo stato attuale dell'ordine. |
paymentMethod | PaymentMethod | Il nome della carta di credito o un altro metodo di pagamento per l'ordine. |
paymentMethodId | Testo | Un identificatore del metodo di pagamento utilizzato (ad es. le ultime 4 cifre della carta di credito). |
orderDate | DateTime | Data di esecuzione dell'ordine. |
isGift | Booleano | L'offerta è stata accettata come regalo per qualcuno che non sia l'acquirente? |
discount | Numero o testo | Qualsiasi sconto applicato. |
discountCurrency | Testo | La valuta (in formato ISO 4217 a tre lettere) dello sconto. |
cliente | Persona oppure Organizzazione | La parte che effettua l'ordine. |
customer.name | Testo | Nome della persona. |
billingAddress | PostalAddress | L'indirizzo di fatturazione dell'ordine. |
billingAddress.name | Testo | Nome dell'indirizzo postale. |
billingAddress.streetAddress | Testo | L'indirizzo fisico. Ad esempio, 1600 Amphitheatre Pkwy. |
billingAddress.addressLocality | Testo | La località. Ad esempio, Mountain View. |
billingAddress.addressRegion | Testo | L'area geografica. ad esempio CA. |
billingAddress.addressCountry | Testo o Paese | Il paese. Ad esempio, USA. Puoi anche fornire il codice paese ISO 3166-1 alpha-2 a due lettere. |