Un pedido es la confirmación de una transacción (un recibo), que puede contener varios elementos de una sola línea, cada uno de ellos representado por una Oferta que el cliente aceptó.
Casos de uso
Orden 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 de View Order
Puedes configurar la propiedad url para agregar un botón View Order a tus pedidos. Si quieres vincular directamente 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 datos de facturación detallados
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 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 de este tipo:
| Propiedad | Tipo | Descripción |
|---|---|---|
| comercio | Organization o Person | (obligatorio) Es la parte que realiza el pedido (p.ej., Amazon.com es un comercio para muchos vendedores). También acepta una cadena (p.ej., “Amazon.com”). |
| merchant.name | Texto | Nombre de la organización (obligatorio) |
| merchant.sameAs | URL | La URL de Freebase correspondiente al 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 la transacción completa. |
| acceptedOffer | Oferta | (obligatorio) Son las ofertas incluidas en el pedido. También acepta un array de objetos. |
| acceptedOffer.itemOffered | Producto o reserva | (obligatorio) Es el artículo que está a la venta. |
| acceptedOffer.itemOffered.name | Texto | Nombre del producto (obligatorio). |
| acceptedOffer.itemOffered.sku | Texto | (recomendado para tarjetas de confirmación o respuestas a la búsqueda): La unidad de mantenimiento de inventario (SKU), es decir, el identificador específico del comercio para un producto o servicio, o bien el producto al que hace referencia la oferta. |
| acceptedOffer.itemOffered.url | URL | (recomendada para las tarjetas de confirmación o las respuestas de la Búsqueda) del Producto, que suele ser la página de destino del producto en el sitio web del comercio. |
| acceptedOffer.itemOffered.image | URL | (opción recomendada para las tarjetas de confirmación y las respuestas a la Búsqueda) de una imagen del Producto, que suele ser una imagen del sitio web del comercio. |
| acceptedOffer.itemOffered.color | Texto | Es el color del producto. |
| acceptedOffer.price | Número o texto | El precio unitario del Producto (obligatorio). |
| acceptedOffer.priceCurrency | Texto | Es la moneda (en formato ISO 4217 de 3 letras) del precio (obligatorio). |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (obligatorio) Es el intervalo y la unidad de medida de las cantidades de los pedidos para los que es válida la oferta o la especificación de precio. |
| acceptedOffer.eligibleQuantity.value | Número | (obligatorio) Es el valor de las características del producto. |
| acceptedOffer.priceSpecification | PriceSpecification | Una o más especificaciones de precios detalladas que indiquen el precio unitario y los cargos de envío o pago. |
| acceptedOffer.priceSpecification.price | Número o texto | Es el precio total de la transacción completa. |
| acceptedOffer.priceSpecification.priceCurrency | Texto | Es la moneda (en formato ISO 4217 de 3 letras) del precio del pedido. |
| acceptedOffer.itemCondition | OfferItemCondition | Una descripción textual del estado del producto o servicio, o de los productos o servicios incluidos en la oferta. |
| acceptedOffer.seller | Organization o Person | Parte con la que se realizó el pedido También acepta una cadena (p.ej., ""). |
| acceptedOffer.seller.name | Texto | Nombre de la Organización. |
| priceSpecification | PriceSpecification | (recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Cualquier alternativa más detallada a price/priceCurrency. También se usa para especificar los impuestos y los gastos de envío. También acepta un array de objetos. |
| url | URL | (opción recomendada para las tarjetas de confirmación y las respuestas a la Búsqueda) del pedido, que suele ser un vínculo al sitio web del comercio, en el que el usuario puede obtener más detalles sobre un pedido. |
| orderStatus | OrderStatus | (recomendado para tarjetas de confirmación/respuestas de la Búsqueda) Es el estado actual del pedido. |
| paymentMethod | PaymentMethod | 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 | Fecha en la que se realizó el pedido |
| isGift | Booleano | ¿La oferta se aceptó como regalo para alguien que no era el comprador? |
| discount | Número o texto | Cualquier descuento aplicado. |
| discountCurrency | Texto | Es la moneda (en formato ISO 4217 de 3 letras) del descuento. |
| Cliente | Persona u Organización | Parte que realiza el pedido. |
| customer.name | Texto | Nombre de la persona. |
| billingAddress | PostalAddress | Es la dirección de facturación del pedido. |
| billingAddress.name | Texto | Es el nombre de la dirección postal. |
| 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, AC. |
| billingAddress.addressCountry | Texto o País | El país. Por ejemplo, USA. También puedes proporcionar el código de país ISO 3166-1 alpha-2 de dos letras. |