# Импорт заказов
Если у вас есть история заказов, загрузка данных за последние 6-12 месяцев поможет быстрее обучить систему, выстроить тренды и сезонные всплески товаров и другие данные, необходимые для работы системы.
В дальнейшем вы сможете синхронизировать актуальные статусы заказов и загружать заказы из розницы (оффлайн) в режиме реального времени.
Описание метода API для импорта заказов и синхронизации их статусов: https://reference.api.rees46.com/?shell#import-orders (opens new window)
# Статусы заказов
Есть два вида статусов заказов:
Статусы заказов в системе REES46, это встроенные системные статусы заказов: оформлен, выполнен, отменен. Системный статус заказа доступен на странице информации о заказе в панели управления REES46.
Статусы заказов которе передаются в запросе к API при синхронизации заказов (opens new window), это собственные статусы заказов, идентичные с вашей системой управления, именно их вы передаете в API как названия статусов. Статус заказа который был передан в запросе на синхронизацию доступен на странице информации о заказе в панели управления REES46.
Чтобы собственный статус переданный в API (opens new window) изменил системный статус заказа, необходимо перейти в раздел Настройки
-> Статусы заказов
и задать нужное соответствие.
Теперь при передаче данных в API собственного статуса, он изменит системный статус заказа в REES46. Это требуется для синхронизации, а также позволяет выводить статусы магазина в списке заказов.
# Первичный импорт
Необходимо импортировать все заказы за период 6-12 месяцев до момента начала работы сервиса.
Массив заказов необходимо разбить на пачки по 5000. Это необходимо для того, чтобы объем отправляемых данных не превышал максимальный размер запроса.
Примите во внимание
Загружать необходимо только те заказы, по которым есть идентификационные данные клиента: email
, phone
или loyalty_id
.
# Регулярный импорт заказов
В рамках интеграции все онлайн заказы передаются с сайта и мобильных приложений. Передавать эти заказы импортом нельзя. В данном случае заказ будет создан в системе без связи с покупателем.
В дополнение к этому вы можете загружать заказы из розницы. Эти заказы влияют на:
- ROPO отчет;
- правильную работу триггерных рассылок "брошенная корзина" и "спасибо за заказ";
- синхронизацию аудиторий для поведенческого ретаргетинга;
- динамическую сегментацию аудиторий для рассылок, попапов и товарных рекомендаций.
Используйте тот же метод импорта заказов, что и в первичном импорте (ссылка в начале статьи).
Для отметки заказа как оффлайн
передавайте поле offline=1
. Система автоматически отделит этот заказ от онлайн и учтет во всех отчетах, включая ROPO отчет после рассылок.
Примите во внимание
Загружать необходимо только те заказы, по которым есть идентификационные данные клиента: email
, phone
или loyalty_id
.
# Синхронизация статусов заказов
Статусы заказов влияют на сегментацию, отправку триггерных рассылок и ряд других отчетов системы. По-умолчанию учет статусов заказов отключен. Если вам нужна эта механика, добавьте свои статусы заказов в панель управления REES46 и запросите включение учета у аккаунт-менеджера.
Для синхронизации статусов заказов вы можете передавать все те же данные, что и при импорте заказов, с тем же идентификатором заказа. В этом случае будет создана новая версия заказа с обновленными данными.
Если состав заказа будет изменен (например, часть товаров были возвращены клиентом), это так же отразится в заказе и в аналитике.
Вы можете изменить любые свойства заказа, кроме номера заказа и идентификатора клиента.
Если вы хотите изменить статус заказа (opens new window), необходимо передать все данные (весь объект) заказа. Для смены статуса заказа недостаточно просто указать номер заказа и его статус.
Режим реального времени
Вы можете пересылать чеки и статусы заказов в режиме реального времени. Чем раньше система получит заказ или его статус, тем лучше будут работать механики и аналитика.
# Детализация цен
Помимо базовой цены заказа вы можете указать детализацию цен:
Поле | Описание |
---|---|
value.total | Полная сумма заказа, включая бонусы, доставку, скидки и пр. |
value.cash | Сумма заказа, оплаченная в деньгах. |
value.bonuses | Сумма заказа, оплаченная бонусами. |
value.delivery | Стоимость доставки. |
value.discount | Размер скидки заказа. |
promocode | Примененный при оформлении заказа промокод. |
# Способы доставки
Вы можете передать в систему больше информации о заказе, например информацию о доставке:
Поле | Описание |
---|---|
delivery_type | Тип доставки. Может быть любым строковым значением. |
delivery_address | Адрес доставки. Любая строка. |
delivery_date | Дата доставки. Любая строка. |
delivery_time | Время доставки. Любая строка. |
Эти данные будут отображаться в карточке заказа/клиента в REES46 CDP и позволят операторам коллцентра оперативнее получать информацию, связанную с обращением клиента.