lamapixel
0%
E-commerce · 7 min чтения

Shoptet API и подключение к Pohoda: что автоматизируется, а что останется вручную

Как работает Shoptet API, почему ключ не получает владелец магазина и чем именно Shoptet обменивается с Pohoda. Включая список данных, которые не переносятся.

Shoptet API и подключение к Pohoda: что автоматизируется, а что останется вручную

Заказы, клиенты и остатки на складе между 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. Прежде чем подписать, требуйте показать это на ваших данных, а не на демо.

Пять вопросов, по которым поймёте, делал ли это подрядчик на самом деле

Работают на ком угодно, включая нас. Ответы запрашивайте письменно.

  1. Какие дополнения у меня должны быть активны и сколько я за них плачу в месяц?
  2. Что именно идёт в каждую сторону и что не переносится вообще?
  3. Что произойдёт с заказом, который клиент после переноса изменит?
  4. Кто прав об остатке на складе, когда обе стороны разойдутся?
  5. Где будет работать mServer и что будет, если эта машина окажется выключена?

Интеграцию покупают не по тому, что она умеет перенести. Её покупают по тому, что произойдёт с данными, когда обе стороны разойдутся. Подрядчик, который ответит на это одной фразой, такого пока не переживал.

Скажем заранее, что будет синхронизироваться, а что нет

Автоматизированное подключение магазина к бухгалтерии, складу и фидам поставщиков - наша обычная работа, и найдёте её на странице автоматизации и интеграции. Напишите нам, в каком варианте Pohoda вы ведёте учёт и сколько у вас позиций, и получите разбивку на три столбца: двусторонне, односторонне, вручную.

Если из этого выйдет, что вам хватит готового дополнения из marketplace, мы вам это скажем и предложение писать не будем. Полный перечень того, что мы автоматизируем, на той же странице.

Напишите на info@lamapixel.com или звоните +420 775 599 009.

Нужна помощь?

Напишите нам - вместе найдём решение.

Назначить консультацию →