Открытое API для продавцов (0.0.1)
Ping
Методы проверки состояния api.
Возвращает тип ответа по параметру say.
Какой ответ получить
| Тип запроса | Описание | Действие |
|---|---|---|
| hello | Кампания активна | обычный ответ сервера (200) |
| error400 | Ошибка клиента 400 | имитация ошибки клиента 400 |
| error401 | Ошибка клиента 401 | имитация ошибки клиента 401 |
| error403 | Ошибка клиента 403 | имитация ошибки клиента 403 |
| error404 | Ошибка клиента 404 | имитация ошибки клиента 404 |
| error429 | Ошибка клиента 429 | имитация ошибки клиента 429 |
| error500 | Ошибка сервера 500 | имитация ошибки сервера 500 |
HelloPossible values: Success
Ответ сервера
helloBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
GET /apiseller/ping/check HTTP/1.1
Host: apis.flowwow.com
Accept: */*
{
"say": "hello"
}Shop
Информация о магазинах или складах холдинга.
Возвращает список магазинов для холдинга или один магазин - для остальных случаев.
Управление пагинацией в отдаваемой коллекции
Статус магазина:
| Статус | Описание |
|---|---|
| moderation | На модерации |
| active | Активен |
| disabled | Деактивирован |
Список идентификаторов магазинов
101Номер страницы. Нумерация начинается с 0.
0Количество элементов в ответе. Максимум — 50, минимум — 1.
10OK
Общее количество магазинов
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/shops HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59
{
"status": "moderation",
"shopIds": [
101
],
"page": 0,
"limit": 10
}{
"shops": [
{
"shopId": 101,
"name": "Мой магазин",
"status": "moderation",
"address": "г. Москва, ул. Ленина, д. 1",
"currency": "RUB",
"isVerified": true,
"workingDays": [
"1",
"2",
"3",
"4",
"5"
]
}
],
"total": 1
}Возвращает отзывы указанного магазина с пагинацией, фильтрацией и сортировкой.
Фильтры передаются в формате filters[withText]=true.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Номер страницы
1Количество отзывов на странице
5Порядок сортировки:
rating_asc— по возрастанию рейтинга;rating_desc— по убыванию рейтинга;date_asc— сначала старые;date_desc— сначала новые.
OK
Общее количество отзывов, соответствующих фильтрам
Есть ли у магазина отзывы с фотографиями покупателей
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
GET /apiseller/shops/review?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": 1,
"complianceScore": 1,
"shopScore": 1,
"courierScore": 1,
"flowScore": 1,
"type": "buyer-flowwow",
"authorName": "text",
"authorAvatarUrl": "text",
"date": "Январь 2026",
"text": "text",
"lang": "ru",
"answerShop": "text",
"answerLang": "ru",
"photoBeforeUrl": "text",
"photoBeforeBigUrl": "text",
"photoShopMiddleUrl": "text",
"photoShopStandardUrl": "text",
"photoShopMediumUrl": "text",
"photoShopBigUrl": "text",
"photoUserUrls": [
{
"id": 1,
"image": "text"
}
]
}
],
"total": 1,
"withPhotos": true
}Products
Добавление, просмотр, изменение и управление отображением товаров.
Возвращает список товаров магазина с возможностью фильтрации. Поддерживается пагинация.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Список идентификаторов товаров в системе магазина
FLOW-0001Идентификаторы товаров в системе Flowwow
83418243Идентификаторы категорий в системе Flowwow
54Тип товара:
1— обычный товар,2— готовый товар,3— дополнительный товар.
Если true, поиск выполняется по активным и архивным товарам.
falseЕсли true, в каждом товаре возвращается объект stats со статистикой за последние 30 дней.
falseЕсли true, в каждом товаре возвращается объект properties со свойствами товара. Имена и формат значений совпадают с правилами ApiSeller из /apiseller/categories/subCategoryProperties, /apiseller/products/create и /apiseller/products/update. Поля, которые уже есть в корне ProductShortDto, внутри properties не дублируются. Для свойств типа text возвращается исходная строка, для multitext — массив исходных строк, для select — ID выбранного варианта из values.
falseНомер страницы. Нумерация начинается с 0.
0Количество элементов в ответе. Минимум — 1, максимум — 1000, по умолчанию — 10.
10OK
Общее количество товаров (без учёта пагинации)
150Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2
{}{
"items": [
{
"offerId": "FLOW-0001",
"productId": 123,
"isActive": true,
"isArchived": false,
"type": 1,
"categoryId": 1002001,
"subCategoryId": 100200101,
"name": "Букет роз «Классика»",
"description": "Классический букет из 21 красной розы",
"url": "https://flowwow.com/product/buket-roz-klassika",
"available": 99999,
"stock": 100,
"minOrder": 1,
"price": "1990.00",
"discount": "10",
"currencyCode": "RUB",
"images": [
"https://cdn.example.com/images/flow-0001-1.png"
],
"productionTime": 60,
"shipmentTime": 120,
"canRent": 0,
"originalId": 0,
"isDeliveryPost": false,
"isStarred": true,
"vat": "20",
"stats": {
"productSales": 12500.5,
"conversionAll": 8.33,
"catalogViews": 500,
"itemViews": 120,
"addToCart": 24,
"purchase": 10
},
"properties": null
},
{
"offerId": "FLOW-0002",
"productId": 124,
"isActive": true,
"isArchived": false,
"type": 1,
"categoryId": 1002001,
"subCategoryId": 100200101,
"name": "Букет с сезонными цветами",
"description": "Сезонный букет",
"url": "https://flowwow.com/product/buket-season",
"available": 99999,
"stock": 0,
"minOrder": 1,
"price": "2500.00",
"discount": "0",
"currencyCode": "RUB",
"images": [
"https://cdn.example.com/images/flow-0002-1.png"
],
"productionTime": 120,
"shipmentTime": 0,
"canRent": 0,
"originalId": 0,
"isDeliveryPost": false,
"isStarred": false,
"vat": "20",
"stats": null,
"properties": {
"width": {
"val": 30,
"measure": 3
},
"height": {
"val": 50,
"measure": 3
},
"color": 1,
"manufacturerName": "Кондитерская «Ромашка»",
"regionOfOrigin": "Москва",
"brand": "Ромашка",
"author": "Анна Иванова",
"textDimensions": "15 × 20 см",
"material": [
"Хлопок",
"Лён"
],
"filling": [
"Шоколад",
"Ваниль"
],
"gender": 2,
"consist": [
{
"name": "Роза",
"quantity": 15,
"measure": 1
}
],
"composition": "Розы, эвкалипт",
"recommendation": "Меняйте воду ежедневно"
}
}
],
"total": 150
}Создаёт новый товар в каталоге магазина на Flowwow.
Ограничения:
Готовые товары (
productType=2) не могут быть созданы через API.Основной товар (
productType=1) — требует указанияsubCategoryId.Дополнительный товар (
productType=3) — не требуетsubCategoryId.
Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на создание.
Изображения: Загружаются асинхронно по переданным URL. Первое появление в интерфейсе Flowwow может занять до 30 минут.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Результат выполнения операции создания товаров
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/create?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 413
[
{
"offerId": "FL-001",
"productType": 1,
"subCategoryId": 437,
"name": "Букет красных роз 25шт",
"price": "3500.00",
"discount": "10",
"description": "Свежие красные розы, 25 штук",
"minOrderCount": 1,
"stock": 20,
"height": {
"val": 50,
"measure": 3
},
"quantityInPackage": 1,
"isAdultsOnly": false,
"manufacturerName": "Розарий Подмосковья",
"images": [
"https://example.com/roses.jpg"
]
}
]{
"shopId": 260,
"summary": {
"total": 3,
"success": 2,
"failed": 1
},
"data": [
{
"offerId": "FLOW-0001",
"productId": 1
},
{
"offerId": "FLOW-0002",
"productId": 2
}
],
"errors": [
{
"offerId": "FLOW-0003",
"product": {
"offerId": "FLOW-0002",
"productType": 1,
"subCategoryId": 1,
"price": 100
},
"message": "Цена товара должна содержать строковое значение"
}
]
}Обновляет товар в каталоге магазина на Flowwow.
При обновлении необходимо передавать все актуальные поля товара (частичное обновление не поддерживается).
Ограничения:
Изменение
productTypeиsubCategoryIdчерез API запрещено.Готовые товары (
productType=2) не могут быть созданы или изменены через API.Для основного товара (
productType=1) полеsubCategoryIdобязательно.Для дополнительного товара (
productType=3) полеsubCategoryIdне требуется.
Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на обновление.
Изображения: Загружаются асинхронно по переданным URI. Первое появление в интерфейсе Flowwow может занять до 30 минут.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Результат выполнения операции создания товаров
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/update?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 413
[
{
"offerId": "FL-001",
"productType": 1,
"subCategoryId": 437,
"name": "Букет красных роз 25шт",
"price": "3500.00",
"discount": "10",
"description": "Свежие красные розы, 25 штук",
"minOrderCount": 1,
"stock": 20,
"height": {
"val": 50,
"measure": 3
},
"quantityInPackage": 1,
"isAdultsOnly": false,
"manufacturerName": "Розарий Подмосковья",
"images": [
"https://example.com/roses.jpg"
]
}
]{
"data": [
{
"offerId": "FH-001",
"productId": 74286570
},
{
"offerId": "FH-003",
"productId": 74286571
},
{
"offerId": "SH-001",
"productId": 74286572
}
],
"errors": [
{
"offerId": "FLOW-0003",
"product": {
"offerId": "FLOW-0002",
"productType": 1,
"subCategoryId": 1,
"price": 100
},
"message": "Цена товара должна содержать строковое значение"
}
]
}Связывает товары из магазина продавца на маркетплейсе Flowwow с товарами из информационной системы продавца по идентификаторам. Если товар с указанным productId не существует у магазина в системе Flowwow, будет возвращена ошибка для этого товара. Если внутри одного запроса присутствуют пары с одинаковым offerId или productId, все такие пары считаются некорректными и не обрабатываются. Частичная обработка для конфликтующих пар не выполняется, каждая из них будет возвращена в массиве errors. Если прислать пары ID, которые уже были ранее привязаны, то такие пары изменены не будут. Готовые товары на Flowwow нельзя привязывать, при попытке связывания, такие товары найдены не будут.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
ID запрошенного магазина, в рамках только данного магазина производится работа с парами offerId и productId
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/offersMappings?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57
{
"offers": [
{
"offerId": "FLOW-0001",
"productId": 83418243
}
]
}{
"shopId": 1,
"summary": {
"total": 13,
"success": 8,
"failed": 5,
"created": 4,
"updated": 0,
"relinked": 2,
"unchanged": 2
},
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"type": 1,
"categoryId": 54,
"subCategoryId": 112,
"name": "Букет из роз",
"description": "Красивый букет из свежих роз.",
"url": "https://flowwow.com/product/12345",
"available": 1,
"stock": 10,
"minOrder": 1,
"price": "1990.00",
"discount": "20",
"currencyCode": "RUB",
"images": [
"https://example.com"
],
"productionTime": 1,
"shipmentTime": 1,
"canRent": 1,
"originalId": 7123456,
"isDeliveryPost": true,
"isStarred": true,
"vat": "10"
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"message": "У данной пары есть дубль с другим productId или offerId в запросе"
}
]
}Делает товары невидимыми на витрине и недоступными для продажи без возврата их из архива. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18».
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Success
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/hide?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"offers": [
{
"offerId": "FLOW-0001"
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"updated": true
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"message": "Товар не существует"
}
]
}Если запрошенный товар не найден в базе, система не может скрыть его и определить текущий статус.
Полностью заменяет список товаров топ-18 магазина.
Частичное обновление не поддерживается: для добавления или удаления товаров необходимо передать полный желаемый список топ-18. Если хотя бы один товар не прошёл валидацию, список не изменяется. Товар должен существовать, принадлежать указанному магазину, не быть дополнительным, скрытым или заблокированным. Пустой массив offers очищает топ-18 магазина.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Список топ-18 успешно заменён
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/setTop18?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 60
{
"offers": [
{
"offerId": "FLOW-0001"
},
{
"offerId": "FLOW-0002"
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243
},
{
"offerId": "FLOW-0002",
"productId": 83418244
}
]
}Делает товары видимыми на витрине и доступными к продаже без перевода их в архив. Если у товара заданы свойства минимального количества для заказа и доступного количества, то для открытия товара доступное количество должно быть больше либо равно минимальному количеству для заказа. Для товаров из оптовых категорий доступное количество рассчитывается как произведение: доступное количество × количество в упаковке. Если до выполнения запроса в магазине не было ни одного открытого товара и в результате запроса появился хотя бы один открытый обычный или готовый товар, магазин переводится в статус активного (при соблюдении остальных условий активности магазина). Подтверждение наличия товаров менеджером через данный эндпоинт не производится.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Success
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/unhide?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"offers": [
{
"offerId": "FLOW-0001"
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"updated": true
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"message": "Товар не существует"
}
]
}Если запрошенный товар не найден в базе, система не может открыть его и определить текущий статус.
Переносит один товар в архив
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор товара в системе продавца
Идентификатор товара в системе продавца.
FLOW-0001OK
Результат выполнения операции переноса товара в архив
Идентификатор магазина.
260Идентификатор товара в системе продавца.
FLOW-0001Идентификатор товара в системе Flowwow
83418243Архивирован ли товар
trueБыли ли изменены данные у товара
trueСообщение об ошибке
Товар не существуетBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/archive?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23
{
"offerId": "FLOW-0001"
}{
"shopId": 260,
"offerId": "FLOW-0001",
"productId": 83418243,
"isArchived": true,
"updated": true,
"message": "Товар не существует"
}Возвращает один товар из архива
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор товара в системе продавца
Идентификатор товара в системе продавца.
FLOW-0001OK
Результат выполнения операции возврата товара из архива
Идентификатор магазина.
260Идентификатор товара в системе продавца.
FLOW-0001Идентификатор товара в системе Flowwow
83418243Архивирован ли товар
trueБыли ли изменены данные у товара
trueСообщение об ошибке
Товар не существуетBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/products/unarchive?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23
{
"offerId": "FLOW-0001"
}{
"shopId": 260,
"offerId": "FLOW-0001",
"productId": 83418243,
"isArchived": true,
"updated": true,
"message": "Товар не существует"
}Stocks
Остатки товаров на складах магазина.
Возвращает информацию по остаткам в магазине продавца
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/stocks/get?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"offers": [
{
"offerId": "FLOW-0001"
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"stock": 13
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"stock": 13,
"message": "Товар не существует"
}
]
}Изменяет информацию по остаткам в магазине продавца. Товар скрывается при изменении остатка с > 0 на 0. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18». Скрытие товара без изменения его остатков производится с помощью запроса POST /apiseller/products/hide
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Success
Информация об остатках одного товара на одном из складов.
Идентификатор магазина.
260Bad Request
Forbidden
Not Found
Too Many Requests
Internal Server Error
PUT /apiseller/stocks/put?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47
{
"offers": [
{
"offerId": "FLOW-0001",
"stock": 13
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"stock": 13,
"updated": true
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"stock": 13,
"message": "Товар не существует"
}
]
}Метод /apiseller/stocks/put возвращает в ответе те значения остатков, которые были переданы в запросе. Если по товару в ответе возвращается null, это означает, что по товару нет данных в базе.
Prices
Цены товаров.
Возвращает информацию по ценам и скидкам товаров в магазине
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/prices/get?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36
{
"offers": [
{
"offerId": "FLOW-0001"
}
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"price": "1990.00",
"discount": "20",
"currencyCode": "RUB"
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"message": "Товар не существует"
}
]
}Изменяет цены и/или скидки у товаров в магазине
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Результаты изменения цены/скидки для товаров
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
PUT /apiseller/prices/put?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17
{
"offers": [
null
]
}{
"shopId": 260,
"data": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"price": "1990.00",
"discount": "20",
"updated": true
}
],
"errors": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"price": "1990.00",
"discount": "20",
"message": "Товар не существует"
}
]
}Categories
Информация о категориях и подкатегориях товаров.
Возвращает иерархическое дерево активных категорий (групп) с их подкатегориями (типами). Результат фильтруется по стране магазина — недоступные в стране категории и подкатегории не включаются. Результат не пагинируется (отдаётся целиком).
Поле chestnyZnakMarkingRequirement
Поле отдаётся только для магазинов из Российской Федерации. Указывает требование маркировки товаров системой «Честный Знак»:
never
Маркировка не требуется для товаров данной подкатегории
selectable
Магазин сам решает, нужна ли маркировка для конкретного товара
always
Все товары данной подкатегории обязательно должны быть промаркированы
Для магазинов из других стран поле не включается в ответ.
Идентификатор магазина. Передаётся как GET-параметр. Пример: ?shopId=260
OK
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/categories/tree?shopId=1 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"shopId": 260,
"data": [
{
"categoryId": 10,
"name": "Цветы",
"isDeliveryPhotoRequired": true,
"isPostcardEnabled": true,
"subCategories": [
{
"subCategoryId": 456,
"name": "Букеты",
"isPostDelivery": false,
"isAdultsOnlyDefault": false,
"chestnyZnakMarkingRequirement": "never"
},
{
"subCategoryId": 457,
"name": "Композиции",
"isPostDelivery": false,
"isAdultsOnlyDefault": false,
"chestnyZnakMarkingRequirement": "selectable"
}
]
}
]
}Возвращает список свойств для одной подкатегории товаров.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор подкатегории товаров
Его можно узнать с помощью запроса POST /apiseller/categories/tree
1Идентификатор типа товаров. От типа товара зависят свойства товара. Возможные значения:
1— обычный товар. Может долгое время находиться в каталоге, может существовать во многих экземплярах, имеет остатки на складе или время изготовления3— дополнительный товар. Не отображается клиентам в каталоге товаров и на странице магазина, виден только в корзине. Может идти дополнительно в заказе вместе с одним или несколькими обычными или готовыми товарами
Настройки для готовых товаров (productType=2) не предоставляются через данный эндпоинт, так как через API нельзя создать готовые товары, используйте для этого приложение FLOWWOW для продавцов.
1Possible values: OK
Идентификатор магазина.
260Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/categories/subCategoryProperties?shopId=123456&subCategoryId=1&productType=1 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"regular": {
"summary": "Обычный товар (productType=1)",
"value": {
"shopId": 260,
"subCategory": {
"subCategoryId": 1,
"name": "Монобукеты",
"isPostDelivery": false,
"isAdultsOnlyDefault": false,
"chestnyZnakMarkingRequirement": "never"
}
}
},
"data": [
{
"name": "Идентификатор товара в вашей системе",
"field": "offerId",
"required": true,
"type": "text",
"maxDecimalPlaces": 0
},
{
"name": "Тип товара",
"field": "productType",
"required": true,
"type": "select",
"values": [
{
"id": 1,
"name": "Основной"
},
{
"id": 3,
"name": "Дополнительный"
}
]
},
{
"name": "Подкатегория",
"field": "subCategoryId",
"required": true,
"type": "decimal",
"maxDecimalPlaces": 0,
"requiredIf": {
"field": "productType",
"in": [
1
]
},
"visibleIf": {
"field": "productType",
"in": [
1
]
}
},
{
"name": "Событие",
"field": "event",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Персонажи",
"field": "characters",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Кому",
"field": "whome",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Тип шаров",
"field": "typeOfBalls",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Особенности",
"field": "peculiarities",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Название",
"field": "name",
"required": true,
"type": "text"
},
{
"name": "Цена товара до применения скидки",
"field": "price",
"required": true,
"type": "text"
},
{
"name": "Скидка, %",
"field": "discount",
"required": false,
"type": "text"
},
{
"name": "Описание товара",
"field": "description",
"required": false,
"type": "text"
},
{
"name": "Изображения",
"field": "images",
"required": false,
"type": "image"
},
{
"name": "Количество товаров на складе, шт.",
"field": "stock",
"required": true,
"type": "decimal",
"maxDecimalPlaces": 0,
"minValue": 1,
"dependsOn": [
"productionTime"
]
},
{
"name": "Время изготовления",
"field": "productionTime",
"required": true,
"type": "measure",
"maxDecimalPlaces": 0,
"measure": [
{
"id": 7,
"maxDecimalPlaces": 0
},
{
"id": 8,
"maxDecimalPlaces": 0
},
{
"id": 9,
"maxDecimalPlaces": 0
}
],
"dependsOn": [
"stock"
]
},
{
"name": "Минимальный заказ",
"field": "minOrderCount",
"required": true,
"type": "decimal",
"maxDecimalPlaces": 0,
"minValue": 1,
"maxValue": 15
},
{
"name": "Ширина",
"field": "width",
"required": true,
"type": "measure",
"minValue": 1,
"maxValue": 9999,
"measure": [
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Высота",
"field": "height",
"required": true,
"type": "measure",
"minValue": 1,
"maxValue": 9999,
"measure": [
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Состав товара",
"field": "consist",
"required": true,
"type": "consist",
"measure": [
{
"id": 1,
"maxDecimalPlaces": 0
},
{
"id": 2,
"maxDecimalPlaces": 0
},
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 4,
"maxDecimalPlaces": 0
},
{
"id": 5,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Вес товара",
"field": "volume",
"required": true,
"type": "measure",
"measure": [
{
"id": 2,
"maxDecimalPlaces": 0
},
{
"id": 5,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Вес букета",
"field": "flowerWeight",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Состав продукта (текстом)",
"field": "composition",
"required": true,
"type": "text"
},
{
"name": "Начинки",
"field": "filling",
"required": false,
"type": "multitext"
},
{
"name": "Тематические подборки",
"field": "thematicSelections",
"required": false,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Цвет",
"field": "color",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Белый"
},
{
"id": 2,
"name": "..."
}
]
},
{
"name": "Тип шаров",
"field": "baloonType",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Латексный"
},
{
"id": 2,
"name": "..."
}
]
},
{
"name": "Бренд",
"field": "brand",
"required": false,
"type": "text"
},
{
"name": "Автор",
"field": "author",
"required": false,
"type": "text"
},
{
"name": "Год",
"field": "year",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Исполнитель",
"field": "singer",
"required": false,
"type": "text"
},
{
"name": "Студия записи",
"field": "recordStudio",
"required": false,
"type": "text"
},
{
"name": "Оригинал ли",
"field": "original",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Оригинал"
},
{
"id": 2,
"name": "Реплика"
}
]
},
{
"name": "Размер одежды",
"field": "clothingSize",
"required": false,
"type": "text"
},
{
"name": "Для кого",
"field": "gender",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Доступные размеры",
"field": "textDimensions",
"required": false,
"type": "text"
},
{
"name": "Количество в упаковке",
"field": "quantityInPackage",
"required": true,
"type": "decimal",
"maxDecimalPlaces": 0,
"minValue": 1
},
{
"name": "Регион происхождения",
"field": "regionOfOrigin",
"required": false,
"type": "text"
},
{
"name": "Калорийность, ккал",
"field": "kilocalories",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Белки, гр.",
"field": "proteins",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Жиры, гр.",
"field": "fats",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Углеводы, гр.",
"field": "carbohydrates",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0
},
{
"name": "Название материала",
"field": "material",
"required": false,
"type": "text"
},
{
"name": "Как ухаживать за растением",
"field": "recommendation",
"required": false,
"type": "text"
},
{
"name": "Сколько раз поливать",
"field": "wateringFrequency",
"required": false,
"type": "measure",
"measure": [
{
"id": 10,
"maxDecimalPlaces": 0
},
{
"id": 11,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Растение уже пересажено",
"field": "isPlantTransplanted",
"required": false,
"type": "bool"
},
{
"name": "Уровень сложности ухода",
"field": "careLevel",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Минимальный"
},
{
"id": 2,
"name": "Средний"
},
{
"id": 3,
"name": "Сложный"
}
]
},
{
"name": "Освещение",
"field": "lightingApartment",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Полутень"
},
{
"id": 2,
"name": "Рассеянный свет"
},
{
"id": 3,
"name": "Яркий свет"
}
]
},
{
"name": "Размер растения",
"field": "flowerSize",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "..."
}
]
},
{
"name": "Цветущее растение",
"field": "isFlowering",
"required": false,
"type": "bool"
},
{
"name": "Ядовито для детей и животных",
"field": "isPoisoned",
"required": false,
"type": "bool"
},
{
"name": "Товар предназначен для лиц старше 18 лет",
"field": "isAdultsOnly",
"required": false,
"type": "bool"
},
{
"name": "Требуется маркировка Честный знак",
"field": "isCzMarkingRequired",
"required": false,
"type": "bool"
},
{
"name": "Назначение сертификата",
"field": "certificatePurpose",
"required": true,
"type": "select",
"values": [
{
"id": 1,
"name": "На конкретную сумму"
},
{
"id": 2,
"name": "На услугу или товары"
}
]
},
{
"name": "Тип сертификата",
"field": "certificateType",
"required": true,
"type": "multiselect",
"values": [
{
"id": 1,
"name": "Электронный"
},
{
"id": 2,
"name": "Физический"
}
]
},
{
"name": "Изготовитель",
"field": "manufacturerName",
"required": false,
"type": "text"
},
{
"name": "Страна-производитель",
"field": "manufacturerCountry",
"required": false,
"type": "select",
"values": [
{
"id": 1,
"name": "Россия"
},
{
"id": 2,
"name": "..."
}
]
},
{
"name": "Адрес изготовителя",
"field": "manufacturerAddress",
"required": false,
"type": "text"
},
{
"name": "Магазин произвёл товар",
"field": "isShopProducedProduct",
"required": false,
"type": "bool"
},
{
"name": "Наименование импортёра",
"field": "importerName",
"required": false,
"type": "text"
},
{
"name": "Адрес импортёра",
"field": "importerAddress",
"required": false,
"type": "text"
},
{
"name": "Почтой в другие города",
"field": "isPostDelivery",
"required": false,
"type": "bool"
},
{
"name": "Почтовая ширина",
"field": "postWidth",
"required": false,
"type": "measure",
"measure": [
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Почтовая высота",
"field": "postHeight",
"required": false,
"type": "measure",
"measure": [
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Почтовая длина",
"field": "postLength",
"required": false,
"type": "measure",
"measure": [
{
"id": 3,
"maxDecimalPlaces": 0
},
{
"id": 6,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Вес товара для почты",
"field": "postWeight",
"required": false,
"type": "measure",
"measure": [
{
"id": 2,
"maxDecimalPlaces": 0
},
{
"id": 5,
"maxDecimalPlaces": 0
}
]
},
{
"name": "Примерный вес для почты",
"field": "approximateWeight",
"required": false,
"type": "select"
},
{
"name": "Тип размера для доставки почтой",
"field": "postSizeType",
"required": false,
"type": "select"
}
],
"additional": {
"summary": "Дополнительный товар (productType=3, subCategoryId=0)",
"value": {
"shopId": 260,
"subCategory": null,
"data": [
{
"name": "Название",
"field": "name",
"required": true,
"type": "text"
},
{
"name": "Цена",
"field": "price",
"required": true,
"type": "text",
"maxDecimalPlaces": 2
},
{
"name": "Фотографии",
"field": "images",
"required": true,
"type": "image"
},
{
"name": "Порядковый номер каким по счету предлагать в корзине относительно других доп товаров",
"field": "orderInList",
"required": false,
"type": "decimal",
"maxDecimalPlaces": 0,
"default": 9999
},
{
"name": "Товар предназначен для лиц старше 18 лет",
"field": "isAdultsOnly",
"required": false,
"type": "bool"
}
]
}
}
}Orders
Действия с заказами.
Просмотр списка заказов
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456ID заказа в системе Flowwow
111546Страница пагинации
1Кол-во записей на странице
20Дата создания заказа
2026-01-01Дата доставки от
2026-01-01Дата доставки до
2026-01-01Тип доставки
- 0 — Курьер отсутствует / Способ доставки не выбран
- 1 — Доставка курьером продавца
- 2 — Собственная доставка продавца
- 4 — Самовывоз
- 5 — Доставка flowwow
- 10 — Доставка курьером пешком
- 11 — Доставка курьером на автомобиле
- 12 — Доставка курьером на транспорте
- 20 — Доставка флористом пешком
- 21 — Доставка флористом на авто
- 22 — Доставка флористом на транспорте
- 23 — Доставка яндекс доставкой
- 24 — Доставка флориста на велике
- 26 — Доставка Gett доставкой
- 32 — Доставка сбермаркетом
- 33 — Доставка магнитом
- 34 — Доставка цифровых товаров (сертификаты)
1Possible values: Статус заказа
- 1 — Новый
- 2 — Принят
- 3 — Завершен
- 4 — Передан в доставку
- 5 — Фото до доставки
- 7 — Заказ ожидает, когда его заберет клиент из магазина
- 10 — Почтовый статус. Заказ собран
- 11 — Почтовый статус. Заказ доставляется почтой
- 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
1Possible values: Тип времени доставки
- 0 — Согласовать время с получателем
- 1 — Ближайшее время
- 2 — На период
2Possible values: OK
Общее количество заказов (без учёта пагинации)
100Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
GET /apiseller/orders/list?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": 19522730,
"shopId": 260,
"createdDate": 1762686732,
"status": 1,
"deliveryType": 1,
"deliveryTimeType": 2,
"deliveryDateFrom": 1762686732,
"deliveryDateTo": 1762686732,
"address": "Адрес доставки",
"courierInfo": "Комментарий для курьера",
"shopAdditionalInfo": "Комментарий для магазина",
"comment": "Комментарий клиента",
"photoBeforeUrl": "https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg",
"photoAfterUrl": "https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg",
"message": "Текст открытки",
"products": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"isArchived": true,
"type": 1,
"categoryId": 54,
"subCategoryId": 112,
"name": "Букет из роз",
"description": "Красивый букет из свежих роз.",
"url": "https://flowwow.com/product/12345",
"available": 1,
"stock": 10,
"minOrder": 1,
"price": "1990.00",
"discount": "20",
"currencyCode": "RUB",
"images": [
"https://example.com"
],
"productionTime": 1,
"shipmentTime": 1,
"canRent": 1,
"originalId": 7123456,
"isDeliveryPost": true,
"isStarred": true,
"vat": "10",
"stats": {
"productSales": 12500.5,
"conversionAll": 8.33,
"catalogViews": 500,
"itemViews": 120,
"addToCart": 24,
"purchase": 10
},
"properties": {
"width": {
"val": 30,
"measure": 3
},
"height": {
"val": 50,
"measure": 3
},
"color": 1,
"manufacturerName": "Кондитерская «Ромашка»",
"regionOfOrigin": "Москва",
"brand": "Ромашка",
"author": "Анна Иванова",
"textDimensions": "15 × 20 см",
"material": [
"Хлопок",
"Лён"
],
"filling": [
"Шоколад",
"Ваниль"
],
"gender": 2,
"consist": [
{
"name": "Роза",
"quantity": 15,
"measure": 1
}
],
"complianceDocumentType": 1,
"complianceDocumentLink": "https://pub.fsa.gov.ru/rds/declaration/view/123",
"composition": "Розы, эвкалипт",
"recommendation": "Меняйте воду ежедневно"
},
"count": 2,
"orderItemId": 65224485,
"cost": "2500.00",
"sum": "1990.00",
"selectedProperties": [
{
"propertyId": 45,
"propertyTitle": "Начинка",
"valueId": 17,
"valueTitle": "Красный бархат",
"type": null
}
]
}
],
"user": {
"name": "Иван Петров",
"phone": "79991234567"
},
"recipient": {
"name": "Марина Татьянина",
"phone": "79997654321"
},
"sourceHost": null
}
],
"total": 100
}Просмотр заказа
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор заказа.
123456OK
ID заказа в системе Flowwow
19522730ID магазина
260Время создания заказа
1762686732Статус заказа
- 1 — Новый
- 2 — Принят
- 3 — Завершен
- 4 — Передан в доставку
- 5 — Фото до доставки
- 7 — Заказ ожидает, когда его заберет клиент из магазина
- 10 — Почтовый статус. Заказ собран
- 11 — Почтовый статус. Заказ доставляется почтой
- 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
1Possible values: Тип доставки
- 0 — Курьер отсутствует / Способ доставки не выбран
- 1 — Доставка курьером продавца
- 2 — Собственная доставка продавца
- 4 — Самовывоз
- 5 — Доставка flowwow
- 10 — Доставка курьером пешком
- 11 — Доставка курьером на автомобиле
- 12 — Доставка курьером на транспорте
- 20 — Доставка флористом пешком
- 21 — Доставка флористом на авто
- 22 — Доставка флористом на транспорте
- 23 — Доставка яндекс доставкой
- 24 — Доставка флориста на велике
- 26 — Доставка Gett доставкой
- 32 — Доставка сбермаркетом
- 33 — Доставка магнитом
- 34 — Доставка цифровых товаров (сертификаты)
1Possible values: Тип времени доставки
- 0 — Согласовать время с получателем
- 1 — Ближайшее время
- 2 — На период
2Possible values: Время доставки от
1762686732Время доставки до
1762686732Адрес доставки. Отделяется символом ';' от детальной информации об адресе
Адрес доставкиКомментарий для курьера
Комментарий для курьераКомментарий для магазина
Комментарий для магазинаКомментарий клиента
Комментарий клиентаФото до доставки
https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpgФото после доставки
https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpgТекст открытки. Если есть, то в секции products будет элемент с данными открытки
Текст открыткиРесурс, на котором был создан заказ
- fmart — заказ создан на сайте FMART
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
GET /apiseller/orders/view?shopId=123456&orderId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"costDetails": {
"currency": "RUB",
"productPrice": {
"name": "Цена товаров",
"value": 6990
},
"dopProductPrice": {
"name": "цена доп. товаров",
"value": 0
},
"delivery": {
"name": "Доставка",
"value": 249
},
"commission": {
"name": "Фиксированная комиссия с товаров с НДС",
"value": 427
},
"commissionPercent": {
"name": "Комиссия",
"value": 14
},
"clientBonuses": {
"name": "Бонусы клиенту с НДС",
"value": 256
},
"acquirePercent": {
"name": "Переменная с заказа с НДС",
"value": 221
},
"commissionSum": {
"name": "Комиссия суммарно",
"value": 648
},
"rentCost": {
"name": "Аренда товаров",
"value": 0
},
"deliveryCompensationCost": {
"name": "Аренда товаров",
"value": 0
},
"productCommissions": [
{
"name": "Товар «Букет для нее», 5% с НДС",
"value": 427
}
]
},
"id": 23481965,
"shopId": 120496,
"createdDate": 1783082849,
"status": 1,
"price": "6990.00",
"products": [
{
"offerId": "",
"productId": 67709265,
"isActive": false,
"isArchived": false,
"type": 1,
"categoryId": 1,
"subCategoryId": 1,
"name": "Букет для нее",
"description": "",
"url": "http://flowwow.loc/luchshey-mame-4131",
"available": 1,
"stock": 0,
"minOrder": 1,
"price": "6990.00",
"discount": "0",
"currencyCode": "RUB",
"images": [
"https://flowwow.com/data/flowers/1000x1000/21/1732306454_65735521.jpg",
"https://flowwow.com/data/flowers/1000x1000/18/1732306454_50497918.jpg",
"https://flowwow.com/data/flowers/1000x1000/97/1732306454_41166897.jpg",
"https://flowwow.com/data/flowers/1000x1000/76/1732306454_84667176.jpg"
],
"productionTime": 25,
"shipmentTime": 0,
"canRent": 0,
"originalId": 0,
"isDeliveryPost": false,
"isStarred": false,
"vat": "0",
"stats": null,
"properties": null,
"count": 1,
"orderItemId": 65757149,
"cost": "6990.00",
"sum": "6990.00",
"selectedProperties": []
}
],
"deliveryType": 1,
"deliveryTimeType": 1,
"deliveryDateFrom": 1783082849,
"deliveryDateTo": 1783084649,
"address": "улица Ленина, 78;",
"courierInfo": "",
"shopAdditionalInfo": "",
"message": "",
"comment": null,
"user": {
"name": "Андрей",
"phone": "79092607032"
},
"recipient": null,
"photoBeforeUrl": null,
"photoAfterUrl": null,
"sourceHost": null
}Переводит заказ в статус «Принят».
Идентификатор заказа
101OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/accept HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"orderId": 123
}textПереводит заказ в статус «Отклонен».
Идентификатор заказа
101Причины отказа от заказа со стороны магазина.
Возможные значения:
1 — Нет товара в наличии
2 — Не успевает доставка
3 — Неправильный город
4 — Отказ клиента
5 — Отказ CRM-заказа
6 — Другая причина
1Possible values: Текст причины отказа.
Обязателен, если reason = 6 (Другая причина).
Комментарий клиенту.
OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/refuse HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 196
{
"orderId": 123,
"reason": 6,
"reasonText": "Другая причина: нет возможности подтвердить заказ",
"commentClient": "Извините, заказ отменён"
}textПереводит заказ в статус «Передан в доставку».
Идентификатор заказа
101OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/courierLeft HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"orderId": 9977016
}[]Переводит заказ в статус «Заказ ожидает, когда его заберет клиент из магазина».
Идентификатор заказа
23788837OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/awaitPickup HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 20
{
"orderId": 23788837
}[]Переводит заказ в статус «Заказ собран» (Почтовый статус).
Идентификатор заказа
101OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/pack HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"orderId": 123
}textПереводит заказ в статус «Выполнен».
Идентификатор заказа
101OK
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/finish HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"orderId": 123
}textЗагрузка фотографии до и после доставки
Идентификатор заказа
101ID магазина
93117Тип фотографии (0 - до доставки, 1 - после доставки)
0Possible values: Фотография в формате JPEG или PNG
OK
ID заказа в системе Flowwow
19522730ID магазина
260Время создания заказа
1762686732Статус заказа
- 1 — Новый
- 2 — Принят
- 3 — Завершен
- 4 — Передан в доставку
- 5 — Фото до доставки
- 7 — Заказ ожидает, когда его заберет клиент из магазина
- 10 — Почтовый статус. Заказ собран
- 11 — Почтовый статус. Заказ доставляется почтой
- 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
1Possible values: Тип доставки
- 0 — Курьер отсутствует / Способ доставки не выбран
- 1 — Доставка курьером продавца
- 2 — Собственная доставка продавца
- 4 — Самовывоз
- 5 — Доставка flowwow
- 10 — Доставка курьером пешком
- 11 — Доставка курьером на автомобиле
- 12 — Доставка курьером на транспорте
- 20 — Доставка флористом пешком
- 21 — Доставка флористом на авто
- 22 — Доставка флористом на транспорте
- 23 — Доставка яндекс доставкой
- 24 — Доставка флориста на велике
- 26 — Доставка Gett доставкой
- 32 — Доставка сбермаркетом
- 33 — Доставка магнитом
- 34 — Доставка цифровых товаров (сертификаты)
1Possible values: Тип времени доставки
- 0 — Согласовать время с получателем
- 1 — Ближайшее время
- 2 — На период
2Possible values: Время доставки от
1762686732Время доставки до
1762686732Адрес доставки. Отделяется символом ';' от детальной информации об адресе
Адрес доставкиКомментарий для курьера
Комментарий для курьераКомментарий для магазина
Комментарий для магазинаКомментарий клиента
Комментарий клиентаФото до доставки
https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpgФото после доставки
https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpgТекст открытки. Если есть, то в секции products будет элемент с данными открытки
Текст открыткиРесурс, на котором был создан заказ
- fmart — заказ создан на сайте FMART
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/uploadPhoto HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 65
{
"orderId": 9968909,
"shopId": 93117,
"type": 0,
"photo": "binary data"
}{
"id": 19522730,
"shopId": 260,
"createdDate": 1762686732,
"status": 1,
"deliveryType": 1,
"deliveryTimeType": 2,
"deliveryDateFrom": 1762686732,
"deliveryDateTo": 1762686732,
"address": "Адрес доставки",
"courierInfo": "Комментарий для курьера",
"shopAdditionalInfo": "Комментарий для магазина",
"comment": "Комментарий клиента",
"photoBeforeUrl": "https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg",
"photoAfterUrl": "https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg",
"message": "Текст открытки",
"products": [
{
"offerId": "FLOW-0001",
"productId": 83418243,
"isActive": true,
"type": 1,
"categoryId": 54,
"subCategoryId": 112,
"name": "Букет из роз",
"description": "Красивый букет из свежих роз.",
"url": "https://flowwow.com/product/12345",
"available": 1,
"stock": 10,
"minOrder": 1,
"price": "1990.00",
"discount": "20",
"currencyCode": "RUB",
"images": [
"https://example.com"
],
"productionTime": 1,
"shipmentTime": 1,
"canRent": 1,
"originalId": 7123456,
"isDeliveryPost": true,
"isStarred": true,
"vat": "10",
"count": 2
}
],
"user": {
"name": "Иван Петров",
"phone": "79991234567"
},
"recipient": {
"name": "Марина Татьянина",
"phone": "79997654321"
},
"sourceHost": null
}Выполняет проверку кода маркировки (КиЗ) товара в заказе селлера через систему «Честный знак».
Идентификатор заказа
123Код маркировки товара
0104630005831152215Y9>q+5OK
Код результата проверки кода маркировки.
Возможные значения:
parsing_error— Ошибка парсинга, скорее всего неверный КМnot_registered— Участник оборота не зарегистрирован в «Честном ЗНАКе»another_inn— Не соответствует ИНН владельца товараnot_introduced— Товар не находится в оборотеrequest_failed— Ошибка при обращении к True APIpassed— Все проверки пройдены, товар доступен к реализации
Сообщение о результате проверки кода маркировки
Является ли код маркировки действительным
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/validateNomenclatureCode HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50
{
"orderId": 123,
"code": "0104630005831152215Y9>q+5"
}{
"code": "passed",
"message": "",
"isValid": true
}Добавление кодов маркировки товара
Идентификатор заказа
23315616ID магазина
240829ID товара в заказе
65224485Код маркировки
ew_BTcnIaHe00snZjOnJ-RfijOK
ID маркировки товара в системе Flowwow. Нужен, если потребуется обновить код маркировки товара
19522730Код маркировки товара
ew_BTcnIaHe00snZjOnJ-RfijBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/addNomenclatureCode HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94
{
"shopId": 240829,
"orderId": 23315616,
"orderItemId": 65224485,
"code": "ew_BTcnIaHe00snZjOnJ-Rfij"
}{
"id": 19522730,
"code": "ew_BTcnIaHe00snZjOnJ-Rfij"
}Изменение кода маркировки товара
Идентификатор заказа
23315616ID магазина
240829ID кода маркировки в системе Flowwow
213Код маркировки
nZjOnJ-Rfijew_BTcnIaHe00sOK
ID маркировки товара в системе Flowwow. Нужен, если потребуется обновить код маркировки товара
19522730Код маркировки товара
ew_BTcnIaHe00snZjOnJ-RfijBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/orders/updateNomenclatureCode HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 84
{
"shopId": 240829,
"orderId": 23315616,
"codeId": 213,
"code": "nZjOnJ-Rfijew_BTcnIaHe00s"
}{
"id": 19522730,
"code": "ew_BTcnIaHe00snZjOnJ-Rfij"
}Webhook
Управление и тестирование веб-хуков.
Мы будем присылать вам HTTP POST-запросы в формате JSON. Вот пример тела запроса:
Поля:
• uuid — уникальный ID этой доставки. При повторных попытках UUID не меняется. • event — тип события (например, смена статуса заказа). • order.id — ID заказа в нашей системе. Каждый запрос будет содержать следующие заголовки:
• Content-Type: application/json — всегда. • X-Webhook-Signature: sha256= — только если вы предоставили секретный ключ.
Чтобы проверить подлинность запроса, вычислите HMAC-SHA256 от тела запроса, используя ваш секретный ключ, и сравните с тем, что пришло в X-Webhook-Signature. Если значения совпадают — запрос настоящий.
Вот полный список значений поля event, которые могут приходить в вебхуках:
• order.paid — новый заказ. Приходит когда покупатель успешно оплатил заказ. Такой заказ необходимо принять
• order.cancelled — заказ отменён. Приходит когда заказ отменён покупателем или системой.
• order.finished — заказ завершён. Приходит когда заказ успешно доставлен и закрыт.
• test — тестовое событие. Отправляется вручную при проверке подключения.
Отправляет тестовый запрос на настроенный URL веб-хука холдинга.
В теле запроса на адрес веб-хука будет передано событие test. Метод всегда возвращает HTTP 200; результат отправки (код ответа и текст ошибки при неудаче) содержится в теле ответа.
OK
Текст ошибки при неудачной отправке; пустая строка при успехе
HTTP-статус ответа веб-хука; 0 если соединение не установлено
200Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
POST /apiseller/webhook/test HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"message": "",
"httpCode": 200
}Managers
Управление менеджерами магазина
Возвращает список менеджеров для указанного магазина.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Общее кол-во менеджеров
3Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
GET /apiseller/managers/list?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"id": 101,
"name": "Иван Иванов",
"phone": "+79001234567",
"photo": "https://cdn.flowwow.com/manager.jpg"
}
],
"total": 3
}Reviews
Работа с отзывами магазина
Сохраняет ответ магазина на отзыв. Контактные данные в тексте удаляются. Отзыв должен принадлежать указанному магазину.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456ID отзыва. Допускается целое число или числовая строка
^[1-9]\d*$Ответ магазина на отзыв
Ответ магазина сохранён
ID отзыва
Сохранённый ответ магазина
Дата и время создания ответа в формате Y-m-d H:i:s
2026-08-19 12:34:56Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/review/answer?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59
{
"reviewId": 123,
"answer": "Спасибо за отзыв!"
}{
"reviewId": 1,
"answer": "text",
"answerCreatedAt": "2026-08-19 12:34:56"
}Certificate templates
Работа с шаблонами специальных сертификатов
Возвращает все шаблоны специальных сертификатов указанного магазина.
Метод доступен только для российских потребителей API и магазинов, перечисленных в фича-флаге shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456OK
Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
GET /apiseller/certificateTemplates?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"templates": [
{
"id": 123,
"text": "Поздравляем! Ваш сертификат готов к использованию.",
"isProduction": true
}
]
}Создаёт новый непроизводственный шаблон специального сертификата магазина. Поле isProduction у созданного шаблона всегда равно false.
Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Текст шаблона сертификата
<html><body>Сертификат № {{ certificateNumber }}</body></html>Шаблон создан
Идентификатор шаблона сертификата
123Текст шаблона сертификата
Поздравляем! Ваш сертификат готов к использованию.Созданный шаблон всегда является непроизводственным
Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
POST /apiseller/certificateTemplates/create?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 85
{
"text": "<html><body>Сертификат № {{ certificateNumber }}</body></html>"
}{
"id": 123,
"text": "Поздравляем! Ваш сертификат готов к использованию.",
"isProduction": false
}Полностью удаляет указанный непроизводственный шаблон сертификата из базы данных. Боевой шаблон удалить нельзя: сначала необходимо назначить боевым другой шаблон.
Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор удаляемого шаблона сертификата
123Шаблон удалён
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
DELETE /apiseller/certificateTemplates/delete?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"templateId": 123
}[]Генерирует PDF по указанному шаблону и возвращает публичную ссылку на файл в S3. Переданные параметры подставляются в шаблон. Для отсутствующих параметров используются автоматически сгенерированные тестовые значения.
Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор шаблона сертификата
123ID заказа для подстановки в шаблон. Если не указан, генерируется автоматически
1234567890Номер сертификата. Если не указан, генерируется автоматически
1234567890123Код активации сертификата. Если не указан, генерируется автоматически
123456Номинал сертификата. Если не указан, генерируется автоматически
3000Название товара. Если не указано, используется тестовое название
Подарочный сертификатPDF-предпросмотр создан
Идентификатор шаблона сертификата
123Текст шаблона сертификата
Поздравляем! Ваш сертификат готов к использованию.Используется ли шаблон в боевой среде
Публичная ссылка на PDF-предпросмотр шаблона в S3
https://cdn.flowwow.com/certificates/test_0123456789abcdef.pdfBad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/certificateTemplates/preview?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 170
{
"templateId": 123,
"orderId": 1234567890,
"certificateNumber": 1234567890123,
"activationCode": 123456,
"nominal": 3000,
"productName": "Подарочный сертификат"
}{
"id": 123,
"text": "Поздравляем! Ваш сертификат готов к использованию.",
"isProduction": true,
"previewUrl": "https://cdn.flowwow.com/certificates/test_0123456789abcdef.pdf"
}Делает указанный шаблон единственным боевым шаблоном сертификатов магазина. Переключение выполняется атомарно: предыдущий боевой шаблон отключается, а выбранный шаблон получает признак isProduction: true.
Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Идентификатор шаблона сертификата, который нужно сделать боевым
123Боевой шаблон изменён
Идентификатор шаблона сертификата
123Текст шаблона сертификата
Поздравляем! Ваш сертификат готов к использованию.Выбранный шаблон является боевым
Bad Request
Unauthorized
Forbidden
Not Found
Too Many Requests
Internal Server Error
POST /apiseller/certificateTemplates/setProduction?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"templateId": 123
}{
"id": 123,
"text": "Поздравляем! Ваш сертификат готов к использованию.",
"isProduction": true
}Certificate activation codes
Добавляет коды активации электронных подарочных сертификатов магазина. Поддерживает частичное сохранение: ошибки отдельных записей не препятствуют сохранению остальных записей.
Метод доступен только российским холдингам и магазинам из настройки shop.special_shop_ids.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Результат обработки всех переданных записей
Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
POST /apiseller/certificateTemplates/activationCodes?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 240
{
"certificateActivationCodes": [
{
"product_id": 123,
"activation_code": "CERT-000001",
"pin_code": "1234",
"expired_at": "2027-12-31 23:59:59"
},
{
"product_id": 124,
"activation_code": "CERT-000002",
"pin_code": "5678",
"expired_at": "2028-12-31 23:59:59"
}
]
}{
"data": [
{
"index": 0,
"product_id": 123,
"activation_code": "CERT-000001",
"pin_code": "1234",
"expired_at": "2027-12-31 23:59:59"
}
],
"errors": [
{
"index": 1,
"product_id": 124,
"activation_code": "CERT-000002",
"pin_code": "1234",
"expired_at": "2027-12-31 23:59:59",
"message": "Товар не является электронным сертификатом"
}
]
}Последнее обновление
Это было полезно?

