Pedido

Um pedido é a confirmação de uma transação (um recibo), que pode conter vários itens de linha, cada um representado por uma oferta aceita pelo cliente.

Casos de uso

Pedido básico

Exemplo mínimo de 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>

Testar sua marcação

É possível validar sua marcação usando a Ferramenta para testar a marcação em e-mails. Cole seu código de marcação e clique no botão Validar para digitalizar o conteúdo e receber um relatório sobre os erros presentes.

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 de muitos vendedores. Também aceita uma string (por exemplo, "Amazon.com").
merchant.name	Texto	(obrigatório) Nome da organização.
merchant.sameAs	URL	O URL do Freebase do comerciante.
orderNumber	Texto	(obrigatório) O identificador específico do comerciante para a transação.
priceCurrency	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.
acceptedOffer	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.
acceptedOffer.itemOffered.name	Texto	(obrigatório) Nome do produto.
acceptedOffer.itemOffered.sku	Texto	(recomendado para cartões de confirmação/respostas da pesquisa) A unidade de manutenção de estoque (SKU), ou seja, um identificador específico do comerciante para um produto/serviço ou o produto a que a oferta se refere.
acceptedOffer.itemOffered.url	URL	(recomendado para cartões de confirmação/respostas da pesquisa) URL do produto, normalmente a página de destino do produto no site do comerciante.
acceptedOffer.itemOffered.image	URL	(recomendado para cartões de confirmação/respostas da pesquisa) URL de uma imagem do produto, geralmente uma imagem no site do comerciante.
acceptedOffer.itemOffered.color	Texto	A cor do produto.
acceptedOffer.price	Número ou texto	(obrigatório) O preço unitário do Produto.
acceptedOffer.priceCurrency	Texto	(obrigatório) A moeda (no formato ISO 4217 de três letras) do preço.
acceptedOffer.eligibleQuantity	QuantitativeValue	(obrigatório) O intervalo e a unidade de medida de pedidos de quantidades para as quais a oferta ou a especificação de preço é válida.
acceptedOffer.eligibleQuantity.value	Número	(obrigatório) O valor da característica do produto.
acceptedOffer.priceSpecification	PriceSpecification	Uma ou mais especificações de preço detalhadas, indicando o preço unitário e as taxas de entrega ou pagamento.
acceptedOffer.priceSpecification.price	Número ou texto	O preço total de toda a 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.seller	Organização ou Pessoa	Parte a quem o pedido foi feito. Também aceita uma string (por exemplo, "").
acceptedOffer.seller.name	Texto	Nome da organização.
priceSpecification	PriceSpecification	(recomendado para cartões de confirmação/respostas da Pesquisa) Outras alternativas mais detalhadas a price/priceCurrency. Também usado para especificar taxas de envio e tributos. Também aceita uma matriz de objetos.
url	URL	(recomendado para cartões de confirmação/respostas da pesquisa) URL do pedido, normalmente um link para o site do comerciante onde o usuário pode acessar mais detalhes sobre um pedido.
orderStatus	OrderStatus	(recomendado para cartões de confirmação/respostas da pesquisa) O status atual do pedido.
paymentMethod	PaymentMethod	O nome do cartão de crédito ou outra forma de pagamento do pedido.
paymentMethodId	Texto	Um identificador da forma de pagamento usada (por exemplo, os últimos quatro dígitos do cartão de crédito).
orderDate	DateTime	Data em que o pedido foi feito.
isGift	Booleano	A oferta foi aceita como presente para alguém que não é o comprador?
discount	Número ou texto	Qualquer desconto aplicado.
discountCurrency	Texto	É a moeda (no formato ISO 4217 de três letras) do desconto.
Cliente	Pessoa ou organização	Parte que fez o pedido.
customer.name	Texto	Nome da pessoa.
billingAddress	PostalAddress	O endereço de cobrança do pedido.
billingAddress.name	Texto	Nome de PostalAddress.
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, USA. Você também pode informar o código ISO 3166-1 alfa-2 do país de duas letras.