EVA Marketplace - интеграция заказов, статусов и ТТН

EVA Marketplace — интеграция заказов, статусов и ТТН — модуль для обмена заказами между OkayCMS и EVA Marketplace через Merchant API.

Модуль автоматизирует получение и обработку заказов EVA в OkayCMS, двустороннюю синхронизацию статусов, передачу ТТН и работу с заказами, которые уже существуют в CMS.

Основные возможности

• авторизация в EVA Merchant API через JWT;
• автоматическая и ручная загрузка заказов EVA;
• инкрементальная синхронизация только новых или изменённых заказов;
• получение полной информации о заказе: покупатель, получатель, товары, сумма, оплата, доставка, адрес, ТТН и комментарий;
• создание новых заказов EVA в OkayCMS;
• ручная привязка EVA-заказа к заказу, который уже существует в OkayCMS;
• защита от дублирования заказов;
• двусторонняя синхронизация статусов;
• контроль разрешённых переходов между статусами EVA;
• передача ТТН из OkayCMS в EVA;
• повторная передача ТТН без отката актуального статуса EVA;
• поддержка причин отмены заказов EVA;
• отдельный информационный блок EVA в карточке заказа OkayCMS;
• ручные действия для синхронизации и диагностики;
• журнал API-запросов и ошибок;
• оптимизированная работа Scheduler без лишней нагрузки на CMS и базу данных.

Интеграция с другими модулями

Модуль поддерживает совместную работу со следующими решениями:

• Nova/OrderMarkers — автоматическое добавление метки к EVA-заказам;
• OkayCMS/NovaposhtaCost — использование данных о доставке Новой почтой;
• Sviat/DoNotCallToConfirm — передача признака «не звонить для подтверждения»;
• TelegramNotifier — стандартное уведомление о новом заказе;
• NovaPoshtaTracking — получение ТТН, созданной в OkayCMS;
• Green API через совместимые модули Rozetka/Maudau — получение рейтинга выкупа покупателя и изменение цвета информационного блока.

Ручная привязка заказов

Для заказов, которые были созданы в OkayCMS до подключения модуля, доступен режим «Загрузить все заказы EVA».

После загрузки администратор может указать номер существующего заказа OkayCMS и создать связь:

EVA order ID ↔ OkayCMS order ID

Привязанный вручную заказ не перезаписывается импортёром. Товары, цены, количество, а также установленный менеджером локальный статус остаются без изменений.

Информационный блок EVA

В карточке заказа OkayCMS отображается отдельный блок с данными EVA:

• EVA ID и текущий статус;
• сумма и информация об оплате;
• способ доставки и адрес;
• ТТН;
• даты создания и обновления;
• тип привязки заказа;
• информация о синхронизации;
• ошибки EVA API.

По умолчанию блок имеет белый фон. Если доступен рейтинг Green API, его цвет может изменяться в соответствии с уровнем выкупа покупателя.

Будущий функционал

В интерфейсе модуля уже зарезервированы, но пока неактивны разделы:

• Товары;
• Цены и остатки;
• Сопоставление товаров;
• Комиссии;
• Контент.

Эти разделы могут быть активированы после появления соответствующих методов в EVA Merchant API.