Pedido

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.