Stocktaking

Stocktaking

List all stocktakings

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings

Lists all stocktakings for a warehouse.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

stocktakingStatusQuerystring · enumOptional

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

Possible values:

stocktakingTypeQuerystring · enumOptional

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

Possible values:

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "createdAt": "2025-12-13T18:43:28.945Z",
      "createdBy": "text",
      "description": "text",
      "lastModifiedAt": "2025-12-13T18:43:28.945Z",
      "lastModifiedBy": "text",
      "status": "NOT_STARTED",
      "stocktakingUid": "text",
      "type": "FULL",
      "warehouseUid": "text",
      "withStock": true
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new stocktaking

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings

Create new stocktaking for warehouse

Authorizations

accessTokenintegrationTokenauthToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

Stock Counting request schema

descriptionstringRequired

typestring · enumRequired

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

Possible values:

withStockbooleanRequiredDefault: false

stocktakingUidstringOptionalPattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

post

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings

HTTPcURLJavaScriptPython

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

200

Example response

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "description": "text",
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "lastModifiedBy": "text",
  "status": "NOT_STARTED",
  "stocktakingUid": "text",
  "type": "FULL",
  "warehouseUid": "text",
  "withStock": true
}

Get stocktaking details

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

Get stocktaking details

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "description": "text",
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "lastModifiedBy": "text",
  "status": "NOT_STARTED",
  "stocktakingUid": "text",
  "type": "FULL",
  "warehouseUid": "text",
  "withStock": true
}

Update stocktaking details

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

Update stocktaking for warehouse

Authorizations

accessTokenintegrationTokenauthToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

descriptionstringRequired

statusstring · enumRequired

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

Possible values:

Responses

200

Example response

application/json

put

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

HTTPcURLJavaScriptPython

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

200

Example response

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "description": "text",
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "lastModifiedBy": "text",
  "status": "NOT_STARTED",
  "stocktakingUid": "text",
  "type": "FULL",
  "warehouseUid": "text",
  "withStock": true
}

Delete a stocktaking

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

Delete a stocktaking

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

delete

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content

Get a stocktaking control list

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/control

Get a stocktaking control list

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

hasDiffbooleanOptional

Only return stocktaking items with diff

hasRegistrationsbooleanOptional

Only return stocktaking items with registrations

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/control

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/control HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "description": "text",
  "totals": {
    "productsWithPositiveDiffCount": 1,
    "positiveDiffAmount": 1,
    "productsWithNegativeDiffCount": 1,
    "negativeDiffAmount": 1,
    "stockValueAtStart": 1,
    "stockValueRegistered": 1
  },
  "items": [
    {
      "costPrice": 1,
      "brandName": "text",
      "createdAt": "2025-12-13T18:43:28.945Z",
      "createdBy": "text",
      "name": "text",
      "note": "text",
      "productGroupName": "text",
      "productUid": "text",
      "quantityDiff": 1,
      "quantityRegistered": 1,
      "quantityStock": 1,
      "sku": "text",
      "stocktakingItemUid": "text"
    }
  ],
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items

Get item list for a stocktaking

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "createdAt": "2025-12-13T18:43:28.945Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-12-13T18:43:28.945Z",
      "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

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items

Add productUids to a stocktaking

Authorizations

accessTokenintegrationTokenauthToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

productUidsstring[]Required

List of productUids to be added to a stocktaking

Responses

200

Example response

application/json

post

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items

HTTPcURLJavaScriptPython

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

200

Example response

{
  "items": [
    {
      "createdAt": "2025-12-13T18:43:28.945Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-12-13T18:43:28.945Z",
      "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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

Get details for a specific item on a stocktaking

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

stocktakingItemUidstringRequired

Reference to a Stocktaking item id.

Pattern: ^[A-Za-z0-9-_]+

Responses

200Success

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

HTTPcURLJavaScriptPython

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: */*

200Success

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "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

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

Update note on a stock taking item

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

stocktakingItemUidstringRequired

Reference to a Stocktaking item id.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

Update a stocktaking item

notestringRequired

Responses

200Success

application/json

put

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

HTTPcURLJavaScriptPython

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

200Success

{
  "createdAt": "2025-12-13T18:43:28.945Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-12-13T18:43:28.945Z",
  "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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

Delete an item from a stocktaking with all registrations

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

stocktakingItemUidstringRequired

Reference to a Stocktaking item id.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

delete

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}

HTTPcURLJavaScriptPython

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: */*

204

No Content

No content

Get all registrations for a stocktaking item

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}/registrations

Get all registrations for a stocktaking item

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

stocktakingItemUidstringRequired

Reference to a Stocktaking item id.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/items/{stocktakingItemUid}/registrations

HTTPcURLJavaScriptPython

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: */*

200

Example response

{
  "items": [
    {
      "stocktakingRegistrationUid": "text",
      "createdAt": "2025-12-13T18:43:28.945Z",
      "createdBy": "text",
      "quantity": 1,
      "serialnumber": "text",
      "note": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Make a stocktaking registration

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/register

A stocktaking registration can only be done while stocktaking has status IN_PROGRESS.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

Schema for a list of stocktaking registrations

Responses

204

OK

post

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/register

HTTPcURLJavaScriptPython

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

204

OK

No content

Download stocktaking report

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/download

Report for a COMPLETE Stocktaking

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

warehouseUidstringRequired

Reference to a Warehouse.

Pattern: ^[A-Za-z0-9-_]+

stocktakingUidstringRequired

Reference to a Stocktaking.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

hasDiffbooleanOptional

Only return stocktaking items with diff

hasRegistrationsbooleanOptional

Only return stocktaking items with registrations

Responses

200

Example response

application/pdfapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Responsestring · binary

get

/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/download

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}/stocktakings/{stocktakingUid}/download HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

binary