⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/Order. Если сайт оказался полезен, то можете пожертвовать 50 рублей создателями сайта.

Order

Тип schema.org ?

Описание:

Заказ — это подтверждение транзакции (чек), который может содержать несколько позиций, каждая из которых представлена предложением, принятым покупателем.

Тип Schema.org "Order" представляет собой структуру данных, которая используется для описания заказа, подтверждающего транзакцию, например, покупку товара или услуги. Этот тип информации помогает поисковым системам и другим приложениям лучше понимать содержание веб-страниц, связанных с коммерцией.

"Order" может содержать несколько элементов, называемых "line items", которые представляют собой отдельные предложения (или товары), принятые клиентом. Это позволяет детализировать информацию о каждом товаре или услуге, входящих в заказ. Например, в заказе может быть несколько товаров, каждый из которых имеет свои характеристики, такие как цена, количество и описание.

Использование типа "Order" важно для улучшения видимости и понимания информации о заказах в интернете. Это может помочь в автоматизации процессов, таких как обработка заказов и управление запасами, а также в улучшении пользовательского опыта, предоставляя более структурированную и понятную информацию о покупке.

Тип "Order" часто используется на веб-сайтах электронной коммерции, в системах управления запасами и в приложениях, которые обрабатывают заказы. Это также может быть полезно для аналитики, так как позволяет собирать данные о продажах и предпочтениях клиентов. В конечном итоге, внедрение структурированных данных, таких как "Order", способствует более точному и эффективному взаимодействию между пользователями и веб-сайтами.

Свойство Ожидаемый тип Описание
Свойство из Order
acceptedOffer Offer Предложение(я) — например, комбинации продукта, количества и цены — включенные в заказ.
billingAddress PostalAddress Адрес для выставления счета по заказу.
broker Organization, Person Сущность, которая организует обмен между покупателем и продавцом. В большинстве случаев брокер никогда не приобретает и не передает право собственности на продукт или услугу, участвующие в обмене. Если неясно, является ли сущность брокером, продавцом или покупателем, предпочтение следует отдавать последним двум терминам.
confirmationNumber Text Номер, который подтверждает, что данный заказ или платеж был получен.
customer Organization, Person Сторона, размещающая заказ или оплачивающая счет.
discount Number, Text Любая скидка, примененная (к Заказу).
discountCode Text Код, используемый для получения скидки.
discountCurrency Text Валюта скидки.

Используйте стандартные форматы: ISO 4217 формат валюты, например, "USD"; Тикер для криптовалют, например, "BTC"; общеизвестные названия для Местных систем обмена валюты (LETS) и других типов валют, например, "Ithaca HOUR".
isGift Boolean Указывает, была ли оферта принята в качестве подарка для кого-то, кроме покупателя.
orderDate Date, DateTime Дата, когда был размещен заказ.
orderDelivery ParcelDelivery Доставка посылки, связанной с этим заказом или позицией заказа.
orderNumber Text Идентификатор транзакции.
orderStatus OrderStatus Текущий статус заказа.
orderedItem OrderItem, Product, Service Заказанный товар.
partOfInvoice Invoice Заказ оплачивается как часть указанного счета.
paymentDueDate Date, DateTime Дата, когда платеж должен быть произведен.
paymentMethod PaymentMethod Название кредитной карты или другого метода оплаты для заказа.
paymentMethodId Text Идентификатор метода оплаты, который используется (например, последние 4 цифры кредитной карты).
paymentUrl URL URL для отправки платежа.
seller Organization, Person Сущность, которая предлагает (продает / сдает в аренду / одалживает / предоставляет в кредит) услуги / товары. Продавец также может быть поставщиком.
Свойство из 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 предмета.

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

Свойство Типы Описание
partOfOrder ParcelDelivery Общий заказ, в который были включены товары в этой доставке.
referencesOrder Invoice Заказ(ы), связанные с этим счетом. Один или несколько заказов могут быть объединены в один счет.

Примеры

Пример 1

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


An example of a invoice for a purchase and installation.

ACME Home Heating
Bill for: New furnace and installation
Customer: Jane Doe
payment due: 2015-01-30
minimum payment: $0.00
total due: $0.00
payment status: paid
order: furnace model ABC123
order: installation labor

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


<div itemscope itemtype="https://schema.org/Invoice">
  <h1 itemprop="description">New furnace and installation</h1>
  <div itemprop="broker" itemscope itemtype="https://schema.org/LocalBusiness">
    <b itemprop="name">ACME Home Heating</b>
  </div>
  <div itemprop="customer" itemscope itemtype="https://schema.org/Person">
    <b itemprop="name">Jane Doe</b>
  </div>
  <time itemprop="paymentDueDate">2015-01-30</time>
  <div itemprop="minimumPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <div itemprop="totalPaymentDue" itemscope itemtype="https://schema.org/PriceSpecification">
    <span itemprop="price">0.00</span>
    <span itemprop="priceCurrency">USD</span>
  </div>
  <link itemprop="paymentStatus" href="https://schema.org/PaymentComplete" />
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace</span>
    <time itemprop="orderDate">2014-12-01</time>
    <span itemprop="orderNumber">123ABC</span>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Product">
      <span itemprop="name">ACME Furnace 3000</span>
      <meta itemprop="productID" content="ABC123" />
    </div>
  </div>
  <div itemprop="referencesOrder" itemscope itemtype="https://schema.org/Order">
    <span itemprop="description">furnace installation</span>
    <time itemprop="orderDate">2014-12-02</time>
    <div itemprop="orderedItem" itemscope itemtype="https://schema.org/Service">
      <span itemprop="description">furnace installation</span>
    </div>
  </div>
</div>

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


<div vocab="https://schema.org/" typeof="Invoice">
  <h1 property="description">New furnace and installation</h1>
  <div property="broker" typeof="LocalBusiness">
    <b property="name">ACME Home Heating</b>
  </div>
  <div property="customer" typeof="Person">
    <b property="name">Jane Doe</b>
  </div>
  <time property="paymentDueDate">2015-01-30</time>
  <div property="minimumPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <div property="totalPaymentDue" typeof="PriceSpecification">
    <span property="price">0.00</span>
    <span property="priceCurrency">USD</span>
  </div>
  <meta itemprop="paymentStatus" content="PaymentComplete" />
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace</span>
    <time property="orderDate">2014-12-01</time>
    <span property="orderNumber">123ABC</span>
    <div property="orderedItem" typeof="Product">
      <span property="name">ACME Furnace 3000</span>
      <meta property="productID" content="ABC123" />
    </div>
  </div>
  <div property="referencesOrder" typeof="Order">
    <span property="description">furnace installation</span>
    <time property="orderDate">2014-12-02</time>
    <div property="orderedItem" typeof="Service">
      <span property="description">furnace installation</span>
    </div>
  </div>
</div>

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


<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "Invoice",
    "broker": {
      "@type": "LocalBusiness",
      "name": "ACME Home Heating"
    },
    "accountId": "xxxx-xxxx-xxxx-1234",
    "customer": {
      "@type": "Person",
      "name": "Jane Doe"
    },
    "paymentDueDate": "2015-01-30",
    "minimumPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "totalPaymentDue": {
      "@type": "PriceSpecification",
      "price": 0.00,
      "priceCurrency": "USD"
    },
    "paymentStatus": "https://schema.org/PaymentComplete",
    "referencesOrder": [
      {
        "@type": "Order",
        "description": "furnace",
        "orderDate": "2014-12-01",
        "orderNumber": "123ABC",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Product",
          "name": "ACME Furnace 3000",
          "productID": "ABC123"
        }
      },
      {
        "@type": "Order",
        "description": "furnace installation",
        "orderDate": "2014-12-02",
        "paymentMethod": "http://purl.org/goodrelations/v1#ByInvoice",
        "orderedItem": {
          "@type": "Service",
          "description": "furnace installation"
        }
      }
    ]
}
</script>

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

@context
https://schema.org/
@type
Invoice
broker
@type
LocalBusiness
name
ACME Home Heating
accountId
xxxx-xxxx-xxxx-1234
customer
@type
Person
name
Jane Doe
paymentDueDate
2015-01-30
minimumPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
totalPaymentDue
@type
PriceSpecification
price
0
priceCurrency
USD
paymentStatus
https://schema.org/PaymentComplete
referencesOrder
0
@type
Order
description
furnace
orderDate
2014-12-01
orderNumber
123ABC
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Product
name
ACME Furnace 3000
productID
ABC123
1
@type
Order
description
furnace installation
orderDate
2014-12-02
paymentMethod
http://purl.org/goodrelations/v1#ByInvoice
orderedItem
@type
Service
description
furnace installation

Пример 2

Пример заметки или 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
@type
Organization
name
ACME Supplies
customer
@type
Person
name
Jane Doe
orderedItem
0
@type
OrderItem
orderItemNumber
abc123
orderQuantity
1
orderedItem
@type
Product
name
Widget
orderItemStatus
https://schema.org/OrderDelivered
orderDelivery
@type
ParcelDelivery
expectedArrivalFrom
2015-03-10
1
@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
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 20.11.2024
Комментарии
Новые материалы на сайте