Интеграция Flowwow с учётной системой: пять проблем при работе с Seller API

Если вы владелец магазина, а не разработчик и просто хотите, чтобы заказы с площадки сами попадали в складскую систему, — вам сюда: что входит в подключение и сколько стоит. Статья ниже техническая, она для тех, кто будет делать интеграцию руками или принимать её у подрядчика.

Подключиться к Flowwow Seller API несложно: получить токен, забрать список заказов, разложить их по своей системе. Первый заказ приезжает в учёт в тот же день, и кажется, что задача решена.

Дальше выясняется, что суммы не сходятся с личным кабинетом, из заказа пропадают позиции, а отгрузка списывает не то, что нужно, — и делает это молча, без ошибок в логах.

Ниже пять случаев из наших интеграций. Всё описанное — наблюдения на конкретных проектах по состоянию на сентябрь 2026 года, а не заявления о том, как площадка устроена внутри. Если делаете сами, проверьте у себя каждый пункт: это те места, где мы теряли время.

1. Цена в позиции приходит без учёта скидки

Площадка отдаёт order.price и products[].price как цену до применения скидки. Сама скидка лежит отдельным полем, в процентах.

Если записать цену как есть, суммы в учётной системе окажутся завышены. Расхождение всплывает не сразу — обычно когда бухгалтерия начинает сверять выручку с отчётом площадки.

Сумма с учётом скидки считается как цена × (1 − скидка / 100). Отметим отдельно: это ещё не вся стоимость заказа — платная открытка, о которой ниже, в общую сумму тоже не входит.

Что проверить перед приёмкой: взять заказ со скидкой и сверить три числа — сумму в кабинете площадки, сумму в учётной системе и то, что пришло в API. Если первые две расходятся, причина здесь.

2. Открытки: бесплатная теряется, платная не входит в сумму

Открытка приходит в заказе позицией с типом type=3, и с ней две разные проблемы.

Бесплатная открытка в наших интеграциях не доезжала до учётной системы вовсе, хотя товар в каталоге у продавца заведён. Флорист собирает букет и не знает, что к нему нужна открытка с текстом, — покупатель получает букет без поздравления.

Причина в том, что метод получения товаров не возвращает позиции, помеченные неактивными, а бесплатные открытки у продавцов обычно именно такие. Запросить их каталогом не выходит — товар нужно один раз завести в учётной системе руками и связать по идентификатору.

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

Что проверить: сделать тестовый заказ с бесплатной открыткой и с платной. Убедиться, что обе доехали и что итог сходится с кабинетом.

3. Архивная карточка перехватывает комплект

Оговоримся сразу: это находка не про Flowwow, а про МойСклад и алгоритм сопоставления товаров. Если у вас другая учётная система, проверьте, как она ведёт себя в аналогичной ситуации.

Флорист переводит товар в комплект — букет теперь собирается из компонентов: розы, зелень, упаковка. МойСклад при этом архивирует старую карточку простого товара, а не удаляет её.

Дальше интеграция ищет товар по идентификатору и находит две карточки: живой комплект и архивный товар. Если алгоритм отдаёт предпочтение простому товару, отгрузка спишет со склада букет целиком, а компоненты — цветы, из которых он собран, — не спишутся.

Учёт разъезжается тихо: в логах чисто, заказы обрабатываются, ошибок нет. Обнаруживается при инвентаризации, когда по документам роз на складе больше, чем в холодильнике.

Что проверить: взять товар, переведённый в комплект, провести по нему заказ и убедиться, что отгрузка списала компоненты, а не готовый букет.

4. История заказов доступна ограниченно

При переходе на автоматизацию хочется импортировать историю, чтобы в учётной системе не было разрыва.

Рассчитывать на это не стоит. В наших проверках метод просмотра заказа переставал возвращать данные примерно через восемь-пятнадцать дней, отдавая ошибку «не найдено». Причём независимо от судьбы заказа: доставленный и закрытый заказ после этого срока тоже переставал отдаваться.

Мы проверяли отдельно, не связано ли это с отменёнными заказами, — нет, поведение одинаковое. Утверждать, что именно происходит с данными на стороне площадки, мы не можем: наблюдаем только недоступность через API.

Что проверить: до планирования переноса запросить заказ месячной давности и посмотреть, что вернётся. От этого зависит, какую глубину истории вы вообще сможете импортировать.

5. Периодические ответы 423 на чтение заказов

При обработке нескольких заказов одновременно часть запросов на получение деталей возвращала HTTP 423.

Причину мы установить не смогли. Воспроизвести ошибку внешними запросами не удалось ни частотой, ни параллельностью; с нашим объёмом запросов появление 423 не коррелировало — приходило редкими окнами. Возможно, дело в защитном контуре на стороне площадки, но это предположение, а не проверенный факт, и мы отправляли вопрос в поддержку.

Что из этого следует для реализации: такие ответы нужно считать временными, а не фатальными. Заказ не должен «замерзать» из-за отказа — обработку следует повторить позже. И имеет смысл ограничивать число одновременных чтений, даже если формальные лимиты вы не превышаете.

Что это значит для проекта

Три случая из пяти не проявляются как ошибки. Ничего не падает, логи чистые — просто цифры перестают сходиться, а обнаруживается это через недели, на сверке или инвентаризации.

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

Если делаете сами — надеемся, список сэкономит вам пару недель. Если хотите, чтобы сделали за вас, посмотрите состав работ и условия сопровождения: подключение от 50 000 ₽, сопровождение 5 000 ₽/мес вместе с хостингом. Или напишите нам — разберём ваш случай и скажем, укладывается ли он в типовую работу.

Читайте также

• Flowwow + МойСклад: автоматизация заказов
• Постебельный учёт цветов: что автоматизируется, а что нет
• Как мы строим интеграции