АПИ
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"
}Возвращает список магазинов для холдинга или один магазин - для остальных случаев.
Управление пагинацией в отдаваемой коллекции
Статус магазина:
| Статус | Описание |
|---|---|
| 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
}Возвращает список товаров магазина с возможностью фильтрации. Поддерживается пагинация.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
123456Список идентификаторов товаров в системе магазина
FLOW-0001Идентификаторы товаров в системе Flowwow
83418243Идентификаторы категорий в системе Flowwow
54Тип товара:
1— обычный товар,2— готовый товар,3— дополнительный товар.
Номер страницы. Нумерация начинается с 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,
"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"
}
],
"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": "Товар не существует"
}
]
}Делает товары видимыми на витрине и доступными к продаже без перевода их в архив. Если у товара заданы свойства минимального количества для заказа и доступного количества, то для открытия товара доступное количество должно быть больше либо равно минимальному количеству для заказа. Для товаров из оптовых категорий доступное количество рассчитывается как произведение: доступное количество × количество в упаковке. Если до выполнения запроса в магазине не было ни одного открытого товара и в результате запроса появился хотя бы один открытый обычный или готовый товар, магазин переводится в статус активного (при соблюдении остальных условий активности магазина). Подтверждение наличия товаров менеджером через данный эндпоинт не производится.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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.
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": "Товар не существует"
}
]
}Возвращает информацию по ценам и скидкам товаров в магазине
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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": "Товар не существует"
}
]
}Возвращает иерархическое дерево активных категорий (групп) с их подкатегориями (типами). Результат фильтруется по стране магазина — недоступные в стране категории и подкатегории не включаются. Результат не пагинируется (отдаётся целиком).
Поле 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.
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": "Товар не существует"
}
]
}Возвращает список свойств для одной подкатегории товаров.
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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"
}
]
}
}
}Просмотр заказа
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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: */*
{
"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
}Просмотр списка заказов
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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,
"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
}
],
"total": 100
}Переводит заказ в статус «Отклонен».
Идентификатор заказа
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/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/courierLeft HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 19
{
"orderId": 9977016
}[]Переводит заказ в статус «Выполнен».
Идентификатор заказа
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
}Возвращает один товар из архива
Идентификатор склада или магазина.
Его можно узнать с помощью запроса 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": "Товар не существует"
}Переводит заказ в статус «Принят».
Идентификатор заказа
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Последнее обновление
Это было полезно?

