Повна інтеграція з маркетплейсом Пром - передача даних про товари, отримання замовлень в Odoo
Модуль інтеграції складається з двох частин, які можуть бути впроваджені як поступово, так і обидві відразу. Базова частина — це модуль для створення XML-прайслистів з інформацією про ваші товари. Друга частина забезпечує повну інтеграцію, що реалізує обмін інформацією про товари та замовлення з Пром через API.
| Встановлення |
Odoo Online
Odoo.sh
On Premise
|
|---|---|
| Сумісність |
Community
Enterprise
|
| Технічна назва | merchant_prom_ua |
| Версія | 19.0.1.1.8 |
| Ліцензія | OPL-1 |
| Категорія | |
| Підтримка | Допомога з встановленням та підтримка впродовж 60 днів, гарантований багфіксинг впродовж року |
Use Case
Jorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Forem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Dorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
It is a long established fact that a reader will be distracted by the readable content of a page
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos.
Korem ipsum dolor sit amet, consectetur adipiscing elit. Nunc vulputate libero et velit interdum, ac aliquet odio mattis.
Встановлення модуля Odoo
Завантаження модулів
Завантажте модулі з ZIP архіву на ваш сервер, де встановлена Odoo, або в GitHub репозиторій підключений до нього.
Розмістить розархівовані модулі у директорії з кастомними модулями та перезапустить системний сервіс Odoo.
Оновить список модулів
Після перезавантаження активуйте Режим розробника, та перейдіть до меню Додатки.
Натисніть на Оновити список додатків, щоб підтягнути нові модулі до списку.
Інсталяція модуля
Знайдіть модуль за його іменем та натисніть на Активувати, щоб інсталювати його.
* Якщо ви не бачите модуль, спробуйте видалити типовий фільтр Додатки у рядку пошуку.
Налаштування
Дотримуйтесь інструкцій в описі модуля, щоб завершити процес встановлення та почати користуватися застосунком.
Інструкція
Налаштування користувачів
На початку роботи з модулем надайте відповідні права користувачам, які будуть переглядати та виконувати операції з магазинами. Існує два види ролей:
- Користувач: доступні лише перегляд інформації та виконання обмеженого кола операцій
- Адміністратор: має повні права і доступ до всіх об'єктів
Щоб призначити ролі, перейдіть до меню керування користувачами, оберіть користувача та на вкладці Права доступу в секції Інше виберіть роль зі списку Мерчант центр.
Роль Користувач не надає дозволу виконувати наступні операції:
- Підключати нові магазини
- Змінювати стан магазину з Тестового на Робоче середовище та навпаки
- Створювати меппінг об'єктів вручну
- Переглядати технічну інформацію, пов'язану з інтеграцією
Додавання магазину
Далі підключіть ваш магазин Пром до Odoo. Для цього знадобиться API-токен, який потрібно отримати в особистому кабінеті продавця Пром.
Авторизуйтесь в кабінеті, відкрийте розділ Налаштування та перейдіть у меню Управління API-токенами.
Вкажіть назву, налаштуйте параметри доступу та натисніть кнопку Створити токен. Після цього нижче в списку з’являється запис із новим токеном. Скопіюйте його, натиснувши Дивитись та у вікні кнопку Скопіювати.
Далі поверніться в Odoo та перейдіть до меню Мерчант центр — Налаштування — Додати магазин.
У вікні майстра виконайте наступні дії:
-
01Оберіть тип маркетплейсу Prom.UA
-
02Введіть назву магазину
-
03Замініть логотип вашого магазину, в разі потреби
-
04Вставте скопійований API-токен з кабінету Пром
-
05Оберіть фід даних з товарами для цього магазину
-
06Натисніть кнопку Додати
Стани інтеграції
Інтеграція з маркетплейсом Пром від компанії Garazd Creation, може працювати у двох станах:
- Тестове середовище
- Робоче середовище
Тестове середовище дозволяє перевірити та протестувати функціонування в безпечному режимі. Воно відрізняється від робочого тим, що в ньому здійснюється лише отримання даних з реального магазину. Для тестування та первинних налаштувань оновлення і повернення даних не відбуваються.
Робоче середовище — це стан роботи інтеграції в повному режимі. Після завершення тестування та підтвердження коректної роботи переведіть магазин у робочий режим. У робочому середовищі зміни в асортименті, ціни, актуальні залишки та статуси замовлень автоматично оновлюються з Odoo і передаються до Пром.
Налаштування
Після додавання магазину налаштуйте його параметри для запуску синхронізації та передачі даних. Налаштування поділені на кілька секцій:
- Замовлення
- Клієнти
- Доставка
- Оплати
- Товари
Налаштування замовлень
Почнемо з параметрів синхронізації замовлень. Наступні поля відповідають за імпорт замовлень з Пром і подальші дії з імпортованими замовленнями:
- Оберіть Тип замовлень, статус з якого потрібно імпортувати з Prom
- Щоб змінити статус замовлення відразу після імпорту, виберіть необхідний статус у полі Встановити статус замовлення
- Шоб замовлення автоматично підтверджувати в Odoo відразу після імпорту, увімкніть опцію Підтверджувати замовлення
У розділі Значення для замовлень вкажіть дані, які додавати до замовлень, отриманих з Пром. Оберіть відповідального менеджера в полі Продавець, вкажіть Команду продажу, Джерело та Теги замовлення. Це дозволить маркувати замовлення відповідними тегами та забезпечить зручну фільтрацію.
Налаштування клієнтів
Секція налаштувань Клієнти дозволяє вказати наступні параметри.
Покупець, який оформлює замовлення на Prom.ua, може вказати різні адреси доставки або іншу особу як отримувача. Щоб зафіксувати в Odoo як контактні дані покупця, так і дані для доставлення товарів, увімкніть опцію Створювати адресу доставки.
Параметр Теги клієнта допомагає ідентифікувати тих, хто був створений через цю інтеграцію. Оберіть теги, які автоматично додавати до записів клієнтів з Пром.
Налаштування доставки
У розділі Доставка можна вказати метод доставки, який додавати окремим рядком у замовлення з Пром. Для активації оберіть один з методів та увімкніть опцію Додавати доставку.
Налаштування для оплат
Щоб автоматично фіксувати платежі, здійснені на боці Prom.ua, виберіть Журнал для оплат.
Налаштування для товарів
Алгоритми Prom.ua аналізують обрану категорію товару Пром, назву, опис та ключові слова для автоматичного визначення категорії товару на боці маркетплейсу. Іноді це може призвести до зміни обраної вами категорії на іншу. Щоб бути проінформованим про такі зміни, увімкніть опцію Відстежувати зміну категорії в розділі Товари.
Товари
Обмін інформацією про товари між Odoo та Пром здійснюється через XML-стрічки даних (фіди). Рішення постачається з готовим шаблоном XML-фіду, що відповідає технічним вимогам Prom.
Щоб переглянути фіди, які пов'язані з магазинами, скористайтеся меню Мерчант центр — Фіди.
Ручне оновлення
Модуль дозволяє вручну оновлювати інформацію про товар. Для цього відкрийте товар та оберіть дію Оновити на Пром.
У вікні, що відкрилося, оберіть ваш магазин Пром та натисніть Оновити.
Синхронізація
Після того, як всі налаштування зроблені, натисніть кнопку Синхронізувати, щоб виконати початкову синхронізацію.
В рамках цього процесу створюються взаємозв’язки між даними в Odoo і на боці Пром і відбувається імпорт наступних об’єктів:
- Категорії товарів
- Статуси замовлення
- Залишки та ціни товарів
- Замовлення
Замовлення
Замовлення, імпортовані з маркетплейсу Prom.ua, містять всю необхідну інформацію:
- Поле Мерчант відображає назву магазину та номер замовлення на боці Пром
- Поле Статус відображає поточний статус замовлення, стан та метод оплати
Також ці дані з Пром додаються до списку замовлень. Активуйте відповідні колонки, щоб переглянути їх.
Автоматична зміна статусу
Модуль підтримує автоматичну зміну статусів для замовлень на Пром, під час здійснення наступних операцій в Odoo:
- Підтвердження замовлення — встановлення статусу Прийнято
- Підтвердження складського документа і відвантаження товарів замовлення — встановлення статусу Виконано
- Скасування замовлення — встановлення статусу Скасовано (додатковий майстер дозволяє вказати причину скасування та додати коментар)
Список змін
17.0.1.2.0 2026-06-10
- Add an option to update Prom sale orders which are created in the last X days only.
- Implement logic to sync canceled orders from Prom. To cover cases when a time delay between order placement and cancellation less than syncing period in Odoo.
- Add an option to disable automatic Prom status changing for sale orders.
- Add skipping of the canceled orders uploading.
17.0.1.1.0 2026-02-26
- Implement syncing of the sale order date fields: Date Created, Date Modified.
- Add advanced options to sync sale orders from Prom, such as the Order Date, the last order ID, the sorting order, the limit, etc.
17.0.1.0.3 2026-02-24
- Improve the wizard to add a new store, add the Company field for the multi-company environment.
17.0.1.0.2 2025-12-08
- Improve price parsing for the automatic payment process.
17.0.1.0.1 2025-11-14
- Improve method to update product data, implement dividing by 100 items.
17.0.1.0.0 2025-10-31
- Implement Prom payment processing.
- Add the merchant option to set an initial order status after importing.
- Add a wizard to map products.
17.0.0.9.6 2025-09-26
- Add the merchant option to set an initial order status after importing.
17.0.0.9.5 2025-08-01
- Add the Control Prom Category Change setting.
- Improve the method for product mapping.
- Add a wizard to map products.
17.0.0.9.4 2025-07-29
- Improve the product map method, add the loop to get all the products.
17.0.0.9.3 2025-06-12
- Fix the Prom order status getting.
- Add logging of the Prom product category changing.
17.0.0.9.2 2025-03-29
- Improve Prom order status updating.
- Improve the client and delivery data processing.
17.0.0.9.1 2025-03-19
- Improve the client and delivery data processing.
- Add the merchant fee value getting.
17.0.0.9.0 2024-10-03
- Init version.
18.0.1.1.0 2026-02-24
- Improve the wizard to add a new store, add the Company field for the multi-company environment.
- Implement syncing of the sale order date fields: Date Created, Date Modified.
- Add advanced options to sync sale orders from Prom, such as the Order Date, the last order ID, the sorting order, the limit, etc.
18.0.1.0.3 2025-12-02
- Improve price parsing for the automatic payment process.
18.0.1.0.2 2025-11-14
- Improve method to update product data, implement dividing by 100 items.
18.0.1.0.1 2025-10-29
- Implement Prom payment processing.
18.0.1.0.0 2025-09-26
- Add the merchant option to set an initial order status after importing.
- Add a wizard to map products.
- Add logging of the Prom product category changing.
18.0.0.9.2 2025-04-10
- Fix SO status updates.
18.0.0.9.1 2025-04-01
- Add checking for a Prom category changing.
18.0.0.9.0 2025-03-28
- Migration from 17.0.
19.0.1.1.8 2026-09-15
- Improve UA transaltions.
- Add a demo data.
- Improve the wizard to update product data on Prom.
19.0.1.1.7 2026-08-13
- Add wizard to update single product on Prom UA.
19.0.1.1.6 2026-06-03
- Improve UA translations.
- Add an option to update Prom sale orders which are created in the last X days only.
19.0.1.1.5 2026-05-08
- Реалізовано логіку синхронізації скасованих замовлень із Prom. Це потрібно для випадків, коли проміжок часу між розміщенням замовлення та його скасуванням покупцем замалий для синхронізації з Odoo.
19.0.1.1.4 2026-04-28
- Add an option to disable automatic Prom status changing for sale orders.
19.0.1.1.3 2026-04-16
- Реалізовано пропуск скасованих замовлень при завантаженні з Prom.
19.0.1.1.2 2026-02-24
- Improve the wizard to add a new store, add the Company field for the multi-company environment.
19.0.1.1.1 2026-02-16
- Add advanced options to sync sale orders from Prom, such as the Order Date, the last order ID, the sorting order, the limit, etc.
19.0.1.1.0 2026-01-06
- Improve order amount processing.
- Fix a name of the tax field for sale orders.
19.0.1.0.1 2025-11-14
- Improve method to update product data, implement dividing by 100 items.
19.0.1.0.0 2025-11-03
- Міграція з версії 18.0.
Додаткова інформація
Дізнайтеся, як налаштувати повну інтеграцію з Prom.ua для ваших продажів за допомогою API
Автоматизуйте передачу товарів, цін і залишків з Odoo на Prom.ua
