integratorШАГ 1
Подключение к Flowwow
Добавьте кабинет продавца по API-токену и управляйте его активностью без потери настроек.Запросите у поддержки Flowwow API-токен продавца. Вставьте его в поле «API-токен Flowwow» и нажмите «Проверить токен». Если токен действителен, задайте понятное внутреннее название кабинета и сохраните его.
- Один токен относится к одному кабинету продавца Flowwow и может включать несколько магазинов.
- Для второго кабинета повторите операцию с его отдельным токеном.
- Отключите «Активен», чтобы приостановить кабинет без удаления настроек.
- Архив скрывает кабинет из рабочего списка, сохраняя настройки для восстановления.
В карточке кабинета указано, что токен сохранён, а количество магазинов определено автоматически.
ШАГ 2
Магазины
Проверьте состав кабинета и включите только те магазины, которые должны участвовать в обмене.Список магазинов загружается из Flowwow автоматически. Выберите кабинет и убедитесь, что нужные магазины появились. Отображаемое название можно изменить — это не меняет название магазина в Flowwow.
- ID магазина определяется автоматически и вручную не вводится.
- «Активен» означает, что магазин участвует в приёме и обновлении заказов.
- Временное отключение не удаляет настройки и товарные соответствия.
Повторно проверьте токен и убедитесь, что магазин действительно относится к выбранному кабинету Flowwow.
ШАГ 3
Настройки магазина
Свяжите магазин с реквизитами МоегоСклада и определите правила заполнения заказа.Основные реквизиты
- Организация и склад — обязательны.
- Контрагент — например, Flowwow.
- Проект — необязателен и используется для аналитики.
Статусы заказа
Для каждого статуса Flowwow выберите статус заказа покупателя в МоемСкладе. Если соответствие не задано, приложение один раз создаст служебный статус Flowwow и запомнит его.
Поля заказа
Можно выбрать поля для номера Flowwow, даты и времени доставки, текста открытки, имени и телефона покупателя, данных получателя, адреса и комментариев. Необязательные поля можно оставить пустыми.
Если они определены в Flowwow, приложение записывает их в стандартное поле «Плановая дата отгрузки». При необходимости значения можно продублировать в пользовательские поля.
ШАГ 4
Товары и услуги
Сопоставьте каталог Flowwow с позициями МоегоСклада и задайте общие правила синхронизации.Каталог обновляется автоматически один раз в 60 минут. Для немедленной проверки новых или изменённых позиций нажмите «Обновить сейчас». Ранее сохранённые соответствия не перезаписываются.
- По умолчанию отображаются только активные позиции Flowwow.
- Поиск в МоемСкладе работает по части артикула или названия.
- Если позиция уже сопоставлена, текущий товар показывается первым в окне выбора.
- Доставку, открытку и другие строки можно связать с обычным товаром или услугой.
- Несопоставленная позиция не блокирует запуск: при заказе приложение может создать её автоматически.
Выберите тип цены, проверьте склад в настройках магазина, включите нужные переключатели и нажмите «Сохранить». Подтвердите предупреждение. Первый обмен запускается в течение минуты, затем — раз в 60 минут. Результаты и ошибки появляются в «Логах».
Передаётся цена выбранного типа без изменения скидки Flowwow, только при совпадении валют. Нулевая или отсутствующая цена не передаётся. Доступный остаток — фактический остаток выбранного склада минус резерв, без ожидаемых поступлений; отрицательное значение превращается в ноль, дробное округляется вниз. Для комплектов учитываются компоненты, для услуг остатки не передаются.
Важно: ноль может скрыть товар в Flowwow, а скрытие всех товаров — отключить магазин. При ошибке чтения или отсутствии строки в отчёте ноль не отправляется. Открытие скрытого товара и магазина проверяйте в Flowwow отдельно.
Технические идентификаторы товаров создаются автоматически при первом включении обмена, если их ещё нет. Существующие идентификаторы сохраняются. Готовые товары типа «готовый товар» Flowwow не допускает к такой привязке — они пропускаются с сообщением в логах.
ШАГ 5
Запуск кабинета
Проверьте готовность и подключите один вебхук сразу для всех активных магазинов кабинета.- 1Выберите кабинет и нажмите «Проверить готовность кабинета».
- 2Исправьте обязательные настройки, если приложение покажет замечания.
- 3Нажмите «Показать URL и Secret» и скопируйте оба значения.
- 4Передайте их поддержке Flowwow и дождитесь подтверждения.
- 5Нажмите «Проверить подключение». Успешная проверка включает обработку активных магазинов кабинета. Убедитесь, что показан результат подключения.
Здравствуйте! Просьба подключить новый вебхук для кабинета продавца Flowwow.
URL вебхука: [вставьте URL из приложения]
Secret: [вставьте Secret из приложения]
Просьба подключить события заказов для всех магазинов кабинета и сообщить, когда вебхук будет готов к проверке.
РАБОТА СИСТЕМЫ
Как обрабатывается заказ
После подключения вебхука приложение поддерживает заказ в актуальном состоянии на всём жизненном цикле.Номер
МойСклад присваивает документу собственный номер, а номер Flowwow записывается в выбранное поле.
Реквизиты
Подставляются организация, склад, проект и контрагент, заданные для магазина.
Состав
Передаются позиции, фактическая стоимость, комментарии, открытка и доступные сведения о доставке.
Резерв
Товарные позиции заказа резервируются в МоемСкладе.
Обновление
Повторное событие изменяет существующий заказ и не должно создавать дубль.
Статус
Статус обновляется согласно соответствию, сохранённому в настройках магазина.
В дополнение к вебхукам каждые 5 минут выполняется сверка заказов, созданных за последние 9 дней. Заказы, завершение которых уже передано в МойСклад, повторно не обновляются. Первое изменение на «Выполнен» передаётся обязательно. При временной потере доступа задачи ждут восстановления подключения.
КОНТРОЛЬ
История заказов и логи
Два раздела помогают быстро понять, что произошло, и передать поддержке точные данные.История заказов
Показывает номер Flowwow, заказ в МоемСкладе, магазин, последнее событие, статус и результат обработки.
Логи
Содержат проверки системы, предупреждения, ошибки и код события. Секреты и токены в обращение не копируйте.
ДИАГНОСТИКА
Если что-то не работает
Сначала выполните короткую проверку — большинство вопросов решается без повторного подключения.Вставьте сам токен, а не временную ссылку. Если он отклонён, запросите проверку у поддержки Flowwow.
Проверьте кабинет и повторно проверьте токен.
Проверьте активность кабинета и магазина, вебхук, историю заказов и логи.
Откройте настройки именно того магазина, в котором создан заказ.
Обновите каталог сейчас и выберите позицию МоегоСклада по названию или артикулу.
Пн–Пт, 09:00–18:00 по Москве. Укажите кабинет, магазин, номер заказа Flowwow, время проблемы и код из логов.
ФИНАЛЬНАЯ ПРОВЕРКА