Расчет корзины, скидок, баллов

Мы работаем только через POST-запросы.

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

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

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

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

Формат запроса и примеры

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

{
            "userData": null,
            "staffId": "1111111",
            "authorizedBonuses": 0,
            "items": [
              {
                "privateId": "7619426049232",
                "subtotal": 320,
                "quantity": 1,
                "appliedDiscounts": [],
                "addons": [],
                "name": "Название Товара",
                "discount": 0,
                "price": 320,
                "id": "7619426",
                "configurationId": "426049232"
              }
            ],
            "deliveryId": null,
            "installId": "efef3134-825f-41f6-9827-76dae5fa6527",
            "preferredPickupId": null,
            "promocode": null,
            "fiasCode": null,
            "externalUserId": null,
            "outletId": "0120383",
            "cityKladr": "7700000000000",
            "addressData": {
              "lon": null,
              "building": null,
              "house": null,
              "beltwayDistance": null,
              "houseKladr": null,
              "cityFias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
              "settlement": null,
              "streetType": null,
              "city": "Москва",
              "fiasCode": null,
              "streetKladr": null,
              "settlementWithType": null,
              "beltwayHit": null,
              "capitalMarker": null,
              "streetFias": null,
              "areaFias": null,
              "settlementKladr": null,
              "street": null,
              "value": null,
              "zip": null,
              "apt": null,
              "region": "Москва",
              "fias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
              "area": null,
              "regionKladr": "7700000000000",
              "lat": null,
              "kladr": null,
              "houseFias": null,
              "cityKladr": "7700000000000",
              "settlementFias": null,
              "areaKladr": null,
              "regionFias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5"
            },
            "customSectionValues": {},
            "user": {
              "phone": "none",
              "name": "none",
              "email": "none"
            },
            "loyaltyCard": "",
            "city": "Москва",
            "paymentId": null
          }

Описание формата запроса

outletId — идентификатор магазина
staffId — идентификатор сотрудника
deliveryId - идентификатор выбранной службы доставки в IMSHOP.IO (null если доставка еще не выбрана)
paymentId - идентификатор выбранной службы оплаты в IMSHOP.IO (null если оплата еще не выбрана)
deliveryPickupId - (опционально) выбранный желаемый пункт выдачи / магазин для получения заказа
preferredPickupId - (опционально) id любимого пункта самовывоза (если есть), выбранный в списке любимых магазинов, например на этапе корзины
addressData — полная информация о адресе, прошедшая валидацию DaData
- kladr — Классификатор адресов Российской Федерации, определяющий город и улицу
- apt— номер квартиры
- houseKladr— не ориентируйтесь на это поле Классификатор адресов Российской Федерации, определяющий конкретный дом, по умолчанию null, ситуативно DaData может передавать данное поле заполненным
- region— регион
- fias— ФИАС города и улицы
- value— адрес полностью
- cityFias— ФИАС города
- areaFias — ФИАС-код района
- streetKladr— Классификатор адресов Российской Федерации, определяющий улицу
- regionKladr— Классификатор адресов Российской Федерации, определяющий регион
- regionFias— ФИАС определяющий регион
- city_kladr— Классификатор адресов Российской Федерации, определяющий город
- streetFias— ФИАС определяющий улицу
- zip— индекс дома
- settlement — населенный пункт
- settlementFias — ФИАС-код населенного пункта
- beltwayDistance — расстояние от кольцевой в км (только если заполнен beltwayHit)
- lat— широта
- lon— долгота
- settlementKladr — Классификатор адресов Российской Федерации, определяющий населенный пункт
- house— номер дома
- city— название города
- cityKladr— Классификатор адресов Российской Федерации, определяющий город
- houseFias— не ориентируйтесь на это поле ФИАС, определяющий конкретный дом, по умолчанию null, ситуативно DaData может передавать данное поле заполненным
- beltwayHit — внутри кольцевой ( INMKAD - на территории МКАД, OUT_MKAD - за территорией МКАД)
- area — район в регионе
- fias_code — не заполняется, используйте fias_id
- street— название улицы
- areaKladr — Классификатор адресов Российской Федерации, определяющий район
- settlementWithType — улица с типом
- fias_id — ФИАС-код адреса (идентификатор адреса)
items - состав корзины
- name - наименование
- id - идентификатор товара в IMSHOP.IO
- privateId - идентификатор товарного предложения в системе клиента
- configurationId - идентификатор товарного предложения в IMSHOP.IO
- price - цена товара на момент добавления в корзину (если товар - это подарок на выбор, то тут передается 0)
- quantity - количество
- subtotal - итого по позиции (subtotal = price * quantity)
- appliedDiscounts - если предыдущий расчет показал наличие маркетинговой акции, или это - подарок на выбор, то передаем идентификатор акции из прошлого ответа от API
- deliveryGroup - (опционально) выбранная группа доставки товара, при разбиении корзины
- addons - (опционально, в разработке) доп. товары, например "Основание для кровати"
externalUserId - идентификатор покупателя в системе клиента, если известен
configurationId - идентификатор товарного предложения из фида
promocode - промокод, введенный покупателем
installId - идентификатор установки приложения
loyaltyCard - номер карты лояльности
customSectionValues - индивидуальные секции в оформлении заказа (к примеру добавить открытку, если пользователь приобретает товар в подарок)

PreviousДоставки NextНайти покупателя

Last updated 1 month ago