База знань Kiero OMS.

Відкрийте Налаштування → Інтеграції → Додати інтеграцію → PrestaShop. Кожен клієнт використовує URL і Webservice-ключ власного магазину. Участь у пілоті та модуль Kiero не потрібні. Підключення потребує прав власника або адміністратора організації; публікація також потребує права запису до товарів. У demo-організації підключення недоступне.

Можливості й обмеження

Імпорт замовлень обраних статусів: покупець, адреси доставки й рахунку, позиції, валюта, суми, податки та підтвердження оплати. Публікація товарів OMS: опис, SKU/EAN, категорія, мова, податок, фото, ціни, залишки та варіанти з наявними атрибутами магазину. Окрема синхронізація цін і залишків охоплює лише товари, опубліковані цим конектором; обидві опції спочатку вимкнені.

Перевірено PrestaShop 9.1.5. Інші версії потребують перевірки; публікація використовує PATCH. Не підтримуються імпорт усього каталогу, створення атрибутів, повернення, передавання статусів замовлень і трекінгу до магазину, webhooks, конвертація валют, спільні та розширені складські залишки.

1. Увімкніть Webservice та створіть ключ

У панелі PrestaShop відкрийте Advanced Parameters → Webservice.
Встановіть Enable PrestaShop's webservice → Yes і збережіть. Повідомлення «This functionality has been disabled» може означати, що головний перемикач вимкнений. Активний ключ сам не вмикає службу.
Натисніть Add new webservice key, згенеруйте ключ із 32 символів, додайте опис «Kiero OMS», увімкніть ключ і надайте права з таблиці. Збережіть.
Не обирайте «All»: PUT і DELETE не потрібні.

Призначення	Ресурси	Методи
Підключення й замовлення	shops, orders, customers, addresses, countries, currencies, carriers, order_states	GET
Автовизначення часового поясу	configurations	GET; необов’язково лише для імпорту
Товари	products	GET, POST, PATCH
Зображення	images	GET, POST
Залишки	stock_availables	GET, PATCH
Налаштування й довідники публікації	configurations, languages, categories, shop_groups, currencies, tax_rule_groups, tax_rules, taxes	GET
Варіанти	combinations	GET, POST, PATCH
Атрибути варіантів	product_options, product_option_values	GET

Вставляйте ключ лише у форму Kiero. Не додавайте його до URL, повідомлень, скриншотів чи опису товару. Ключ зберігається зашифрованим на сервері. Якщо його розкрито, створіть новий, замініть у налаштуваннях інтеграції, перевірте підключення та вимкніть старий.

2. Перевірте хостинг

Потрібний публічний HTTPS URL, наприклад https://your-shop.com або https://your-shop.com/shop/; закінчення /api/ розпізнається автоматично. Не використовуйте localhost, приватні IP, логін/пароль, query/fragment чи нестандартний порт. TLS-сертифікат має бути чинним.

Хостинг повинен передавати Authorization і підтримувати GET, а для публікації — POST/PATCH. Зовнішній Basic Auth перед /api конфліктує з Webservice-ключем. Попросіть адміністратора залишити API під перевіркою ключа PrestaShop, зберігши захист вітрини й адміністративної панелі. Не вимикайте захист усього магазину. CGI змінюйте лише відповідно до фактичного налаштування PHP.

3. Підключіть магазин у Kiero

Вкажіть назву, URL і ключ, завантажте доступні магазини та статуси замовлень.
Оберіть правильний магазин; за кількох доступних вибір обов’язковий. Публікація не підтримує спільний залишок групи магазинів.
Явно позначте статуси для імпорту, виключивши скасовані й повернені. Назви залежать від магазину; початкового автоматичного вибору немає.
Перевірте фактичний часовий пояс IANA, наприклад Europe/Kyiv. Якщо його не отримано з конфігурації, введіть вручну. Помилка зміщує період імпорту.
Оберіть юридичну особу своєї організації та дату початку імпорту. Початок дати зберігається як 00:00 UTC.
Перевірте автоматичний імпорт і збережіть. Для нових підключень він увімкнений за замовчуванням; старі можуть залишатися ручними. Збереження не запускає імпорт негайно: скористайтеся ручною синхронізацією або дочекайтеся розкладу, зазвичай близько п’яти хвилин плюс обробка черги.
Запустіть перевірку підключення та імпорт. У Замовленнях звірте кілька записів: позиції, адреси, валюту, доставку й оплату.

Після зміни URL/ключа завантажте магазини й статуси повторно. Повторний імпорт не має створювати дубль або вдруге списувати залишок. За неповного імпорту усуньте причину та повторіть. Підтвердження оплати залежить від оплаченого статусу й фактичної суми; нестандартні платіжні модулі потребують перевірки.

4. Опублікуйте товар

Підготуйте назву, унікальний SKU, необов’язковий коректний EAN-13, опис і публічні HTTPS-фото. До 10 JPEG/PNG/WebP, кожне до 8 MiB.
У Товарах оберіть один або до 20 товарів, Опублікувати → PrestaShop і потрібне підключення.
Оберіть наявні мову, категорію та перевірену податкову групу магазину. Відсутність податку обирайте свідомо; складні регіональні ставки не вгадуються.
Вкажіть брутто-ціни у валюті магазину й невід’ємні цілі кількості. Kiero обчислює нетто для PrestaShop. Зміна валюти не конвертує суму.
Для кількох варіантів зіставте кожен із наявними значеннями атрибутів. Відсутні атрибути спочатку створіть у PrestaShop. Набори мають відрізнятися, але охоплювати однакові групи атрибутів.
Типово товар неактивний. Позначте активацію лише якщо він має стати доступним після перевірки.
Надішліть завдання, дочекайтеся успіху операції та перевірте товар у PrestaShop. Прийняття до черги ще не означає публікацію.

Спочатку створюється неактивний товар, потім варіанти, фото, залишки й зв’язки, лише після цього можлива активація. Від’ємна різниця ціни варіанта правильна, якщо він дешевший за базовий товар. Повторна публікація того самого товару в тому самому підключенні використовує існуючу операцію. Її набір даних незмінний: Retry не редагує опис, категорію чи обрані значення.

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

У налаштуваннях інтеграції окремо ввімкніть ціни та залишки. Джерело значень — товар/варіант OMS; уникайте одночасного запису цих полів іншою системою. Спочатку перевірте один товар, зокрема залишок нуль. Оновлення виконує черга за розкладом, не миттєво після редагування.

Охоплено лише товари, опубліковані конектором, а не весь наявний каталог магазину. Залишок — абсолютна кількість, ціна варіанта — різниця щодо базової. Загальний одиночний/масовий редактор цін і залишків оферт не записує PrestaShop: змінюйте товар OMS та використовуйте синхронізацію інтеграції. Описів, категорій і фото цей розклад не оновлює.

6. Усунення проблем

Ознака	Дія
Webservice disabled	Увімкніть і збережіть головний перемикач, перевірте активність ключа.
401 / 403	Перевірте ключ, права, передавання Authorization та зовнішній Basic Auth/WAF із хостингом.
Немає прав публікації	Додайте права за таблицею; для варіантів потрібні combinations і довідники атрибутів.
Валюта/податок не збігаються	Використовуйте валюту магазину й підтримувану групу; не перейменовуйте валюту без зміни суми.
Фото недоступне	Відкрийте без входу; перевірте HTTPS, формат, розмір і блокування хостингу.
Shared/advanced stock	Використовуйте підтримувані незалежні залишки або перегляньте модель складу; не обирайте довільний запис.
Failed	Усуньте причину й повторіть; не створюйте нове підключення для обходу помилки.
Reconciliation required	Не публікуйте копію. Відповідь могла загубитися після запису. Підтримка має порівняти IDs і стан операції. Невідомий результат upload фото потребує ручної звірки; Retry сам його не вирішує.
Немає замовлення	Перевірте магазин, статуси, дату, пояс, активність інтеграції, доступ за підпискою та результат черги; потім повторіть.

До Підтримки передайте назву інтеграції, версію PrestaShop, час, IDs товару/замовлення/завдання та безпечну помилку. Не передавайте ключ.

7. Пауза та відключення

Вимкніть автоматичні замовлення й синхронізацію цін/залишків, щоб зупинити розклади. Призупиніть інтеграцію для наступних завдань; це не скасовує завершених операцій або вже надісланих запитів. Імпортовані дані OMS і товари магазину залишаються. Видалення підключення не видаляє товари PrestaShop. Після завершення користування вимкніть/видаліть окремий ключ у PrestaShop.

Статус дорожньої карти означає доступність функції. Контрольну перевірку 9.1.5 виконано 27 жовтня 2026; вона не підтверджує всі версії та конфігурації магазинів.