Employee

Please see the Breaking changes page for more info on the planned changes in validation.

Employee schema

id long? Employee ID - cannot be null in PUT/PATCH methods 📶 EQUALS,ENUM

_cloudId integer Cloud ID

_sellerId long? Seller ID 📶 EQUALS,ENUM

accessLevel long Access level 📶 BITS

barcode string?(180) Bar code 📶 STRING

deleted boolean Employee deleted - cannot be true in POST/PUT/PATCH methods 📶 EQUALS, ENUM 🔽 BOTH

email string?(100) E-mail address 📶 STRING 🔽 BOTH

enabled boolean Employee enabled 📶 EQUALS, ENUM

hexColor string(7) Employee color

maxDiscount double? Max discount

modifiedBy string?(32) Employee modified by

name string(256) Employee name - must not be empty 📶 STRING 🔽 BOTH

phone string?(40) Phone number 📶 STRING

requirePinAlways boolean Whether the PIN is always required 📶 EQUALS, ENUM

stockAccessLevel long Stock access level 📶 BITS

tags string[]? Tags list for employee 📶 EQUALS, ENUM

versionDate timestamp? Last modification date and time 📶 EQUALS, ENUM, NUMBER 🔽 BOTH

JSON response

{
    "_cloudId": <integer>,
    "_sellerId": <long>,
    "accessLevel": <long>,
    "barcode": <string>,
    "deleted": <boolean>,
    "email": <string>,
    "enabled": <boolean>,
    "hexColor": <string>,
    "id": <long> ,
    "maxDiscount": <double>,
    "modifiedBy": <string>,
    "name": <string>,
    "phone": <string>,
    "requirePinAlways": <boolean>,
    "stockAccessLevel": <long>,
    "tags":  <string[]>,
    "versionDate": <timestamp>
}

Get employees

GET https://api.dotykacka.cz/v2/clouds/:cloudId/employees

Path Parameters

Name	Type	Description
cloudId*	integer

Query Parameters

Name	Type	Description
sort	string
filter	string
page	integer
limit	integer

Headers

Name	Type	Description
If-None-Match	string	ETag to return results only if changed.
Authorization*	string	Bearer accessToken

200

[
 {
  // employee schema
 }
]

Get employee

GET https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
If-None-Match	string	ETag to return results only if changed.
Authorization*	string	Bearer accessToken

200

{
    // employee schema
}

Create employee

POST https://api.dotykacka.cz/v2/clouds/:cloudId/employees

Path Parameters

Name	Type	Description
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

Request Body

Name	Type	Description
	array	Array of employee. Maximum size 100.

200

[
    {
        // employee schema
        ...
    }
]

400

Replace or create employees

PUT https://api.dotykacka.cz/v2/clouds/:cloudId/employees

Path Parameters

Name	Type	Description
cloudId*	integer

Headers

Name	Type	Description
If-Match	string	ETag to update only if not changed.
Authorization*	string	Bearer accessToken

Request Body

Name	Type	Description
	array	Array of employee. Maximum size 100.

200

[
    {
        // Employee schema
        ...
    }
]

400

Replace or create employee

PUT https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
If-Match	string	ETag to update only if not changed.
Authorization*	string	Bearer accessToken

Request Body

Name	Type	Description
	object	Employee

200

{
    // Employee schema
}

400

Partial update of employee

PATCH https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
If-Match*	string	ETag to update only if not changed.
Authorization*	string	Bearer accessToken

Request Body

Name	Type	Description
	object	Part of employee

200

400

Delete employee

DELETE https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
If-Match	string	ETag ignored (temporarily) when deleting an entity.
Authorization*	string	Bearer accessToken

200

Options employees

OPTIONS https://api.dotykacka.cz/v2/clouds/:cloudId/employees

Path Parameters

Name	Type	Description
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

200

Options employee

OPTIONS https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

200

Set access pin schema

accessPin string(4,...) Numeric characters only

requirePinAlways boolean?

JSON access pin schema

{
    "accessPin":  <string>,
    "requirePinAlways": <boolean>
}

Set employee access pin

POST https://api.dotykacka.cz/v2/clouds/:cloudId/employees/:employeeId/access-pins

Path Parameters

Name	Type	Description
employeeId*	integer
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

Request Body

Name	Type	Description
	object	Access pin schema

200