API
Search
⌃K
Links

Customer

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

Customer schema

id long? Customer ID - cannot be null in PUT/PATCH methods 📶 EQUALS,ENUM
_cloudId integer Cloud ID
_discountGroupId long? Discount group ID 📶 EQUALS,ENUM
_sellerId long? Seller ID 📶 EQUALS,ENUM
addressLine1 string(180) Address line 1 📶 STRING
addressLine2 string?(180) Address line 2 📶 STRING
barcode string(50) Bar code 📶 EQUALS,ENUM
birthday timestamp? The date of birth
city string?(255) City 📶 EQUALS,STRING
companyId string(255) Customer company ID (CZ: IČO, PL: REGON) 📶 ENUM
companyName string(180) [1] Customer company name 📶 STRING 🔽 BOTH
country string?(10) Country code 📶 STRING
created timestamp? Customer created date and time 📶 EQUALS, ENUM, NUMBER 🔽 BOTH
deleted boolean Customer deleted - cannot be true in POST/PUT/PATCH methods 📶 EQUALS, ENUM 🔽 BOTH
display boolean Customer displayed 📶 EQUALS, ENUM 🔽 BOTH
email string(100) E-mail address 📶 STRING
expireDate timestamp? Customer expire date and time 📶 EQUALS, ENUM, NUMBER 🔽 BOTH
externalId string?(256) External ID 📶 EQUALS,ENUM
firstName string(180) [1] First name 📶 STRING 🔽 BOTH
flags long Customer flags 📶 BITS
headerPrint string(256) Header for printing
hexColor string(7) Product color
internalNote string(1000) Internal note
lastName string(180) [1] Last name 📶 STRING 🔽 BOTH
modifiedBy string?(32) Customer modified by
note string?(500) Customer note
phone string(20) Phone 📶 STRING
points double Customer points - must be greater than or equal to 0 📶 NUMBER
tags string[](255) Tags for a customer 📶 EQUALS, ENUM
vatId string(255) Customer VAT ID (CZ: DIČ, PL: NIP). Validation regex.
versionDate timestamp? Last modification date and time 📶 EQUALS, ENUM, NUMBER 🔽 BOTH
zip string(20) ZIP code 📶 STRING
[1] Properties firstName, lastName and companyName must not be blank. At least one of these properties must contain a non-blank value.

JSON response

{
"_cloudId": <integer>,
"_discountGroupId": <integer>,
"_sellerId": <long>,
"addressLine1": <string>,
"addressLine2": <string>,
"barcode": <string>,
"birthday": <timestamp>,
"city": <string>,
"companyId": <string>,
"companyName": <string>,
"country": <string>,
"created": <timestamp>,
"deleted": <boolean>,
"display": <boolean>,
"email": <string>,
"expireDate": <timestamp>,
"externalId": <string>,
"firstName": <string>,
"flags": <long>,
"headerPrint": <string>,
"hexColor": <string>,
"id": <long>,
"internalNote": <string>,
"lastName": <string>,
"modifiedBy": <string>,
"note": <string>,
"phone":<string>,
"points": <double>,
"tags": <string[]>,
"vatId": <string>,
"versionDate": <timestamp>,
"zip": <string>
}
get
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers
Get customers
get
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers/:customerId
Get customer
post
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers
Create customers
// Body request minimmum
[
{
"_cloudId": <integer>,
"addressLine1": <string>,
"barcode": <string>,
"companyId": <string>,
"companyName": <string>,
"deleted": <boolean>,
"display": <boolean>,
"email": <string>,
"firstName": <string>,
"headerPrint": <string>,
"hexColor": <string>,
"internalNote": <string>,
"lastName": <string>,
"phone":<string>,
"points": <double>,
"tags": <string[]>,
"vatId": <string>,
"zip": <string>,
}
]
put
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers
Replace or create customers
// Body request minimmum
[
{
"_cloudId": <integer>,
"addressLine1": <string>,
"barcode": <string>,
"companyId": <string>,
"companyName": <string>,
"deleted": <boolean>,
"display": <boolean>,
"email": <string>,
"firstName": <string>,
"headerPrint": <string>,
"hexColor": <string>,
"id": <long>,
"internalNote": <string>,
"lastName": <string>,
"phone":<string>,
"points": <double>,
"tags": <string[]>,
"vatId": <string>,
"zip": <string>,
}
]
put
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers/:customerId
Replace or create customer
// Body request minimmum
{
"_cloudId": <integer>,
"addressLine1": <string>,
"barcode": <string>,
"companyId": <string>,
"companyName": <string>,
"deleted": <boolean>,
"display": <boolean>,
"email": <string>,
"firstName": <string>,
"headerPrint": <string>,
"hexColor": <string>,
"id": <long>,
"internalNote": <string>,
"lastName": <string>,
"phone":<string>,
"points": <double>,
"tags": <string[]>,
"vatId": <string>,
"zip": <string>,
}
patch
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers/:customerId
Partial update of Customer
delete
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers/:customerId
Delete customer
options
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers
Options customers
options
https://api.dotykacka.cz
/v2/clouds/:cloudId/customers/:customerId
Options customer