API
Ping
Методы проверки состояния api
Проверка API
Возвращает тип ответа по параметру say.
QUERY PARAMETERS
say string
Enum: "hello" "error400" "error401" "error403"
"error404" "error409" "error429" "error500"
Example: say=Hello
Какой ответ получить
hello
Кампания активна
обычный ответ сервера (200)
error400
Ошибка клиента 400
имитация ошибки клиента 400
error401
Ошибка клиента 401
имитация ошибки клиента 401
error403
Ошибка клиента 403
имитация ошибки клиента 403
error404
Ошибка клиента 404
имитация ошибки клиента 404
error429
Ошибка клиента 429
имитация ошибки клиента 429
error500
Ошибка сервера 500
имитация ошибки сервера 500
Responses
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Shop
Информация о магазинах или складах холдинга
Просмотр списка магазинов
Возвращает список магазинов для холдинга или один магазин - для остальных случаев.
AUTHORIZATIONS:
bearerToken
HTTP: bearerToken
HTTP Authorization Scheme: bearer
Bearer format: JWT
REQUEST BODY SCHEMA: application/json required
status string (ShopStatus)
required Enum: "moderation" "active" "disabled"
Статус магазина:
moderation
На модерации
active
Активен
disabled
Деактивирован
shopIds Array of integers (ShopId) [ 1 .. 1000 ] items [ items ]
Список идентификаторов магазинов
page integer >= 0
Default: 0
Номер страницы. Нумерация начинается с 0.
limit integer [ 1 .. 50 ]
Default: 10
Количество элементов в ответе. Максимум — 50, минимум — 1.
Responses
POST /apiseller/shops
Request samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Products
Добавление, просмотр, изменение и управление отображением товаров
Получение информации о товарах магазина
Возвращает список товаров магазина с возможностью фильтрации. Поддерживается пагинация.
AUTHORIZATIONS:
bearerToken
HTTP: bearerToken
HTTP Authorization Scheme: bearer
Bearer format: JWT
QUERY PARAMETERS
shopId integer [ 1 .. 4294967295 ]
required Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json optional
offerIds Array of strings or null (OfferId) [ 1 .. 1000 ] items [ items <= 50 characters ]
Список идентификаторов товаров в системе магазина
productIds Array of integers or null (ProductId) [ 1 .. 1000 ] items [ items >= 1 ]
Идентификаторы товаров в системе Flowwow
categoryIds Array of integers (RangeGroupId) [ 1 .. 1000 ] items [ items >= 1 ]
Идентификаторы категорий в системе Flowwow
type integer (ProductType)
Enum: 1 2 3
Тип товара:
1— обычный товар,2— готовый товар,3— дополнительный товар.
page integer >= 0 Default: 0 Номер страницы. Нумерация начинается с 0.
limit integer [ 1 .. 1000 ] Default: 10 Количество элементов в ответе. Минимум — 1, максимум — 1000, по умолчанию — 10.
Responses
POST /apiseller/products
Content type application/json Request samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Создание товаров
Создаёт новый товар в каталоге магазина на Flowwow.
Ограничения:
Готовые товары (
productType=2) не могут быть созданы через API.Основной товар (
productType=1) — требует указанияsubCategoryId.Дополнительный товар (
productType=3) — не требуетsubCategoryId.
Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на создание.
Изображения: Загружаются асинхронно по переданным URL. Первое появление в интерфейсе Flowwow может занять до 30 минут.
AUTHORIZATIONS:
bearerToken
HTTP: bearerToken
HTTP Authorization Scheme: bearer
Bearer format: JWT
QUERY PARAMETERS
shopId integer <int32> [ 1 .. 4294967295 ]
required Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops
или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Изменение товаров
Обновляет товар в каталоге магазина на Flowwow.
При обновлении необходимо передавать все актуальные поля товара (частичное обновление не поддерживается).
Ограничения:
Изменение
productTypeиsubCategoryIdчерез API запрещено.Готовые товары (
productType=2) не могут быть созданы или изменены через API.Для основного товара (
productType=1) полеsubCategoryIdобязательно.Для дополнительного товара (
productType=3) полеsubCategoryIdне требуется.
Свойства товара: Набор обязательных и допустимых полей зависит от подкатегории. Актуальную схему свойств, включая зависимости между атрибутами (dependsOn), необходимо получать через POST /apiseller/categories/subCategoryProperties — это единственный источник истины. Атрибут dependsOn носит информационный характер и не передаётся в запросе на обновление.
Изображения: Загружаются асинхронно по переданным URI. Первое появление в интерфейсе Flowwow может занять до 30 минут.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Связывание с товарами из магазина продавца
Связывает товары из магазина продавца на маркетплейсе Flowwow с товарами из информационной системы продавца по идентификаторам. Если товар с указанным productId не существует у магазина в системе Flowwow, будет возвращена ошибка для этого товара. Если внутри одного запроса присутствуют пары с одинаковым offerId или productId, все такие пары считаются некорректными и не обрабатываются. Частичная обработка для конфликтующих пар не выполняется, каждая из них будет возвращена в массиве errors. Если прислать пары ID, которые уже были ранее привязаны, то такие пары изменены не будут. Готовые товары на Flowwow нельзя привязывать, при попытке связывания, такие товары найдены не будут.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
POST /apiseller/products/offersMappings
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Скрытие товаров
Делает товары невидимыми на витрине и недоступными для продажи без возврата их из архива. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18».
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Request samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Открытие товаров
Делает товары видимыми на витрине и доступными к продаже без перевода их в архив. Если у товара заданы свойства минимального количества для заказа и доступного количества, то для открытия товара доступное количество должно быть больше либо равно минимальному количеству для заказа. Для товаров из оптовых категорий доступное количество рассчитывается как произведение: доступное количество × количество в упаковке. Если до выполнения запроса в магазине не было ни одного открытого товара и в результате запроса появился хотя бы один открытый обычный или готовый товар, магазин переводится в статус активного (при соблюдении остальных условий активности магазина). Подтверждение наличия товаров менеджером через данный эндпоинт не производится.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
POST /apiseller/products/unhide
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Перенос товара в архив
Переносит один товар в архив.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
offerId
string or null (OfferId) <= 50 characters
Идентификатор товара в системе продавца
Responses
POST /apiseller/products/archive
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Возврат товара из архива
Возвращает один товар из архива.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
offerId
string or null (OfferId) <= 50 characters
Идентификатор товара в системе продавца
Responses
POST /apiseller/products/unarchive
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Stocks
Остатки товаров на складах магазина.
Просмотр остатков по товарам
Возвращает информацию по остаткам в магазине продавца.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение остатков по товарам
Изменяет информацию по остаткам в магазине продавца. Товар скрывается при изменении остатка с > 0 на 0. Если в результате выполнения запроса в магазине были скрыты все товары, магазин принудительно переводится в статус неактивного. У скрываемых товаров снимается метка «ТОП-18». Скрытие товара без изменения его остатков производится с помощью запроса POST /apiseller/products/hide
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Prices
Цены товаров.
Получение цен и скидок у товаров
Возвращает информацию по ценам и скидкам товаров в магазине.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение цен и скидок у товаров
Изменяет цены и/или скидки у товаров в магазине.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: application/json required
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Categories
Информация о категориях и подкатегориях товаров.
Дерево категорий и подкатегорий товаров
Возвращает иерархическое дерево активных категорий (групп) с их подкатегориями (типами). Результат фильтруется по стране магазина — недоступные в стране категории и подкатегории не включаются. Результат не пагинируется (отдаётся целиком).
Поле chestnyZnakMarkingRequirement
Поле отдаётся только для магазинов из Российской Федерации. Указывает требование маркировки товаров системой «Честный Знак»:
never
Маркировка не требуется для товаров данной подкатегории
selectable
Магазин сам решает, нужна ли маркировка для конкретного товара
always
Все товары данной подкатегории обязательно должны быть промаркированы
Для магазинов из других стран поле не включается в ответ.
QUERY PARAMETERS
shopId required
integer <int32> >=1
Идентификатор склада или магазина. Идентификатор магазина. Передаётся как GET-параметр. Пример: ?shopId=260
Responses
POST /apiseller/categories/tree
Response samples
Content type application/json
Example Ответ для российского магазина (с chestnyZnakMarkingRequirement)
Ответ для иностранного магазина (без chestnyZnakMarkingRequirement)
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Свойства подкатегории
Возвращает список свойств для одной подкатегории товаров.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
subCategoryId required
integer [ 1 .. 4294967295 ]
Example: subCategoryId=1
Идентификатор подкатегории товаров.
Его можно узнать с помощью запроса POST/apiseller/categories/tree
productType required
integer
Enum: 1 3
Example: productType=1
Идентификатор типа товаров. От типа товара зависят свойства товара. Возможные значения:
1— обычный товар. Может долгое время находиться в каталоге, может существовать во многих экземплярах, имеет остатки на складе или время изготовления3— дополнительный товар. Не отображается клиентам в каталоге товаров и на странице магазина, виден только в корзине. Может идти дополнительно в заказе вместе с одним или несколькими обычными или готовыми товарами
Настройки для готовых товаров (productType=2) не предоставляются через данный эндпоинт, так как через API нельзя создать готовые товары, используйте для этого приложение FLOWWOW для продавцов.
Responses
POST /apiseller/categories/subCategoryProperties
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Orders
Действия с заказами.
Просмотр списка заказов
Просмотр списка заказов.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
REQUEST BODY SCHEMA: multipart/form-data required
id
integer or null ID заказа в системе Flowwow
page
integer or null Страница пагинации
limit
integer or null [ 1 .. 100 ] Кол-во записей на странице
createdDate
string or null <Y-m-d> Дата создания заказа
deliveryDateFrom
string or null <Y-m-d> Дата доставки от
deliveryDateTo
string or null <Y-m-d> Дата доставки до
deliveryType
integer
Enum: 0 1 2 4 5 10 11 12 20 21 22 23 24 26 32 33 34
Тип доставки:
0 — Курьер отсутствует / Способ доставки не выбран
1 — Доставка курьером продавца
2 — Собственная доставка продавца
4 — Самовывоз
5 — Доставка flowwow
10 — Доставка курьером пешком
11 — Доставка курьером на автомобиле
12 — Доставка курьером на транспорте
20 — Доставка флористом пешком
21 — Доставка флористом на авто
22 — Доставка флористом на транспорте
23 — Доставка яндекс доставкой
24 — Доставка флориста на велике
26 — Доставка Gett доставкой
32 — Доставка сбермаркетом
33 — Доставка магнитом
34 — Доставка цифровых товаров (сертификаты)
status
integer
Enum: 1 2 3 4 5 7 10 11 12
Статус заказа:
1 — Новый
2 — Принят
3 — Завершен
4 — Передан в доставку
5 — Фото до доставки
7 — Заказ ожидает, когда его заберет клиент из магазина
10 — Почтовый статус. Заказ собран
11 — Почтовый статус. Заказ доставляется почтой
12 — Почтовый статус. Заказ ждет, когда его заберут из почтового офиса
deliveryTimeType
integer
Enum: 0 1 2
Тип времени доставки:
0 — Согласовать время с получателем
1 — Ближайшее время
2 — На период
Responses
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Просмотр заказа
Просмотр заказа.
QUERY PARAMETERS
shopId required
integer <int32> [ 1 .. 4294967295 ]
Example: shopId=123456
Идентификатор склада или магазина.
Его можно узнать с помощью запроса POST /apiseller/shops или в кабинете продавца Flowwow.
orderId required
integer <int32> [ 1 .. 4294967295 ]
Example: orderId=123456
Идентификатор заказа.
Responses
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение статуса заказа на Принят
Переводит заказ в статус «Принят».
REQUEST BODY SCHEMA: application/json required
orderId required
integer <int32> (orderId) Идентификатор заказа.
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение статуса заказа на Отклонен
Переводит заказ в статус «Отклонен».
REQUEST BODY SCHEMA: application/json required
orderId required
integer <int32> (orderId) Идентификатор заказа.
reason required
integer
Enum: 1 2 3 4 5 6
Причины отказа от заказа со стороны магазина.
Возможные значения:
1 — Нет товара в наличии 2 — Не успевает доставка 3 — Неправильный город 4 — Отказ клиента 5 — Отказ CRM-заказа 6 — Другая причина
reasonText
string <= 255 characters
Текст причины отказа. Обязателен, если reason = 6 (Другая причина).
commentClient
string <= 700 characters
Комментарий клиенту.
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение статуса заказа на "Передан в доставку"
Переводит заказ в статус «Передан в доставку».
REQUEST BODY SCHEMA: application/json required
orderId required
integer <int32> (orderId) Идентификатор заказа
Responses
POST /apiseller/orders/courierLeft
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение статуса заказа на "Заказ собран" (Почтовый статус)
Переводит заказ в статус «Заказ собран» (Почтовый статус).
REQUEST BODY SCHEMA: application/json required
orderId required
integer <int32> (orderId) Идентификатор заказа
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Изменение статуса заказа на "Выполнен"
Переводит заказ в статус «Выполнен».
REQUEST BODY SCHEMA: application/json required
orderId required
integer <int32> (orderId) Идентификатор заказа
Responses
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Загрузка фотографии до и после доставки
Загрузка фотографии до и после доставки.
REQUEST BODY SCHEMA: multipart/form-data required
orderId required
integer <int32> (orderId) Идентификатор заказа
shopId required
integer ID магазина
type required
integer
Default: 0
Enum: 0 1
Тип фотографии (0 - до доставки, 1 - после доставки)
photo required
string <binary> Фотография в формате JPEG или PNG
Responses
POST /apiseller/orders/uploadPhoto
Request samples
Content type application/json
Response samples
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Content type application/json
Последнее обновление
Это было полезно?

