Шапка заказа

Что такое шапка заказа

Шапка заказа — это блок, где содержится основная информация о заказе: номер, статус на таймлайне, товары. Она формируется автоматически в начале цепочки писем заказах. Карточка помогает пользователю ориентироваться в своих заказах и сразу видеть информацию о покупке.

Карточка заказа формируется с помощью JSON-LD — это метод передачи связанных данных. Письмо размечают по специальному шаблону, Почта видит эту разметку и преобразует данные в карточку.

Как выглядит карточка заказа

  • В браузере
  • В приложении

Спецификация для разметки

В этой таблице мы описываем параметры для разметки письма, в котором должна появится шапка заказа. Все параметры делятся на три типа:

  • CONST — зарезервированная константа: этот параметр нужно вставить без изменений, как показано в нашем примере, в то же место и с тем же значением;
  • REQUIRED — обязательный параметр, для которого вы сами указываете значение;
  • OPTIONAL — необязательный параметр.
ПараметрОписаниеТипПример
@contextКонтекст описания объектаCONST"@context": "http://schema.org"
@typeТип описываемого объекта, в данном случае — Order (заказ)CONST"@type": "Order"
merchantСведения о продавцеOPTIONAL

"merchant": {

"@type": "Organization",

"name": "PYE Optics"

},

@typeУкажите Organization
CONST
nameНазвание вашей компанииOPTIONAL
orderNumberНомер заказа в вашей системеREQUIRED"orderNumber": "123-4567890-1234567"
orderStatusСтатус заказа. Доступно восемь статусов. Подробнее о них смотрите в таблице нижеREQUIRED"orderStatus": "http://schema.org/OrderDelivered"
priceCurrencyВалюта заказаOPTIONAL"priceCurrency": "RUB"
priceСумма всего заказа OPTIONAL"price": "6500"
acceptedOfferОписание заказаREQUIRED

"acceptedOffer": {

"@type": "Offer",

"itemOffered": {

"@type": "Product",

"name": "Очки Marvin Black jellyfish",

"url": "https://pyeoptics.com/..."

"image": "https://pyeoptics.com/..."
},

@typeУкажите Offer
CONST
itemOfferedПараметры товара в заказеREQUIRED
@typeТип описываемого объекта, в данном случае — Product (товар)CONST
nameНазвание товара в заказеREQUIRED
urlСсылка на товар в магазинеOPTIONAL
imageИзображениеOPTIONAL

Статусы заказов

СтатусОписаниеКак передавать
OrderCancelledОтменен"orderStatus": "http://schema.org/OrderCancelled"
OrderDeliveredДоставлен"orderStatus": "http://schema.org/OrderDelivered"
OrderInTransitЗаказ в пути"orderStatus": "http://schema.org/OrderInTransit"
OrderPaymentDueОжидает оплаты"orderStatus": "http://schema.org/OrderPaymentDue"
OrderPickupAvailableОжидает в пункте самовывоза"orderStatus": "http://schema.org/OrderPickupAvailable"
OrderProblemПроблема"orderStatus": "http://schema.org/OrderProblem"
OrderProcessingВ процессе"orderStatus": "http://schema.org/OrderProcessing"
OrderReturnedВозвращен"orderStatus": "http://schema.org/OrderReturned"

Пример разметки

<script type="application/ld+json">
{
    "@context": "http://schema.org",
    "@type": "Order",
    "merchant": {
        "@type": "Organization",
        "name": "PYE Optics"
    },
    "orderNumber": "123-4567890-1234567",
    "orderStatus": "http://schema.org/OrderDelivered",
    "priceCurrency": "RUB",
    "price": "6500",
    "acceptedOffer": [{
        "@type": "Offer",
        "itemOffered": {
            "@type": "Product",
            "name": "Очки Marvin Black jellyfish",
            "url": "https://pyeoptics.com/shop/catalogue/marvin_5923/",
            "image": "https://pyeoptics.com/shop/catalogue/marvin_5923/image1.png"
        },
        "price": "6500",
        "priceCurrency": "RUB",
        "eligibleQuantity": {
            "@type": "QuantitativeValue",
            "value": "1"
        }
    }],
    "url": "https://pyeoptics.com/shop/cart/cart/orderID=123-4567890-1234567"
}
</script>
Помощь Mail
Обновлено 21 ноября 2021 г.
Была ли эта информация полезной?

Помощь по другим проектам

icon