Stocktaking
Stocktaking
List all stocktakings
Lists all stocktakings for a warehouse.
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a specific page in a result set.
The number of items per page in a result set.
Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
| ENUM | Description |
|---|---|
| NOT_STARTED | Stock counting not started |
| IN_PROGRESS | Stock counting is in progress. Registraions can be made. |
| COMPLETE | Stock counting is complete |
| DELETED | Stock counting is deleted, stock not adjusted |
| CONTROL | Stock counting is in control mode, no further registrations can be made |
| ENUM | Description |
|---|---|
| FULL | Stock counting containing all productUids in tenant |
| PARTIAL | Stock counting containing a list of specific producdIds |
| RECOUNT | Make a new stock taking with a set of productUids to be recounted |
Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"description": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"status": "NOT_STARTED",
"stocktakingUid": "text",
"type": "FULL",
"warehouseUid": "text",
"withStock": true
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}Create new stocktaking
Create new stocktaking for warehouse
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Stock Counting request schema
| ENUM | Description |
|---|---|
| FULL | Stock counting containing all productUids in tenant |
| PARTIAL | Stock counting containing a list of specific producdIds |
| RECOUNT | Make a new stock taking with a set of productUids to be recounted |
false^[A-Za-z0-9-_]+Example response
POST /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 78
{
"description": "text",
"type": "FULL",
"withStock": false,
"stocktakingUid": "text"
}Example response
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"description": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"status": "NOT_STARTED",
"stocktakingUid": "text",
"type": "FULL",
"warehouseUid": "text",
"withStock": true
}Get stocktaking details
Get stocktaking details
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"description": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"status": "NOT_STARTED",
"stocktakingUid": "text",
"type": "FULL",
"warehouseUid": "text",
"withStock": true
}Update stocktaking details
Update stocktaking for warehouse
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+| ENUM | Description |
|---|---|
| NOT_STARTED | Stock counting not started |
| IN_PROGRESS | Stock counting is in progress. Registraions can be made. |
| COMPLETE | Stock counting is complete |
| DELETED | Stock counting is deleted, stock not adjusted |
| CONTROL | Stock counting is in control mode, no further registrations can be made |
Example response
PUT /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45
{
"description": "text",
"status": "NOT_STARTED"
}Example response
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"description": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"status": "NOT_STARTED",
"stocktakingUid": "text",
"type": "FULL",
"warehouseUid": "text",
"withStock": true
}Delete a stocktaking
Delete a stocktaking
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+No Content
No content
DELETE /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No Content
No content
Get a stocktaking control list
Get a stocktaking control list
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
Reference to a specific page in a result set.
The number of items per page in a result set.
Only return stocktaking items with diff
Only return stocktaking items with registrations
Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/control HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"description": "text",
"totals": {
"productsWithPositiveDiffCount": 1,
"positiveDiffAmount": 1,
"productsWithNegativeDiffCount": 1,
"negativeDiffAmount": 1,
"stockValueAtStart": 1,
"stockValueRegistered": 1
},
"items": [
{
"costPrice": 1,
"brandName": "text",
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"name": "text",
"note": "text",
"productGroupName": "text",
"productUid": "text",
"quantityDiff": 1,
"quantityRegistered": 1,
"quantityStock": 1,
"sku": "text",
"stocktakingItemUid": "text"
}
],
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
},
"status": "NOT_STARTED",
"stocktakingUid": "text",
"warehouseUid": "text",
"withStock": true
}Get item list for a stocktaking
Get item list for a stocktaking
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
Reference to a specific page in a result set.
The number of items per page in a result set.
Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"note": "text",
"product": {
"brandName": "text",
"gtins": [
"text"
],
"name": "text",
"productGroupName": "text",
"productUid": "text",
"serialNoRequired": "NO",
"sku": "text"
},
"serialnumbers": [
"text"
],
"stocktakingItemUid": "text"
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}Add productUids to a stocktaking
Add productUids to a stocktaking
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+List of productUids to be added to a stocktaking
Example response
POST /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24
{
"productUids": [
"text"
]
}Example response
{
"items": [
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"note": "text",
"product": {
"brandName": "text",
"gtins": [
"text"
],
"name": "text",
"productGroupName": "text",
"productUid": "text",
"serialNoRequired": "NO",
"sku": "text"
},
"serialnumbers": [
"text"
],
"stocktakingItemUid": "text"
}
]
}Get an item on a stocktaking
Get details for a specific item on a stocktaking
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Reference to a Stocktaking item id.
^[A-Za-z0-9-_]+GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"note": "text",
"product": {
"brandName": "text",
"gtins": [
"text"
],
"name": "text",
"productGroupName": "text",
"productUid": "text",
"serialNoRequired": "NO",
"sku": "text"
},
"serialnumbers": [
"text"
],
"stocktakingItemUid": "text"
}Update an item on a stocktaking
Update note on a stock taking item
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Reference to a Stocktaking item id.
^[A-Za-z0-9-_]+Update a stocktaking item
PUT /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15
{
"note": "text"
}{
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"lastModifiedAt": "2025-10-28T12:47:01.504Z",
"lastModifiedBy": "text",
"note": "text",
"product": {
"brandName": "text",
"gtins": [
"text"
],
"name": "text",
"productGroupName": "text",
"productUid": "text",
"serialNoRequired": "NO",
"sku": "text"
},
"serialnumbers": [
"text"
],
"stocktakingItemUid": "text"
}Delete an item from a stocktaking
Delete an item from a stocktaking with all registrations
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Reference to a Stocktaking item id.
^[A-Za-z0-9-_]+No Content
No content
DELETE /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No Content
No content
Get all registrations for a stocktaking item
Get all registrations for a stocktaking item
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Reference to a Stocktaking item id.
^[A-Za-z0-9-_]+Defines which field the resource list is sorted by.
| ENUM | Description |
|---|---|
| ASC | Sort in ascending order |
| DESC | Sort in descending order |
Reference to a specific page in a result set.
The number of items per page in a result set.
Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}/registrations HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
{
"items": [
{
"stocktakingRegistrationUid": "text",
"createdAt": "2025-10-28T12:47:01.504Z",
"createdBy": "text",
"quantity": 1,
"serialnumber": "text",
"note": "text"
}
],
"paging": {
"pageNumber": 1,
"pageSize": 1,
"totalCount": 1
}
}Make a stocktaking registration
A stocktaking registration can only be done while stocktaking has status IN_PROGRESS.
Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Schema for a list of stocktaking registrations
OK
No content
POST /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/register HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 82
{
"items": [
{
"productUid": "text",
"quantity": 1,
"serialnumber": "text",
"note": "text"
}
]
}OK
No content
Download stocktaking report
Report for a COMPLETE Stocktaking
Reference to a tenant.
^[A-Za-z0-9-_]+Reference to a Store.
^[A-Za-z0-9-_]+Reference to a Warehouse.
^[A-Za-z0-9-_]+Reference to a Stocktaking.
^[A-Za-z0-9-_]+Only return stocktaking items with diff
Only return stocktaking items with registrations
Example response
GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/download HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
Example response
binaryWas this helpful?