Um pedido é a confirmação de uma transação (recibo), que pode conter vários itens de linha, cada um representado por uma oferta que foi aceita pelo cliente.
Casos de uso
Ordem básica
Exemplo mínimo para um pedido
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>
Microdados
<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>
Ver ação do pedido
É possível adicionar um botão View Order
aos seus pedidos definindo a propriedade url
. Para vincular diretamente a um aplicativo para dispositivos móveis, adicione também um 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>
Microdados
<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>
Pedido com detalhes de faturamento
Exemplo de pedido com informações de faturamento detalhadas
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>
Microdados
<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>
Teste sua marcação.
É possível validar sua marcação usando a Ferramenta de testagem de marcação de e-mail. Cole o código de marcação e clique no botão Validar para verificar o conteúdo e receber um relatório sobre erros.
Especificação
A tabela a seguir lista todas as propriedades disponíveis para esse tipo:
Propriedade | Tipo | Descrição |
---|---|---|
comerciante | Organização ou Pessoa | (obrigatório) A parte que recebe o pedido (por exemplo, Amazon.com é um comerciante para muitos vendedores). Também aceita uma string (por exemplo, "Amazon.com"). |
Nome do merchant. | Texto | (obrigatório) Nome da organização. |
merchant.sameAs | URL | O URL do Freebase para o comerciante. |
Número do pedido | Texto | (obrigatório) O identificador específico do comerciante para a transação. |
na moeda do preço | Texto | (obrigatório) A moeda, no formato ISO 4217 de três letras, do preço do pedido. |
preço | Número ou texto | (obrigatório) O preço total de toda a transação. |
Oferta aceita | Oferta | (obrigatório) As ofertas incluídas no pedido. Também aceita uma matriz de objetos. |
acceptedOffer.itemOffered | Produto ou Reserva | (obrigatório) O item que está sendo vendido. |
Nome acceptedOffer.itemOffered. | Texto | (obrigatório) nome do produto. |
acceptedOffer.itemOffered.sku | Texto | (recomendado para cartões de confirmação/respostas de pesquisa) A unidade de manutenção de estoque (SKU), ou seja, um identificador específico do comerciante para um produto ou serviço, ou o produto ao qual a oferta se refere. |
URL acceptedOffer.itemOffered. | URL | (recomendado para cartões de confirmação/respostas de pesquisa) URL do produto, normalmente a página de destino do produto no site do comerciante. |
Imagem acceptedOffer.itemOffered. | URL | (recomendado para cards de confirmação/respostas de pesquisa) URL de uma imagem do produto, normalmente uma imagem no site do comerciante. |
acceptedOffer.itemOffered.cor | Texto | A cor do produto. |
Preço acceptedOffer. | Número ou texto | (obrigatório) O preço unitário do produto. |
acceptedOffer.priceCurrency | Texto | (obrigatório) A moeda do preço no formato ISO 4217 com três letras. |
acceptedOffer.eligibleQuantity | QuantitativeValue (em inglês) | (Obrigatório) Intervalo e unidade de medida das quantidades dos pedidos em que a oferta ou a especificação de preços é válida. |
Valor acceptedOffer.eligibleQuantity. | Número | (obrigatório) O valor da característica do produto. |
acceptedOffer.priceSpecification | Preço específico | Uma ou mais especificações detalhadas de preço, indicando o preço unitário e as cobranças de entrega ou pagamento. |
acceptedOffer.priceSpecification.price | Número ou texto | É o preço total da transação. |
acceptedOffer.priceSpecification.priceCurrency | Texto | É a moeda, no formato ISO 4217 de três letras, do preço do pedido. |
acceptedOffer.itemCondition | OfferItemCondition | Uma descrição textual da condição do produto ou serviço, ou dos produtos ou serviços incluídos na oferta. |
acceptedOffer.vendedor | Organização ou Pessoa | É a pessoa com quem o pedido foi feito. Também aceita uma string (por exemplo, ""). |
Nome acceptedOffer.seller. | Texto | Nome da organização. |
priceSpecification (preço específico) | Preço específico | (recomendado para cartões de confirmação/respostas de pesquisa) Alternativas mais detalhadas para price/priceCurrency. Também usado para especificar cobranças de impostos e entrega. Também aceita uma matriz de objetos. |
url | URL | (recomendado para cartões de confirmação/respostas de pesquisa) URL do pedido, normalmente um link para o site do comerciante, em que o usuário pode recuperar mais detalhes sobre um pedido. |
Status do pedido | Status do pedido | (recomendado para cartões de confirmação/respostas de pesquisa) O status atual do pedido. |
Forma de pagamento | Forma de pagamento | O nome do cartão de crédito ou outra forma de pagamento para o pedido. |
ID do método de pagamento | Texto | Um identificador para a forma de pagamento usada (por exemplo, os últimos quatro dígitos do cartão de crédito). |
Data do pedido | DateTime | Data em que o pedido foi feito. |
IsGift | Booleano | A oferta foi aceita como presente para outra pessoa que não foi o comprador. |
discount | Número ou texto | Qualquer desconto aplicado. |
Moeda do desconto | Texto | É a moeda (no formato ISO 4217 de três letras) do desconto. |
Cliente | Person ou Organization | É hora de fazer o pedido. |
Nome do cliente. | Texto | Nome da pessoa. |
billingAddress | PostalAddress | O endereço de faturamento do pedido. |
Nome do billingAddress. | Texto | Nome do CEP. |
billingAddress.streetAddress. | Texto | É o endereço. Por exemplo, 1600 Amphitheatre Pkwy. |
billingAddress.addressLocality | Texto | É a localidade. Por exemplo, Mountain View. |
billingAddress.addressRegion | Texto | É a região. Por exemplo, CA. |
billingAddress.addressCountry | Texto ou país | O país. Por exemplo, EUA. Também é possível fornecer o código do país ISO 3166-1 alfa-2 com duas letras. |