Skip to Content

Integration with Prom.ua

by
Odoo

$ 117.15

v 18.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Inventory (stock)
• Sales (sale_management)
• eCommerce (website_sale)
• Invoicing (account)
• Discuss (mail)
• Website (website)
Community Apps Dependencies
Lines of code 5911
Technical Name us_prom_integration
LicenseOPL-1
Websitehttps://unitsoft.com.ua/
Versions 17.0 18.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Inventory (stock)
• Sales (sale_management)
• eCommerce (website_sale)
• Invoicing (account)
• Discuss (mail)
• Website (website)
Community Apps Dependencies
Lines of code 5911
Technical Name us_prom_integration
LicenseOPL-1
Websitehttps://unitsoft.com.ua/
Versions 17.0 18.0

Інтеграція з Prom.ua від UnitSoft

Взаємодійте з Prom.ua в Odoo

Опис

Інструкція

Опис

Обмін товарами

Інтеграція працює у двох напрямках (завантаження товарів з Prom.ua в Odoo та вивантаження товарів з Odoo на Prom.ua).

Завантаження товарів з Prom.ua в Odoo: Товари можна оновити/завантажити вручну чи за допомогою запланованої дії. Оновлення відбувається лише для тих товарів, які були змінені з моменту останнього оновлення, зазначеного в налаштуваннях модуля. Якщо модуль встановлено вперше, завантажуються всі товари.

Автоматичне оновлення відбувається приблизно раз на годину.

Зображення обробляються окремо кожні ~10 хвилин. Спочатку завантажується вся інформація про товар, а після обробки зображення додаються до картки товару.

Всі товари створюються як окремий товар, без використання варіацій, оскільки API Prom.ua не дозволяє отримувати атрибути. Товари-різновиди на Prom.ua можна редагувати лише в межах обмеженого списку полів.

Вивантаження товарів з Odoo на Prom.ua: При редагуванні картки товару (полів, що стосуються Prom.ua на вкладці маркетплейсів), зміні цін у прайс-листах або при складських переміщеннях товар додається в чергу на обмін. Кожні ~5 хвилин черга обробляється, і товари експортуються на Prom.ua.

Додаткові довідники:

  1. Довідник регіонів: Містить регіони, з яких відправляють товари, формуються на основі існуючого довідника на Prom.ua (Регіони).
  2. Категорії товарів: Стандартна модель Odoo для категорій, дані про які імпортуються через API.
  3. Категорії товарів Prom.ua: Ґрунтується на категоріях, наданих самим маркетплейсом (Категорії).
Завантаження замовлень

Завантаження замовлень з Prom.ua в Odoo: Замовлення можна оновити або завантажити вручну чи за допомогою запланованої дії. Оновлення відбувається лише для замовлень, які були змінені з моменту останнього оновлення. При першому завантаженні модуль завантажує лише ті замовлення, які були створені після дати встановлення модуля.

Автоматичне оновлення відбувається кожні ~5 хвилин.

Вивантаження замовлень з Odoo на Prom.ua: Вивантаження замовлень не підтримується. Єдине, що передається на Prom.ua, — статус замовлення та номер декларації. Також модуль дозволяє повернути кошти за замовлення клієнту.

Додаткові довідники:

  1. Клієнти: Імпортуються через API та використовуються для заповнення даних замовлень.
  2. Методи доставки: Дані імпортуються через API і використовуються для виконання замовлень.
  3. Методи оплати: Імпортуються через API.
  4. Статуси замовлень: Включають стандартні та кастомні статуси.
Експорт залишків

Функціонал експорту залишків:

  • Увімкнено: Залишки товару обчислюються автоматично та додаються в чергу на оновлення.
  • Вимкнено: Експортується лише значення поля «Кількість на складі».
Обмін статусами

Завантаження статусів: Відбувається під час оновлення замовлень. Статус «Виконано» автоматично переводить трансфер у статус «Виконано».

Вивантаження статусів: Черга змін статусів обробляється кожні ~5 хвилин. Якщо ж документ замовлення в Odoo було скасовано, то замовлення автоматично скасується і на Prom.ua. Причина автоматично вказується як «Інша» із повідомленням «Скасовано менеджером».

Оновлення статусу оплат

Включає оновлення методів оплати, статусів (Оплачено покупцем, Не оплачено, Виконане повернення покупцю, Виплачено продавцю) та дати змін.

Інструкція

Рекомендація перед початком роботи

Перш ніж розпочати використання модуля, наполегливо рекомендуємо виконати експорт актуальної інформації про всі товари:

  1. Увійдіть у кабінет продавця Prom.ua та перейдіть до Товари та послуги → Позиції;
  2. Натисніть кнопку Експорт, оберіть задані налаштування та Експортуйте групи та позиції.

Це дозволить уникнути можливих втрат даних у разі помилок синхронізації та забезпечить максимальну безпеку для вашого магазину.

Початок роботи
  1. Увійдіть у кабінет продавця Prom.ua та перейдіть до Налаштування → Управління API-токенами;
  2. Створіть новий API-токен із заданими налаштуваннями доступу (потрібну дату Prom.ua визначить автоматично):
  3. Скопіюйте свій API-токен;
  4. У Odoo перейдіть до меню Маркетплейси → Налаштування;
  5. Введіть API-токен та збережіть налаштування.
Імпорт даних з Prom.ua
  1. Перейдіть у розділ Товари;
  2. Оберіть дію Завантажити з Prom.ua (завантаження товарів може зайняти деякий час).

    Інформація про товари буде імпортована. Усі товари, включаючи різновиди, створюються як окремі позиції, оскільки API Prom.ua не дозволяє отримувати характеристики.

    Окремо у фоновому режимі запуститься процес імпорту зображень — це може зайняти кілька хвилин.

    Після завершення імпорту товарів, будь ласка, внесіть в Odoo актуальні залишки по товарах у відповідних розділах складу.

  3. Аналогічно імпортуйте Клієнтів та Замовлення.

    За замовчуванням завантажаться тільки ті замовлення, що були отримані після встановлення модуля. За необхідністю можна завантажити й минулі замовлення. Для цього скористайтесь пунктом інструкції «Завантаження всіх замовлень».

Завантаження всіх замовлень

⚠️ Увага: імпорт старих замовлень може вплинути на поточні залишки товарів, оскільки система перерахує рух товарів відповідно до цих замовлень.

  1. Для того, щоб завантажити всі замовлення, необхідно увімкнути додаткові права доступу (див. пункт «Додаткові права доступу»);
  2. Перейдіть до Налаштувань:
  3. Оберіть дату, з якої хочете завантажити замовлення, в полі Останнє оновлення замовлень. Якщо є необхідність завантажити всі існуючі замовлення, то приберіть дату взагалі;
  4. Перейдіть до вкладки Замовлення і оберіть Завантажити з Prom.

⚠️ Увага: Після завантаження всіх замовлень рекомендуємо вимкнути додаткові права доступу, якщо немає необхідності їх використовувати.

Взаємодія з товарами

Зміни, що були внесені на картці товару на вкладці Prom.ua, автоматично відправляються на Prom.ua.

Для товарів-різновидів на Prom.ua список редагованих полів обмежений: Назва та переклади, статус, наявність, кількість на складі, знижка. Дізнатись що товар є різновидом можна з поля на картці товару:

Ціни, що було змінено в прайс-листах для товарів з Prom.ua, також автоматично оновлюються на маркетплейсі.

Щоб ціна експортувалася на Prom.ua, необхідно вказати правильний прайс-лист: Retail Pricelist for Marketplaces (роздрібні ціни) або Wholesale Pricelist for Marketplaces (оптові ціни) з позначкою Prom.ua в полі Маркетплейси. Можна змінити ціну перейшовши на Додаткові ціни в картці товару:

Черга товарів на оновлення обробляється кожні 5 хвилин. Якщо Prom.ua не приймає пакети на даний момент, то оновлена інформація про товар і залишки буде відправлена згодом (коли Prom.ua знову почне приймати пакети).

Оновлення товару на Prom.ua може зайняти більше 20 хвилин. Якщо під час вивантаження інформації про товари на Prom.ua виникли помилки, ви отримаєте повідомлення про це. Деталі можна переглянути в черзі синхронізації, яка доступна за шляхом Налаштування → Черга синхронізації.

На відповідній дії Експортувати товари на маркетплейс буде відображений ID товару в системі та повідомлення про помилку, яке надійшло від Prom.ua. В такому випадку варто виправити помилку в товарі, щоб знову спробувати його експортувати.

Залишки

За замовчуванням при експорті товарів на Prom.ua використовується спеціальне поле «Кількість на складі», яке заповнюється під час імпорту з Prom.ua. Тоді це поле не пов’язане з реальними залишками у системі.

Якщо ви хочете, щоб на Prom.ua вивантажувались актуальні залишки з Odoo, увімкніть опцію «Вивантажувати актуальні залишки на Prom.ua» у налаштуваннях модуля. Перед увімкненням цієї опції переконайтесь, що всі залишки товарів в системі актуальні.

За замовчуванням залишки відслідковуються за Вашими складами, для яких дозволена взаємодія з Prom.ua.

Якщо у Вас більше одного складу та є необхідність не враховувати залишки з певних складів:

  1. Перейдіть до модулю Складу та оберіть в Налаштуваннях «Склади»:
  2. Приберіть галочку на складі, залишки якого не хочете враховувати:
Статуси замовлення

Модуль дозволяє змінювати статус замовлення та відправляти оновлений статус на Prom.ua. Для статусу Скасовано необхідно також додатково обирати причину скасування.

Дані актуалізуються кожні 5 хвилин.

Модуль автоматично переводить трансфер у статус «Виконано» для виконаних замовлень.

Якщо ж документ замовлення в Odoo було скасовано, то замовлення автоматично скасується і на Prom.ua. Причина автоматично вказується «Інша» із повідомленням «Скасовано менеджером».

Повернення коштів

Для того, щоб повернути клієнту кошти за замовлення, перейдіть у потрібне замовлення та оберіть Повернення коштів клієнту Prom.

Прикріплення ЕН

Модуль підтримує можливість збереження номеру декларації, створеної не через кабінет Prom.ua. Для цього:

  1. Перейдіть на трансфер потрібного замовлення;
  2. Введіть ЕН в Референс відстеження;
  3. Збережіть зміни;
  4. Натисніть Зберегти на Prom.ua.
Послідовність синхронізації

За необхідності можна змінити послідовність виконання синхронізації з маркетплейсом.

Для цього:

  1. Перейдіть в Параметри послідовності обміну:
  2. Перетягніть дії у бажаному порядку виконання. Найвища дія виконується найпершою, найнижча – останньою.
Додаткові права доступу

Якщо виникла потреба змінити службові або технічні поля, необхідно надати користувачу додаткові права — Адміністратор маркетплейсів.

Для цього:

  1. Перейдіть в глобальні налаштування Odoo;
  2. Активуйте режим розробника;
  3. В глобальних налаштуваннях оберіть в меню Користувачів;
  4. Знайдіть поточного користувача;
  5. В технічних налаштуваннях Вашого користувача оберіть Адміністратора маркетплейсів.

Наші додатки для Odoo

Інтеграція з Telegram

Асистент на основі штучного інтелекту

Переклад на основі штучного інтелекту

Інтеграція з Viber

Повнотекстовий пошук

Хаб маркетингу 

Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.