Персональные предложения

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

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

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

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

• Доставки

• Оплаты

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

Описание

Данный метод позволяет получить персональные для пользователя промокоды (акции) для показа в виде шрихкода и считывания на кассе, например, Акция "Скачай приложение и получи скидку на кассе". Для того, чтобы акция отобразилась у пользователя нужно, чтобы:

• Пользователь авторизовался в приложении

• Ендпоинт вернул акцию с промокодом

• В админке imshop создан баннер акции с указанным id акции - именно этот баннер будет показан пользователю, в конце содержимого баннера будет показан штрихкод акции для считывания на кассе

Получение списка индивидуальных предложений

Формат запроса

• userId - идентификатор пользователя в системе продавца (на сайте / в CRM итд)

• segments - список сегментов, в которые добавлен пользователь на стороне IMSHOP

  • id - идентификатор сегмента

  • name - название сегмента

Пример запроса

{
    "userId": "1234567890",
    "segments": [
        { "id": "PEREKRESTOR-BUYER", "name": "Пользователи, установившие приложение по флаеру в Перекрестке" },
        { "id": "SALES", "name": "Пользователи, покупающие только на распродажах" }
    ]
}

Формат ответа

• offers - список предложений

  • id - идентификатор предложения

  • name - название

  • description - описание

  • promocode - промокод

  • barcodeType (опционально) - тип баркода, по-умолчанию code128

  • online - промокод может быть применен в приложении

  • offline - промокод может быть предъявлен в рознице

  • used (опционально) - true / false - предложение было использовано

  • expirationTimestamp - таймштамп, когда истекает срок действия предложения (null - если предложение не имеет срока действия)

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

{
    "offers": [
        {
            "id": "PROMO-1",
            "name": "Скидка 1000 рублей при покупке духов HUGO BOSS",
            "description": "Воспользуйтесь вашим персональным промокодом до 31 августа",
            "promocode": "HUGO1000",
            "barcodeType": "qr",
            "online": true,
            "offline": false,
            "expirationTimestamp": 1586459114
        }
    ]
}

Список промокодов оффера (в разработке)

• promoList

  • promocode - промокод (строка)

  • value - номинал (число); в валюте, используемой в каталоге приложения

  • image (опционально) - ссылка на изображение (строка); по умолчанию отображается QR-код со значением, заданным в promocode

  • expirationTimestamp(опционально) - таймштамп, когда истекает срок действия промокода

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

{
    "offers": [
        {
            "id": "PROMO-1",
            "name": "Ваши промокоды",
            "promoList": [
                {
                    "promocode": "code-1",
                    "value": 500,
                    "image": "https://media.url/promo-image.png",
                    "expirationTimestamp": 1586459114
                },
                {
                    "promocode": "code-2",
                    "value": 1000
                }
            ]
        }
    ]
}