Un pedido es la confirmación de una transacción (un recibo), que puede contener varias líneas de pedido, cada una de las cuales está representada por una Oferta aceptada por el cliente.
Casos de uso
Pedido básico
Ejemplo mínimo para 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>
Ver acción de pedido
Para agregar un botón View Order
a tus pedidos, configura la propiedad url
. Para vincular directamente a una aplicación para dispositivos móviles, agrega una 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 el 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 para este tipo:
Propiedad | Tipo | Descripción |
---|---|---|
comerciante | Organización o Persona | (Obligatorio) La parte que acepta el pedido (p.ej., Amazon.com es un comercio que vende muchos productos). También acepta una cadena (p.ej., "Amazon.com"). |
merchant.nombre | Texto | (obligatorio) Nombre de la organización. |
merchant.sameAs | URL | La URL de Freebase para el comerciante. |
Númerodepedido | Texto | (obligatorio) Es el identificador específico del comercio para la transacción. |
Moneda del precio | Texto | (obligatorio) Corresponde a la moneda (en formato ISO 4217 de 3 letras) del precio del pedido. |
precio | Número o texto | El precio total de la transacción (obligatorio). |
Se aceptó la oferta. | Oferta | (Obligatorio) Las ofertas incluidas en el pedido. También acepta una matriz de objetos. |
acceptedOffer.itemOffered | Producto o Reservación | (obligatorio) Artículo que se vende. |
acceptedOffer.itemOffered.name | Texto | (obligatorio): Nombre del producto |
acceptedOffer.itemOffered.sku | Texto | (recomendado para tarjetas de confirmación/Respuestas de búsqueda) Es la unidad de mantenimiento de inventario (SKU), es decir, un identificador específico del comercio para un producto o servicio, o bien el producto al que hace referencia la oferta. |
acceptedOffer.itemOffered.url | URL | (recomendado para tarjetas de confirmación/Respuestas de búsqueda) URL del Producto. Por lo general, es la página de destino del producto en el sitio web del comercio. |
acceptedOffer.itemOffered.imagen | URL | (recomendado para tarjetas de confirmación/Respuestas de búsqueda) URL de una imagen del Producto, por lo general, una imagen del sitio web del comercio. |
acceptedOffer.itemOffered.color | Texto | El color del producto. |
acceptedOffer. | Número o texto | El precio unitario del Producto (obligatorio). |
acceptedOffer.priceCurrency | Texto | (obligatorio) La moneda (en formato ISO 4217 de 3 letras) del precio. |
acceptedOffer.eligibleQuantity | Valor cuantitativo | (obligatorio): Intervalo y unidad de medida de las cantidades de pedidos para las que es válida la oferta o la especificación de precios. |
acceptedOffer.eligibleQuantity. | Number | El valor de la característica del producto (obligatorio). |
acceptedOffer.priceSpecification. | Especificación de precio | Una o más especificaciones de precios detalladas que indican el precio unitario y los cargos de entrega o pago. |
acceptedOffer.priceSpecification.price | Número o texto | El precio total de la transacción completa. |
acceptedOffer.priceSpecification.priceCurrency | Texto | Corresponde a la moneda (en formato ISO 4217 de 3 letras) del precio del pedido. |
acceptedOffer.itemCondition | OfferItemCondition | Una descripción textual de la condición del producto o servicio, o de los productos o servicios incluidos en la oferta |
acceptedOffer.vendedor | Organización o Persona | Parte con la que se realizó el pedido. También acepta una cadena (p.ej., ""). |
acceptedOffer.seller.nombre | Texto | Nombre de la organización. |
Especificación de precio | Especificación de precio | (se recomienda para tarjetas de confirmación/Respuestas de búsqueda) Alternativas más detalladas a price/priceCurrency. También se usa para especificar los impuestos y los gastos de envío. También acepta una matriz de objetos. |
URL | URL | (recomendada para tarjetas de confirmación/Respuestas de búsqueda) URL del pedido, generalmente un vínculo al sitio web del comercio en el que el usuario puede obtener más detalles sobre el pedido. |
Estado del pedido | Estado del pedido | (recomendado para tarjetas de confirmación/Respuestas de búsqueda) Es el estado actual del pedido. |
métododepago | Forma de pago | El nombre de la tarjeta de crédito u otra forma de pago del pedido. |
ID de método de pago | Texto | Es un identificador para la forma de pago utilizada (p.ej., los últimos 4 dígitos de la tarjeta de crédito). |
Fecha del pedido | DateTime | Fecha en que se realizó el pedido. |
isGift | Booleano | ¿La oferta se aceptó como regalo para alguien que no es el comprador? |
discount | Número o texto | Cualquier descuento aplicado |
Moneda del descuento | Texto | Corresponde a la moneda (en formato ISO 4217 de 3 letras) del descuento. |
customer | Persona u organización | Parte que realizó el pedido. |
customer.name | Texto | Nombre de la persona. |
BillingAddress | PostalAddress | La dirección de facturación del pedido. |
billingAddress.nombre | Texto | Nombre de la dirección postal. |
billingAddress.nombreDirección | Texto | Indica la dirección, Por ejemplo, 1600 Amphitheatre Pkwy. |
billingAddress.addressLocality | Texto | Corresponde a la localidad, Por ejemplo, Mountain View. |
billingAddress.dirección. | Texto | Indica la región, Por ejemplo, CA. |
billingAddress.direcciónPaís | Texto o País | 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. |