Перейти к содержимому
For the complete documentation index, see llms.txt. This page is also available as Markdown.

АПИ

Ping

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

Проверка API

get

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

Query parameters
saystring · enumOptional

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

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

Success

application/json
saystringRequired

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

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

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

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
}

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

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:
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,
      "type": 1,
      "categoryId": 1002001,
      "subCategoryId": 100200101,
      "name": "Букет роз «Классика»",
      "description": "Классический букет из 21 красной розы",
      "url": "https://flowwow.com/product/buket-roz-klassika",
      "available": 99999,
      "stock": 100,
      "minOrder": 1,
      "price": "1990.00",
      "discount": "10",
      "currencyCode": "RUB",
      "images": [
        "https://cdn.example.com/images/flow-0001-1.png"
      ],
      "productionTime": 60,
      "shipmentTime": 120,
      "canRent": 0,
      "originalId": 0,
      "isDeliveryPost": false,
      "isStarred": true,
      "vat": "20"
    }
  ],
  "total": 150
}

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

post

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

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

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

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

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

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

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

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

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

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

Example: 123456
Body
Responses
200

OK

application/json

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

shopIdinteger · int32 · min: 1Optional

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

Example: 260
post/apiseller/products/create
POST /apiseller/products/create?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 413

[
  {
    "offerId": "FL-001",
    "productType": 1,
    "subCategoryId": 437,
    "name": "Букет красных роз 25шт",
    "price": "3500.00",
    "discount": "10",
    "description": "Свежие красные розы, 25 штук",
    "minOrderCount": 1,
    "stock": 20,
    "height": {
      "val": 50,
      "measure": 3
    },
    "quantityInPackage": 1,
    "isAdultsOnly": false,
    "manufacturerName": "Розарий Подмосковья",
    "images": [
      "https://example.com/roses.jpg"
    ]
  }
]
{
  "shopId": 260,
  "summary": {
    "total": 3,
    "success": 2,
    "failed": 1
  },
  "data": [
    {
      "offerId": "FLOW-0001",
      "productId": 1
    },
    {
      "offerId": "FLOW-0002",
      "productId": 2
    }
  ],
  "errors": [
    {
      "offerId": "FLOW-0003",
      "product": {
        "offerId": "FLOW-0002",
        "productType": 1,
        "subCategoryId": 1,
        "price": 100
      },
      "message": "Цена товара должна содержать строковое значение"
    }
  ]
}

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

post

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

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

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

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

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

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

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

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

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

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

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

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

Example: 123456
Body
Responses
200

OK

application/json

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

shopIdinteger · int32 · min: 1Optional

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

Example: 260
post/apiseller/products/update
POST /apiseller/products/update?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 413

[
  {
    "offerId": "FL-001",
    "productType": 1,
    "subCategoryId": 437,
    "name": "Букет красных роз 25шт",
    "price": "3500.00",
    "discount": "10",
    "description": "Свежие красные розы, 25 штук",
    "minOrderCount": 1,
    "stock": 20,
    "height": {
      "val": 50,
      "measure": 3
    },
    "quantityInPackage": 1,
    "isAdultsOnly": false,
    "manufacturerName": "Розарий Подмосковья",
    "images": [
      "https://example.com/roses.jpg"
    ]
  }
]
{
  "data": [
    {
      "offerId": "FH-001",
      "productId": 74286570
    },
    {
      "offerId": "FH-003",
      "productId": 74286571
    },
    {
      "offerId": "SH-001",
      "productId": 74286572
    }
  ],
  "errors": [
    {
      "offerId": "FLOW-0003",
      "product": {
        "offerId": "FLOW-0002",
        "productType": 1,
        "subCategoryId": 1,
        "price": 100
      },
      "message": "Цена товара должна содержать строковое значение"
    }
  ]
}

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

post

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

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

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

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

Example: 123456
Body
Responses
200

OK

application/json
shopIdintegerOptional

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

post/apiseller/products/offersMappings
POST /apiseller/products/offersMappings?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "offers": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243
    }
  ]
}
{
  "shopId": 1,
  "summary": {
    "total": 13,
    "success": 8,
    "failed": 5,
    "created": 4,
    "updated": 0,
    "relinked": 2,
    "unchanged": 2
  },
  "data": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "type": 1,
      "categoryId": 54,
      "subCategoryId": 112,
      "name": "Букет из роз",
      "description": "Красивый букет из свежих роз.",
      "url": "https://flowwow.com/product/12345",
      "available": 1,
      "stock": 10,
      "minOrder": 1,
      "price": "1990.00",
      "discount": "20",
      "currencyCode": "RUB",
      "images": [
        "https://example.com"
      ],
      "productionTime": 1,
      "shipmentTime": 1,
      "canRent": 1,
      "originalId": 7123456,
      "isDeliveryPost": true,
      "isStarred": true,
      "vat": "10"
    }
  ],
  "errors": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "message": "У данной пары есть дубль с другим productId или offerId в запросе"
    }
  ]
}

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

post

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

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

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

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

Example: 123456
Body
Responses
200

Success

application/json
shopIdinteger · int32 · min: 1Required

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

Example: 260
post/apiseller/products/hide
POST /apiseller/products/hide?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "offers": [
    {
      "offerId": "FLOW-0001"
    }
  ]
}
{
  "shopId": 260,
  "data": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "updated": true
    }
  ],
  "errors": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "message": "Товар не существует"
    }
  ]
}

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

post

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

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

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

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

Example: 123456
Body
Responses
200

Success

application/json
shopIdinteger · int32 · min: 1Required

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

Example: 260
post/apiseller/products/unhide
POST /apiseller/products/unhide?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "offers": [
    {
      "offerId": "FLOW-0001"
    }
  ]
}
{
  "shopId": 260,
  "data": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "updated": true
    }
  ],
  "errors": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "message": "Товар не существует"
    }
  ]
}

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

post

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

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

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

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

Example: 123456
Body

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

offerIdstring · max: 50 · nullableOptional

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

Example: FLOW-0001
Responses
200

OK

application/json

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

shopIdinteger · int32 · min: 1Optional

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

Example: 260
offerIdstring · max: 50 · nullableOptional

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

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

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

Example: 83418243
isArchivedbooleanOptional

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

Example: true
updatedbooleanOptional

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

Example: true
messagestringOptional

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

Example: Товар не существует
post/apiseller/products/archive
POST /apiseller/products/archive?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "offerId": "FLOW-0001"
}
{
  "shopId": 260,
  "offerId": "FLOW-0001",
  "productId": 83418243,
  "isArchived": true,
  "updated": true,
  "message": "Товар не существует"
}

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

post

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

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

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

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

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

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

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

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

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

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

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

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

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,
      "type": 1,
      "categoryId": 54,
      "subCategoryId": 112,
      "name": "Букет из роз",
      "description": "Красивый букет из свежих роз.",
      "url": "https://flowwow.com/product/12345",
      "available": 1,
      "stock": 10,
      "minOrder": 1,
      "price": "1990.00",
      "discount": "20",
      "currencyCode": "RUB",
      "images": [
        "https://example.com"
      ],
      "productionTime": 1,
      "shipmentTime": 1,
      "canRent": 1,
      "originalId": 7123456,
      "isDeliveryPost": true,
      "isStarred": true,
      "vat": "10",
      "count": 2
    }
  ],
  "user": {
    "name": "Иван Петров",
    "phone": "79991234567"
  },
  "recipient": {
    "name": "Марина Татьянина",
    "phone": "79997654321"
  },
  "sourceHost": null
}

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

get

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

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

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

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

Example: 123456
idinteger · nullableOptional

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

Example: 111546
pageinteger · nullableOptional

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

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

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

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

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

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

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

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

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

Example: 2026-01-01
deliveryTypeinteger · enumOptional

Тип доставки

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

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

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

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

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

OK

application/json
totalintegerOptional

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

Example: 100
get/apiseller/orders/list
GET /apiseller/orders/list?shopId=123456 HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "items": [
    {
      "id": 19522730,
      "shopId": 260,
      "createdDate": 1762686732,
      "status": 1,
      "deliveryType": 1,
      "deliveryTimeType": 2,
      "deliveryDateFrom": 1762686732,
      "deliveryDateTo": 1762686732,
      "address": "Адрес доставки",
      "courierInfo": "Комментарий для курьера",
      "shopAdditionalInfo": "Комментарий для магазина",
      "comment": "Комментарий клиента",
      "photoBeforeUrl": "https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg",
      "photoAfterUrl": "https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg",
      "message": "Текст открытки",
      "products": [
        {
          "offerId": "FLOW-0001",
          "productId": 83418243,
          "isActive": true,
          "type": 1,
          "categoryId": 54,
          "subCategoryId": 112,
          "name": "Букет из роз",
          "description": "Красивый букет из свежих роз.",
          "url": "https://flowwow.com/product/12345",
          "available": 1,
          "stock": 10,
          "minOrder": 1,
          "price": "1990.00",
          "discount": "20",
          "currencyCode": "RUB",
          "images": [
            "https://example.com"
          ],
          "productionTime": 1,
          "shipmentTime": 1,
          "canRent": 1,
          "originalId": 7123456,
          "isDeliveryPost": true,
          "isStarred": true,
          "vat": "10",
          "count": 2
        }
      ],
      "user": {
        "name": "Иван Петров",
        "phone": "79991234567"
      },
      "recipient": {
        "name": "Марина Татьянина",
        "phone": "79997654321"
      },
      "sourceHost": null
    }
  ],
  "total": 100
}

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

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
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
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
stringOptional
post/apiseller/orders/finish
POST /apiseller/orders/finish HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "orderId": 123
}
text

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

post

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

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

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

Example: 101
shopIdintegerRequired

ID магазина

Example: 93117
typeinteger · enumRequired

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

Default: 0Possible values:
photostring · binaryRequired

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

Responses
200

OK

application/json
idintegerOptional

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

Example: 19522730
shopIdintegerOptional

ID магазина

Example: 260
createdDateintegerOptional

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

Example: 1762686732
statusinteger · enumOptional

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

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

Тип доставки

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

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

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

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

Example: 1762686732
deliveryDateTointegerOptional

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

Example: 1762686732
addressstringOptional

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • fmart — заказ создан на сайте FMART
post/apiseller/orders/uploadPhoto
POST /apiseller/orders/uploadPhoto HTTP/1.1
Host: apis.flowwow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 65

{
  "orderId": 9968909,
  "shopId": 93117,
  "type": 0,
  "photo": "binary data"
}
{
  "id": 19522730,
  "shopId": 260,
  "createdDate": 1762686732,
  "status": 1,
  "deliveryType": 1,
  "deliveryTimeType": 2,
  "deliveryDateFrom": 1762686732,
  "deliveryDateTo": 1762686732,
  "address": "Адрес доставки",
  "courierInfo": "Комментарий для курьера",
  "shopAdditionalInfo": "Комментарий для магазина",
  "comment": "Комментарий клиента",
  "photoBeforeUrl": "https://flowwow.com/data/flowphoto_before/150/8e/68b5ae8c5ma8e.jpg",
  "photoAfterUrl": "https://flowwow.com/data/flowphoto_before/150/6e/69a5ae129cd7d.jpg",
  "message": "Текст открытки",
  "products": [
    {
      "offerId": "FLOW-0001",
      "productId": 83418243,
      "isActive": true,
      "type": 1,
      "categoryId": 54,
      "subCategoryId": 112,
      "name": "Букет из роз",
      "description": "Красивый букет из свежих роз.",
      "url": "https://flowwow.com/product/12345",
      "available": 1,
      "stock": 10,
      "minOrder": 1,
      "price": "1990.00",
      "discount": "20",
      "currencyCode": "RUB",
      "images": [
        "https://example.com"
      ],
      "productionTime": 1,
      "shipmentTime": 1,
      "canRent": 1,
      "originalId": 7123456,
      "isDeliveryPost": true,
      "isStarred": true,
      "vat": "10",
      "count": 2
    }
  ],
  "user": {
    "name": "Иван Петров",
    "phone": "79991234567"
  },
  "recipient": {
    "name": "Марина Татьянина",
    "phone": "79997654321"
  },
  "sourceHost": null
}

Возврат товара из архива

post

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
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>.
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

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

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