MAUDAU Public Merchant API

MAUDAU Public Merchant API — модуль интеграции OkayCMS 4.5.2 с маркетплейсом MAUDAU через Public Merchant API. Модуль автоматизирует обмен заказами, статусами, ТТН, ценами и наличием товаров, а также предоставляет инструменты контроля комиссии и маржинальности.

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

• импорт новых заказов MAUDAU в стандартные заказы OkayCMS;
• сопоставление статусов OkayCMS ↔️ MAUDAU и автоматическая передача разрешённых переходов статусов;
• передача ТТН Новой почты и контроль фактического принятия ТТН со стороны MAUDAU;
• интеграция с NovaPoshtaTracking для получения ТТН;
• интеграция с OkayCMS/NovaposhtaCost: город, отделение, почтомат и курьерский адрес сохраняются в штатные данные доставки заказа;
• ручное повторное обновление адреса MAUDAU из карточки заказа;
• интеграция с Nova/OrderMarkers для маркировки заказов MAUDAU;
• интеграция с DoNotCallToConfirm: признак MAUDAU «не звонить клиенту» может передаваться в заказ OkayCMS;
• синхронизация изменений позиций заказа с MAUDAU для доступных API-состояний заказа.

Товары и API-синхронизация

• автоматическая синхронизация цены, старой цены и наличия товаров через MAUDAU API;
• OkayCMS используется как источник актуальной цены и остатка;
• очередь изменённых товаров: изменение цены, старой цены, остатка, валюты, комиссии или закупочной цены инициирует повторную проверку и передачу товара;
• пакетная обработка очереди для снижения нагрузки на CMS и базу данных;
• серверная пагинация, поиск и взаимоисключающие фильтры в таблице товаров MAUDAU;
• активная ссылка из названия товара на карточку товара OkayCMS;
• активный ID MAUDAU для перехода к товару/поиску на сайте MAUDAU;
• отдельный режим показа товаров, которые есть в наличии и продаются;
• отдельные режимы для товаров без наличия, отсутствующих в CMS и товаров вне условий Feeds.

Интеграция с OkayCMS/Feeds

Модуль может использовать выбранный профиль OkayCMS/Feeds как набор правил для товаров MAUDAU, даже если сам XML-фид отключён.

Поддерживаются:

• условия включения и исключения Feeds;
• ограничения по наличию, цене и другим параметрам профиля;
• наценка выбранного Feeds-профиля как базовая наценка для цены MAUDAU;
• автоматическое обновление выборки после изменения правил Feeds;
• передача temporarily_unavailable, если товар не должен продаваться по правилам интеграции.

Комиссия и маржа

В отдельной вкладке «Комиссии»:

• комиссия MAUDAU задаётся для категорий OkayCMS;
• дочерняя категория может наследовать ставку родительской категории;
• для отдельного товара можно установить индивидуальную комиссию;
• категории без товаров можно показать или скрыть, выбор запоминается;
• несколько изменённых комиссий сохраняются одним AJAX-запросом без перезагрузки страницы.

В таблице товаров выводится компактный блок «Комиссия / маржа» в три строки:

Комиссия: 14% / 839,86 грн Опт: 5 099,00 грн Маржа: 60,14 грн / 1,0%

Интеграция с PurchasePrice

При наличии модуля PurchasePrice — закупочная цена и маржа модуль MAUDAU использует закупочную цену и её валюту для расчёта фактической маржи после комиссии маркетплейса.

Маржа = Цена для MAUDAU − Комиссия MAUDAU − Закупочная цена

Условия товаров — дополнительная наценка РРЦ

Для товаров, которые есть в наличии в OkayCMS, но попали под конкретное исключение Feeds, можно создать цепочку дополнительных правил РРЦ:

Исключение Feeds → РРЦ от ... грн → маржа после комиссии меньше ... % → добавить ... % к РРЦ

Для одного исключения можно настроить несколько ценовых порогов. Применяется правило с максимальным порогом «РРЦ от», который уже достигнут. После применения правила модуль пересчитывает цену MAUDAU, комиссию и маржу.

Валюты

• цена и старая цена варианта конвертируются в выбранную валюту по курсам OkayCMS;
• наценка Feeds применяется после конвертации;
• поддерживается повторная проверка товаров при изменении курса или валюты варианта.

Автоматизация

Модуль работает через штатный Scheduler OkayCMS. Отдельный публичный cron-URL не требуется. Автоматические задачи выполняют:

• получение новых заказов;
• синхронизацию статусов;
• передачу ТТН;
• обработку очереди изменённых товаров;
• контроль актуальности цен и наличия;
• повторные попытки после временных API-ошибок.