Un pedido es la confirmación de una transacción (un recibo) que puede contener varias líneas de pedido, cada una representada por una oferta que el cliente aceptó.
Casos de uso
Pedido básico
Ejemplo mínimo de un 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>
Microdatos
<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>
Acción Ver pedido
Para agregar un botón View Order a tus pedidos, configura la propiedad url. Para crear un vínculo directo a una aplicación para dispositivos móviles, agrega también 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>
Microdatos
<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 con detalles de facturación
Ejemplo de pedido con información de facturación detallada
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>
Microdatos
<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>
Prueba tu lenguaje de marcado
Puedes validar tu lenguaje de marcado con la herramienta de prueba de lenguaje de marcado de correo electrónico. Pega el código de lenguaje de marcado y haz clic en el botón Validar para analizar el contenido y recibir un informe sobre los errores presentes.
Especificación
En la siguiente tabla, se enumeran todas las propiedades disponibles para este tipo:
| Propiedad | Tipo | Descripción |
|---|---|---|
| comercio | Organización o Persona | (obligatorio) Es la parte que toma el pedido (p.ej., Amazon.com es un comercio para muchos vendedores). También acepta una cadena (p.ej., "Amazon.com"). |
| merchant.name | Texto | (obligatorio) Es el nombre de la organización. |
| merchant.sameAs | URL | Es la URL de Freebase del comercio. |
| orderNumber | Texto | (obligatorio) Es el identificador específico del comercio para la transacción. |
| priceCurrency | Texto | (obligatorio) Es la moneda (en formato ISO 4217 de 3 letras) del precio del pedido. |
| precio | Número o texto | (obligatorio) Es el precio total de toda la transacción. |
| acceptedOffer | Oferta | (obligatorio) Son las ofertas incluidas en el pedido. También acepta un array de objetos. |
| acceptedOffer.itemOffered | Producto o Reservation | (obligatorio) Es el artículo que está en venta. |
| acceptedOffer.itemOffered.name | Texto | (obligatorio) Es el nombre del producto. |
| acceptedOffer.itemOffered.sku | Texto | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Es la unidad de mantenimiento de stock (SKU), es decir, un identificador específico del comercio para un producto o servicio, o el producto al que se refiere la oferta. |
| acceptedOffer.itemOffered.url | URL | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Es la URL del producto, por lo general, la página de destino del producto en el sitio web del comercio. |
| acceptedOffer.itemOffered.image | URL | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Es la URL de una imagen del producto, por lo general, una imagen en el sitio web del comercio. |
| acceptedOffer.itemOffered.color | Texto | Es el color del producto. |
| acceptedOffer.price | Número o texto | (obligatorio) Es el precio unitario del producto. |
| acceptedOffer.priceCurrency | Texto | (obligatorio) Es la moneda (en formato ISO 4217 de 3 letras) del precio. |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (obligatorio) Es el intervalo y la unidad de medida de las cantidades de pedido para las que es válida la oferta o la especificación de precio. |
| acceptedOffer.eligibleQuantity.value | Número | (obligatorio) Es el valor de la característica del producto. |
| acceptedOffer.priceSpecification | PriceSpecification | Son una o más especificaciones de precio detalladas que indican el precio unitario y los cargos de entrega o pago. |
| acceptedOffer.priceSpecification.price | Número o texto | Es el precio total de toda la transacción. |
| acceptedOffer.priceSpecification.priceCurrency | Texto | Es la moneda (en formato ISO 4217 de 3 letras) del precio del pedido. |
| acceptedOffer.itemCondition | OfferItemCondition | Es una descripción textual de la condición del producto o servicio, o de los productos o servicios incluidos en la oferta. |
| acceptedOffer.seller | Organización o Persona | Es la parte con la que se realizó el pedido. También acepta una cadena (p.ej., ""). |
| acceptedOffer.seller.name | Texto | Es el nombre de la organización. |
| priceSpecification | PriceSpecification | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Son alternativas más detalladas a price o priceCurrency. También se usa para especificar los impuestos y los cargos de entrega. También acepta un array de objetos. |
| url | URL | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Es la URL del pedido, por lo general, un vínculo al sitio web del comercio en el que el usuario puede recuperar más detalles sobre un pedido. |
| orderStatus | OrderStatus | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Es el estado actual del pedido. |
| paymentMethod | PaymentMethod | Es el nombre de la tarjeta de crédito o de otra forma de pago del pedido. |
| paymentMethodId | Texto | Es un identificador de la forma de pago utilizada (p.ej., los últimos 4 dígitos de la tarjeta de crédito). |
| orderDate | DateTime | Es la fecha en que se realizó el pedido. |
| isGift | Booleano | Indica si se aceptó la oferta como regalo para alguien que no es el comprador. |
| discount | Número o texto | Es cualquier descuento aplicado. |
| discountCurrency | Texto | Es la moneda (en formato ISO 4217 de 3 letras) del descuento. |
| Cliente | Persona u Organización | Es la parte que realiza el pedido. |
| customer.name | Texto | Es el nombre de la persona. |
| billingAddress | PostalAddress | Es la dirección de facturación del pedido. |
| billingAddress.name | Texto | Es el nombre de PostalAddress. |
| billingAddress.streetAddress | Texto | Indica la dirección, por ejemplo, 1600 Amphitheatre Pkwy. |
| billingAddress.addressLocality | Texto | Corresponde a la localidad, por ejemplo, Mountain View. |
| billingAddress.addressRegion | Texto | Indica la región, por ejemplo, CA. |
| billingAddress.addressCountry | Texto o Country | Indica el país, por ejemplo, EE.UU. También puedes proporcionar el código de país ISO 3166-1 alpha-2 de dos letras. |