1. Flowbridge
  2. Подключение
  3. МойСклад

Как подключить Flowwow к МоемуСкладу

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

7 шагов ≈ 30 минут своего времени Обновлено
Содержание

    Что понадобится

    • Доступ администратора к аккаунту МоегоСклада. Устанавливать решения из каталога может только он.
    • Платный или пробный тариф МоегоСклада. На бесплатном решения из каталога не работают.
    • Кабинет продавца на Flowwow и почта или чат, через которые вы пишете в их поддержку.
    • Список своих складов и юрлиц: для каждого магазина Flowwow вы выберете, куда падают его заказы.

    Токен Flowwow выдаёт только их поддержка, и ждать его обычно приходится от 1 дня. Запросите его сегодня, ещё до установки приложения, чтобы подписка не шла вхолостую.

    Маршрут подключения

    Шаги 1 и 4 зависят от поддержки Flowwow, остальное делаете вы сами в окне приложения.

    ШАГ 1 ИЗ 7

    Запросите токен у Flowwow

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

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

    Письмо в поддержку Flowwow
    Здравствуйте!
    
    Мы подключаем интеграцию Flowwow с МоимСкладом. Просим выдать API-токен продавца для нашего кабинета.
    
    Номер магазина: номер из адреса витрины или кабинета
    
    Токен нужен для чтения заказов, смены их статусов и работы с каталогом.
    
    Спасибо!

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

    В ответ придёт не сам токен, а одноразовая ссылка на сайт secret.flowwow.ru. Откройте её, и на странице будет токен.

    Ссылка показывает токен один раз. Сразу сохраните его в надёжном месте, например в менеджере паролей, или вставьте в приложение (шаг 3). Второй раз ссылка ничего не покажет, и за токеном придётся писать в поддержку снова.

    Не пересылайте ссылку коллегам, пока не открыли её сами: токен увидит тот, кто откроет её первым.

    Храните токен как пароль. Приложение хранит его в зашифрованном виде, а после подключения стирает из поля ввода, так что второй раз его никто не увидит.

    ШАГ 2 ИЗ 7

    Установите приложение в МоемСкладе

    1. Откройте в каталоге решений МоегоСклада карточку «Flowwow интеграция» от разработчика nimatica: открыть в МоемСкладе. Ссылка ведёт внутрь аккаунта, поэтому войдите в МойСклад, если ещё не вошли. В самом МоемСкладе каталог находится в разделе «Приложения».
    2. Нажмите Установить.
    3. МойСклад покажет, к каким данным просит доступ приложение, и попросит подтвердить. Подтвердите.
    4. После установки откройте приложение. В шапке будет название вашего аккаунта и статус «нужно закончить настройку»: Flowwow ещё не подключён. На вкладке «Обзор» приложение покажет, что делать дальше, а кнопка Подключить кабинет Flowwow переведёт к следующему шагу.
    Карточка приложения в каталоге решений: 2 900 ₽ в месяц и кнопка «Установить».
    Первый запуск: «Обзор» сам подсказывает, с чего начать.
    ШАГ 3 ИЗ 7

    Подключите кабинет Flowwow

    1. В окне приложения откройте вкладку Подключение.
    2. Вставьте в поле «Токен продавца Flowwow» токен, который показала одноразовая ссылка от поддержки.
    3. Нажмите Подключить кабинет. Приложение проверит токен и сразу его сохранит.

    Если всё верно, появится зелёная плашка «Кабинет подключён, добавлено магазинов: N из N». Это магазины, которые приложение нашло в кабинете. Дальше каждый из них настраивается отдельно.

    Вкладка «Подключение»: вставьте токен и нажмите «Подключить кабинет».

    Несколько кабинетов Flowwow? Вставьте токен второго кабинета в то же поле и снова нажмите «Подключить кабинет». Он появится рядом с первым как «Кабинет Flowwow 2», у каждого будут свои магазины и свой вебхук.

    ШАГ 4 ИЗ 7

    Включите вебхук

    Вебхук — это уведомление, которое Flowwow присылает в момент оплаты, отмены или выполнения заказа. С ним заказ появляется в МоемСкладе через несколько секунд после оплаты. Адрес для уведомлений прописывает на своей стороне поддержка Flowwow, поэтому понадобится ещё одно письмо.

    1. Там же, на вкладке Подключение, спуститесь к блоку «Вебхук». Приложение уже составило письмо с адресом и секретным ключом именно вашего кабинета.
    2. Нажмите Скопировать письмо и отправьте его в поддержку Flowwow целиком, ничего не меняя.
    3. Когда поддержка ответит, что всё настроено, плашка в блоке станет зелёной: «Вебхук подключён: заказы приходят сразу после оплаты».
    Письмо для поддержки Flowwow приложение собирает само. Адрес и ключ на скриншоте скрыты.

    Секретный ключ из письма — только для поддержки Flowwow. Не выкладывайте скриншот с ним в чаты и не пересылайте подрядчикам: по этому ключу приложение отличает настоящие уведомления Flowwow от подделок.

    Ждать ответа поддержки не обязательно, настраивайте магазин дальше. Пока вебхука нет, приложение само проверяет Flowwow раз в 3 минуты, как только вы включите перенос заказов (шаг 7). С вебхуком заказ приходит сразу после оплаты.

    ШАГ 5 ИЗ 7

    Настройте магазин

    Откройте вкладку Магазины. У каждого магазина Flowwow своя карточка. Обязательны в ней только юрлицо и склад, остальное можно оставить как есть и вернуться к нему позже. Сам перенос заказов включается не здесь, а на «Обзоре» (шаг 7).

    Склад, юрлицо и тип цены

    1. Выберите юрлицо, от имени которого оформляются заказы этого магазина.
    2. Выберите склад заказов: с него резервируется и списывается товар.
    3. Выберите тип цены, по которому считать позиции.
    4. Нажмите Сохранить. Пока юрлицо или склад не выбраны, на «Обзоре» у магазина будет подсказка «Не выбрано юрлицо» или «Не выбран склад».
    Карточка магазина целиком. Без юрлица и склада заказы магазина не переносятся.

    У сети каждой точке назначайте свой склад. Тогда заказ с витрины «Лаванда на Тверской» не зарезервирует букет, который стоит на другом конце города.

    На кого записывать заказы

    Flowwow не передаёт продавцу данные покупателей для справочника, поэтому все заказы магазина записываются на одного контрагента. Вариантов два:

    • Карточка Flowwow. Приложение само создаст контрагента с реквизитами ООО «Флаувау», ИНН 9702020445. Подходит почти всем.
    • Контрагент из вашего справочника. Начните вводить название, выберите из списка, нажмите «Сохранить». Выбирайте этот вариант, если Flowwow у вас уже заведён или тариф МоегоСклада не даёт создать нового контрагента.

    Имя и телефон получателя при этом не теряются: они попадают в сам заказ, как вы настроите в блоке «Данные заказа».

    Канал продаж

    Канал продаж отделяет заказы с Flowwow от ваших собственных, и в отчётах видно, сколько принесла площадка.

    • Завести канал «Flowwow» с типом «Маркетплейс» — рекомендуем, если отдельного канала ещё нет.
    • Выбрать мой канал — если канал для Flowwow у вас уже есть.
    • Без канала продаж — заказы придут без пометки.

    Данные заказа

    Часть данных Flowwow переносится всегда, потому что у них в МоемСкладе есть родное место:

    Из FlowwowКуда в МоемСкладе
    Состав заказаПозиции заказа
    Дата и время доставкиПлановая дата отгрузки
    Адрес доставкиПоле адреса заказа
    Комментарий курьеруКомментарий в адресе
    Ставка НДСНДС позиции

    Для остального нажмите Настроить поля и выберите для каждой строки, куда её класть: в отдельное поле заказа, в ваше собственное поле, в комментарий или никуда. Выбор сохраняется кнопкой Сохранить поля. По умолчанию так:

    • В отдельные поля заказа: номер заказа Flowwow, текст открытки, получатель, способ доставки, «доставить до» и фото до доставки ссылкой.
    • В комментарий заказа: покупатель, окно доставки целиком, «когда доставить», выбор покупателя, комментарии покупателя и магазину, время изготовления, детали приезда и ссылки на товары на витрине.

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

    Пример настройки: для каждой строки своё место.

    Номер Flowwow как номер документа. Удобно: заказ ищется по номеру с витрины в любом списке. Но ваша нумерация заказов перестанет идти подряд. Настройка действует только на новые заказы, уже перенесённые не перенумеровываются.

    Статусы заказа

    У Flowwow свои этапы заказа, у вас в МоемСкладе свои статусы. Нажмите Настроить статусы и для каждого этапа выберите один из трёх вариантов. Выбор сохраняется кнопкой Сохранить статусы.

    • Ваш статус из списка. Например, этап «Передан в доставку» → ваш «У курьера».
    • Статус приложения «Flowwow: …». Он заводится сам, когда придёт первый заказ на этом этапе, не раньше. Лишних статусов заранее не появится.
    • Не менять статус заказа. Этап Flowwow на заказ в МоемСкладе не повлияет.
    Этап FlowwowЧто происходит
    НовыйОплачен, ждёт, пока магазин примет. На это у вас 45 минут
    ПринятМагазин взял заказ в работу
    Фото до доставкиМагазин отправил покупателю фото букета
    Передан в доставкуКурьер выехал
    Ждёт самовывозаЗаказ готов и ждёт покупателя в магазине
    ЗавершёнЗаказ выполнен
    Отменён · событиеЗаказ отменил покупатель или сам Flowwow, например если его не приняли за 45 минут
    Отклонён магазином · событиеМагазин отказался от заказа

    Ещё три почтовых этапа (собран, доставляется, ждёт в отделении) спрятаны под кнопкой «Показать почтовые этапы». Они нужны тем, кто отправляет заказы в другие города.

    Этапы Flowwow ложатся на ваши статусы. Здесь раскрыты и почтовые этапы, обычно они свёрнуты.

    В МоемСкладе у заказа может быть только один «успешный» финальный статус. Если он у вас уже есть, например «Выполнен», поставьте его на этап «Завершён».

    ШАГ 6 ИЗ 7

    Свяжите карточки витрины с товарами

    На Flowwow лежат карточки для покупателей: «Букет из 25 пионов», «Корзина „Нежность“». В МоемСкладе — ваша номенклатура. Чтобы заказ пришёл с правильными позициями, приложению нужно знать, какая карточка какому товару соответствует.

    Позиция без связи в заказ не попадёт. Заказ создастся, но без этой позиции, а в итоге переноса будет строка «нет пары у „Букет из 25 пионов“». Свяжите хотя бы ходовые карточки до того, как переносить заказы.

    1. Откройте вкладку Каталог и выберите магазин справа вверху.
    2. В фильтре оставьте «без связи»: в списке будут только карточки, которые ещё не разобраны.
    3. В строке карточки начните вводить название товара в поле «найдите позицию учёта» и выберите его в подсказке. Можно выбрать и модификацию, например размер или цвет.
    4. Нажмите Связать. Карточка уйдёт из списка «без связи».
    Выбор в подсказке ничего не меняет, связь появляется только по кнопке «Связать».

    Несколько карточек можно связать с одним и тем же товаром. Это нормальная ситуация: на витрине три варианта оформления, а в учёте один букет. Связку всегда можно поменять кнопками Изменить и Отвязать в фильтре «связанные».

    В колонке «Как связано» видно, откуда взялась связь: совпал артикул, совпал код, совпало название, выбрано вручную или товар создан приложением.

    Остатки на витрине

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

    1. Переключите фильтр на «связанные». В колонке «Остатки» отметьте передавать у товаров, остаток которых должен видеть Flowwow.
    2. В панели «Остатки на витрину» оставьте галочку «Обновлять остатки автоматически каждые 5 минут». Кнопка Обновить сейчас отправит остатки сразу.
    3. Решите, что делать с закончившимся товаром. С галочкой «Скрывать товар на Flowwow, когда он закончился» он пропадёт с витрины, без неё останется с прежним количеством.
    Колонка «Остатки» и общие настройки передачи.

    Если скрыты все товары, Flowwow делает магазин неактивным. Со включённым скрытием следите, чтобы на витрине оставался хотя бы один товар в наличии.

    У товаров, которые делаются под заказ (на Flowwow у них указан срок изготовления), остатка нет, и галочка недоступна: рядом написано «под заказ, без остатков». Если панель просит Подготовить товары, нажмите: приложение запишет в карточки Flowwow служебную отметку, по которой площадка поймёт, какой товар из учёта стоит за карточкой. Покупатели её не увидят, но убрать отметку потом нельзя.

    ШАГ 7 ИЗ 7

    Проверьте и включите перенос заказов

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

    1. На вкладке Магазины в карточке магазина нажмите Посмотреть, что перенесётся. Это пробный прогон: документы не создаются.
    2. Прочитайте итог: сколько заказов будет создано и какие помехи найдены. Строка «нет пары у…» значит, что карточка не связана с товаром: вернитесь к шагу 6.
    3. Откройте вкладку Обзор и отметьте у магазина Переносить заказы в МойСклад автоматически. Первая проверка пройдёт в ближайшие 3 минуты, дальше под галочкой будет видно время последней.
    4. Откройте любой перенесённый заказ в МоемСкладе и проверьте позиции, дату доставки, адрес и открытку.
    Скриншот 7.1Итог пробного прогона: зелёная или жёлтая плашка «Заказов во Flowwow… Будет создано…» и пример заказа таблицейshots/07-1-preview.png
    Сначала смотрим, потом создаём.
    Перенос включён. Жёлтая плашка сверху пропадёт, когда поддержка Flowwow включит вебхук.

    Без вебхука новый заказ приходит с задержкой до 3 минут, с вебхуком сразу после оплаты. Кнопка Перенести заказы в карточке магазина забирает заказы вручную и сразу. Дублей не будет: уже перенесённые заказы приложение узнаёт и только обновляет.

    Заказ с Flowwow в МоемСкладе: контрагент FLOWWOW, канал продаж, плановая дата отгрузки и адрес с комментарием курьеру. Заказ проведён и резервирует товар, под ним виджет.

    Если всё сошлось, подключение закончено.


    Работа каждый день

    Виджет Flowwow в карточке заказа

    Откройте заказ с Flowwow в МоемСкладе, и под ним появится виджет. В нём всё, что флористу и курьеру нужно знать о заказе: номер и статус на Flowwow, время и способ доставки, адрес, получатель, покупатель, комментарии, текст открытки и выбор покупателя.

    Виджет в карточке заказа. Кнопка следующего шага стоит рядом с номером заказа.

    Кнопки виджета меняют статус заказа прямо на Flowwow, покупатель видит это сразу. Шаги идут в том же порядке, что в приложении Flowwow, и виджет показывает только те кнопки, которые подходят заказу:

    Этап на FlowwowЧто в виджете
    НовыйПринять заказ
    ПринятДобавить фото и кнопка отправки
    Фото до доставкиКнопка отправки
    Передан в доставку, ждёт самовывоза, почтовые этапыЗаказ выполнен

    Кнопка отправки зависит от того, как уходит заказ: «Курьер выехал», «Готов к самовывозу» или «Собран для отправки почтой».

    Фото до доставки отправляется прямо из виджета: нажмите Добавить фото и выберите снимок букета, JPEG или PNG до 15 МБ. Покупатель получит его на Flowwow и сможет оценить. Фото хранит Flowwow, приложение у себя его не оставляет. В некоторых категориях фото не обязательно, поэтому кнопка отправки доступна и без него.

    Если заказ везёт курьер Flowwow, вам остаются принятие и фото. Передачу курьеру и завершение ведёт сам Flowwow, и вместо кнопок виджет пишет «Курьер Flowwow заберёт заказ, статус сменится сам».

    Принять новый заказ нужно в течение 45 минут, иначе Flowwow отменит его сам и начислит штраф. Кнопка «Принять заказ» в виджете работает так же, как в кабинете Flowwow.

    Обзор, Заказы и Журнал

    • Обзор — сколько магазинов подключено, сколько из них переносят заказы и сколько карточек связано. Здесь же включается перенос заказов в МойСклад. Если что-то мешает магазину, причина написана прямо в его строке.
    • Заказы — список заказов прямо из Flowwow с отметкой «перенесён» или «нет». Сюда смотрите первым делом, если кажется, что заказ потерялся: вверху написано, сколько заказов во Flowwow и сколько из них в МоемСкладе.
    • Журнал — что делало приложение и что ему помешало: установка, уведомления Flowwow, перенос заказов. Фильтр наверху сужает список до нужного.
    «Обзор» сети из четырёх магазинов: два переносят заказы, у одного перенос выключен, у другого не выбран склад.
    Сверка: что есть на Flowwow и что дошло до учёта.

    Что важно знать

    Ограничения, о которые спотыкаются чаще всего. Большинство идёт не от приложения, а от Flowwow или тарифа МоегоСклада.

    Тариф МоегоСклада

    На бесплатном тарифе МойСклад ограничивает число товаров и контрагентов сотней и запрещает дополнительные поля. Приложение это учитывает: всё, что вы отправили «в отдельное поле», пишет в комментарий заказа, и заказы переносятся как обычно. Перейдёте на платный тариф — поля включатся сами.

    Покупатели Flowwow скрыты

    Площадка не отдаёт покупателей как клиентскую базу. Поэтому все заказы идут на одного контрагента (карточку Flowwow или вашего), а имена и телефоны лежат в самом заказе.

    Короткая память Flowwow

    Flowwow хранит для API заказы примерно за две недели. Всё, что старше, перенести нельзя, а виджет в старом заказе напишет «Заказ больше не отдаётся Flowwow». Сам заказ в МоемСкладе при этом остаётся целым.

    Проведение и резерв

    Заказы создаются проведёнными и резервируют товар на выбранном складе. Если у приложения нет права проводить документы, заказ придёт непроведённым, а в итоге переноса будет подсказка. Лечится переустановкой: МойСклад выдаст права заново.

    Удаление приложения

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

    Если что-то пошло не так

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

    Откройте вкладку Заказы и найдите его там. Отметка «нет» значит, что перенести не удалось. Причина будет на вкладке Журнал.

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

    Карточка витрины не связана с товаром. Свяжите её на вкладке Каталог (шаг 6) и снова нажмите «Перенести заказы»: приложение обновит заказ.

    У приложения нет права проводить документы. Такое бывает, если права урезали при установке или после неё. Переустановите приложение из каталога решений: МойСклад выдаст права заново, а настройки магазинов сохранятся.

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

    Если упёрлись в контрагентов, выберите существующего в блоке «На кого записывать заказы». Если в товары — освободите место или перейдите на тариф выше.

    В списке показываются только поля заказа покупателя подходящего типа: текст открытки не положить в поле-дату. Если полей нет совсем, либо вы их ещё не заводили, либо тариф МоегоСклада не даёт работать с дополнительными полями. Об этом приложение напишет прямо под таблицей.

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

    Flowwow не принял действие. Чаще всего заказ на площадке уже в другом статусе: его приняли или отменили из кабинета Flowwow. Нажмите «Сохранить» в заказе, виджет перечитает статус и покажет правильные кнопки.

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

    Не получилось? Напишите нам

    Пришлите в Telegram скриншот вкладки «Журнал» или текст ошибки. Разберёмся, почему заказ не дошёл, поможем договориться с поддержкой Flowwow и настроить статусы под ваш процесс. Отвечаем с 09:00 до 21:00.

    Написать в Telegram

    Или на почту hello@flowbridge.ru