Замовлення, клієнти і залишки на складі між Shoptet і Pohoda переносити вміють. Зображення, параметри товарів, гарантії та правки вже надісланих замовлень - ні. А доступ до API отримує не власник магазину, а схвалене доповнення, і ця деталь змінює все завдання.
Ця стаття не інструкція зі встановлення. Це перелік того, чого в пропозиціях на інтеграцію зазвичай не пишуть, і питання, якими ви це перевірите до того, як підпишете.
Ключ до API отримаєте не ви, а доповнення з marketplace
У Shoptet є REST API, яке працює в JSON і служить для читання та зміни даних магазину. Але доступ до нього не вільний. Документація каже прямо: «The API is not freely accessible, it is currently available for developers of so-called addons, which are published at the marketplace» (developers.shoptet.com, знято 31. 8. 2026).
Практично це три шляхи, і жоден не виглядає як «дайте нам ключ»:
- ви ставите готове доповнення з marketplace, і підключення вирішує його автор,
- ви замовляєте розробку доповнення, що вимагає схвалення і договору з Shoptet,
- ви на Shoptet Premium, який дає приватний доступ до даних через API за замовленнями, клієнтами, товарами і запасами.
Авторизація йде через OAuth2. Доповнення отримує під час встановлення постійний токен і з нього здобуває короткострокові токени доступу терміном 30 хвилин. Сам Shoptet при цьому попереджає, що API не призначене для правок фронтенду магазину.
Ліміти API ви помітите на великому каталозі, а не на тесті
Rate limiter описаний числами, тож із ним можна рахуватися заздалегідь. У кожного застосунку є відро місткістю 200 крапель, і щосекунди з нього забирається 10 крапель; складніший виклик витрачає більше. Коли відро повне, приходить HTTP 429 і треба чекати.
До цього ліміти паралельності: 50 з'єднань з однієї IP-адреси і 3 з'єднання на один API-токен. Блокування проти дублювального запису в методів POST, PUT, PATCH і DELETE повертають 423 і тримають щонайбільше 5 секунд. У кожної пари доповнення-проєкт своє відро, тож два доповнення ліміт одне в одного не забирають (developers.shoptet.com, знято 31. 8. 2026).
Чому це має знати власник магазину, а не лише програміст: ці числа визначають, чи перепишуться двадцять тисяч позицій за хвилину, чи за ніч. На каталозі до кількох сотень товарів лімітів ви не відчуєте взагалі.
Між Shoptet і Pohoda іде лише частина даних, і в кожен бік своя
Підключення до Pohoda вирішує доповнення. Офіційна «Pohoda» в marketplace вміє, судячи з опису, двосторонній перенос товарів, запасів, замовлень, клієнтів, податкових документів, авансових рахунків і кредит-нот. На боці Pohoda потрібна функція Internetové obchodování, яка є у варіанті Jazz і вище, і рекомендована версія 12008.7 (podpora.shoptet.cz, знято 31. 8. 2026).
| Напрямок | Що переноситься |
|---|---|
| Pohoda → Shoptet | залишки на складі, зміна замовлення на Vyřízena |
| Pohoda → Shoptet | клієнти, у яких заповнений e-mail |
| Shoptet → Pohoda | нові замовлення разом із позиціями |
| Shoptet → Pohoda | клієнти з адресної книги, доставка і оплата |
| Shoptet → Pohoda | опис, ціни, EAN, PLU, вага, ознаки |
Для переносу складських запасів має бути активним доповнення Skladové hospodářství. Воно коштує 200 Kč на місяць, а в тарифі Business і вище безкоштовне (doplnky.shoptet.cz, знято 31. 8. 2026).
Що не переноситься, хоча ви цього від інтеграції чекаєте
Це ядро всієї статті, і в пропозиціях його зазвичай опускають, бо воно погано продається. За документацією Shoptet не переносяться:
- зображення товарів і файли,
- параметри товарів і гарантії,
- супутні та альтернативні товари,
- варіанти як варіанти; з Pohoda вони прийдуть окремими картками,
- зміни вже перенесеного замовлення, Pohoda оновлення не приймає,
- видалення категорії, категорії лише створюються.
До цього чотири технічні пастки, на яких інтеграція тихо пропустить позицію: синхронізуються лише запаси типу Karta, PLU довше за 6 знаків не пройде, у EAN стеля 14 знаків, назва адреси в Pohoda 25 знаків, а IČO має збігатися з обох боків точно (podpora.shoptet.cz, знято 31. 8. 2026).
Найдорожчий передостанній пункт списку. Замовлення, яке вже є в Pohoda, інтеграція не виправить. Зміна після переносу вирішується сторнувальним документом і новим записом, тобто вручну і з ризиком двох нумерацій.
Pohoda працює на комп'ютері, і це визначає, як часто дані зустрінуться
Pohoda не хмарний сервіс. Зв'язок ведеться через POHODA mServer, який приймає XML по HTTP методом POST; GET не підтримується, а XML-обмін треба дозволити в правах користувача (stormware.cz, знято 31. 8. 2026).
Звідси операційна умова, яку під час постановки задачі мало хто усвідомлює: десь має працювати машина з Pohoda і бути доступною тоді, коли магазин запитає дані. Вимкнений офісний комп'ютер у п'ятницю ввечері означає, що суботні замовлення потраплять у бухгалтерію в понеділок.
Другий наслідок проєктний. У складу один господар, і зазвичай це Pohoda. Магазин тоді поводиться як вітрина, а не як база даних, і рішення про те, хто має рацію при розбіжності, ухвалюється на початку, а не під час рекламації. Цю частину вирішуємо на сторінці про підключення до ERP і CRM.
Перш ніж платити за роботу, порахуйте місячні платежі за доповнення
В інтеграції дві ціни, і менша видно одразу. Доповнення Pohoda коштує 200 Kč на місяць, у тарифі Profi і вище безкоштовне; Skladové hospodářství ще 200 Kč на місяць, безкоштовно від тарифу Business (doplnky.shoptet.cz, знято 31. 8. 2026). До цього сам тариф: Shoptet Business вийде в 1 490 Kč на місяць без DPH, Profi в 2 490 Kč (shoptet.cz/cenik, знято 31. 8. 2026).
У marketplace поруч з офіційним доповненням є і рішення третіх сторін, серед іншого Pohoda by ShopSync і Pohoda by Dominik Prajzler. Відрізняються вони охопленням зіставлення і мірою доопрацювань, а не принципом: усе одно це доповнення, яке має доступ до API, і mServer з іншого боку.
Розбір усього місячного рахунку за магазин, тобто тариф, комісії, доставку і застосунки, розбираємо окремо у статті про щомісячні витрати магазину.
Що майже завжди залишається вручну
Не тому, що це не можна запрограмувати, а тому, що за вас цього ніхто не вирішить. Ось роботи, які після ввімкнення інтеграції залишаються людям:
- Каталог. Зображення, параметри й описи ведуться в магазині.
- Правки замовлень. Після переносу вирішуються документом, а не редагуванням.
- Розбіжності складу. Хтось має щотижня проходити позиції, де числа розійшлися.
- Нові категорії і зіставлення. Виникає вручну, бо це комерційне рішення, а не технічний перенос.
З податковими документами будьте особливо обережні. Опис доповнення їхній перенос зазначає, але у відгуках у marketplace трапляється закид, що документи не зіставляються і частина роботи робиться експортом та імпортом XML. Перш ніж підписати, вимагайте показати це на ваших даних, а не на демо.
П'ять питань, за якими зрозумієте, чи робив це підрядник насправді
Працюють на будь-кому, включно з нами. Відповіді запитуйте письмово.
- Які доповнення в мене мають бути активні і скільки я за них плачу на місяць?
- Що саме йде в кожен бік і що не переноситься взагалі?
- Що станеться із замовленням, яке клієнт після переносу змінить?
- Хто має рацію щодо залишку на складі, коли обидві сторони розійдуться?
- Де працюватиме mServer і що буде, якщо ця машина виявиться вимкненою?
Інтеграцію купують не за тим, що вона вміє перенести. Її купують за тим, що станеться з даними, коли обидві сторони розійдуться. Підрядник, який відповість на це однією фразою, такого поки не переживав.
Скажемо заздалегідь, що синхронізуватиметься, а що ні
Автоматизоване підключення магазину до бухгалтерії, складу і фідів постачальників - наша звична робота, і знайдете її на сторінці автоматизації та інтеграції. Напишіть нам, у якому варіанті Pohoda ви ведете облік і скільки у вас позицій, і отримаєте розбивку на три стовпці: двосторонньо, односторонньо, вручну.
Якщо з цього вийде, що вам вистачить готового доповнення з marketplace, ми вам це скажемо і пропозицію писати не будемо. Повний перелік того, що ми автоматизуємо, на тій самій сторінці.
Напишіть на info@lamapixel.com або телефонуйте +420 775 599 009.
