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
Category flags
Bit
Name
8
FISCALIZATION_DISABLED
Get categories
GET
https://api.dotykacka.cz/v2/clouds/:cloudId/categories
Path Parameters
cloudId*
integer
Query Parameters
page
integer
limit
integer
filter
string
sort
string
Headers
If-None-Match
string
ETag to return results only if changed.
Authorization*
string
Bearer accessToken
Get category
GET
https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId
Path Parameters
categoryId*
integer
cloudId*
integer
Headers
If-None-Match
string
ETag to return results only if changed.
Authorization*
string
Bearer accessToken
Create category
POST
https://api.dotykacka.cz/v2/clouds/:cloudId/categories
Path Parameters
cloudId*
integer
Headers
Authorization*
string
Bearer accessToken
Request Body
array
Array of categories. Maximum size 100.
Replace or create categories
PUT
https://api.dotykacka.cz/v2/clouds/:cloudId/categories
Path Parameters
cloudId*
integer
Headers
If-Match
string
ETag to update only if not changed.
Authorization*
string
Bearer accessToken
Request Body
array
Array of categories. Maximum size 100.
Replace or create category
PUT
https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId
Path Parameters
categoryId*
integer
cloudId*
integer
Headers
If-Match
string
ETag to update only if not changed.
Authorization*
string
Bearer accessToken
Request Body
object
Category
Partial update of category
PATCH
https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId
Path Parameters
categoryId*
integer
cloudId*
integer
Headers
If-Match*
string
ETag to update only if not changed.
Authorization*
string
Bearer accessToken
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
categoryId*
integer
cloudId*
integer
Headers
If-Match
string
ETag ignored (temporarily) when deleting an entity.
Authorization*
string
Bearer accessToken
Options categories
OPTIONS
https://api.dotykacka.cz/v2/clouds/:cloudId/categories
Path Parameters
cloudId*
integer
Headers
Authorization*
string
Bearer accessToken
Options category
OPTIONS
https://api.dotykacka.cz/v2/clouds/:cloudId/categories/:categoryId
Path Parameters
categoryId*
integer
cloudId*
integer
Headers
Authorization*
string
Bearer accessToken
Last updated