OrderItem

Тип schema.org ^?

Канонический URL: https://schema.org/OrderItem
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Примеры использования.

Описание:

Позиция заказа — это строка заказа. Она включает количество и детали доставки купленного предложения.

Что такое OrderItem и зачем он нужен?

Тип OrderItem из словаря Schema.org — это настоящий "кирпичик" для описания отдельных позиций в заказе. Если вы когда-либо делали покупки онлайн, то знаете, что каждый товар или услуга в корзине — это отдельная строка с деталями: сколько штук, как доставить и какой статус у заказа. Вот именно это и описывает OrderItem.

Основные свойства OrderItem

Чтобы сделать описание заказа максимально точным, OrderItem предлагает несколько ключевых свойств:

orderQuantity: Количество заказанных единиц товара или услуги.
orderedItem: Ссылка на сам товар или услугу. Это может быть объект типа Product, Service или даже текстовое описание.
orderItemNumber: Уникальный номер позиции в заказе. Полезно для отслеживания.
orderItemStatus: Текущий статус позиции (например, "в обработке", "доставлено").
orderDelivery: Информация о доставке, включая сроки и способ.

Пример использования:

{
  "@context": "https://schema.org",
  "@type": "OrderItem",
  "orderQuantity": 2,
  "orderedItem": {
    "@type": "Product",
    "name": "Умные часы XYZ"
  },
  "orderItemNumber": "123456789",
  "orderItemStatus": "http://schema.org/OrderInTransit",
  "orderDelivery": {
    "@type": "ParcelDelivery",
    "expectedArrivalFrom": "2023-11-10",
    "expectedArrivalUntil": "2023-11-15"
  }
}

Почему это важно?

Для продавцов
Использование OrderItem помогает организовать данные о заказах так, чтобы они были понятны не только людям, но и машинам. Например, поисковые системы могут использовать эту информацию для создания удобных сниппетов, где клиент сразу увидит статус своего заказа.
Для покупателей
Чёткое описание каждой позиции в заказе позволяет покупателям легко отслеживать свои покупки. Никто не хочет гадать, где его посылка или сколько товаров он заказал.
Для платформ и систем
Платформы электронной коммерции, такие как Shopify или WooCommerce, используют подобную разметку для автоматизации процессов. Это упрощает интеграцию с логистическими службами, бухгалтерскими системами и CRM.

Когда использовать OrderItem?

Если ваш сайт или приложение работает с заказами, вам определённо стоит использовать OrderItem. Особенно это актуально для:

Интернет-магазинов.
Сервисов, предлагающих услуги (например, бронирование туров).
Маркетплейсов, где продаются товары разных продавцов.

Дополнительные возможности

Специалисты рекомендуют сочетать использование OrderItem с другими типами Schema.org:

Order: Для описания самого заказа в целом.
Product: Чтобы детализировать товары.
ParcelDelivery: Для информации о доставке.

Это создаёт полную картину для всех участников процесса: от покупателя до службы доставки.

Заключение

Тип OrderItem — это простой, но мощный инструмент для структурирования данных о заказах. Он помогает сделать процесс покупок более прозрачным и удобным для всех сторон. Если вы хотите, чтобы ваши заказы обрабатывались быстрее, а клиенты оставались довольными, не игнорируйте этот тип. Ведь в мире электронной коммерции мелочей не бывает — каждая деталь имеет значение!

Свойство	Ожидаемый тип	Описание
Свойство из OrderItem
orderDelivery	ParcelDelivery	Доставка посылки, связанной с этим заказом или позицией заказа.
orderItemNumber	Text	Идентификатор товарной позиции заказа.
orderItemStatus	OrderStatus	Текущий статус элемента заказа.
orderQuantity	Number	Количество заказанного товара. Если свойство не установлено, предполагается, что количество равно одному.
orderedItem	OrderItem, Product, Service	Заказанный товар.
Свойство из Thing
additionalType	URL, Text	Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName	Text	Псевдоним для элемента.
description	Text, TextObject	Описание предмета.
disambiguatingDescription	Text	Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier	PropertyValue, Text, URL	Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image	ImageObject, URL	Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage	CreativeWork, URL	Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name	Text	Название элемента.
potentialAction	Action	Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs	URL	URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf	CreativeWork, Event	Творческое произведение или событие, связанное с этой вещью.
url	URL	URL предмета.

Экземпляры OrderItem могут использоваться в качестве значения для следующих свойств.

Свойство	Типы	Описание
orderedItem	OrderItem, Order	Заказанный товар.

Примеры

Пример 1

Пример заметки или HTML разметки.


An example of an order for multiple items, shipped separately.

ACME Supplies
Customer: Jane Doe
Order:
  Item abc123: 1 Widget: delivered 2015-03-10
  Item def456: 3 Widget accessories: shipped 2015-03-12

Пример, закодированный в формате Microdata, встроенный в HTML.


<div itemscope itemtype="https://schema.org/Order">
  <div itemprop="seller" itemscope itemtype="https://schema.org/Organization">
    <b itemprop="name">ACME Supplies</b>
  </div>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <div itemprop="orderedItem" itemscope itemtype="https://schema.org/OrderItem">
    Item number: <span itemprop="orderItemNumber">abc123</span>
    <span itemprop="orderQuantity">1</span>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Product">
      <span itemprop="name">Widget</span>
    </div>
    <link itemprop="orderItemStatus" href="https://schema.org/OrderDelivered" />Delivered
    <div itemprop="orderDelivery" itemscope itemtype="https://schema.org/ParcelDelivery">
      <time itemprop="expectedArrivalFrom">2015-03-10</time>
    </div>
  </div>
  <div itemprop="orderedItem" itemscope itemtype="https://schema.org/OrderItem">
    Item number: <span itemprop="orderItemNumber">def456</span>
    <span itemprop="orderQuantity">4</span>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Product">
      <span itemprop="name">Widget accessories</span>
    </div>
    <link itemprop="orderItemStatus" href="https://schema.org/OrderInTransit" />Shipped
    <div itemprop="orderDelivery" itemscope itemtype="https://schema.org/ParcelDelivery">
      <time itemprop="expectedArrivalFrom">2015-03-15</time>
      <time itemprop="expectedArrivalUntil">2015-03-18</time>
    </div>
  </div>
</div>

Пример, закодированный в формате RDFa, встроенный в HTML.


<div vocab="https://schema.org/" typeof="Order">
  <div property="seller" typeof="Organization">
    <b property="name">ACME Supplies</b>
  </div>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <div property="orderedItem" typeof="OrderItem">
    Item number: <span property="orderItemNumber">abc123</span>
    <span property="orderQuantity">1</span>
    <div property="orderedItem" typeof="Product">
      <span property="name">Widget</span>
    </div>
    <link property="orderItemStatus" href="https://schema.org/OrderDelivered" />Delivered
    <div property="orderDelivery" typeof="ParcelDelivery">
      <time property="expectedArrivalFrom">2015-03-10</time>
    </div>
  </div>
  <div property="orderedItem" typeof="OrderItem">
    Item number: <span property="orderItemNumber">def456</span>
    <span property="orderQuantity">4</span>
    <div property="orderedItem" typeof="Product">
      <span property="name">Widget accessories</span>
    </div>
    <link property="orderItemStatus" href="https://schema.org/OrderInTransit" />Shipped
    <div property="orderDelivery" typeof="ParcelDelivery">
      <time property="expectedArrivalFrom">2015-03-15</time>
      <time property="expectedArrivalUntil">2015-03-18</time>
    </div>
  </div>
</div>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Order",
  "seller": {
    "@type": "Organization",
    "name": "ACME Supplies"
  },
  "customer": {
    "@type": "Person",
    "name": "Jane Doe"
  },
  "orderedItem": [
    {
      "@type": "OrderItem",
      "orderItemNumber": "abc123",
      "orderQuantity": 1,
      "orderedItem": {
        "@type": "Product",
        "name": "Widget"
      },
      "orderItemStatus": "https://schema.org/OrderDelivered",
      "orderDelivery": {
        "@type": "ParcelDelivery",
        "expectedArrivalFrom": "2015-03-10"
      }
    },
    {
      "@type": "OrderItem",
      "orderItemNumber": "def456",
      "orderQuantity": 3,
      "orderedItem": {
        "@type": "Product",
        "name": "Widget accessories"
      },
      "orderItemStatus": "https://schema.org/OrderInTransit",
      "orderDelivery": {
        "@type": "ParcelDelivery",
        "expectedArrivalFrom": "2015-03-15",
        "expectedArrivalUntil": "2015-03-18"
      }
    }
  ]
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org/

@type

Order

seller