Link Поиск Меню Развернуть Документ

Метаданные заказа/элемента корзины

Передача расширенного набора данных по заказу или элементу корзины осуществляется путём заполнения свойства заказа или элемента корзины metaData в запросе создания заказа и оформления возврата. По умолчанию, свойство заполняется в формате json-ld. Система поддерживат типы объектов, описанные на сайте https://schema.org/.

Данные бронирования авиабилетов

Для передачи данных бронирования авиаперелётов, в поле заказа metaData необходимо передать объект ReservationPackage с перечнем дочерних объектов FlightReservation. Для каждого из сегментов полёта, а также для каждого из пассажиров передаётся отдельный объект FlightReservation.

Пример объекта ReservationPackage
{
  "@type": "ReservationPackage",
  "subReservation": [
  {
    "@type": "FlightReservation",
    "reservationId": "YQVM18",
    "reservationStatus": "https://schema.org/ReservationConfirmed",
    "underName": {
      "@type": "Person",
      "name": "Андрей Макаров"
    },
    "reservationFor": {
      "@type": "Flight",
      "flightNumber": "NDJ37S",
      "provider": {
        "@type": "Airline",
        "name": "Aeroflot",
        "iataCode": "SU"
      },
      "seller": {
        "@type": "Airline",
        "name": "Aeroflot",
        "iataCode": "SU"
      },
      "departureAirport": {
        "@type": "Airport",
        "name": "Москва (Шерементьево)",
        "iataCode": "SVO"
      },
      "departureTime": "2022-03-04T20:15:00+03:00",
      "departureGate": "11",
      "departureTerminal": "C",
      "arrivalAirport": {
        "@type": "Airport",
        "name": "Санкт-Петербург (Пулково)",
        "iataCode": "LED"
      },
      "arrivalTime": "2022-03-05T21:30:00+03:00",
      "arrivalGate": "11",
      "arrivalTerminal": "1"
    },
    "airplaneSeat": "1A",
    "airplaneSeatClass": {
      "@type": "AirplaneSeatClass",
      "name": "Business"
    },
    "ticketNumber": "111-1231231239",
    "ticketToken": "qrCode:AB34",
    "checkinUrl": "https://checkmytrip.ru/onlinecheckin.html",
    "reservedTicket": {
      "@type": "flightTicket",
      "underName": {
        "@type": "Person",
        "name": "MAKAROV ANDREY"
      },
      "fareBase": 57.00,
      "fareReservation": 66.40,
      "vatValue": [{
          "vatCode": "RUS_VAT0",
          "totalVatAmount": 0.00
      },
      {
          "vatCode": "RUS_VAT20",
          "totalVatAmount": 10.00
      }],
      "paymentType": "Безналичный расчёт"
    }
  }]
}

Данные бронирования железнодорожных билетов

Для передачи данных бронирования железнодорожных билетов, в полях элементов корзины metaData необходимо передать объект TrainReservation с перечнем дочерних объектов.

Пример объекта элемента корзины (билета) TrainReservation
{
  "@type": "TrainReservation",
  "bookingTime": "2021-05-15T12:22:01",
  "reservationId": "74345932763286",
  "reservationStatus": "https://schema.org/ReservationConfirmed",
  "reservationFor": {
    "@type": "TrainTrip",
    "departureStation": {
      "@type": "TrainStation",
      "name": "Moscow Kievskyi"
    },
    "departureTime": "2021-06-04T10:30:00+01:00",
    "arrivalStation": {
      "@type": "TrainStation",
      "name": "St. Petersburg Central"
    },
    "arrivalTime": "2021-06-04T03:10:00+01:00",
    "trainName" : "ГСЭ",
    "trainNumber": "425*СА"
  },
  "underName": {
    "@type": "Person",
    "name": "Иванов Сергей Иванович"
  },
  "provider": {
    "@type": "Organization",
    "name": "Sapsan",
    "taxID": "2323232323"
  },
  "reservedTicket": {
    "@type": "trainTicket",
    "underName": {
      "@type": "Person",
      "name": "Иванов Сергей Иванович"
    },
    "gender": "male",
    "nationality": "RUS",
    "idDocumentNumber": "***** 3456",
    "idDocumentDate": "2015-01-01",
    "coachNumber": "04",
    "coachType": "Плацкартный",
    "serviceClass": "3Э",
    "ticketedSeat": {
      "@type": "Seat",
      "seatNumber": "038"
    },
    "ticketNumber": "74363372056286",
    "ticketStatus": "Оформлен",
    "ticketIssueTime": "2021-05-15T12:30:21+01:00",
    "fareBase": 57.00,
    "fareReservation": 66.40,
    "vatValue": [{
        "vatCode": "RUS_VAT0",
        "totalVatAmount": 0.00
    },
    {
        "vatCode": "RUS_VAT20",
        "totalVatAmount": 10.00
    }],
    "paymentType": "Безналичный расчёт"
  }
}
Пример объекта элемента корзины (услуги) TrainReservation
{
  "@type": "TrainReservation",
  "bookingTime": "2021-05-15T12:22:01",
  "reservationId": "74345932763286",
  "reservationStatus": "https://schema.org/ReservationConfirmed",
  "reservationFor": {
    "@type": "TrainTrip",
    "departureStation": {
      "@type": "TrainStation",
      "name": "Moscow Kievskyi"
    },
    "departureTime": "2021-06-04T10:30:00+01:00",
    "arrivalStation": {
      "@type": "TrainStation",
      "name": "St. Petersburg Central"
    },
    "arrivalTime": "2021-06-04T03:10:00+01:00",
    "trainName" : "ГСЭ",
    "trainNumber": "425*СА"
  },
  "underName": {
    "@type": "Person",
    "name": "Иванов Сергей Иванович"
  },
  "provider": {
    "@type": "Organization",
    "name": "Sapsan",
    "taxID": "2323232323"
  },
  "reservedTicket": {
    "@type": "baggageCheck",
    "underName": {
      "@type": "Person",
      "name": "Иванов Сергей Иванович"
    },
    "idDocumentNumber": "***** 3456",
    "idDocumentDate": "2015-01-01",
    "ticketNumber": "44363452345662",
    "declaredName": "Велосипед",
    "declaredValue": 100.00,
    "note": "Малогабаритный багаж в специализированном купе",
    "fare": 57.00,
    "valueFee": 66.40,
    "vatValue": [{
        "vatCode": "RUS_VAT0",
        "totalVatAmount": 0.00
    },
    {
        "vatCode": "RUS_VAT20",
        "totalVatAmount": 10.00
    }],
    "paymentType": "Безналичный расчёт"
  }
}

Данные бронирования места проживания

Для передачи данных бронирования места проживания (отель, хостел, апартаменты и пр.), в поле заказа metaData необходимо передать объект ReservationPackage с перечнем дочерних объектов LodgingReservation.

Пример объекта ReservationPackage
{
  "@type": "ReservationPackage",
  "subReservation": [
  {
    "@type": "LodgingReservation",
    "reservationId": "YQVM18",
    "reservationStatus": "https://schema.org/ReservationConfirmed",
    "underName": {
      "@type": "Person",
      "name": "Андрей Макаров"
    },
    "reservationFor": {
      "@type": "LodgingBusiness",
      "name": "Гранд Отель Европа",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "ул. Михайловская, д. 1/7",
        "addressLocality": "Санкт-Петербург",
        "addressRegion": "Санкт-Петербург",
        "postalCode": "191186",
        "addressCountry": "ru"
      },
      "telephone": "+7 (812) 329-6000"
    },
    "checkinTime": "2021-02-21T16:00:00-08:00",
    "checkoutTime": "2021-02-23T11:00:00-08:00"
  }]
}

Данные подписки

Для передачи данных о подписке, в полях элементов корзины metaData необходимо передать объект PaymentPlan с перечнем дочерних объектов.

Пример объекта элемента корзины (подписки) PaymentPlan
{
  "@context": "https://schema.org",
  "@type": "PaymentPlan",
  "name": "Pro-подписка на сервис Экспресс Клиент",
  "description": "Доступ к премиум-функциям в течение 1 года с ежемесячными платежами",
  "billingPeriod": "P1M", 
  "billingIncrement": "1",
  "contractStartDate": "2025-01-01",
  "contractEndDate": "2026-01-01",
  "price": "2990.00",
  "priceCurrency": "RUB",
  "provider": {
    "@type": "Organization",
    "name": "Экспресс Клиент",
    "url": "https://expressclient.ru"
  }
}

Читать далее »