Рекомендации товаров

IMSHOP Retail Protocol (IRP) является объектом интеллектуальной собственности ООО «АЙ ЭМ СОЛЮШНЗ» (IMSHOP) и защищён как объект авторского права. Свидетельство о депонировании произведения № 023-014461 от 16 января 2023 г. подтверждает исключительные права ООО «АЙ ЭМ СОЛЮШНЗ» на данные технологии.

IMSHOP Retail Protocol создан по заказу ООО «АЙ ЭМ СОЛЮШНЗ». Использование IMSHOP Retail Protocol допустимо только при взаимодействии с ООО "АЙ ЭМ СОЛЮШНЗ" и наличии действующего лицензионного договора. Более подробно можно ознакомиться здесь.

Дополнительные интеграции вводятся в эксплуатацию после завершения основных интеграций:

• Оформление заказа

• Доставки

• Оплаты

Для подключения дополнительных интеграций обратитесь к вашему менеджеру в IMSHOP.IO

Запрос

APP SERVER → INFRASTRUCTURE

От вас потребуется URL, на который наш сервер будет слать POST-запрос. Да, мы запрашиваем данные через POST, а не через GET.

В вашу систему будут приходить вот такие данные:

{
      "privateId": "12345",
      "userIdentifier": "qwerty12345",
      "location": {
        "city": "Москва",
        "cityFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
        "region": "Москва",
        "regionFiasId": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
    }
}

• privateId — id товара *

• userIdentifier — external id (идентификатор пользователя в системе клиента)

• location (в разработке) — локация пользователя, объект «Местоположение»

Ответ

Массив с объектами

ids - Массив идентификаторов товаров из фида. В блоке рекомендаций выводятся модели, поэтому рекомендуем передавать group_id; если по какой-то причине в фиде этот атрибут отсутствует - передаётся id оффера, например:

1. модель <offer id="12345" group_id="67890"... - в качестве идентификатора указывается "67890"

2. цветоразмер <offer id="12345"... - в качестве идентификатора указывается "12345"

title - Название блока с товарами

type (опционально) - Тип блока рекомендаций; см. раздел Upsell.

Пример ответа

[{ ids: ["12345"], title: "Покупают вместе с этим" }]

Upsell (в разработке)

При добавлении товара в корзину через карточку товара, пользователю можно показать несколько релевантных предложений (аксессуаров). Для этого в массив рекомендаций нужно добавить объект с type "upsell" (title в нём задавать не требуется).

Пример ответа

[
    { ids: ["01234", "54321"], type: "upsell" },
    { ids: ["12345", "98765"], title: "Покупают вместе с этим" }
]