Ordenar

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.