Модуль Prom

Можливі помилки під час інтеграції

Використання модуля Prom у K2 ERP

Для K2 ERP компонент Prom доцільно реалізовувати як окремий канал продажів із власними налаштуваннями API, типом цін, складами, правилами синхронізації, журналом обміну, обробкою помилок і зв’язком із доставкою, оплатами та фіскалізацією. Окремо варто відзначити цінами, залишками, замовленнями, статусами, доставкою, оплатами і іншими даними інтернет-продажів. Типовий сценарій експорту товарів з K2 ERP у Prom здатна виглядати так: Типовий сценарій обробки замовлення з Prom у K2 ERP здатна виглядати так:

Інтеграція з Укрпоштою в Python

API-токен Prom

У журналі бажано зберігати:

назва товару;
артикул;
SEO-опис;
ціна;
стара ціна;
залишок;
статус наявності;
категорія;
характеристики;
одиниця виміру;
фото;
бренд;
гарантія;
мінімальна кількість для замовлення;
додаткові параметри залежно від API. Рекомендація: компонент Prom має мати механізм повторної обробки помилок. Його не можна передавати стороннім особам, публікувати в коді, зберігати у відкритих файлах або виводити в логах. Для B2C-продажів через Prom здатна бути потрібна фіскалізація розрахункових операцій через РРО або ПРРО. :contentReference [oaicite:2]{index=2}

передавання товарів з ERP на Prom;
оновлення версій назв, описів, фото і характеристик;
синхронізація цін;
синхронізація залишків;
отримання замовлень з Prom;
створення замовлень клієнта в ERP;
створення або оновлення версій картки клієнта;
передавання статусів замовлень назад у Prom;
передавання номерів ТТН;
контроль оплат;
контроль доставки;
передавання даних для фіскалізації;
зберігання історії обміну;
обробка помилок інтеграції. ERP або CRM здатна бути головною системою для товарів, цін, залишків, клієнтів, документів, оплат, складів і фіскалізації, а Prom — каналом продажів і вітриною для покупців. # користувач системи створює або оновлює товар у K2 ERP. # платформа зіставляє товари за артикулом або ID Prom. компонент Prom потрібен для автоматизації роботи з маркетплейсом і зменшення ручної обробки даних. # компонент Prom отримує нове замовлення через API. # платформа формує документ продажу. :contentReference [oaicite:0]{index=0}

Tilda Commerce

доступ до API-токена;
права користувачів;
строк дії токена;
журнал дій;
обмеження доступу до налаштувань;
шифрування секретів;
захист логів;
резервне копіювання налаштувань;
блокування доступу звільнених працівників;
розмежування прав між менеджерами й адміністраторами;
контроль змін цін і залишків. Він дає можливість синхронізувати товари, ціни, залишки, отримувати замовлення, передавати статуси, ТТН і забезпечувати зв’язок онлайн-продажів з внутрішнім обліком компанії. # Номер фіскального чека зберігається в ERP. Це дозволить відрізняти ціни маркетплейсу від роздрібних, гуртових або внутрішніх цін.

Не плутати: компонент Prom — це не без зусиль імпорт замовлень. # Формується відвантаження. # Prom повертає результат обробки.

У ERP на підставі замовлення Prom здатна створюватися:

Не плутати: API-токен — це ключ доступу до даних магазину. # Якщо товару немає, платформа створює нову картку.== Синхронізація товарів ==

Типовий сценарій синхронізації товарів

Журнал обміну потрібен для контролю інтеграції та швидкого пошуку помилок. У кабінеті компанії Prom можна створити токен для інтеграції з CRM, ERP або іншими зовнішніми системами. Можливі сценарії:

компонент Prom здатна враховувати способи оплати та статуси оплат. Це дає можливість уникати дублювання і правильно оновлювати статуси. # Виконується фіскалізація через РРО або ПРРО. * конфігурація підключення до Prom;

зберігання API-токена;
вибір складів для залишків;
вибір типу цін для Prom;
зіставлення категорій;
зіставлення характеристик;
зіставлення товарів за артикулом або ID;
експорт товарів;
оновлення версій цін;
оновлення версій залишків;
імпорт замовлень;
створення документів замовлення клієнта;
резервування товарів;
передавання статусів назад у Prom;
передавання ТТН;
інтеграцію з доставкою;
інтеграцію з оплатами;
фіскалізацію;
журнал технічного обміну. # Статус замовлення оновлюється. У K2 ERP це здатна працювати так:

Висновок

спосіб оплати;
статус оплати;
суму замовлення;
суму передоплати;
суму післяплати;
комісію за потреби;
дату оплати;
платіжний сервіс;
ідентифікатор платежу;
зв’язок з касовим або банківським документом. Він застосовується для для автоматизації роботи з товарами. # Статус і номер ТТН передаються назад у Prom.== Оплати ==

Інтеграція з Prom, Rozetka, Hotline

ID магазину Prom;
API-токен;
ID товару Prom;
артикул товару;
статус синхронізації товару;
дату останнього оновлення версій товару;
номер замовлення Prom;
ID замовлення Prom;
дату замовлення;
статус замовлення Prom;
статус замовлення ERP;
покупця;
телефон покупця;
спосіб доставки;
спосіб оплати;
номер ТТН;
статус оплати;
статус фіскалізації;
номер фіскального чека;
текст помилки API;
журнал запитів і відповідей;
кількість спроб синхронізації.ЕДО

Безпека інтеграції

залежність від API Prom;
потребу в API-токені;
строк дії API-токена;
потребу в правильному зіставленні товарів;
різницю категорій ERP і Prom;
різницю характеристик;
можливі помилки в артикулах;
потребу в контролі залишків;
потребу в обробці дублювань;
потребу в тестуванні перед масовим експортом;
ризик оновлення версій неправильних цін;
ризик передавання неправильних залишків. Для K2 ERP: Prom варто розглядати як зовнішній канал продажів.РРО

конкурентні переваги модуля Prom

критично: компонент Prom не замінює ERP або CRM.SaaS

Під час роботи модуля Prom можуть виникати такі помилки:

OpenCart Із замовлення можуть завантажуватися:

Для облікової системи: критично не без зусиль імпортувати замовлення, а зберігати ідентифікатор Prom. Для токена задаються назва, строк дії та права доступу до груп методів: читання, читання і запис або відсутність доступу.== Загальний SEO-опис ==

Джерела

Журнал обміну

ERP виступає як головним джерелом цін;
ціни на Prom оновлюються за розкладом;
ціни оновлюються після зміни в ERP;
для Prom застосовується для окремий тип цін;
ціна залежить від акцій або знижок;
частина товарів не синхронізується автоматизовано;
ціни округлюються за правилами магазину. # Якщо товар існує, платформа оновлює його інформаційні дані. * менше ручного введення;
швидше оновлення версій товарів;
актуальні ціни;
актуальні залишки;
автоматичне отримання замовлень;
менше помилок менеджерів;
швидша обробка замовлень;
контроль статусів;
передавання ТТН;
зв’язок із оплатами;
зв’язок із фіскалізацією;
централізований обліковий облік у ERP;
прозорий журнал інтеграції. # K2 ERP зберігає ідентифікатор товару Prom.Технічне завдання: інтеграція ПРРО Checkbox для Python

Для чого потрібен компонент Prom

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

інформаційні дані, які бажано зберігати в ERP

Типові задачі зі статусами:

службу доставки;
тип доставки;
відділення;
поштомат;
адресу;
місто;
отримувача;
телефон отримувача;
номер ТТН;
статус доставки;
дату відправлення;
дату отримання;
вартість доставки. Повноцінна інтеграційні функції ERP має охоплювати товари, ціни, залишки, замовлення, статуси, доставку, оплату, фіскалізацію та журнал помилок. # Менеджер перевіряє оплату і доставку. * дату і час запиту;
напрям обміну;
тип операції;
об’єкт обміну;
ідентифікатор Prom;
ідентифікатор ERP;
статус операції;
текст помилки;
технічну відповідь API;
користувача або сервіс, який запустив обмін;
кількість повторних спроб;
результат повторної обробки. Синхронізація цін потрібна для того, щоб на Prom відображалися актуальні ціни з ERP або CRM. # платформа перевіряє артикул, назву, категорію, ціну, залишок і фото. До основних переваг модуля Prom можна віднести:

Без інтеграції менеджерам доводиться вручну переносити товари, ціни, залишки й замовлення між Prom та обліковою системою. # Товари резервуються на складі. # ERP перевіряє оплату. # За потреби чек надсилається покупцю.

ДПС

Prom підтримує конфігурація обліку залишків у кабінеті компанії. ERP має бути головною системою для товарів, залишків, цін, документів, оплат і фіскалізації, а Prom — вітриною та джерелом замовлень. Рекомендація: у K2 ERP бажано мати окреме правило ціноутворення для Prom. * отримати нове замовлення з Prom;

змінити статус в ERP;
передати статус назад у Prom;
передати номер ТТН;
повідомити покупця;
зафіксувати причину скасування;
не оновлювати закриті замовлення без потреби. Одна з ключових функцій модуля — отримання замовлень з Prom в ERP. Він виступає як інтеграційним шаром, який синхронізує інформаційні дані між обліковою системою та Prom.ua, щоб зменшити ручне введення товарів, цін, залишків і замовлень.

В ERP бажано зберігати:

Покупець оформлює замовлення на Prom. компонент Prom автоматизує обмін даними. У довідці Prom зазначено, що обліковий облік залишків вмикається в розділі «конфігурація — Залишки товарів», після чого можна налаштовувати автоматичний перерахунок залишків, зміну статусу і відображення залишків на картці товару. як приклад, якщо API тимчасово недоступне, платформа повинна повторити запит пізніше, а не втрачати замовлення або оновлення версій товару. :contentReference [oaicite:1]{index=1}

замовлення клієнта;
картка клієнта;
резерв товару;
задача на пакування;
документ оплати;
документ доставки;
фіскальний чек;
видаткова накладна.== Отримання замовлень ==

Зверніть увагу: конкретні функції ERP модуля Prom залежать від API Prom, прав API-токена, тарифу, налаштувань кабінету компанії, структури товарів, способів доставки, оплат і бізнес-логіки ERP.== Обмеження та ризики ==

компонент Prom здатна працювати з доставкою та номерами ТТН.

Практичне сценарії використання: компонент Prom особливо корисний для магазинів із великим каталогом, частими змінами цін, складськими залишками, великою кількістю замовлень і потребою оперативно оновлювати інформаційні дані на Prom.ua.

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

Фіскалізація замовлень Prom

компонент Prom здатна оновлювати залишки:

Типова реалізація здатна включати:

нове;
прийнято в роботу;
очікує оплати;
оплачено;
резерв;
комплектується;
передано на складський облік;
відправлено;
виконано;
скасовано;
повернення;
помилка обробки. У модулі Prom бажано зберігати:

компонент Prom — це інтеграційний компонент для автоматизації обміну між ERP або CRM і маркетплейсом Prom.ua. # Створюється ТТН.== Основні функції ERP ==

B2C інформаційні дані доставки можуть включати:

Типові статуси в ERP:

назву підключення;
API-токен;
строк дії токена;
магазин або компанію Prom;
права доступу;
дату останньої перевірки;
статус підключення;
користувача, який налаштував інтеграцію;
журнал помилок авторизації. Синхронізація товарів дає можливість передавати асортимент з ERP на Prom або отримувати товари з Prom в облікову систему. Prom.ua застосовується для як канал онлайн-продажів. Для інтеграції з CRM, ERP або іншими зовнішніми системами в кабінеті Prom створюється API-токен із налаштованими правами доступу. * за всіма складами;
за вибраним складом;
за віртуальним складом Prom;
з урахуванням резервів;
з урахуванням неоплачених замовлень;
з урахуванням мінімального залишку;
з округленням або обмеженням показу залишку;
з автоматичним вимкненням товару при нульовому залишку. обміну даними між ERP забезпечується через компонент Prom — це інтеграційний компонент; так само реалізовано CRM або обліковою системою та маркетплейсом Prom.ua. Для безпечної роботи модуля Prom потрібно контролювати:

Доставка і ТТН

API-токен недійсний;
строк дії токена завершився;
недостатньо прав доступу;
API тимчасово недоступне;
товар не знайдено;
дублюється артикул;
не зіставлена категорія;
не зіставлена характеристика;
не завантажується фото;
неправильна ціна;
неправильний залишок;
замовлення вже імпортоване;
товар із замовлення не знайдено в ERP;
неправильний спосіб доставки;
неправильний спосіб оплати;
не передано номер ТТН;
статус не оновився;
помилка фіскалізації;
перевищено ліміт запитів або виникла технічна помилка обміну. Це створює ризик помилок: застарілі ціни, неправильні залишки, дублювання замовлень, несвоєчасне оновлення версій статусів і проблеми з відвантаженням. Для роботи модуля потрібен API-токен Prom. # платформа створює замовлення клієнта.Інтеграція РРО в Python

компонент Prom здатна забезпечувати такі функції ERP:

З ERP у Prom можуть передаватися:

номер замовлення Prom;
дата і час створення;
статус замовлення;
покупець;
телефон;
email;
адреса доставки;
спосіб доставки;
спосіб оплати;
список товарів;
кількість;
ціна;
знижки;
загальна сума;
коментар покупця;
службові примітки;
номер ТТН;
статус оплати;
джерело замовлення. Основні задачі модуля:

ідентифікатор товару Prom;
назва;
артикул;
ціна;
залишок;
статус;
посилання на товар;
категорія;
замовлені позиції.== Статуси замовлень ==

Для якісної інтеграції з Prom в ERP бажано зберігати: З Prom в ERP можуть завантажуватися:

Prom має публічне API, яке дає можливість компаніям, зареєстрованим на порталі, отримувати віддалений доступ до керування даними в Кабінеті компанії через власний програмний інтерфейс. # компонент Prom визначає, чи товар уже існує на Prom. # K2 ERP перевіряє, чи замовлення вже не імпортоване. # У журналі обміну зберігається статус і можливі помилки. # За потреби виконується фіскалізація.== Див. так само ==

підключення одного або кількох магазинів Prom;
конфігурація API-токена;
імпорт товарів з Prom;
експорт товарів у Prom;
оновлення версій товарних карток;
синхронізація цін;
синхронізація залишків;
отримання нових замовлень;
оновлення версій статусів замовлень;
передавання номерів ТТН;
зіставлення товарів за артикулом або ідентифікатором;
зіставлення категорій;
зіставлення характеристик;
зіставлення способів доставки;
зіставлення способів оплати;
журнал API-запитів;
повторна відправка після помилки;
ручний і автоматичний режим синхронізації. У сценаріях інтеграції часто потрібно передавати номер ТТН з ERP або CRM назад у Prom, щоб покупець і магазин бачили статус відправлення.

Синхронізація цін

Синхронізація залишків

Інтеграція з Новою поштою в Python

Під час впровадження модуля Prom потрібно враховувати: