> For the complete documentation index, see [llms.txt](https://seller-docs.flowwow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://seller-docs.flowwow.com/product-docs-eng/integrations-and-api/flowwow-seller-api.md).

# Flowwow Seller API

The Flowwow API enables sellers to automate operations with their shops and items: retrieve a list of shops, manage assortment, pricing, and stock levels, and process orders, non-pickups, and returns.

#### Creating and using an API key token

The Seller API is currently in closed beta testing. Once it becomes publicly available, this information will be updated.

## Ping <a href="#apiflowwowdlyaprodavcov-ping" id="apiflowwowdlyaprodavcov-ping"></a>

API status check methods. Designed to verify API availability and test how different types of server responses are handled.

#### API validation

Returns the server response type based on the value of the say query parameter.

### **Request**

API availability check method: GET `/apiseller/ping/check`.

| **Parameter** | **Type** | **Required** | **Description**                                                                                          |
| ------------- | -------- | ------------ | -------------------------------------------------------------------------------------------------------- |
| `say`         | string   | yes          | <p>Specifies the type of response the server will return.<br></p><p>Example:  <code>say=Hello</code></p> |

Allowed values `say`**:** `hello`, `error400`, `error401`, `error403`, `error404`, `error429`, `error500`.

| **Parameter value** | **Description**    | **Action**                     |
| ------------------- | ------------------ | ------------------------------ |
| `hello`             | Campaign is active | Standard server response (200) |
| `error400`          | Client error 400   | Simulates a 400 client error   |
| `error401`          | Client error 401   | Simulates a 401 client error   |
| `error403`          | Client error 403   | Simulates a 403 client error   |
| `error404`          | Client error 404   | Simulates a 404 client error   |
| `error429`          | Client error 429   | Simulates a 429 client error   |
| `error500`          | Server error 500   | Simulates a 500 client error   |

### **Responses**

Server response types: 200 Success, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table data-header-hidden><thead><tr><th width="132.79998779296875"></th><th></th><th width="106.60003662109375"></th><th width="96.800048828125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 Success</strong></td><td>say</td><td>string</td><td>yes</td><td>Server response</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"say": "hello"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br><mark style="background-color:blue;">"fields": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"path": "say",</mark><br><mark style="background-color:blue;">"messages": [</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br>}</td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>403 Forbidden</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Too Many Requests",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>

## Shop <a href="#shop" id="shop"></a>

Warehouses or holding shops information.

#### **View shop list**

Returns a list of shops for a holding, or a single shop in other cases.

To use the API, you must authenticate using a `bearerToken` that allows the server to identify the seller.

* HTTP: `bearerToken`.&#x20;
* Authorization scheme: `bearer`.
* Token format: `JWT`.

### **Request**

Example:\
`{`\
`"status": "moderation",`\
`"shopIds": [`\
`101`\
`],`\
`"page": 0,`\
`"limit": 10`\
`}`

Format: `application/json`.

The request structure is shown below:

<table><thead><tr><th></th><th></th><th width="105.7999267578125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td>status</td><td>string (ShopStatus)</td><td>yes</td><td><p>Shop status. Allowed values:  <code>"moderation"</code>, <code>"active"</code>, <code>"disabled"</code>.<br></p><p><code>moderation</code> – under review<br><code>active</code> – active<br><code>disabled</code> – deactivated</p></td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"status": "moderation",</mark><br><mark style="background-color:blue;">"shopIds": [</mark><br><mark style="background-color:blue;">101</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"page": 0,</mark><br><mark style="background-color:blue;">"limit": 10</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td>shopIds</td><td>array of integers (ShopId)<br>[ 1 .. 1000 ] items [ items ]</td><td>no</td><td>List of shop IDs</td><td></td></tr><tr><td>page</td><td>integer ≥ 0</td><td>no</td><td>Page number. Pagination starts from 0. Default: 0</td><td></td></tr><tr><td>limit</td><td>integer [1..50]</td><td>no</td><td>Number of items in the response. Maximum – 50, minimum – 1. Default: 10</td><td></td></tr></tbody></table>

### **Responses**

Server response types: 200 Success, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table><thead><tr><th width="104.199951171875"></th><th width="92.800048828125"></th><th width="116.79998779296875"></th><th width="80.7999267578125"></th><th width="136.7998046875"></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 Success</strong></td><td>shops</td><td>array of objects (ShopItem)</td><td>yes</td><td>List of shops</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"shops": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"shopId": 101,</mark><br><mark style="background-color:blue;">"name": "Мой магазин",</mark><br><mark style="background-color:blue;">"status": "moderation",</mark><br><mark style="background-color:blue;">"address": "г. Москва, ул. Ленина, д. 1",</mark><br><mark style="background-color:blue;">"currency": "RUB",</mark><br><mark style="background-color:blue;">"isVerified": true,</mark><br><mark style="background-color:blue;">"workingDays": [</mark><br><mark style="background-color:blue;">"1",</mark><br><mark style="background-color:blue;">"2",</mark><br><mark style="background-color:blue;">"3",</mark><br><mark style="background-color:blue;">"4",</mark><br><mark style="background-color:blue;">"5"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"total": 0</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>shops[].shopId</td><td>integer &#x3C;int32>(ShopId)</td><td>yes</td><td>Flowwow platform shop ID</td><td></td></tr><tr><td></td><td>shops[].name</td><td>string</td><td>yes</td><td>Shop name on the Flowwow platform</td><td></td></tr><tr><td></td><td>shops[].status</td><td>string (ShopStatus)</td><td>yes</td><td>Shop status:<code>"moderation"</code> – under review, <code>"active"</code> – active, <code>"disabled"</code> –deactivated</td><td></td></tr><tr><td></td><td>shops[].address</td><td>string</td><td>yes</td><td>Shop address on the Flowwow platform</td><td></td></tr><tr><td></td><td>shops[].currency</td><td>string</td><td>no</td><td>Shop currency in ISO 4217 format</td><td></td></tr><tr><td></td><td>shops[].isVerified</td><td>boolean</td><td>no</td><td>Indicates whether the shop is verified on the Flowwow platform</td><td></td></tr><tr><td></td><td>shops[].workingDays</td><td>array of string</td><td>no</td><td>Working days (Allowed values: <code>"1"</code>..<code>"7"</code>). If not specified, an empty array is returned</td><td></td></tr><tr><td></td><td>total</td><td>integer</td><td>no</td><td>Total number of shops</td><td></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><p><mark style="background-color:blue;">{</mark><br>    <mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br>    <mark style="background-color:blue;">"fields": [</mark><br>      <mark style="background-color:blue;">{</mark><br>        <mark style="background-color:blue;">"path":</mark> </p><p><mark style="background-color:blue;">"say",</mark><br>          <mark style="background-color:blue;">"messages":</mark> </p><p><mark style="background-color:blue;">[</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br>                 <mark style="background-color:blue;">]</mark><br>             <mark style="background-color:blue;">}</mark><br>         <mark style="background-color:blue;">]</mark><br> <mark style="background-color:blue;">}</mark></p></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>403 Forbidden</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Too Many Requests", "fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>

## Products

Adding, viewing, editing, and managing the visibility of items.

To use the API, you must authenticate using a `bearerToken` that allows the server to identify the seller.

* HTTP: `bearerToken`.
* Authorization scheme: `bearer`.
* Token format: `JWT`.

The item list is determined by the value of the `shopId`. The `shopId` is also available in the Flowwow seller dashboard.

| **Parameter** | **Type**                            | **Required** | **Description**                                                       |
| ------------- | ----------------------------------- | ------------ | --------------------------------------------------------------------- |
| shopId        | integer \<int32> \[1 .. 4294967295] | yes          | <p>Warehouse or shop ID</p><p>Example: <code>shopId=123456</code></p> |

### Retrieve shop items

Returns a list of shop items with filtering options. Pagination is supported.

### **Request**

API request method: POST `/apiseller/products`.

The request structure is shown below. Format: `application/json`:

<table data-header-hidden><thead><tr><th width="131"></th><th></th><th width="121.800048828125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example</strong></td></tr><tr><td>offerIds</td><td>array of strings or null (OfferId) [1 .. 1000], items ≤ 50 символов</td><td>no</td><td>List of item IDs in the shop system</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerIds": [</mark><br><mark style="background-color:blue;">"FLOW-001",</mark><br><mark style="background-color:blue;">"FLOW-002"</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"productIds": [</mark><br><mark style="background-color:blue;">123,</mark><br><mark style="background-color:blue;">456</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"categoryIds": [</mark><br><mark style="background-color:blue;">1,</mark><br><mark style="background-color:blue;">2</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"type": 1,</mark><br><mark style="background-color:blue;">"page": 0,</mark><br><mark style="background-color:blue;">"limit": 20</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td>productIds</td><td>array of integers or null &#x3C;int32> (ProductId) [1 .. 1000], items ≥ 1</td><td>no</td><td>Item IDs in the Flowwow system</td><td></td></tr><tr><td>categoryIds</td><td>array of integers &#x3C;int64> (CategoryId) [1 .. 1000]</td><td>no</td><td>Category IDs in the Flowwow system</td><td></td></tr><tr><td>type</td><td>integer</td><td>no</td><td>Item type in the Flowwow system</td><td></td></tr><tr><td>page</td><td>integer ≥ 0</td><td>no</td><td>Page number. Pagination starts from 0. Default: 0</td><td></td></tr><tr><td>limit</td><td>integer [1 .. 1000]</td><td>no</td><td>Number of items in the response. Minimum – 1, maximum – 1000. Default: 10</td><td></td></tr></tbody></table>

### **Responses**

Server response types: 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table data-header-hidden><thead><tr><th width="142.20001220703125"></th><th width="107.20001220703125"></th><th width="110.5999755859375"></th><th width="96.7999267578125"></th><th width="128.400146484375"></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 OK</strong></td><td>items</td><td>array of objects (ProductItem)</td><td>yes</td><td>List of items</td><td><p> <mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"items": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 123,</mark><br><mark style="background-color:blue;">"isActive": true,</mark><br><mark style="background-color:blue;">"type": 1,</mark><br><mark style="background-color:blue;">"categoryId": 1002001,</mark><br><mark style="background-color:blue;">"subCategoryId": 100200101,</mark><br><mark style="background-color:blue;">"name": "Букет роз «Классика»",</mark><br><mark style="background-color:blue;">"description": "Классический букет из 21 красной розы",</mark><br><mark style="background-color:blue;">"url": "https://flowwow.com/product/buket-roz-klassika",</mark><br><mark style="background-color:blue;">"available": 99999,</mark><br><mark style="background-color:blue;">"stock": 100,</mark><br><mark style="background-color:blue;">"minOrder": 1,</mark><br><mark style="background-color:blue;">"price": "1990.00",</mark><br><mark style="background-color:blue;">"discount": "10",</mark><br><mark style="background-color:blue;">"currencyCode": "RUB",</mark><br><mark style="background-color:blue;">"images": [</mark><br><mark style="background-color:blue;">"https://cdn.example.com/images/flow-0001-1.png"</mark><br><mark style="background-color:blue;">], "productionTime": 60,</mark><br><mark style="background-color:blue;">"shipmentTime": 120,</mark><br><mark style="background-color:blue;">"canRent": 0,</mark><br><mark style="background-color:blue;">"originalId": 0,</mark><br><mark style="background-color:blue;">"isDeliveryPost": false,</mark><br><mark style="background-color:blue;">"isStarred": true,</mark><br><mark style="background-color:blue;">"vat": "20"</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"total": 150</mark><br><mark style="background-color:blue;">}</mark></p><p></p></td></tr><tr><td></td><td>items[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>yes</td><td>Item ID in the seller’s system</td><td></td></tr><tr><td></td><td>items[].productId</td><td>integer or null &#x3C;int32> ≥ 1</td><td>yes</td><td>Item ID in the Flowwow system</td><td></td></tr><tr><td></td><td>items[].isActive</td><td>boolean</td><td>yes</td><td>Indicates whether the item is active. Default: true</td><td></td></tr><tr><td></td><td>items[].type</td><td>integer &#x3C;int32> ≥ 0</td><td>yes</td><td>Item type. Allowed values: 1–3.<br>1 – regular item<br>2 – ready-made item (no assembly required)<br>3 – add-on item (can be bundled with another item)</td><td></td></tr><tr><td></td><td>items[].categoryId</td><td>integer &#x3C;int64> (CategoryId)</td><td>yes</td><td>Category ID</td><td></td></tr><tr><td></td><td>items[].subCategoryId</td><td>integer &#x3C;int64> (SubCategoryId)</td><td>no</td><td>Subcategory ID</td><td></td></tr><tr><td></td><td>items[].name</td><td>string ≤ 500 characters</td><td>yes</td><td>Item name</td><td></td></tr><tr><td></td><td>items[].description</td><td>string or null ≤ 20000 characters</td><td>yes</td><td>Detailed item description</td><td></td></tr><tr><td></td><td>items[].url</td><td>string ≤ 20000 characters</td><td>no</td><td>Item page URL on Flowwow (customer-facing)</td><td></td></tr><tr><td></td><td>items[].available</td><td>integer ≥ 0</td><td>no</td><td>Item availability</td><td></td></tr><tr><td></td><td>items[].stock</td><td>integer ≥ 0</td><td>no</td><td>Stock quantity</td><td></td></tr><tr><td></td><td>items[].minOrder</td><td>integer ≥ 0</td><td>no</td><td>Minimum order quantity</td><td></td></tr><tr><td></td><td>items[].price</td><td>string (PriceString) ^[0-9]+(.[0-9]{1,2})?$</td><td>yes</td><td>Price before discount. Decimal separator: dot</td><td></td></tr><tr><td></td><td>items[].discount</td><td>string (DiscountString) ^[0-9]+$</td><td>no</td><td>Discount percentage</td><td></td></tr><tr><td></td><td>items[].currencyCode</td><td>string (CurrencyCode)</td><td>no</td><td>Shop currency code (ISO 4217). Allowed values: <code>"AED"</code> <code>"AFN"</code> <code>"ALL"</code> <code>"AMD"</code> <code>"ANG"</code> <code>"AOA"</code> <code>"ARS"</code> <code>"AUD"</code> <code>"AWG"</code> <code>"AZN"</code> <code>"BAM"</code> <code>"BBD"</code> <code>"BDT"</code> <code>"BGN"</code> <code>"BHD"</code> <code>"BIF"</code> <code>"BMD"</code> <code>"BND"</code> <code>"BOB"</code> <code>"BRL"</code> <code>"BSD"</code> <code>"BTC"</code> <code>"BTN"</code> <code>"BWP"</code> <code>"BYN"</code> <code>"BYR"</code> <code>"BZD"</code> <code>"CAD"</code> <code>"CDF"</code> <code>"CHF"</code> <code>"CLF"</code> <code>"CLP"</code> <code>"CNY"</code> <code>"COP"</code> <code>"CRC"</code> <code>"CUC"</code> <code>"CUP"</code> <code>"CVE"</code> <code>"CZK"</code> <code>"DJF"</code> <code>"DKK"</code> <code>"DOP"</code> <code>"DZD"</code> <code>"EEK"</code> <code>"EGP"</code> <code>"ERN"</code> <code>"ETB"</code> <code>"EUR"</code> <code>"FJD"</code> <code>"FKP"</code> <code>"GBP"</code> <code>"GEL"</code> <code>"GGP"</code> <code>"GHS"</code> <code>"GIP"</code> <code>"GMD"</code> <code>"GNF"</code> <code>"GTQ"</code> <code>"GYD"</code> <code>"HKD"</code> <code>"HNL"</code> <code>"HRK"</code> <code>"HTG"</code> <code>"HUF"</code> <code>"IDR"</code> <code>"ILS"</code> <code>"IMP"</code> <code>"INR"</code> <code>"IQD"</code> <code>"IRR"</code> <code>"ISK"</code> <code>"JEP"</code> <code>"JMD"</code> <code>"JOD"</code> <code>"JPY"</code> <code>"KES"</code> <code>"KGS"</code> <code>"KHR"</code> <code>"KMF"</code> <code>"KPW"</code> <code>"KRW"</code> <code>"KWD"</code> <code>"KYD"</code> <code>"KZT"</code> <code>"LAK"</code> <code>"LBP"</code> <code>"LKR"</code> <code>"LRD"</code> <code>"LSL"</code> <code>"LTL"</code> <code>"LVL"</code> <code>"LYD"</code> <code>"MAD"</code> <code>"MDL"</code> <code>"MGA"</code> <code>"MKD"</code> <code>"MMK"</code> <code>"MNT"</code> <code>"MOP"</code> <code>"MRO"</code> <code>"MTL"</code> <code>"MUR"</code> <code>"MVR"</code> <code>"MWK"</code> <code>"MXN"</code> <code>"MYR"</code> <code>"MZN"</code> <code>"NAD"</code> <code>"NGN"</code> <code>"NIO"</code> <code>"NOK"</code> <code>"NPR"</code> <code>"NZD"</code> <code>"OMR"</code> <code>"PAB"</code> <code>"PEN"</code> <code>"PGK"</code> <code>"PHP"</code> <code>"PKR"</code> <code>"PLN"</code> <code>"PYG"</code> <code>"QAR"</code> <code>"RON"</code> <code>"RSD"</code> <code>"RUB"</code> <code>"RWF"</code> <code>"SAR"</code> <code>"SBD"</code> <code>"SCR"</code> <code>"SDG"</code> <code>"SEK"</code> <code>"SGD"</code> <code>"SHP"</code> <code>"SLL"</code> <code>"SOS"</code> <code>"SRD"</code> <code>"STD"</code> <code>"SVC"</code> <code>"SYP"</code> <code>"SZL"</code> <code>"THB"</code> <code>"TJS"</code> <code>"TMT"</code> <code>"TND"</code> <code>"TOP"</code> <code>"TRY"</code> <code>"TTD"</code> <code>"TWD"</code> <code>"TZS"</code> <code>"UAH"</code> <code>"UGX"</code> <code>"USD"</code> <code>"UYU"</code> <code>"UZS"</code> <code>"VEF"</code> <code>"VND"</code> <code>"VUV"</code> <code>"WST"</code> <code>"XAF"</code> <code>"XAG"</code> <code>"XAU"</code> <code>"XCD"</code> <code>"XDR"</code> <code>"XOF"</code> <code>"XPD"</code> <code>"XPF"</code> <code>"XPT"</code> <code>"YER"</code> <code>"ZAR"</code> <code>"ZMK"</code> <code>"ZMW"</code> <code>"ZWL"</code></td><td></td></tr><tr><td></td><td>items[].images</td><td>array of strings &#x3C;uri> [ items &#x3C;uri > ]</td><td>no</td><td>Image URLs</td><td></td></tr><tr><td></td><td>items[].productionTime</td><td>integer ≥ 0</td><td>no</td><td>Production time in minutes</td><td></td></tr><tr><td></td><td>items[].shipmentTime</td><td>integer ≥ 0</td><td>no</td><td>Delivery time in minutes</td><td></td></tr><tr><td></td><td>items[].canRent</td><td>integer &#x3C;int32> ≥ 0</td><td>no</td><td>Rental status. Allowed values: 0–2.<br>0 – rental disabled by owner (default)<br>1 – rental enabled by owner<br>2 – rental disabled by Flowwow</td><td></td></tr><tr><td></td><td>items[].originalId</td><td>integer &#x3C;int32> ≥ 0</td><td>no</td><td>Original item ID. If ≠ 0, the item is rented</td><td></td></tr><tr><td></td><td>items[].isDeliveryPost</td><td>boolean</td><td>no</td><td>Delivered by post. Default: false</td><td></td></tr><tr><td></td><td>items[].isStarred</td><td>boolean</td><td>no</td><td>Indicates whether the item is starred. Default: false</td><td></td></tr><tr><td></td><td>items[].vat</td><td>string</td><td>no</td><td>VAT percentage rate. Default: 0</td><td></td></tr><tr><td></td><td>total</td><td>integer</td><td>no</td><td>Total number of items (without pagination)</td><td></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br><mark style="background-color:blue;">"fields": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"path": "say",</mark><br><mark style="background-color:blue;">"messages": [</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><p></p><p><strong>403 Forbidden</strong></p><p><br></p></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td>{<br>"message": "Too Many Requests", "fields": []<br>}</td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>yes</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>

### Link items from the seller’s shop

Imports items from the seller’s shop into the Flowwow marketplace by linking them to existing items using their identifiers.

* If an item with the specified `productId` does not exist for the shop in the Flowwow system, an error will be returned for that item.
* If duplicate `offerId` or `productId`, pairs are included in the same request, all such pairs are considered invalid and will not be processed. Partial processing is not performed for conflicting pairs — each pair will be returned in the `errors` array.
* If ID pairs that have already been linked are submitted again, those pairs will not be processed.

### **Request**

API request method: POST `/apiseller/products/offersMappings`.

The request structure is shown below. Format: `application/json`:

<table data-header-hidden><thead><tr><th></th><th></th><th width="125"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example</strong></td></tr><tr><td>offers</td><td>array of objects [0 .. 1000]</td><td>yes</td><td>Shop item to Flowwow item link</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offers": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td>offers[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>yes</td><td>Item ID in the seller system</td><td></td></tr><tr><td>offers[].productId</td><td>integer or null &#x3C;int32> (ProductId) ≥ 1</td><td>yes</td><td>Item ID in the Flowwow system</td><td></td></tr></tbody></table>

### **Responses**

Server response types: 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table data-header-hidden><thead><tr><th width="98.5999755859375"></th><th></th><th width="110.4000244140625"></th><th width="104"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 OK</strong></td><td>shopId</td><td>integer</td><td>yes</td><td>ID of the requested shop. Processing of <code>offerId</code> and <code>productId</code> pairs is performed only within this shop</td><td><p><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"shopId": 0,</mark><br><mark style="background-color:blue;">"summary": {</mark><br><mark style="background-color:blue;">"total": 13,</mark><br><mark style="background-color:blue;">"success": 8,</mark><br><mark style="background-color:blue;">"failed": 5,</mark><br><mark style="background-color:blue;">"created": 4,</mark><br><mark style="background-color:blue;">"updated": 0,</mark><br><mark style="background-color:blue;">"relinked": 2,</mark><br><mark style="background-color:blue;">"unchanged": 2</mark><br><mark style="background-color:blue;">},</mark><br><mark style="background-color:blue;">"data": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243,</mark><br><mark style="background-color:blue;">"isActive": true,</mark><br><mark style="background-color:blue;">"type": 1,</mark><br><mark style="background-color:blue;">"categoryId": 54,</mark><br><mark style="background-color:blue;">"subCategoryId": 112,</mark><br><mark style="background-color:blue;">"name": "Букет из роз",</mark><br><mark style="background-color:blue;">"description": "Красивый букет из свежих роз.",</mark><br><mark style="background-color:blue;">"url": "https://flowwow.com/product/12345",</mark><br><mark style="background-color:blue;">"available": 1,</mark><br><mark style="background-color:blue;">"stock": 10,</mark><br><mark style="background-color:blue;">"minOrder": 1,</mark><br><mark style="background-color:blue;">"price": "1990.00",</mark><br><mark style="background-color:blue;">"discount": "20",</mark><br><mark style="background-color:blue;">"currencyCode": "RUB",</mark><br><mark style="background-color:blue;">"images": [</mark><br><mark style="background-color:blue;">"</mark><a href="http://example.com/"><mark style="background-color:blue;">http://example.com</mark></a> <mark style="background-color:blue;">"</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"productionTime": 0, "shipmentTime": 0,</mark><br><mark style="background-color:blue;">"canRent": 1,</mark><br><mark style="background-color:blue;">"originalId": 7123456,</mark><br><mark style="background-color:blue;">"isDeliveryPost": true,</mark><br><mark style="background-color:blue;">"isStarred": true,</mark><br><mark style="background-color:blue;">"vat": "10"</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"errors": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243,</mark><br><mark style="background-color:blue;">"message": "У данной пары есть дубль с другим productId или offerId в запросе"</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></p><p><br><br></p></td></tr><tr><td></td><td>summary</td><td>object</td><td>yes</td><td>Summary statistics of processed records</td><td></td></tr><tr><td></td><td>summary[].total</td><td>integer</td><td>yes</td><td>Total number of processed records (<code>success</code> + <code>failed</code>)</td><td></td></tr><tr><td></td><td>summary[].success</td><td>integer</td><td>yes</td><td>Number of successfully processed records (<code>created</code> + <code>updated</code> + <code>relinked</code> + <code>unchanged</code>)</td><td></td></tr><tr><td></td><td>summary[].failed</td><td>integer</td><td>yes</td><td>Number of records that failed processing</td><td></td></tr><tr><td></td><td>summary[].created</td><td>integer</td><td>yes</td><td>Number of newly created links</td><td></td></tr><tr><td></td><td>summary[].updated</td><td>integer</td><td>yes</td><td>Number of updated records without changing the link pair</td><td></td></tr><tr><td></td><td>summary[].relinked</td><td>integer</td><td>yes</td><td>Number of updated link pairs</td><td></td></tr><tr><td></td><td>summary[].unchanged</td><td>integer</td><td>yes</td><td>Number of unchanged records and links</td><td></td></tr><tr><td></td><td>data</td><td>array of objects (ProductItem)</td><td>yes</td><td>Set of items with shortened information</td><td></td></tr><tr><td></td><td>data[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>yes</td><td>Item ID in the seller system</td><td></td></tr><tr><td></td><td>data[].productId</td><td>integer or null ≥ 1</td><td>yes</td><td>Item ID in the Flowwow system</td><td></td></tr><tr><td></td><td>data[].isActive</td><td>boolean</td><td>yes</td><td>Whether the item is active. Default: true</td><td></td></tr><tr><td></td><td>data[].type</td><td>integer ≥ 0</td><td>yes</td><td>Item type. Allowed values: 1–3. 1 – regular item, 2 – ready-made item (no assembly required), 3 – add-on item that can be bundled with another item</td><td></td></tr><tr><td></td><td>data[].categoryId</td><td>integer &#x3C;int64> (CategoryId)</td><td>yes</td><td>Category ID</td><td></td></tr><tr><td></td><td>data[].subCategoryId</td><td>integer &#x3C;int64> (SubCategoryId)</td><td>no</td><td>Subcategory ID</td><td></td></tr><tr><td></td><td>data[].name</td><td>string ≤ 500 characters</td><td>yes</td><td>Item name</td><td></td></tr><tr><td></td><td>data[].description</td><td>string or null ≤ 20000 characters</td><td>yes</td><td>Detailed item description</td><td></td></tr><tr><td></td><td>data[].url</td><td>string ≤ 20000 characters</td><td>no</td><td>Customer-facing item URL on Flowwow</td><td></td></tr><tr><td></td><td>data[].available</td><td>integer ≥ 0</td><td>no</td><td>Item availability</td><td></td></tr><tr><td></td><td>data[].stock</td><td>integer ≥ 0</td><td>no</td><td>Stock quantity</td><td></td></tr><tr><td></td><td>data[].minOrder</td><td>integer ≥ 0</td><td>no</td><td>Minimum order quantity</td><td></td></tr><tr><td></td><td>data[].price</td><td>string (PriceString) ^[0-9]+(\.[0-9]{1,2})?$</td><td>yes</td><td>Price before discount. Decimal separator: dot</td><td></td></tr><tr><td></td><td>data[].discount</td><td>string (DiscountString) ^[0-9]+$</td><td>no</td><td>Discount percentage (integer)</td><td></td></tr><tr><td></td><td>data[].currencyCode</td><td>string (CurrencyCode)</td><td>no</td><td>Shop currency code (ISO 4217). Allowed values: <code>"AED"</code> <code>"AFN"</code> <code>"ALL"</code> <code>"AMD"</code> <code>"ANG"</code> <code>"AOA"</code> <code>"ARS"</code> <code>"AUD"</code> <code>"AWG"</code> <code>"AZN"</code> <code>"BAM"</code> <code>"BBD"</code> <code>"BDT"</code> <code>"BGN"</code> <code>"BHD"</code> <code>"BIF"</code> <code>"BMD"</code> <code>"BND"</code> <code>"BOB"</code> <code>"BRL"</code> <code>"BSD"</code> <code>"BTC"</code> <code>"BTN"</code> <code>"BWP"</code> <code>"BYN"</code> <code>"BYR"</code> <code>"BZD"</code> <code>"CAD"</code> <code>"CDF"</code> <code>"CHF"</code> <code>"CLF"</code> <code>"CLP"</code> <code>"CNY"</code> <code>"COP"</code> <code>"CRC"</code> <code>"CUC"</code> <code>"CUP"</code> <code>"CVE"</code> <code>"CZK"</code> <code>"DJF"</code> <code>"DKK"</code> <code>"DOP"</code> <code>"DZD"</code> <code>"EEK"</code> <code>"EGP"</code> <code>"ERN"</code> <code>"ETB"</code> <code>"EUR"</code> <code>"FJD"</code> <code>"FKP"</code> <code>"GBP"</code> <code>"GEL"</code> <code>"GGP"</code> <code>"GHS"</code> <code>"GIP"</code> <code>"GMD"</code> <code>"GNF"</code> <code>"GTQ"</code> <code>"GYD"</code> <code>"HKD"</code> <code>"HNL"</code> <code>"HRK"</code> <code>"HTG"</code> <code>"HUF"</code> <code>"IDR"</code> <code>"ILS"</code> <code>"IMP"</code> <code>"INR"</code> <code>"IQD"</code> <code>"IRR"</code> <code>"ISK"</code> <code>"JEP"</code> <code>"JMD"</code> <code>"JOD"</code> <code>"JPY"</code> <code>"KES"</code> <code>"KGS"</code> <code>"KHR"</code> <code>"KMF"</code> <code>"KPW"</code> <code>"KRW"</code> <code>"KWD"</code> <code>"KYD"</code> <code>"KZT"</code> <code>"LAK"</code> <code>"LBP"</code> <code>"LKR"</code> <code>"LRD"</code> <code>"LSL"</code> <code>"LTL"</code> <code>"LVL"</code> <code>"LYD"</code> <code>"MAD"</code> <code>"MDL"</code> <code>"MGA"</code> <code>"MKD"</code> <code>"MMK"</code> <code>"MNT"</code> <code>"MOP"</code> <code>"MRO"</code> <code>"MTL"</code> <code>"MUR"</code> <code>"MVR"</code> <code>"MWK"</code> <code>"MXN"</code> <code>"MYR"</code> <code>"MZN"</code> <code>"NAD"</code> <code>"NGN"</code> <code>"NIO"</code> <code>"NOK"</code> <code>"NPR"</code> <code>"NZD"</code> <code>"OMR"</code> <code>"PAB"</code> <code>"PEN"</code> <code>"PGK"</code> <code>"PHP"</code> <code>"PKR"</code> <code>"PLN"</code> <code>"PYG"</code> <code>"QAR"</code> <code>"RON"</code> <code>"RSD"</code> <code>"RUB"</code> <code>"RWF"</code> <code>"SAR"</code> <code>"SBD"</code> <code>"SCR"</code> <code>"SDG"</code> <code>"SEK"</code> <code>"SGD"</code> <code>"SHP"</code> <code>"SLL"</code> <code>"SOS"</code> <code>"SRD"</code> <code>"STD"</code> <code>"SVC"</code> <code>"SYP"</code> <code>"SZL"</code> <code>"THB"</code> <code>"TJS"</code> <code>"TMT"</code> <code>"TND"</code> <code>"TOP"</code> <code>"TRY"</code> <code>"TTD"</code> <code>"TWD"</code> <code>"TZS"</code> <code>"UAH"</code> <code>"UGX"</code> <code>"USD"</code> <code>"UYU"</code> <code>"UZS"</code> <code>"VEF"</code> <code>"VND"</code> <code>"VUV"</code> <code>"WST"</code> <code>"XAF"</code> <code>"XAG"</code> <code>"XAU"</code> <code>"XCD"</code> <code>"XDR"</code> <code>"XOF"</code> <code>"XPD"</code> <code>"XPF"</code> <code>"XPT"</code> <code>"YER"</code> <code>"ZAR"</code> <code>"ZMK"</code> <code>"ZMW"</code> <code>"ZWL"</code></td><td></td></tr><tr><td></td><td>data[].images</td><td>Array of strings &#x3C;uri> [ items &#x3C;uri > ]</td><td>no</td><td>Image URLs</td><td></td></tr><tr><td></td><td>data[].productionTime</td><td>integer ≥ 0</td><td>no</td><td>Production time in minutes</td><td></td></tr><tr><td></td><td>data[].shipmentTime</td><td>integer ≥ 0</td><td>no</td><td>Delivery time in minutes</td><td></td></tr><tr><td></td><td>data[].canRent</td><td>integer ≥ 0</td><td>no</td><td>Rental status. Allowed values: 0–2. 0 – rental disabled by owner (default), 1 – rental enabled by owner, 2 – rental disabled by Flowwow</td><td></td></tr><tr><td></td><td>data[].originalId</td><td>integer ≥ 0</td><td>no</td><td>Original item ID. If not 0, the item is rented</td><td></td></tr><tr><td></td><td>data[].isDeliveryPost</td><td>boolean</td><td>no</td><td>Delivered by post. Default: false</td><td></td></tr><tr><td></td><td>data[].isStarred</td><td>boolean</td><td>no</td><td>Starred item. Promoted more actively</td><td></td></tr><tr><td></td><td>data[].vat</td><td>string</td><td>no</td><td>VAT rate percentage. Default: "0"</td><td></td></tr><tr><td></td><td>errors</td><td>array of objects</td><td>no</td><td>Set of items with shortened information</td><td></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br><mark style="background-color:blue;">"fields": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"path": "say",</mark><br><mark style="background-color:blue;">"messages": [</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>403 Forbidden</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found","fields": [ ]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Too Many Requests",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>

## Stocks <a href="#stocks" id="stocks"></a>

Item stock levels in shop warehouses.

To use the API, you must authenticate with a bearer token that allows the server to identify the seller.

* HTTP: `bearerToken`.
* Authorization scheme: `bearer`.
* Token format: `JWT`.

The item list depends on the value of the `shopId` query parameter. The `shopId` is also available in the Flowwow seller dashboard.

| **Parameter** | **Type**                            | **Required** | **Description**                                                           |
| ------------- | ----------------------------------- | ------------ | ------------------------------------------------------------------------- |
| shopId        | integer \<int32> \[1 .. 4294967295] | yes          | <p>Warehouse or shop ID<br></p><p>Exapmle: <code>shopId=123456</code></p> |

### View item stock levels

Returns stock information for items in the seller’s shop from the Flowwow marketplace.

### **Request**

API request method: POST `/apiseller/stocks/get`.

The request structure is shown below. Format: `application/json`:

<table data-header-hidden><thead><tr><th></th><th></th><th></th><th width="149"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example</strong></td></tr><tr><td>offers</td><td>array of objects [1 .. 1000]</td><td>yes</td><td>Information about items in warehouses</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offers": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001"</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td>offers[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>yes</td><td>Item ID in the seller system</td><td></td></tr></tbody></table>

### **Responses**

Server response types: 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table data-header-hidden><thead><tr><th width="103.4000244140625"></th><th></th><th></th><th width="102.4000244140625"></th><th width="138.2000732421875"></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 OK</strong></td><td>shopId</td><td>integer &#x3C;int32> (schemas-ShopId) ≥ 1</td><td>yes</td><td>Shop ID</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"shopId": 260,</mark><br><mark style="background-color:blue;">"data": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243,</mark><br><mark style="background-color:blue;">"stock": 13</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"errors": [</mark><br><mark style="background-color:blue;">null</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>data</td><td>array of objects [ 0 .. 1000 ] items</td><td>yes</td><td>List of items with stock information</td><td></td></tr><tr><td></td><td>data[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>no</td><td>Item ID in the seller system</td><td></td></tr><tr><td></td><td>data[].productId</td><td>integer or null &#x3C;int32> (ProductId) ≥ 1</td><td>no</td><td>Item ID in the Flowwow system</td><td></td></tr><tr><td></td><td>data[].stock</td><td>integer &#x3C;int32> (StockCount) ≥ 0</td><td>yes</td><td>Available stock quantity, excluding reserved items</td><td></td></tr><tr><td></td><td>errors</td><td>array</td><td>yes</td><td>List of errors</td><td></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br><mark style="background-color:blue;">"fields": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"path": "say",</mark><br><mark style="background-color:blue;">"messages": [</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td><strong>403 Forbidden</strong></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Too Many Requests",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>

### Update item stock levels

Updates stock information for items in the seller’s shop in the Flowwow marketplace.

### **Request**

API request method: PUT `/apiseller/stocks/put`.

The request structure is shown below. Format: `application/json`

| **Field**                                                               | **Type**                                 | **Required** | **Description**                                    | **Example**                                      |
| ----------------------------------------------------------------------- | ---------------------------------------- | ------------ | -------------------------------------------------- | ------------------------------------------------ |
| offers                                                                  | array of objects \[0 .. 1000]            | yes          | Item stock data                                    | <p><mark style="background-color:blue;">{</mark> |
| <br><mark style="background-color:blue;">"offers": \[</mark>            |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">{</mark>                       |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark> |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">"stock": 13</mark>             |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">}</mark>                       |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">]</mark>                       |                                          |              |                                                    |                                                  |
| <br><mark style="background-color:blue;">}</mark></p>                   |                                          |              |                                                    |                                                  |
| offers\[].offerId                                                       | string or null (OfferId) ≤ 50 characters | yes          | Item ID in the seller system                       |                                                  |
| offers\[].stock                                                         | integer \<int32> (StockCount) ≥ 0        | yes          | Available stock quantity, excluding reserved items |                                                  |

### **Responses**

Server response types: 200 OK, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error.

Format: `application/json`.

<table data-header-hidden><thead><tr><th width="90.800048828125"></th><th width="147.79998779296875"></th><th width="128.7999267578125"></th><th width="95.2000732421875"></th><th width="122.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>Status</strong></td><td><strong>Field</strong></td><td><strong>Type</strong></td><td><strong>Required</strong></td><td><strong>Description</strong></td><td><strong>Example response</strong></td></tr><tr><td><strong>200 OK</strong></td><td>shopId</td><td>integer &#x3C;int32> (ShopId) ≥ 1</td><td>yes</td><td>Shop ID</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"shopId": 260,</mark><br><mark style="background-color:blue;">"data": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243,</mark><br><mark style="background-color:blue;">"stock": 13,</mark><br><mark style="background-color:blue;">"updated": true</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">],</mark><br><mark style="background-color:blue;">"errors": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"offerId": "FLOW-0001",</mark><br><mark style="background-color:blue;">"productId": 83418243,</mark><br><mark style="background-color:blue;">"stock": 13,</mark><br><mark style="background-color:blue;">"message": "string"</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>data</td><td>array of objects [1 .. 1000]</td><td>yes</td><td>List of processed item stock records</td><td></td></tr><tr><td></td><td>data[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>no</td><td>Item ID in the seller system</td><td></td></tr><tr><td></td><td>data[].productId</td><td>integer or null &#x3C;int32> (ProductId) ≥ 1</td><td>no</td><td>Item ID in the Flowwow system</td><td></td></tr><tr><td></td><td>data[].stock</td><td>integer &#x3C;int32> (StockCount) ≥ 0</td><td>yes</td><td>Available stock quantity, excluding reserved items</td><td></td></tr><tr><td></td><td>data[].updated</td><td>boolean</td><td>yes</td><td>Indicates whether the item stock was updated</td><td></td></tr><tr><td></td><td>errors</td><td>array of objects [0 .. 1000]</td><td>no</td><td>List of errors</td><td></td></tr><tr><td></td><td>errors[].offerId</td><td>string or null (OfferId) ≤ 50 characters</td><td>no</td><td>Item ID in the seller system</td><td></td></tr><tr><td></td><td>errors[].productId</td><td>integer or null &#x3C;int32> (ProductId) ≥ 1</td><td>no</td><td>Item ID in the Flowwow system</td><td></td></tr><tr><td></td><td>errors[].stock</td><td>integer &#x3C;int32> (StockCount) ≥ 0</td><td>no</td><td>Submitted stock quantity</td><td></td></tr><tr><td></td><td>errors[].message</td><td>string</td><td>yes</td><td>Error description</td><td></td></tr><tr><td><strong>400 Bad Request</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Query param 'say' is empty",</mark><br><mark style="background-color:blue;">"fields": [</mark><br><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"path": "say",</mark><br><mark style="background-color:blue;">"messages": [</mark><br><mark style="background-color:blue;">"Query param 'say' is empty"</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark><br><mark style="background-color:blue;">]</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of string</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>401 Unauthorized</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Missing or invalid token"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>403 Forbidden</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Access denied",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>404 Not Found</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Resource not found",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td></td><td>Retry-After (header)</td><td>integer ≥ 0</td><td>no</td><td>Number of seconds before retrying the request</td><td></td></tr><tr><td><strong>429 Too Many Requests</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Too Many Requests",</mark><br><mark style="background-color:blue;">"fields": []</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr><tr><td><strong>500 Internal Server Error</strong></td><td>message</td><td>string</td><td>yes</td><td>General error description</td><td><mark style="background-color:blue;">{</mark><br><mark style="background-color:blue;">"message": "Internal server error"</mark><br><mark style="background-color:blue;">}</mark></td></tr><tr><td></td><td>fields</td><td>array of objects (fields)</td><td>no</td><td>List of additional field validation errors</td><td></td></tr><tr><td></td><td>fields[].path</td><td>string</td><td>yes</td><td>Field where the error occurred</td><td></td></tr><tr><td></td><td>fields[].messages</td><td>array of strings</td><td>yes</td><td>List of field error messages</td><td></td></tr><tr><td></td><td>trace</td><td>object / null</td><td>no</td><td>Error trace (not available in LIVE environment)</td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://seller-docs.flowwow.com/product-docs-eng/integrations-and-api/flowwow-seller-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
