# Импорт заказов

Если у вас есть история заказов, загрузка данных за последние 6-12 месяцев поможет быстрее обучить систему, выстроить тренды и сезонные всплески товаров и другие данные, необходимые для работы системы.

В дальнейшем вы сможете синхронизировать актуальные статусы заказов и загружать заказы из розницы (оффлайн) в режиме реального времени.

Описание метода API для импорта заказов и синхронизации их статусов: https://reference.api.rees46.com/?shell#import-orders (opens new window)

# Статусы заказов

Есть два вида статусов заказов:

  1. Статусы заказов в системе REES46, это встроенные системные статусы заказов: оформлен, выполнен, отменен. Системный статус заказа доступен на странице информации о заказе в панели управления REES46. Системный статус заказа в ПУ

  2. Статусы заказов которе передаются в запросе к API при синхронизации заказов (opens new window), это собственные статусы заказов, идентичные с вашей системой управления, именно их вы передаете в API как названия статусов. Статус заказа который был передан в запросе на синхронизацию доступен на странице информации о заказе в панели управления REES46. Переданный статус заказа в API

Чтобы собственный статус переданный в 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), можно не передавать все данные заказа. Достаточно указать: номер заказа (id), и новый статус заказа (status).

Режим реального времени

Вы можете пересылать чеки и статусы заказов в режиме реального времени. Чем раньше система получит заказ или его статус, тем лучше будут работать механики и аналитика.

# Детализация цен

Помимо базовой цены заказа вы можете указать детализацию цен:

Поле Описание
value.total Полная сумма заказа, включая бонусы, доставку, скидки и пр.
value.cash Сумма заказа, оплаченная в деньгах.
value.bonuses Сумма заказа, оплаченная бонусами.
value.delivery Стоимость доставки.
value.discount Размер скидки заказа.
promocode Примененный при оформлении заказа промокод.

# Способы доставки

Вы можете передать в систему больше информации о заказе, например информацию о доставке:

Поле Описание
delivery_type Тип доставки. Может быть любым строковым значением.
delivery_address Адрес доставки. Любая строка.
delivery_date Дата доставки. Любая строка.
delivery_time Время доставки. Любая строка.

Эти данные будут отображаться в карточке заказа/клиента в REES46 CRM и позволят операторам коллцентра оперативнее получать информацию, связанную с обращением клиента.