Pedido

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	(opción recomendada para las tarjetas de confirmación y 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.