For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Перейти к содержимому

Открытое API для продавцов (0.0.1)

Ping

Методы проверки состояния api.

Проверка API

get

Возвращает тип ответа по параметру say.

Query parameters
saystring · enumOptional

Какой ответ получить

Тип запросаОписаниеДействие
helloКампания активнаобычный ответ сервера (200)
error400Ошибка клиента 400имитация ошибки клиента 400
error401Ошибка клиента 401имитация ошибки клиента 401
error403Ошибка клиента 403имитация ошибки клиента 403
error404Ошибка клиента 404имитация ошибки клиента 404
error429Ошибка клиента 429имитация ошибки клиента 429
error500Ошибка сервера 500имитация ошибки сервера 500
Example: HelloPossible values:
Responses
200

Success

application/json
saystringRequired

Ответ сервера

Example: hello
get/apiseller/ping/check
GET /apiseller/ping/check HTTP/1.1
Host: apis.flowwow.com
Accept: */*
{
  "say": "hello"
}

Shop

Информация о магазинах или складах холдинга.

Просмотр списка магазинов

post

Возвращает список магазинов для холдинга или один магазин - для остальных случаев.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

Управление пагинацией в отдаваемой коллекции

statusstring · enumRequired

Статус магазина:

СтатусОписание
moderationНа модерации
activeАктивен
disabledДеактивирован
Possible values:
shopIdsinteger · int32[] · min: 1 · max: 1000Optional

Список идентификаторов магазинов

Example: 101
pageintegerOptional

Номер страницы. Нумерация начинается с 0.

Default: 0
limitinteger · min: 1 · max: 50Optional

Количество элементов в ответе. Максимум — 50, минимум — 1.

Default: 10
Responses
200

OK

application/json
totalintegerOptional

Общее количество магазинов

post/apiseller/shops
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
}

Получение отзывов магазина

get

Возвращает отзывы указанного магазина с пагинацией, фильтрацией и сортировкой.

Фильтры передаются в формате filters[withText]=true.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
pageinteger · min: 1Optional

Номер страницы

Default: 1
limitinteger · min: 1 · max: 100Optional

Количество отзывов на странице

Default: 5
sortstring · enumOptional

Порядок сортировки:

  • rating_asc — по возрастанию рейтинга;
  • rating_desc — по убыванию рейтинга;
  • date_asc — сначала старые;
  • date_desc — сначала новые.
Possible values:
Responses
200

OK

application/json
totalintegerRequired

Общее количество отзывов, соответствующих фильтрам

withPhotosbooleanRequired

Есть ли у магазина отзывы с фотографиями покупателей

get/apiseller/shops/review
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

Возвращает список товаров магазина с возможностью фильтрации. Поддерживается пагинация.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
offerIdsstring[] · min: 1 · max: 1000Optional

Список идентификаторов товаров в системе магазина

Example: FLOW-0001
productIdsinteger · int32[] · min: 1 · max: 1000Optional

Идентификаторы товаров в системе Flowwow

Example: 83418243
categoryIdsinteger[] · min: 1 · max: 1000Optional

Идентификаторы категорий в системе Flowwow

Example: 54
typeinteger · enumOptional

Тип товара:

  • 1 — обычный товар,
  • 2 — готовый товар,
  • 3 — дополнительный товар.
Possible values:
withArchivebooleanOptional

Если true, поиск выполняется по активным и архивным товарам.

Default: false
withStatsbooleanOptional

Если true, в каждом товаре возвращается объект stats со статистикой за последние 30 дней.

Default: false
extendedbooleanOptional

Если true, в каждом товаре возвращается объект properties со свойствами товара. Имена и формат значений совпадают с правилами ApiSeller из /apiseller/categories/subCategoryProperties, /apiseller/products/create и /apiseller/products/update. Поля, которые уже есть в корне ProductShortDto, внутри properties не дублируются. Для свойств типа text возвращается исходная строка, для multitext — массив исходных строк, для select — ID выбранного варианта из values.

Default: false
pageintegerOptional

Номер страницы. Нумерация начинается с 0.

Default: 0
limitinteger · min: 1 · max: 1000Optional

Количество элементов в ответе. Минимум — 1, максимум — 1000, по умолчанию — 10.

Default: 10
Responses
200

OK

application/json
totalintegerOptional

Общее количество товаров (без учёта пагинации)

Example: 150
post/apiseller/products
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
}

Создание товаров

post

Создаёт новый товар в каталоге магазина на Flowwow.

Ограничения:

  • Готовые товары (productType=2) не могут быть созданы через API.

  • Основной товар (productType=1) — требует указания subCategoryId.

  • Дополнительный товар (productType=3) — не требует subCategoryId.

Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на создание.

Изображения: Загружаются асинхронно по переданным URL. Первое появление в интерфейсе Flowwow может занять до 30 минут.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json

Результат выполнения операции создания товаров

shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
post/apiseller/products/create
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": "Цена товара должна содержать строковое значение"
    }
  ]
}

Изменение товаров

post

Обновляет товар в каталоге магазина на Flowwow.

При обновлении необходимо передавать все актуальные поля товара (частичное обновление не поддерживается).

Ограничения:

  • Изменение productType и subCategoryId через API запрещено.

  • Готовые товары (productType=2) не могут быть созданы или изменены через API.

  • Для основного товара (productType=1) поле subCategoryId обязательно.

  • Для дополнительного товара (productType=3) поле subCategoryId не требуется.

Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на обновление.

Изображения: Загружаются асинхронно по переданным URI. Первое появление в интерфейсе Flowwow может занять до 30 минут.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json

Результат выполнения операции создания товаров

shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
post/apiseller/products/update
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": "Цена товара должна содержать строковое значение"
    }
  ]
}

Связывание с товарами из магазина продавца

post

Связывает товары из магазина продавца на маркетплейсе Flowwow с товарами из информационной системы продавца по идентификаторам. Если товар с указанным productId не существует у магазина в системе Flowwow, будет возвращена ошибка для этого товара. Если внутри одного запроса присутствуют пары с одинаковым offerId или productId, все такие пары считаются некорректными и не обрабатываются. Частичная обработка для конфликтующих пар не выполняется, каждая из них будет возвращена в массиве errors. Если прислать пары ID, которые уже были ранее привязаны, то такие пары изменены не будут. Готовые товары на Flowwow нельзя привязывать, при попытке связывания, такие товары найдены не будут.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json
shopIdintegerOptional

ID запрошенного магазина, в рамках только данного магазина производится работа с парами offerId и productId

post/apiseller/products/offersMappings
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 в запросе"
    }
  ]
}

Скрытие товаров

post

Делает товары невидимыми на витрине и недоступными для продажи без возврата их из архива. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

Success

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/products/hide
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 магазина

post

Полностью заменяет список товаров топ-18 магазина.

Частичное обновление не поддерживается: для добавления или удаления товаров необходимо передать полный желаемый список топ-18. Если хотя бы один товар не прошёл валидацию, список не изменяется. Товар должен существовать, принадлежать указанному магазину, не быть дополнительным, скрытым или заблокированным. Пустой массив offers очищает топ-18 магазина.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

Список топ-18 успешно заменён

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/products/setTop18
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

Делает товары видимыми на витрине и доступными к продаже без перевода их в архив. Если у товара заданы свойства минимального количества для заказа и доступного количества, то для открытия товара доступное количество должно быть больше либо равно минимальному количеству для заказа. Для товаров из оптовых категорий доступное количество рассчитывается как произведение: доступное количество × количество в упаковке. Если до выполнения запроса в магазине не было ни одного открытого товара и в результате запроса появился хотя бы один открытый обычный или готовый товар, магазин переводится в статус активного (при соблюдении остальных условий активности магазина). Подтверждение наличия товаров менеджером через данный эндпоинт не производится.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

Success

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/products/unhide
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

Переносит один товар в архив

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body

Идентификатор товара в системе продавца

offerIdstring · max: 50 · nullableOptional

Идентификатор товара в системе продавца.

Example: FLOW-0001
Responses
200

OK

application/json

Результат выполнения операции переноса товара в архив

shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
offerIdstring · max: 50 · nullableOptional

Идентификатор товара в системе продавца.

Example: FLOW-0001
productIdinteger · int32 · min: 1 · nullableOptional

Идентификатор товара в системе Flowwow

Example: 83418243
isArchivedbooleanOptional

Архивирован ли товар

Example: true
updatedbooleanOptional

Были ли изменены данные у товара

Example: true
messagestringOptional

Сообщение об ошибке

Example: Товар не существует
post/apiseller/products/archive
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

Возвращает один товар из архива

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body

Идентификатор товара в системе продавца

offerIdstring · max: 50 · nullableOptional

Идентификатор товара в системе продавца.

Example: FLOW-0001
Responses
200

OK

application/json

Результат выполнения операции возврата товара из архива

shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
offerIdstring · max: 50 · nullableOptional

Идентификатор товара в системе продавца.

Example: FLOW-0001
productIdinteger · int32 · min: 1 · nullableOptional

Идентификатор товара в системе Flowwow

Example: 83418243
isArchivedbooleanOptional

Архивирован ли товар

Example: true
updatedbooleanOptional

Были ли изменены данные у товара

Example: true
messagestringOptional

Сообщение об ошибке

Example: Товар не существует
post/apiseller/products/unarchive
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

Возвращает информацию по остаткам в магазине продавца

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/stocks/get
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": "Товар не существует"
    }
  ]
}

Изменение остатков по товарам

put

Изменяет информацию по остаткам в магазине продавца. Товар скрывается при изменении остатка с > 0 на 0. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18». Скрытие товара без изменения его остатков производится с помощью запроса POST /apiseller/products/hide

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

Success

application/json

Информация об остатках одного товара на одном из складов.

shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
put/apiseller/stocks/put
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

Возвращает информацию по ценам и скидкам товаров в магазине

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json
shopIdinteger · int32 · min: 1Optional

Идентификатор магазина.

Example: 260
post/apiseller/prices/get
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": "Товар не существует"
    }
  ]
}

Изменение цен и скидок у товаров

put

Изменяет цены и/или скидки у товаров в магазине

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

OK

application/json

Результаты изменения цены/скидки для товаров

shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
put/apiseller/prices/put
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

Информация о категориях и подкатегориях товаров.

Дерево категорий и подкатегорий товаров

post

Возвращает иерархическое дерево активных категорий (групп) с их подкатегориями (типами). Результат фильтруется по стране магазина — недоступные в стране категории и подкатегории не включаются. Результат не пагинируется (отдаётся целиком).

Поле chestnyZnakMarkingRequirement

Поле отдаётся только для магазинов из Российской Федерации. Указывает требование маркировки товаров системой «Честный Знак»:

Значение
Описание

never

Маркировка не требуется для товаров данной подкатегории

selectable

Магазин сам решает, нужна ли маркировка для конкретного товара

always

Все товары данной подкатегории обязательно должны быть промаркированы

Для магазинов из других стран поле не включается в ответ.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1Required

Идентификатор магазина. Передаётся как GET-параметр. Пример: ?shopId=260

Responses
200

OK

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/categories/tree
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

Возвращает список свойств для одной подкатегории товаров.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
subCategoryIdinteger · min: 1 · max: 4294967295Required

Идентификатор подкатегории товаров

Его можно узнать с помощью запроса POST /apiseller/categories/tree

Example: 1
productTypeinteger · enumRequired

Идентификатор типа товаров. От типа товара зависят свойства товара. Возможные значения:

  • 1 — обычный товар. Может долгое время находиться в каталоге, может существовать во многих экземплярах, имеет остатки на складе или время изготовления
  • 3 — дополнительный товар. Не отображается клиентам в каталоге товаров и на странице магазина, виден только в корзине. Может идти дополнительно в заказе вместе с одним или несколькими обычными или готовыми товарами

Настройки для готовых товаров (productType=2) не предоставляются через данный эндпоинт, так как через API нельзя создать готовые товары, используйте для этого приложение FLOWWOW для продавцов.

Example: 1Possible values:
Responses
200

OK

application/json
shopIdinteger · int32 · min: 1Required

Идентификатор магазина.

Example: 260
post/apiseller/categories/subCategoryProperties
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

Действия с заказами.

Просмотр списка заказов

get

Просмотр списка заказов

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
idinteger · nullableOptional

ID заказа в системе Flowwow

Example: 111546
pageinteger · nullableOptional

Страница пагинации

Example: 1
limitinteger · min: 1 · max: 100 · nullableOptional

Кол-во записей на странице

Example: 20
createdDatestring · Y-m-d · nullableOptional

Дата создания заказа

Example: 2026-01-01
deliveryDateFromstring · Y-m-d · nullableOptional

Дата доставки от

Example: 2026-01-01
deliveryDateTostring · Y-m-d · nullableOptional

Дата доставки до

Example: 2026-01-01
deliveryTypeinteger · enumOptional

Тип доставки

  • 0 — Курьер отсутствует / Способ доставки не выбран
  • 1 — Доставка курьером продавца
  • 2 — Собственная доставка продавца
  • 4 — Самовывоз
  • 5 — Доставка flowwow
  • 10 — Доставка курьером пешком
  • 11 — Доставка курьером на автомобиле
  • 12 — Доставка курьером на транспорте
  • 20 — Доставка флористом пешком
  • 21 — Доставка флористом на авто
  • 22 — Доставка флористом на транспорте
  • 23 — Доставка яндекс доставкой
  • 24 — Доставка флориста на велике
  • 26 — Доставка Gett доставкой
  • 32 — Доставка сбермаркетом
  • 33 — Доставка магнитом
  • 34 — Доставка цифровых товаров (сертификаты)
Example: 1Possible values:
statusinteger · enumOptional

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

  • 1 — Новый
  • 2 — Принят
  • 3 — Завершен
  • 4 — Передан в доставку
  • 5 — Фото до доставки
  • 7 — Заказ ожидает, когда его заберет клиент из магазина
  • 10 — Почтовый статус. Заказ собран
  • 11 — Почтовый статус. Заказ доставляется почтой
  • 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
Example: 1Possible values:
deliveryTimeTypeinteger · enumOptional

Тип времени доставки

  • 0 — Согласовать время с получателем
  • 1 — Ближайшее время
  • 2 — На период
Example: 2Possible values:
Responses
200

OK

application/json
totalintegerOptional

Общее количество заказов (без учёта пагинации)

Example: 100
get/apiseller/orders/list
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
}

Просмотр заказа

get

Просмотр заказа

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
orderIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор заказа.

Example: 123456
Responses
200

OK

application/json
idintegerOptional

ID заказа в системе Flowwow

Example: 19522730
shopIdintegerOptional

ID магазина

Example: 260
createdDateintegerOptional

Время создания заказа

Example: 1762686732
statusinteger · enumOptional

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

  • 1 — Новый
  • 2 — Принят
  • 3 — Завершен
  • 4 — Передан в доставку
  • 5 — Фото до доставки
  • 7 — Заказ ожидает, когда его заберет клиент из магазина
  • 10 — Почтовый статус. Заказ собран
  • 11 — Почтовый статус. Заказ доставляется почтой
  • 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
Example: 1Possible values:
deliveryTypeinteger · enumOptional

Тип доставки

  • 0 — Курьер отсутствует / Способ доставки не выбран
  • 1 — Доставка курьером продавца
  • 2 — Собственная доставка продавца
  • 4 — Самовывоз
  • 5 — Доставка flowwow
  • 10 — Доставка курьером пешком
  • 11 — Доставка курьером на автомобиле
  • 12 — Доставка курьером на транспорте
  • 20 — Доставка флористом пешком
  • 21 — Доставка флористом на авто
  • 22 — Доставка флористом на транспорте
  • 23 — Доставка яндекс доставкой
  • 24 — Доставка флориста на велике
  • 26 — Доставка Gett доставкой
  • 32 — Доставка сбермаркетом
  • 33 — Доставка магнитом
  • 34 — Доставка цифровых товаров (сертификаты)
Example: 1Possible values:
deliveryTimeTypeinteger · enumOptional

Тип времени доставки

  • 0 — Согласовать время с получателем
  • 1 — Ближайшее время
  • 2 — На период
Example: 2Possible values:
deliveryDateFromintegerOptional

Время доставки от

Example: 1762686732
deliveryDateTointegerOptional

Время доставки до

Example: 1762686732
addressstringOptional

Адрес доставки. Отделяется символом ';' от детальной информации об адресе

Example: Адрес доставки
courierInfostringOptional

Комментарий для курьера

Example: Комментарий для курьера
shopAdditionalInfostringOptional

Комментарий для магазина

Example: Комментарий для магазина
commentstring · nullableOptional

Комментарий клиента

Example: Комментарий клиента
photoBeforeUrlstring · nullableOptional

Фото до доставки

Example: https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg
photoAfterUrlstring · nullableOptional

Фото после доставки

Example: https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg
messagestringOptional

Текст открытки. Если есть, то в секции products будет элемент с данными открытки

Example: Текст открытки
sourceHoststring · nullableOptional

Ресурс, на котором был создан заказ

  • fmart — заказ создан на сайте FMART
get/apiseller/orders/view
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
}

Изменение статуса заказа на Принят

post

Переводит заказ в статус «Принят».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
Responses
200

OK

application/json
stringOptional
post/apiseller/orders/accept
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

Изменение статуса заказа на Отклонен

post

Переводит заказ в статус «Отклонен».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
reasoninteger · enumRequired

Причины отказа от заказа со стороны магазина.

Возможные значения:

1 — Нет товара в наличии
2 — Не успевает доставка
3 — Неправильный город
4 — Отказ клиента
5 — Отказ CRM-заказа
6 — Другая причина

Example: 1Possible values:
reasonTextstring · max: 255Optional

Текст причины отказа. Обязателен, если reason = 6 (Другая причина).

commentClientstring · max: 700Optional

Комментарий клиенту.

Responses
200

OK

application/json
stringOptional
post/apiseller/orders/refuse
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

Изменение статуса заказа на "Передан в доставку"

post

Переводит заказ в статус «Передан в доставку».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
Responses
200

OK

application/json
arrayOptional
post/apiseller/orders/courierLeft
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
}
[]

Изменение статуса заказа на "Заказ ожидает, когда его заберет клиент из магазина"

post

Переводит заказ в статус «Заказ ожидает, когда его заберет клиент из магазина».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 23788837
Responses
200

OK

application/json
arrayOptional
post/apiseller/orders/awaitPickup
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
}
[]

Изменение статуса заказа на "Заказ собран" (Почтовый статус)

post

Переводит заказ в статус «Заказ собран» (Почтовый статус).

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
Responses
200

OK

application/json
stringOptional
post/apiseller/orders/pack
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

Изменение статуса заказа на "Выполнен"

post

Переводит заказ в статус «Выполнен».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
Responses
200

OK

application/json
stringOptional
post/apiseller/orders/finish
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

Загрузка фотографии до и после доставки

post

Загрузка фотографии до и после доставки

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 101
shopIdintegerRequired

ID магазина

Example: 93117
typeinteger · enumRequired

Тип фотографии (0 - до доставки, 1 - после доставки)

Default: 0Possible values:
photostring · binaryRequired

Фотография в формате JPEG или PNG

Responses
200

OK

application/json
idintegerOptional

ID заказа в системе Flowwow

Example: 19522730
shopIdintegerOptional

ID магазина

Example: 260
createdDateintegerOptional

Время создания заказа

Example: 1762686732
statusinteger · enumOptional

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

  • 1 — Новый
  • 2 — Принят
  • 3 — Завершен
  • 4 — Передан в доставку
  • 5 — Фото до доставки
  • 7 — Заказ ожидает, когда его заберет клиент из магазина
  • 10 — Почтовый статус. Заказ собран
  • 11 — Почтовый статус. Заказ доставляется почтой
  • 12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
Example: 1Possible values:
deliveryTypeinteger · enumOptional

Тип доставки

  • 0 — Курьер отсутствует / Способ доставки не выбран
  • 1 — Доставка курьером продавца
  • 2 — Собственная доставка продавца
  • 4 — Самовывоз
  • 5 — Доставка flowwow
  • 10 — Доставка курьером пешком
  • 11 — Доставка курьером на автомобиле
  • 12 — Доставка курьером на транспорте
  • 20 — Доставка флористом пешком
  • 21 — Доставка флористом на авто
  • 22 — Доставка флористом на транспорте
  • 23 — Доставка яндекс доставкой
  • 24 — Доставка флориста на велике
  • 26 — Доставка Gett доставкой
  • 32 — Доставка сбермаркетом
  • 33 — Доставка магнитом
  • 34 — Доставка цифровых товаров (сертификаты)
Example: 1Possible values:
deliveryTimeTypeinteger · enumOptional

Тип времени доставки

  • 0 — Согласовать время с получателем
  • 1 — Ближайшее время
  • 2 — На период
Example: 2Possible values:
deliveryDateFromintegerOptional

Время доставки от

Example: 1762686732
deliveryDateTointegerOptional

Время доставки до

Example: 1762686732
addressstringOptional

Адрес доставки. Отделяется символом ';' от детальной информации об адресе

Example: Адрес доставки
courierInfostringOptional

Комментарий для курьера

Example: Комментарий для курьера
shopAdditionalInfostringOptional

Комментарий для магазина

Example: Комментарий для магазина
commentstring · nullableOptional

Комментарий клиента

Example: Комментарий клиента
photoBeforeUrlstring · nullableOptional

Фото до доставки

Example: https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg
photoAfterUrlstring · nullableOptional

Фото после доставки

Example: https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg
messagestringOptional

Текст открытки. Если есть, то в секции products будет элемент с данными открытки

Example: Текст открытки
sourceHoststring · nullableOptional

Ресурс, на котором был создан заказ

  • fmart — заказ создан на сайте FMART
post/apiseller/orders/uploadPhoto
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

Выполняет проверку кода маркировки (КиЗ) товара в заказе селлера через систему «Честный знак».

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 123
codestring · max: 255Required

Код маркировки товара

Example: 0104630005831152215Y9>q+5
Responses
200

OK

application/json
codestring · enumRequired

Код результата проверки кода маркировки.

Возможные значения:

  • parsing_error — Ошибка парсинга, скорее всего неверный КМ
  • not_registered — Участник оборота не зарегистрирован в «Честном ЗНАКе»
  • another_inn — Не соответствует ИНН владельца товара
  • not_introduced — Товар не находится в обороте
  • request_failed — Ошибка при обращении к True API
  • passed — Все проверки пройдены, товар доступен к реализации
Possible values:
messagestringRequired

Сообщение о результате проверки кода маркировки

isValidbooleanRequired

Является ли код маркировки действительным

post/apiseller/orders/validateNomenclatureCode
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
}

Добавление кодов маркировки товара

post

Добавление кодов маркировки товара

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 23315616
shopIdintegerRequired

ID магазина

Example: 240829
orderItemIdintegerRequired

ID товара в заказе

Example: 65224485
codestring · max: 255Required

Код маркировки

Example: ew_BTcnIaHe00snZjOnJ-Rfij
Responses
200

OK

application/json
idintegerOptional

ID маркировки товара в системе Flowwow. Нужен, если потребуется обновить код маркировки товара

Example: 19522730
codestringOptional

Код маркировки товара

Example: ew_BTcnIaHe00snZjOnJ-Rfij
post/apiseller/orders/addNomenclatureCode
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"
}

Изменение кода маркировки товара

post

Изменение кода маркировки товара

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
orderIdinteger · int32Required

Идентификатор заказа

Example: 23315616
shopIdintegerRequired

ID магазина

Example: 240829
codeIdintegerRequired

ID кода маркировки в системе Flowwow

Example: 213
codestring · max: 255Required

Код маркировки

Example: nZjOnJ-Rfijew_BTcnIaHe00s
Responses
200

OK

application/json
idintegerOptional

ID маркировки товара в системе Flowwow. Нужен, если потребуется обновить код маркировки товара

Example: 19522730
codestringOptional

Код маркировки товара

Example: ew_BTcnIaHe00snZjOnJ-Rfij
post/apiseller/orders/updateNomenclatureCode
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 — тестовое событие. Отправляется вручную при проверке подключения.

Проверка работы веб-хука

post

Отправляет тестовый запрос на настроенный URL веб-хука холдинга.

В теле запроса на адрес веб-хука будет передано событие test. Метод всегда возвращает HTTP 200; результат отправки (код ответа и текст ошибки при неудаче) содержится в теле ответа.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

OK

application/json
messagestringRequired

Текст ошибки при неудачной отправке; пустая строка при успехе

httpCodeintegerRequired

HTTP-статус ответа веб-хука; 0 если соединение не установлено

Example: 200
post/apiseller/webhook/test
POST /apiseller/webhook/test HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "message": "",
  "httpCode": 200
}

Managers

Управление менеджерами магазина

Список менеджеров магазина

get

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Responses
200

OK

application/json
totalintegerOptional

Общее кол-во менеджеров

Example: 3
get/apiseller/managers/list
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

Сохраняет ответ магазина на отзыв. Контактные данные в тексте удаляются. Отзыв должен принадлежать указанному магазину.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
reviewIdone ofRequired

ID отзыва. Допускается целое число или числовая строка

integer · min: 1 · max: 4294967295Optional
or
string · max: 10OptionalPattern: ^[1-9]\d*$
answerstring · min: 1 · max: 16383Required

Ответ магазина на отзыв

Responses
200

Ответ магазина сохранён

application/json
reviewIdintegerRequired

ID отзыва

answerstringRequired

Сохранённый ответ магазина

answerCreatedAtstringRequired

Дата и время создания ответа в формате Y-m-d H:i:s

Example: 2026-08-19 12:34:56Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$
post/apiseller/review/answer
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

Работа с шаблонами специальных сертификатов

Просмотр шаблонов специальных сертификатов магазина

get

Возвращает все шаблоны специальных сертификатов указанного магазина.

Метод доступен только для российских потребителей API и магазинов, перечисленных в фича-флаге shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Responses
200

OK

application/json
get/apiseller/certificateTemplates
GET /apiseller/certificateTemplates?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "templates": [
    {
      "id": 123,
      "text": "Поздравляем! Ваш сертификат готов к использованию.",
      "isProduction": true
    }
  ]
}

Создание шаблона специального сертификата магазина

post

Создаёт новый непроизводственный шаблон специального сертификата магазина. Поле isProduction у созданного шаблона всегда равно false.

Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
textstring · min: 1 · max: 850000Required

Текст шаблона сертификата

Example: <html><body>Сертификат № {{ certificateNumber }}</body></html>
Responses
200

Шаблон создан

application/json
idinteger · int32Required

Идентификатор шаблона сертификата

Example: 123
textstringRequired

Текст шаблона сертификата

Example: Поздравляем! Ваш сертификат готов к использованию.
isProductionboolean · enumRequired

Созданный шаблон всегда является непроизводственным

Possible values:
post/apiseller/certificateTemplates/create
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
}

Удаление шаблона специального сертификата магазина

delete

Полностью удаляет указанный непроизводственный шаблон сертификата из базы данных. Боевой шаблон удалить нельзя: сначала необходимо назначить боевым другой шаблон.

Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
templateIdinteger · int64 · min: 1 · max: 4294967295Required

Идентификатор удаляемого шаблона сертификата

Example: 123
Responses
200

Шаблон удалён

application/json
arrayOptional
delete/apiseller/certificateTemplates/delete
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 шаблона специального сертификата магазина

post

Генерирует PDF по указанному шаблону и возвращает публичную ссылку на файл в S3. Переданные параметры подставляются в шаблон. Для отсутствующих параметров используются автоматически сгенерированные тестовые значения.

Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
templateIdinteger · int64 · min: 1 · max: 4294967295Required

Идентификатор шаблона сертификата

Example: 123
orderIdinteger · int64 · min: 1Optional

ID заказа для подстановки в шаблон. Если не указан, генерируется автоматически

Example: 1234567890
certificateNumberinteger · int64 · min: 1Optional

Номер сертификата. Если не указан, генерируется автоматически

Example: 1234567890123
activationCodeinteger · int64 · min: 1Optional

Код активации сертификата. Если не указан, генерируется автоматически

Example: 123456
nominalinteger · int64 · min: 1Optional

Номинал сертификата. Если не указан, генерируется автоматически

Example: 3000
productNamestring · max: 255Optional

Название товара. Если не указано, используется тестовое название

Example: Подарочный сертификат
Responses
200

PDF-предпросмотр создан

application/json
idinteger · int32Required

Идентификатор шаблона сертификата

Example: 123
textstringRequired

Текст шаблона сертификата

Example: Поздравляем! Ваш сертификат готов к использованию.
isProductionbooleanRequired

Используется ли шаблон в боевой среде

previewUrlstring · uriRequired

Публичная ссылка на PDF-предпросмотр шаблона в S3

Example: https://cdn.flowwow.com/certificates/test_0123456789abcdef.pdf
post/apiseller/certificateTemplates/preview
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"
}

Смена боевого шаблона специального сертификата магазина

post

Делает указанный шаблон единственным боевым шаблоном сертификатов магазина. Переключение выполняется атомарно: предыдущий боевой шаблон отключается, а выбранный шаблон получает признак isProduction: true.

Метод доступен только российским потребителям API и магазинам, перечисленным в фича-флаге shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
templateIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор шаблона сертификата, который нужно сделать боевым

Example: 123
Responses
200

Боевой шаблон изменён

application/json
idinteger · int32Required

Идентификатор шаблона сертификата

Example: 123
textstringRequired

Текст шаблона сертификата

Example: Поздравляем! Ваш сертификат готов к использованию.
isProductionboolean · enumRequired

Выбранный шаблон является боевым

Possible values:
post/apiseller/certificateTemplates/setProduction
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

Добавление кодов активации специальных сертификатов

post

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

Метод доступен только российским холдингам и магазинам из настройки shop.special_shop_ids.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
shopIdinteger · int32 · min: 1 · max: 4294967295Required

Идентификатор склада или магазина.

Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.

Example: 123456
Body
Responses
200

Результат обработки всех переданных записей

application/json
post/apiseller/certificateTemplates/activationCodes
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": "Товар не является электронным сертификатом"
    }
  ]
}

Последнее обновление

Это было полезно?