Руководство по подключению Flowwow к RetailCRM через официальный Seller API: заказы, клиенты, каталог ICML, статусы и обратная синхронизация. JWT, URL вебхука, секрет и токен триггера копируйте на вкладках настроек в личном кабинете — в этой инструкции они не дублируются.
order.paid создаётся заказ в CRM: позиции, адрес доставки,
открытка и комментарии, контакты покупателя/получателя, оплаченный платёж
(если задан тип оплаты). События order.cancelled и order.finished
обновляют только статус уже связанного заказа.
pack), завершение, отказ (refuse), загрузка фото до/после доставки.
order.update у Flowwow нет. Изменения адреса и текста открытки
в ЛК покупателя подтягиваются опросом Seller API (~каждые 3 минуты), пока заказ не в финальном статусе.
integration_*, order_*, customer_*,
reference_*, custom_fields_*, file_read
(файлы заказа нужны для загрузки фото в Flowwow).
Модуль принимает order.paid, order.cancelled,
order.finished и test (проверка канала, без создания заказа).
Вебхука order.update нет: промежуточные статусы, выставленные вручную
в кабинете Flowwow (принято, доставка, фото и т.п.), сами в CRM не приходят.
Рабочий процесс — статусы в RetailCRM + reverse-триггеры.
Полный заказ (состав, адрес, комментарии, платёж) создаётся только по order.paid.
Повторный paid для уже связанного заказа пропускается (состав не перезаписывается).
order.cancelled / order.finished меняют только статус в CRM.
В Seller API нет метода изменения позиций. Правки состава в RetailCRM не уходят в Flowwow и не видны покупателю в ЛК. Обратная синхронизация — только статусы (и связанные API-действия) и фото.
Коды pickup-wait, post-delivering, post-pickup
(Flowwow 7 / 11 / 12) можно сопоставить для отображения в CRM, но обратного API нет —
reverse-триггер для них не вызывается. Их меняют вручную в кабинете Flowwow.
В RetailCRM нет события «файл прикреплён». Чтобы отправить фото в Flowwow до доставки:
прикрепите JPEG/PNG к заказу CRM, переведите заказ в статус photo-before
и вызовите триггер с action: photo_upload и photo_type: 0
(не status_sync — отдельного API смены статуса «фото до» в Flowwow нет).
Загрузка с photo_type: 1. Отдельного статуса CRM не требуется —
триггер можно повесить, например, на переход в complete.
Seller API в объекте заказа не передаёт промокод и e-mail покупателя. Отдельные поля промокода в CRM не создаются; поиск дублей по email фактически недоступен (рабочий режим — по телефону).
Ведите статусы в RetailCRM и настройте reverse-триггеры — тогда Flowwow обновляется из CRM. Не рассчитывайте на ручные клики в кабинете Flowwow как на источник статусов для CRM.
Один JWT и один вебхук на аккаунт продавца. Переключайте активный магазин в шапке или на вкладке «Подключение»: у каждого магазина свои site CRM, статусы, каталог и заказы. Заказы неизвестного или отключённого магазина вебхук принимает, но не обрабатывает.
order.paid, order.cancelled,
order.finished; событие test — для проверки канала.
order.paid в CRM не создаётся.
reference_write).
X-Flowwow-Trigger-Token),
затем создайте HTTP-триггеры по матрице ниже (раздел 5).
URL триггера и токен (X-Flowwow-Trigger-Token) копируйте на вкладке
«Обратная синхр.» — кнопки копирования уже там. В инструкции секреты не показываются.
Метод запроса: POST.
| Статус CRM (типичный код) | Действие в Flowwow | HTTP action |
|---|---|---|
new / accepted |
Принять заказ (accept) |
status_sync |
photo-before |
Загрузить фото до доставки | photo_upload |
delivering |
Курьер выехал (courierLeft) |
status_sync |
post-packed |
Собрать почтовый заказ (pack) |
status_sync |
complete |
Завершить заказ (finish) |
status_sync |
cancel / cancel-other |
Отказаться от заказа (refuse) |
status_sync |
| завершение / своё условие | Фото после доставки (photo_type: 1) |
photo_upload |
photo-before
Используйте только photo_upload с photo_type: 0.
Не отправляйте status_sync для этого статуса.
В автоматизации RetailCRM подставьте переменные заказа.
Смена статуса (status_sync)
{
"action": "status_sync",
"retailcrm_order_id": "{{ order.id }}",
"retailcrm_status": "{{ order.status.code }}"
}Фото до доставки (photo_upload)
{
"action": "photo_upload",
"retailcrm_order_id": "{{ order.id }}",
"photo_type": 0
}Фото после доставки (опционально)
{
"action": "photo_upload",
"retailcrm_order_id": "{{ order.id }}",
"photo_type": 1
}
Для pickup-wait, post-delivering, post-pickup
(Flowwow 7, 11, 12) обратная синхронизация недоступна. В CRM эти промежуточные статусы
сами не появятся — вебхуки приходят только на оплату, отмену и завершение:
order.paid, order.cancelled, order.finished.
new / accepted → принять (status_sync → accept)photo-before → JPEG/PNG на заказе CRM, затем photo_upload (photo_type: 0)delivering → курьер выехалcomplete → завершить (+ при необходимости фото после с photo_type: 1)
Отмена: статус отмены в CRM + status_sync → Flowwow refuse.
Для почтовых заказов дополнительно используйте post-packed → pack.
integration_read / integration_write — регистрация и работа модуляorder_read / order_write — заказыcustomer_read / customer_write — клиентыreference_read / reference_write — справочники; reference_write нужен для создания статусов из кабинетаcustom_fields_read / custom_fields_write — пользовательские поляfile_read — файлы заказа для загрузки фото в Flowwowstatus_sync и photo_upload для photo-before
file_read (фото) и при создании статусов — reference_write