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-помилок.