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)2

Проверка 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"
}

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

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": [
        "text"
      ]
    }
  ],
  "total": 1,
  "withPhotos": true
}

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

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
}

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

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

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

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"
}

Получение информации о товарах магазина

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,
      "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": "Меняйте воду ежедневно"
      }
    }
  ],
  "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": "Товар не существует"
    }
  ]
}

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

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": "Товар не существует"
    }
  ]
}

Изменение товаров топ-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

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

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": "Товар не существует"
}

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

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": "Товар не существует"
    }
  ]
}

Получение цен и скидок у товаров

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": "Товар не существует"
    }
  ]
}

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

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"
        }
      ]
    }
  }
}

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

get

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

Лимиты запросов:

  • Базовый лимит составляет 60 запросов в минуту для одного магазина.

  • Для холдингов за каждый магазин добавляется ещё 15 запросов в минуту. Максимальный лимит — 300 запросов в минуту.

  • Информация о текущем лимите передаётся в заголовках ответа: X-Rate-Limit-Limit, X-Rate-Limit-Remaining, X-Rate-Limit-Reset.

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
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: */*
{
  "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
}

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

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: 101
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,
      "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
}

Валидация кода маркировки товара в заказе

post

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

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

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

Example: 101
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 — Все проверки пройдены, товар доступен к реализации

Example: passedPossible values:
messagestringRequired

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

isValidbooleanRequired

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

Example: true
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: 101
shopIdintegerRequired

ID магазина

Example: 93117
orderItemIdintegerRequired

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

Example: 65116150
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: 101
shopIdintegerRequired

ID магазина

Example: 93117
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"
}

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

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
}

Список чатов магазина

get

Возвращает список чатов для указанного магазина. Основная выдача состоит из чатов типов shop_client, shop_news (важные новости) и shop_bots (уведомления) и учитывает выбранный type (в том числе archive и favorite). При type=all на первой странице в начало списка дополнительно закрепляются служебные чаты магазина — shop_news, shop_bots и shops (чат с поддержкой), именно в этом порядке; в основной выдаче они при этом не дублируются.

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

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

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

Example: 123456
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
typestring · enumRequired

Тип фильтрации списка чатов:

ЗначениеОписание
allВсе активные чаты
clientЧаты с клиентами
archiveАрхивные чаты
favoriteИзбранные чаты
Default: allExample: allPossible values:
pageinteger · min: 1 · nullableOptional

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

Example: 1
limitinteger · min: 1Optional

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

Default: 10Example: 10
querystringOptional

Поиск по ID заказа (только цифры)

Example: 12345
Responses
200

OK

application/json
get/apiseller/chats/list
GET /apiseller/chats/list?shopId=123456&managerId=101&type=all HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "chats": [
    {
      "id": "shop_client/-NXA3iS-tAIccORO91MR",
      "type": "shop_client",
      "client": {
        "id": 456,
        "name": "Мария Сидорова"
      },
      "orders": [
        {
          "id": 12345,
          "status": "accepted"
        }
      ],
      "newMessagesCount": 3,
      "timestamp": -1684498747,
      "isCanArchive": false,
      "isArchived": false,
      "isBlocked": false,
      "isFavorite": false,
      "lastMessage": {
        "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
        "text": "Текст сообщения",
        "type": "text",
        "isViewed": false,
        "createdAt": {
          "timestamp": 1684498747,
          "short": "14:32"
        },
        "updatedAt": null,
        "user": {
          "id": 123,
          "type": "manager",
          "name": "Иван Иванов",
          "photo": "https://cdn.flowwow.com/photo.jpg"
        },
        "widgets": [
          {
            "type": "product_card",
            "params": null
          }
        ],
        "translations": [
          {
            "language": "en",
            "text": "Hello! How can I help?"
          }
        ]
      },
      "dispute": {
        "order_id": 12345,
        "dispute_id": 678
      },
      "ticket": {}
    }
  ],
  "counters": {
    "all": 5,
    "dispute": 0,
    "client": 5,
    "favorite": 2
  }
}

Просмотр данных чата

get

Возвращает детальную информацию о чате, включая историю сообщений (пагинированную). Поддерживаются чаты типов shop_client, shop_bots (уведомления), shop_news (важные новости).

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

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

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

Example: 123456
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата. Допустимые типы: shop_client, shop_bots, shop_news (формат: <тип>/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
pageinteger · min: 1 · nullableOptional

Страница пагинации сообщений

Example: 1
limitinteger · min: 1Optional

Кол-во сообщений на странице

Default: 50Example: 50
sortstring · enumRequired

Порядок сортировки сообщений

Default: ascExample: ascPossible values:
isPreviewbooleanOptional

Если true — счётчик непрочитанных сообщений не сбрасывается в 0

Default: falseExample: false
Responses
200

OK

application/json

Детальная информация о чате, включая историю сообщений

idstringOptional

ID чата

Example: shop_client/-NXA3iS-tAIccORO91MR
typestringOptional

Тип чата. В apiseller всегда shop_client

Example: shop_client
newMessagesCountintegerOptional

Кол-во непрочитанных сообщений

Example: 3
timestampintegerOptional

Дата последнего изменения в чате (отрицательный unix timestamp)

Example: -1684498747
isCanArchivebooleanOptional

Можно ли архивировать чат

Example: false
isArchivedbooleanOptional

Находится ли чат в архиве

Example: false
isBlockedbooleanOptional

Заблокирован ли чат

Example: false
isFavoritebooleanOptional

Является ли чат избранным

Example: false
isTranslatedbooleanOptional

Если true — сообщения чата могут быть авто-переведены

Example: false
isShopComplaintbooleanOptional

Есть ли жалоба магазина на клиента

Example: false
sourceHoststring · nullableOptional

Ресурс, на котором был создан заказ (например fmart)

ticketobject · nullableOptional

Данные активного тикета (если есть)

get/apiseller/chats/info
GET /apiseller/chats/info?shopId=123456&managerId=101&chatId=shop_client%2F-NXA3iS-tAIccORO91MR&sort=asc HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "id": "shop_client/-NXA3iS-tAIccORO91MR",
  "type": "shop_client",
  "messages": [
    {
      "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
      "text": "Текст сообщения",
      "type": "text",
      "isViewed": false,
      "createdAt": {
        "timestamp": 1684498747,
        "short": "14:32"
      },
      "updatedAt": null,
      "user": {
        "id": 123,
        "type": "manager",
        "name": "Иван Иванов",
        "photo": "https://cdn.flowwow.com/photo.jpg"
      },
      "widgets": [
        {
          "type": "product_card",
          "params": null
        }
      ],
      "translations": [
        {
          "language": "en",
          "text": "Hello! How can I help?"
        }
      ]
    }
  ],
  "client": {
    "id": 456,
    "name": "Мария Сидорова",
    "phone": "+79001234567"
  },
  "orders": [
    {
      "id": 12345,
      "status": "accepted",
      "productCount": 2,
      "photo": [
        "https://cdn.flowwow.com/product.jpg"
      ]
    }
  ],
  "newMessagesCount": 3,
  "timestamp": -1684498747,
  "isCanArchive": false,
  "isArchived": false,
  "isBlocked": false,
  "isFavorite": false,
  "isTranslated": false,
  "isShopComplaint": false,
  "sourceHost": null,
  "lastMessage": {
    "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
    "text": "Текст сообщения",
    "type": "text",
    "isViewed": false,
    "createdAt": {
      "timestamp": 1684498747,
      "short": "14:32"
    },
    "updatedAt": null,
    "user": {
      "id": 123,
      "type": "manager",
      "name": "Иван Иванов",
      "photo": "https://cdn.flowwow.com/photo.jpg"
    },
    "widgets": [
      {
        "type": "product_card",
        "params": null
      }
    ],
    "translations": [
      {
        "language": "en",
        "text": "Hello! How can I help?"
      }
    ]
  },
  "dispute": {
    "order_id": 12345,
    "dispute_id": 678
  },
  "ticket": {}
}

Архивные сообщения чата

get

Возвращает архивные (старые) сообщения чата одного из типов: shop_client, shop_bots (уведомления), shop_news (важные новости). Для получения страниц параметр page обязателен.

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

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

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

Example: 123456
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата. Допустимые типы: shop_client, shop_bots, shop_news (формат: <тип>/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
pageinteger · min: 1Required

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

Example: 1
limitinteger · min: 1Optional

Кол-во сообщений на странице

Default: 50Example: 50
sortstring · enumRequired

Порядок сортировки сообщений

Default: ascExample: ascPossible values:
Responses
200

OK

application/json
get/apiseller/chats/archiveMessages
GET /apiseller/chats/archiveMessages?shopId=123456&managerId=101&chatId=shop_client%2F-NXA3iS-tAIccORO91MR&page=1&sort=asc HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "messages": [
    {
      "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
      "text": "Текст сообщения",
      "type": "text",
      "isViewed": false,
      "createdAt": {
        "timestamp": 1684498747,
        "short": "14:32"
      },
      "updatedAt": null,
      "user": {
        "id": 123,
        "type": "manager",
        "name": "Иван Иванов",
        "photo": "https://cdn.flowwow.com/photo.jpg"
      },
      "widgets": [
        {
          "type": "product_card",
          "params": null
        }
      ],
      "translations": [
        {
          "language": "en",
          "text": "Hello! How can I help?"
        }
      ]
    }
  ]
}

Токен авторизации в Centrifugo

get

Возвращает JWT токен для подключения к Centrifugo (WebSocket) и название канала для получения событий чатов в режиме реального времени.

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

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

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

Example: 123456
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
Responses
200

OK

application/json
centrifugoUrlstringOptional

URL для подключения к Centrifugo по WebSocket

Example: wss://centrifugo.flowwow.com/connection/websocket
tokenstringOptional

JWT токен для авторизации в Centrifugo

Example: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...
channelNamestringOptional

Название канала для получения событий чатов

Example: remote_manager:#101
get/apiseller/chats/token
GET /apiseller/chats/token?shopId=123456&managerId=101 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "centrifugoUrl": "wss://centrifugo.flowwow.com/connection/websocket",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "channelName": "remote_manager:#101"
}

Архивировать чат

post

Переводит чат в архив. Поддерживаются только чаты типа shop_client.

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

Идентификатор магазина платформы Flowwow

Example: 101
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата типа shop_client (формат: shop_client/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
Responses
200

OK

application/json
chat_idstringOptional

ID архивированного чата

Example: shop_client/-NXA3iS-tAIccORO91MR
post/apiseller/chats/archive
POST /apiseller/chats/archive HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "shopId": 123456,
  "managerId": 101,
  "chatId": "shop_client/-NXA3iS-tAIccORO91MR"
}
{
  "chat_id": "shop_client/-NXA3iS-tAIccORO91MR"
}

Разархивировать чат

post

Возвращает чат из архива. Поддерживаются только чаты типа shop_client.

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

Идентификатор магазина платформы Flowwow

Example: 101
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата типа shop_client (формат: shop_client/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
Responses
200

OK

application/json
chat_idstringOptional

ID разархивированного чата

Example: shop_client/-NXA3iS-tAIccORO91MR
post/apiseller/chats/unarchive
POST /apiseller/chats/unarchive HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "shopId": 123456,
  "managerId": 101,
  "chatId": "shop_client/-NXA3iS-tAIccORO91MR"
}
{
  "chat_id": "shop_client/-NXA3iS-tAIccORO91MR"
}

Отправить текстовое сообщение в чат

post

Отправляет текстовое сообщение от имени менеджера магазина в чат. Поддерживаются только чаты типа shop_client.

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

Идентификатор магазина платформы Flowwow

Example: 101
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата типа shop_client (формат: shop_client/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
textstringRequired

Текст сообщения

Example: Добрый день! Чем могу помочь?
Responses
200

OK

application/json
messageIdstringOptional

ID сообщения

Example: c71a84ae-8fdf-4af2-b75c-fa06d03c5261
textone ofOptional

Текст сообщения. Для типа dispute — массив объектов

Example: Текст сообщения
stringOptional
or
typestring · enumOptional

Тип сообщения:

ЗначениеОписание
textОбычное текстовое сообщение
imageИзображение (text содержит URL)
disputeСообщение спора (text — массив объектов)
Example: textPossible values:
isViewedbooleanOptional

Просмотрено ли сообщение

Example: false
updatedAtinteger · nullableOptional

Unix timestamp обновления сообщения

post/apiseller/chats/createMessage
POST /apiseller/chats/createMessage HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "shopId": 123456,
  "managerId": 101,
  "chatId": "shop_client/-NXA3iS-tAIccORO91MR",
  "text": "Добрый день! Чем могу помочь?"
}
{
  "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
  "text": "Текст сообщения",
  "type": "text",
  "isViewed": false,
  "createdAt": {
    "timestamp": 1684498747,
    "short": "14:32"
  },
  "updatedAt": null,
  "user": {
    "id": 123,
    "type": "manager",
    "name": "Иван Иванов",
    "photo": "https://cdn.flowwow.com/photo.jpg"
  },
  "widgets": [
    {
      "type": "product_card",
      "params": null
    }
  ],
  "translations": [
    {
      "language": "en",
      "text": "Hello! How can I help?"
    }
  ]
}

Отправить изображение в чат

post

Загружает изображение и отправляет его как сообщение в чат типа shop_client. Поддерживаемые форматы: JPEG, PNG. Максимальный размер файла: 20 МБ.

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

Идентификатор магазина платформы Flowwow

Example: 101
managerIdinteger · int32 · min: 1Required

ID менеджера

Example: 101
chatIdstringRequired

ID чата типа shop_client (формат: shop_client/<name>)

Example: shop_client/-NXA3iS-tAIccORO91MR
filestring · binaryRequired

Изображение в формате JPEG или PNG, максимум 20 МБ

Responses
200

OK

application/json
messageIdstringOptional

ID сообщения

Example: c71a84ae-8fdf-4af2-b75c-fa06d03c5261
textone ofOptional

Текст сообщения. Для типа dispute — массив объектов

Example: Текст сообщения
stringOptional
or
typestring · enumOptional

Тип сообщения:

ЗначениеОписание
textОбычное текстовое сообщение
imageИзображение (text содержит URL)
disputeСообщение спора (text — массив объектов)
Example: textPossible values:
isViewedbooleanOptional

Просмотрено ли сообщение

Example: false
updatedAtinteger · nullableOptional

Unix timestamp обновления сообщения

post/apiseller/chats/uploadImage
POST /apiseller/chats/uploadImage HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 90

{
  "shopId": 101,
  "managerId": 101,
  "chatId": "shop_client/-NXA3iS-tAIccORO91MR",
  "file": "binary"
}
{
  "messageId": "c71a84ae-8fdf-4af2-b75c-fa06d03c5261",
  "text": "Текст сообщения",
  "type": "text",
  "isViewed": false,
  "createdAt": {
    "timestamp": 1684498747,
    "short": "14:32"
  },
  "updatedAt": null,
  "user": {
    "id": 123,
    "type": "manager",
    "name": "Иван Иванов",
    "photo": "https://cdn.flowwow.com/photo.jpg"
  },
  "widgets": [
    {
      "type": "product_card",
      "params": null
    }
  ],
  "translations": [
    {
      "language": "en",
      "text": "Hello! How can I help?"
    }
  ]
}

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

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
}

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

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