Category

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

Category schema

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

_cloudId integer Cloud ID

_defaultCourseId long? Course ID 📶 EQUALS,ENUM

_eetSubjectId long? EET Subject ID 📶 EQUALS,ENUM 🔽 NONE

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

display boolean Category displayed 📶 EQUALS, ENUM 🔽 BOTH

externalId string? External ID 📶 EQUALS,ENUM 🔽 NONE

flags long Category flags 📶 BITS 🔽 NONE

hexColor string(7) Category color

margin string?(180) Category margin

maxDiscount double? Max discount

modifiedBy string?(32) Category modified by

name string(180) Category name 📶 STRING 🔽 BOTH

sortOrder long? Category sort order 🔽 BOTH

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

translatedName map<string, string>? A mapping of language codes to translated category names. 🔽 NONE

vat double? VAT value (a multiplier from range <1.0; 2.0>, f.e. vat=1.234 corresponds to VAT 23.4%)

For VAT payers this value is validated and it must correspond to one of the configured VAT rates.

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

Category response

JSON

{
    "_cloudId": <integer>,
    "_defaultCourseId": <long>,    
    "_eetSubjectId": <long>,
    "deleted": <boolean>,
    "display": <boolean>,
    "externalId": <string>,
    "flags": <long>,
    "hexColor": <string>,
    "id": <long>,
    "margin": <string>,
    "maxDiscount": <double>,
    "modifiedBy": <string>,
    "name": <string>,
    "sortOrder": <long>,
    "tags": <string[]>,
    "translatedName": <map<string, string>>,
    "vat": <double>,
    "versionDate": <timestamp>
}

Category flags

Bit	Name
8	FISCALIZATION_DISABLED

Get categories

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

Path Parameters

Name	Type	Description
cloudId*	integer

Query Parameters

Name	Type	Description
page	integer
limit	integer
filter	string
sort	string

Headers

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

200

JSON

[
    {
        Category response schema
    },
    ...
]

400

404

Get category

GET https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId

Path Parameters

Name	Type	Description
categoryId*	integer
cloudId*	integer

Headers

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

200

400

404

Create category

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

Path Parameters

Name	Type	Description
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

Request Body

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

200

400

// Body request minimmum
[
	{		
		"_cloudId":  <integer>,
    "deleted": <boolean>,
    "display": <boolean>,
    "flags": <short>,
    "hexColor": <string>,
    "name": <string>
		... Optional is category schema
	}	
]

Replace or create categories

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

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 categories. Maximum size 100.

200

400

// Body request minimmum
[
  {	
    "_cloudId":  <integer>,
    "deleted": <boolean>,
    "display": <boolean>,
    "flags": <short>,
    "hexColor": <string>,
    "id": <long>,
    "name": <string>		
  	... Optional is category schema
  }
]

Replace or create category

PUT https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId

Path Parameters

Name	Type	Description
categoryId*	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	Category

200

400

// Body request minimmum
{	
  "_cloudId":  <integer>,
  "deleted": <boolean>,
  "display": <boolean>,
  "flags": <short>,
  "hexColor": <string>,
  "id": <long>,
  "name": <string>	
	... Optional is category schema
}

Partial update of category

PATCH https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId

Path Parameters

Name	Type	Description
categoryId*	integer
cloudId*	integer

Headers

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

200

400

Delete category

DELETE https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId

Category cannot contains any non-deleted products (deleted=false). Only empty category can be deleted. Move products from category via GET/PUT methods. For GET method usefilter=deleted|eq|false;_categoryId|eq|:categoryId

Path Parameters

Name	Type	Description
categoryId*	integer
cloudId*	integer

Headers

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

200

409

Options categories

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

Path Parameters

Name	Type	Description
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

200

Options category

OPTIONS https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId

Path Parameters

Name	Type	Description
categoryId*	integer
cloudId*	integer

Headers

Name	Type	Description
Authorization*	string	Bearer accessToken

200