Prodej

Operace ve skupině Prodej.

Základní URLhttps://api.damedoklad.cz/v1Přihlášení Chyby a limity Konvence

GET/v1/contacts/{id}/set-off-candidates
POST/v1/eet/certificate
DEL/v1/eet/certificate
POST/v1/eet/certificate/renew
GET/v1/eet/certificate/renewal
POST/v1/eet/devices
PATCH/v1/eet/devices/{id}
GET/v1/eet/mandates
POST/v1/eet/mandates
PATCH/v1/eet/mandates/{id}
DEL/v1/eet/mandates/{id}
POST/v1/eet/mandates/{id}/certificate
GET/v1/eet/records
POST/v1/eet/records/{id}/exclude
POST/v1/eet/records/{id}/retry
POST/v1/eet/records/retry
GET/v1/eet/settings
PATCH/v1/eet/settings
GET/v1/eet/summary
POST/v1/eet/test-connection
POST/v1/eet/units
PATCH/v1/eet/units/{id}
GET/v1/eet/vouchers
POST/v1/eet/vouchers
GET/v1/eet/vouchers/{id}
PATCH/v1/eet/vouchers/{id}
POST/v1/eet/vouchers/{id}/adjust
POST/v1/eet/vouchers/{id}/redeem
POST/v1/eet/vouchers/{id}/void
POST/v1/pos/bridge/grants
GET/v1/pos/bridge/key
GET/v1/pos/closures/{id}/pdf
GET/v1/pos/offline-conflicts
POST/v1/pos/offline-conflicts
POST/v1/pos/offline-conflicts/{id}/resolve
GET/v1/pos/offline-pack
GET/v1/pos/receipts/{id}/pdf
GET/v1/pos/registers
POST/v1/pos/registers
PATCH/v1/pos/registers/{id}
GET/v1/pos/registers/{id}/closure-preview
GET/v1/pos/registers/{id}/closures
POST/v1/pos/registers/{id}/closures
GET/v1/pos/registers/{id}/hardware
PUT/v1/pos/registers/{id}/hardware
GET/v1/pos/registers/{id}/quick-keys
PUT/v1/pos/registers/{id}/quick-keys
GET/v1/pos/series-gaps
POST/v1/proformas/{id}/refund
GET/v1/retentions
POST/v1/retentions
PATCH/v1/retentions/{id}
DEL/v1/retentions/{id}
POST/v1/retentions/{id}/classify
GET/v1/retentions/notice
POST/v1/retentions/reclassify
GET/v1/retentions/settings
PUT/v1/retentions/settings
GET/v1/sales/accounting-options
GET/v1/sales/doc/{kind}/{id}/emails
GET/v1/sales/doc/{kind}/{id}/isdoc
GET/v1/sales/doc/{kind}/{id}/pdf
POST/v1/sales/doc/{kind}/{id}/public-link
DEL/v1/sales/doc/{kind}/{id}/public-link
POST/v1/sales/doc/{kind}/{id}/send
GET/v1/sales/documents
POST/v1/sales/documents
GET/v1/sales/documents/{id}
PATCH/v1/sales/documents/{id}
DEL/v1/sales/documents/{id}
POST/v1/sales/documents/{id}/cancel
POST/v1/sales/documents/{id}/convert
POST/v1/sales/documents/{id}/issue
POST/v1/sales/documents/{id}/payments
POST/v1/sales/documents/{id}/pos-return
POST/v1/sales/documents/{id}/status
POST/v1/sales/documents/{id}/storno
GET/v1/sales/email-templates
PUT/v1/sales/email-templates/{type}/{language}
DEL/v1/sales/email-templates/{type}/{language}
POST/v1/sales/import-isdoc
POST/v1/sales/import-isdoc-advance
POST/v1/sales/invoices/{id}/penalty-invoice
POST/v1/sales/invoices/{id}/reminders
GET/v1/sales/late-interest
GET/v1/sales/overdue
POST/v1/sales/pos-returns
POST/v1/sales/pos-sales
GET/v1/sales/recurring
POST/v1/sales/recurring
GET/v1/sales/recurring/{id}
PATCH/v1/sales/recurring/{id}
DEL/v1/sales/recurring/{id}
POST/v1/sales/recurring/run-due
GET/v1/sales/reminders
GET/v1/sales/reminders/{id}/pdf
POST/v1/sales/reminders/{id}/send
POST/v1/sales/reminders/run-due
GET/v1/sales/settings
PUT/v1/sales/settings
POST/v1/sales/settings/logo
GET/v1/set-offs
POST/v1/set-offs
GET/v1/set-offs/{id}
GET/v1/set-offs/{id}/pdf
POST/v1/set-offs/{id}/storno

List the open receivables and payables of one contact that can be set off against each other

GET/v1/contacts/{id}/set-off-candidates

List the open receivables and payables of one contact that can be set off against each other

Nástroj MCP: list-set-off-candidates

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"set_off_candidate"povinné

kindstringpovinné

sidestringpovinné

creditNotebooleanpovinné

documentIdnull | stringpovinné

numbernull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

currencynull | stringpovinné

totalHalerinteger | nullpovinné

openHalerintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/contacts/{id}/set-off-candidates

curl https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/set-off-candidates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/set-off-candidates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/set-off-candidates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Upload the .p12 cash register certificate from DIS+ as base64 with its password. It is stored encrypted and the private key never comes back

POST/v1/eet/certificate

Upload the .p12 cash register certificate from DIS+ as base64 with its password. It is stored encrypted and the private key never comes back. § 14 odst. 4: the taxpayer answers for handling the certificate so it cannot be misused. The password is used once to open the file and is not stored.

Nástroj MCP: upload-eet-certificate

Tělo požadavku

certificateBase64stringpovinnémin 16 charsmax 64000 chars

File content encoded as base64.

passwordstringpovinnémax 200 chars

Odpověď · 201

enabledbooleanpovinné

modestringpovinné

liveAvailablebooleanpovinné

eicnull | stringpovinné

suggestedEicnull | stringpovinné

responseTimeoutSecondsintegerpovinné

certificatenull | objectpovinné

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

unitsobject[]povinné

object"eet_unit"povinné

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

devicesobject[]povinné

object"eet_device"povinné

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

mandatesobject[]

object"eet_mandate"povinné

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

POST/v1/eet/certificate

curl -X POST https://api.damedoklad.cz/v1/eet/certificate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "certificateBase64": "string",
  "password": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/certificate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "certificateBase64": "string",
    "password": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/certificate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "certificateBase64": "string",
        "password": "string"
    },
)
data = response.json()

Delete the stored cash register certificate and its private key. Refused while the company records sales in live mode

DELETE/v1/eet/certificate

Delete the stored cash register certificate and its private key. Refused while the company records sales in live mode

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: remove-eet-certificate

Odpověď · 200

enabledbooleanpovinné

modestringpovinné

liveAvailablebooleanpovinné

eicnull | stringpovinné

suggestedEicnull | stringpovinné

responseTimeoutSecondsintegerpovinné

certificatenull | objectpovinné

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

unitsobject[]povinné

object"eet_unit"povinné

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

devicesobject[]povinné

object"eet_device"povinné

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

mandatesobject[]

object"eet_mandate"povinné

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

DELETE/v1/eet/certificate

curl -X DELETE https://api.damedoklad.cz/v1/eet/certificate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/certificate', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/eet/certificate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Renew a cash register certificate now through CA EET. Refused unless the operator has turned automatic renewal on

POST/v1/eet/certificate/renew

Renew a cash register certificate now through CA EET. Refused unless the operator has turned automatic renewal on. The old certificate must still be valid. CA EET makes a new key and certificate, which replace the old ones here, encrypted. The sweep does this by itself from three weeks before the end.

Nástroj MCP: renew-eet-certificate

Tělo požadavku

mandateIdstring | null

ID of the mandate.

Odpověď · 200

mandateIdnull | stringpovinné

automaticAvailablebooleanpovinné

hasCertificatebooleanpovinné

environmentnull | stringpovinné

daysLeftinteger | nullpovinné

duebooleanpovinné

renewBeforeDaysintegerpovinné

expiredbooleanpovinné

lastnull | objectpovinné

object"eet_certificate_renewal"povinné

idstringpovinné

mandateIdnull | stringpovinné

environmentstringpovinné

statusstringpovinné

oldSerialnull | stringpovinné

newSerialnull | stringpovinné

attemptsintegerpovinné

errorCodenull | stringpovinné

errorMessagenull | stringpovinné

startedBystringpovinné

createdAtstringpovinnédate-time

finishedAtnull | stringpovinnédate-time

POST/v1/eet/certificate/renew

curl -X POST https://api.damedoklad.cz/v1/eet/certificate/renew \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mandateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/certificate/renew', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mandateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/certificate/renew",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "mandateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Whether a cash register certificate is due for renewal, whether that can happen by itself, and how the last try ended

GET/v1/eet/certificate/renewal

Whether a cash register certificate is due for renewal, whether that can happen by itself, and how the last try ended. Automatic renewal is the CA EET API (caeetapi_jwt.yml) and stays off until the operator sets EET_CA_RENEWAL_ENABLED. Without it a new certificate is issued in DIS+ and uploaded.

Nástroj MCP: get-eet-certificate-renewal

Parametry dotazu

mandateIdstring

ID of the mandate.

Odpověď · 200

mandateIdnull | stringpovinné

automaticAvailablebooleanpovinné

hasCertificatebooleanpovinné

environmentnull | stringpovinné

daysLeftinteger | nullpovinné

duebooleanpovinné

renewBeforeDaysintegerpovinné

expiredbooleanpovinné

lastnull | objectpovinné

object"eet_certificate_renewal"povinné

idstringpovinné

mandateIdnull | stringpovinné

environmentstringpovinné

statusstringpovinné

oldSerialnull | stringpovinné

newSerialnull | stringpovinné

attemptsintegerpovinné

errorCodenull | stringpovinné

errorMessagenull | stringpovinné

startedBystringpovinné

createdAtstringpovinnédate-time

finishedAtnull | stringpovinnédate-time

GET/v1/eet/certificate/renewal

curl https://api.damedoklad.cz/v1/eet/certificate/renewal \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/certificate/renewal', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/certificate/renewal",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a till device (pokladní zařízení) under a recording unit, optionally tied to one POS register or one cash register

POST/v1/eet/devices

Add a till device (pokladní zařízení) under a recording unit, optionally tied to one POS register or one cash register

Nástroj MCP: create-eet-device

Tělo požadavku

mandateIdstring | null

ID of the mandate.

unitIdstringpovinné

ID of the unit.

deviceCodestringpovinné

namestring | null

posRegisterIdstring | null

ID of the pos register. Find it with list-pos-registers.

cashRegisterIdstring | null

ID of the cash register. Find it with list-cash-registers.

isDefaultboolean

Odpověď · 201

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

POST/v1/eet/devices

curl -X POST https://api.damedoklad.cz/v1/eet/devices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "deviceCode": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/devices', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "deviceCode": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/devices",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "deviceCode": "string"
    },
)
data = response.json()

Change a till device. The default device cannot be switched off while the company records sales

PATCH/v1/eet/devices/{id}

Change a till device. The default device cannot be switched off while the company records sales

Nástroj MCP: update-eet-device

Parametry v cestě

idstringpovinné

Tělo požadavku

unitIdstring

ID of the unit.

deviceCodestring

namestring | null

posRegisterIdstring | null

ID of the pos register. Find it with list-pos-registers.

cashRegisterIdstring | null

ID of the cash register. Find it with list-cash-registers.

mandateIdstring | null

ID of the mandate.

isDefaultboolean

isActiveboolean

Odpověď · 200

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

PATCH/v1/eet/devices/{id}

curl -X PATCH https://api.damedoklad.cz/v1/eet/devices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "deviceCode": "string",
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/devices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "deviceCode": "string",
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/eet/devices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "unitId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "deviceCode": "string",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Representations and authorisations for EET: for whom this company records sales

GET/v1/eet/mandates

Representations and authorisations for EET: for whom this company records sales

Nástroj MCP: list-eet-mandates

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"eet_mandate"povinné

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/eet/mandates

curl https://api.damedoklad.cz/v1/eet/mandates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/mandates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/mandates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a representation or authorisation: direct (přímé zastoupení), indirect (nepřímé, § 9), authorised (pověření jedním, § 10) or authorised_many (pověření více poplatníky)

POST/v1/eet/mandates

Add a representation or authorisation: direct (přímé zastoupení), indirect (nepřímé, § 9), authorised (pověření jedním, § 10) or authorised_many (pověření více poplatníky). direct: the message is the principal's, with their EIČ and unit, signed with the certificate they gave you. indirect: your own message of the whole amount, with no principal in it. authorised: your EIČ, unit and certificate, with the principal in eic_poverujiciho. authorised_many: yours, with povereni_vice_popl; the principal's EIČ is optional and recommended when you are not one of the owners.

Nástroj MCP: create-eet-mandate

Tělo požadavku

kind"direct" | "indirect" | "authorised" | "authorised_many"povinné

namestringpovinnémax 160 chars

principalEicstring | null

referencestring | null

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

POST/v1/eet/mandates

curl -X POST https://api.damedoklad.cz/v1/eet/mandates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "direct",
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/mandates', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "direct",
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/mandates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "direct",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Change a representation or authorisation. Sales already recorded keep what they said

PATCH/v1/eet/mandates/{id}

Change a representation or authorisation. Sales already recorded keep what they said

Nástroj MCP: update-eet-mandate

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 160 chars

principalEicstring | null

referencestring | null

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

isActiveboolean

notestring | null

Odpověď · 200

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

PATCH/v1/eet/mandates/{id}

curl -X PATCH https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "principalEic": "string",
  "reference": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "principalEic": "string",
    "reference": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "principalEic": "string",
        "reference": "string"
    },
)
data = response.json()

Remove a representation that nothing has used. One with recorded sales is switched off instead

DELETE/v1/eet/mandates/{id}

Remove a representation that nothing has used. One with recorded sales is switched off instead

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-eet-mandate

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/eet/mandates/{id}

curl -X DELETE https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Upload the .p12 the principal gave you for direct representation. It is stored encrypted and the private key never comes back

POST/v1/eet/mandates/{id}/certificate

Upload the .p12 the principal gave you for direct representation. It is stored encrypted and the private key never comes back. Only for direct representation (popis položek situace 2). Under indirect representation and authorisation you sign with your own certificate.

Nástroj MCP: upload-eet-mandate-certificate

Parametry v cestě

idstringpovinné

Tělo požadavku

certificateBase64stringpovinnémin 16 charsmax 64000 chars

File content encoded as base64.

passwordstringpovinnémax 200 chars

Odpověď · 201

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

POST/v1/eet/mandates/{id}/certificate

curl -X POST https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "certificateBase64": "string",
  "password": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "certificateBase64": "string",
    "password": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/mandates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "certificateBase64": "string",
        "password": "string"
    },
)
data = response.json()

Recorded sales with their send status. open=true lists only what still waits or failed

GET/v1/eet/records

Recorded sales with their send status. open=true lists only what still waits or failed

Nástroj MCP: list-eet-records

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

open"true" | "false"

Odpověď · 200

dataobject[]povinné

object"eet_record"povinné

idstringpovinné

sourceKindstringpovinné

sourceIdstringpovinné

sourceEventstringpovinné

documentNumbernull | stringpovinné

modestringpovinné

statusstringpovinné

unitNumberintegerpovinné

deviceCodestringpovinné

sequenceNumberstringpovinné

soldAtstringpovinnédate-time

soldOnstringpovinnédate

timeAssumedbooleanpovinné

amountHalerintegerpovinné

prepaidLoadHalerintegerpovinné

prepaidUseHalerintegerpovinné

responseSignaturenull | stringpovinné

attemptsintegerpovinné

lastAttemptAtnull | stringpovinnédate-time

nextAttemptAtnull | stringpovinnédate-time

deadlineAtstringpovinnédate-time

overDeadlinebooleanpovinné

confirmationCodenull | stringpovinné

receivedAtnull | stringpovinnédate-time

isLatebooleanpovinné

warningsobject[]povinné

codeinteger | nullpovinné

messagenull | stringpovinné

errorCodenull | stringpovinné

errorMessagenull | stringpovinné

transactionIdnull | stringpovinné

excludedReasonnull | stringpovinné

mandateIdnull | string

mandateKindnull | string

forManyTaxpayersboolean

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/eet/records

curl https://api.damedoklad.cz/v1/eet/records \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/records', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/records",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Take a sale that was never confirmed out of the queue, with a reason, because the law does not require recording it

POST/v1/eet/records/{id}/exclude

Take a sale that was never confirmed out of the queue, with a reason, because the law does not require recording it. For exceptions like a one-off income (§ 7) or a § 11 to § 13 exemption. The decision stays with the company; a confirmed sale is corrected by a negative one instead (§ 8).

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: exclude-eet-record

Parametry v cestě

idstringpovinné

Tělo požadavku

reasonstringpovinnémin 3 charsmax 300 chars

Odpověď · 200

idstringpovinné

sourceKindstringpovinné

sourceIdstringpovinné

sourceEventstringpovinné

documentNumbernull | stringpovinné

modestringpovinné

statusstringpovinné

unitNumberintegerpovinné

deviceCodestringpovinné

sequenceNumberstringpovinné

soldAtstringpovinnédate-time

soldOnstringpovinnédate

timeAssumedbooleanpovinné

amountHalerintegerpovinné

prepaidLoadHalerintegerpovinné

prepaidUseHalerintegerpovinné

responseSignaturenull | stringpovinné

attemptsintegerpovinné

lastAttemptAtnull | stringpovinnédate-time

nextAttemptAtnull | stringpovinnédate-time

deadlineAtstringpovinnédate-time

overDeadlinebooleanpovinné

confirmationCodenull | stringpovinné

receivedAtnull | stringpovinnédate-time

isLatebooleanpovinné

warningsobject[]povinné

codeinteger | nullpovinné

messagenull | stringpovinné

errorCodenull | stringpovinné

errorMessagenull | stringpovinné

transactionIdnull | stringpovinné

excludedReasonnull | stringpovinné

mandateIdnull | string

mandateKindnull | string

forManyTaxpayersboolean

POST/v1/eet/records/{id}/exclude

curl -X POST https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/exclude \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/exclude', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "reason": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/exclude",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "reason": "string"
    },
)
data = response.json()

Send a recorded sale again now. Repeats the same data with a new message id, marked as not the first attempt

POST/v1/eet/records/{id}/retry

Send a recorded sale again now. Repeats the same data with a new message id, marked as not the first attempt

Nástroj MCP: retry-eet-record

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

sourceKindstringpovinné

sourceIdstringpovinné

sourceEventstringpovinné

documentNumbernull | stringpovinné

modestringpovinné

statusstringpovinné

unitNumberintegerpovinné

deviceCodestringpovinné

sequenceNumberstringpovinné

soldAtstringpovinnédate-time

soldOnstringpovinnédate

timeAssumedbooleanpovinné

amountHalerintegerpovinné

prepaidLoadHalerintegerpovinné

prepaidUseHalerintegerpovinné

responseSignaturenull | stringpovinné

attemptsintegerpovinné

lastAttemptAtnull | stringpovinnédate-time

nextAttemptAtnull | stringpovinnédate-time

deadlineAtstringpovinnédate-time

overDeadlinebooleanpovinné

confirmationCodenull | stringpovinné

receivedAtnull | stringpovinnédate-time

isLatebooleanpovinné

warningsobject[]povinné

codeinteger | nullpovinné

messagenull | stringpovinné

errorCodenull | stringpovinné

errorMessagenull | stringpovinné

transactionIdnull | stringpovinné

excludedReasonnull | stringpovinné

mandateIdnull | string

mandateKindnull | string

forManyTaxpayersboolean

POST/v1/eet/records/{id}/retry

curl -X POST https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/retry \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/retry', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/retry",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Put every waiting or refused sale back in the queue

POST/v1/eet/records/retry

Put every waiting or refused sale back in the queue

Nástroj MCP: retry-eet-records

Odpověď · 200

queuedintegerpovinné

POST/v1/eet/records/retry

curl -X POST https://api.damedoklad.cz/v1/eet/records/retry \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/records/retry', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/records/retry",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

EET 2.0 settings: on or off, mode, EIČ, recording units, till devices, and the certificate. The private key is never returned

GET/v1/eet/settings

EET 2.0 settings: on or off, mode, EIČ, recording units, till devices, and the certificate. The private key is never returned

Nástroj MCP: get-eet-settings

Odpověď · 200

enabledbooleanpovinné

modestringpovinné

liveAvailablebooleanpovinné

eicnull | stringpovinné

suggestedEicnull | stringpovinné

responseTimeoutSecondsintegerpovinné

certificatenull | objectpovinné

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

unitsobject[]povinné

object"eet_unit"povinné

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

devicesobject[]povinné

object"eet_device"povinné

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

mandatesobject[]

object"eet_mandate"povinné

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

GET/v1/eet/settings

curl https://api.damedoklad.cz/v1/eet/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/settings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Turn EET 2.0 on or off, or change EIČ and the response limit. Live mode is refused unless the operator has enabled it

PATCH/v1/eet/settings

Turn EET 2.0 on or off, or change EIČ and the response limit. Live mode is refused unless the operator has enabled it. Turning it on needs a default device. Test mode sends to the official playground with the shared test certificate and fulfils no duty. § 19: the response limit is at least 2 seconds.

Nástroj MCP: update-eet-settings

Tělo požadavku

enabledboolean

mode"test" | "live"

eicstring | null

responseTimeoutSecondsintegermin 2max 60

Odpověď · 200

enabledbooleanpovinné

modestringpovinné

liveAvailablebooleanpovinné

eicnull | stringpovinné

suggestedEicnull | stringpovinné

responseTimeoutSecondsintegerpovinné

certificatenull | objectpovinné

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

unitsobject[]povinné

object"eet_unit"povinné

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

devicesobject[]povinné

object"eet_device"povinné

idstringpovinné

unitIdstringpovinné

deviceCodestringpovinné

namenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

isActivebooleanpovinné

mandateIdnull | string

mandatesobject[]

object"eet_mandate"povinné

idstringpovinné

kindstringpovinné

namestringpovinné

isActivebooleanpovinné

validFromstring | nullpovinné

validTonull | stringpovinnédate

principalEicnull | string

referencenull | string

notestring | null

certificatenull | object

subjectnull | stringpovinné

serialstringpovinné

notBeforestringpovinnédate-time

notAfterstringpovinnédate-time

daysLeftintegerpovinné

environmentstringpovinné

PATCH/v1/eet/settings

curl -X PATCH https://api.damedoklad.cz/v1/eet/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": false,
  "mode": "test",
  "eic": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/settings', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "enabled": false,
    "mode": "test",
    "eic": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/eet/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "enabled": False,
        "mode": "test",
        "eic": "string"
    },
)
data = response.json()

Whether this company records sales under EET 2.0, how many records wait or failed, and the till devices whose representation or authorisation ends within 14 days or is no longer in force, where a sale must be confirmed as the company's own (eetOwnSale)

GET/v1/eet/summary

Whether this company records sales under EET 2.0, how many records wait or failed, and the till devices whose representation or authorisation ends within 14 days or is no longer in force, where a sale must be confirmed as the company's own (eetOwnSale)

Nástroj MCP: get-eet-summary

Odpověď · 200

enabledbooleanpovinné

modenull | stringpovinné

pendingintegerpovinné

rejectedintegerpovinné

needsSetupintegerpovinné

overDeadlineintegerpovinné

mandateWarningsobject[]

deviceIdstringpovinné

deviceCodenull | stringpovinné

posRegisterIdnull | stringpovinné

cashRegisterIdnull | stringpovinné

isDefaultbooleanpovinné

mandateIdnull | stringpovinné

mandateNamestringpovinné

validTonull | stringpovinné

daysLeftinteger | nullpovinné

expiredbooleanpovinné

registersWithDevicestring[]

GET/v1/eet/summary

curl https://api.damedoklad.cz/v1/eet/summary \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/summary', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/summary",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Send one verification message to the official EET playground. Records nothing and uses the shared test certificate

POST/v1/eet/test-connection

Send one verification message to the official EET playground. Records nothing and uses the shared test certificate

Nástroj MCP: test-eet-connection

Odpověď · 200

okbooleanpovinné

codenull | stringpovinné

messagenull | stringpovinné

warningsany[]povinné

elapsedMsintegerpovinné

transactionIdnull | stringpovinné

POST/v1/eet/test-connection

curl -X POST https://api.damedoklad.cz/v1/eet/test-connection \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/test-connection', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/test-connection",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a recording unit with the number DIS+ assigned to it (evidenční jednotka, § 3 and § 15)

POST/v1/eet/units

Add a recording unit with the number DIS+ assigned to it (evidenční jednotka, § 3 and § 15)

Nástroj MCP: create-eet-unit

Tělo požadavku

namestringpovinnémax 120 chars

unitNumberintegerpovinnémin 1max 999999999

indirectRepresentationboolean

Odpověď · 201

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

POST/v1/eet/units

curl -X POST https://api.damedoklad.cz/v1/eet/units \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "unitNumber": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/units', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "unitNumber": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/units",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "unitNumber": 1
    },
)
data = response.json()

Change a recording unit. Sales already recorded keep the number they had

PATCH/v1/eet/units/{id}

Change a recording unit. Sales already recorded keep the number they had

Nástroj MCP: update-eet-unit

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

unitNumberintegermin 1max 999999999

isActiveboolean

indirectRepresentationboolean

Odpověď · 200

idstringpovinné

namestringpovinné

unitNumberintegerpovinné

isActivebooleanpovinné

numberLooksAssignedbooleanpovinné

indirectRepresentationboolean

PATCH/v1/eet/units/{id}

curl -X PATCH https://api.damedoklad.cz/v1/eet/units/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "unitNumber": 1,
  "isActive": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/units/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "unitNumber": 1,
    "isActive": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/eet/units/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "unitNumber": 1,
        "isActive": False
    },
)
data = response.json()

The register of vouchers and prepaid credit, with their balances. `code` finds one exactly, `search` by code or holder

GET/v1/eet/vouchers

The register of vouchers and prepaid credit, with their balances. `code` finds one exactly, `search` by code or holder

Nástroj MCP: list-eet-vouchers

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

status"active" | "used" | "void"

kind"limited_network" | "specific_goods"

codestringmax 40 chars

Odpověď · 200

dataobject[]povinné

object"eet_voucher"povinné

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/eet/vouchers

curl https://api.damedoklad.cz/v1/eet/vouchers \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/vouchers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a voucher to the register: limited_network for credit or a voucher for goods not yet named, specific_goods for named goods or a service

POST/v1/eet/vouchers

Add a voucher to the register: limited_network for credit or a voucher for goods not yet named, specific_goods for named goods or a service. Popis položek kap. 1 bod 13 and Příklad 4. A limited_network voucher is loaded by a sale with eetVoucherId and eetPrepaidLoadHaler, and spent with eetPrepaidUseHaler. A specific_goods voucher is an ordinary sale when bought, and redeeming it records nothing. openingBalanceHaler is for what was sold before this register.

Nástroj MCP: create-eet-voucher

Tělo požadavku

codestringmin 3 charsmax 40 chars

kind"limited_network" | "specific_goods"povinné

openingBalanceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

descriptionstring | null

holderNamestring | null

contactIdstring | null

ID of the contact. Find it with list-contacts.

validUntilstring | null

notestring | null

Odpověď · 201

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

POST/v1/eet/vouchers

curl -X POST https://api.damedoklad.cz/v1/eet/vouchers \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "kind": "limited_network"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "kind": "limited_network"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/vouchers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "kind": "limited_network"
    },
)
data = response.json()

One voucher with all its movements

GET/v1/eet/vouchers/{id}

One voucher with all its movements

Nástroj MCP: get-eet-voucher

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

GET/v1/eet/vouchers/{id}

curl https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change the holder, validity, description or note of a voucher. Its balance moves only with sales and adjustments

PATCH/v1/eet/vouchers/{id}

Change the holder, validity, description or note of a voucher. Its balance moves only with sales and adjustments

Nástroj MCP: update-eet-voucher

Parametry v cestě

idstringpovinné

Tělo požadavku

descriptionstring | null

holderNamestring | null

contactIdstring | null

ID of the contact. Find it with list-contacts.

validUntilstring | null

notestring | null

Odpověď · 200

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

PATCH/v1/eet/vouchers/{id}

curl -X PATCH https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Pečivo, říjen",
  "holderName": "Pekárna U Lípy s.r.o.",
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "Pečivo, říjen",
    "holderName": "Pekárna U Lípy s.r.o.",
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "description": "Pečivo, říjen",
        "holderName": "Pekárna U Lípy s.r.o.",
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Correct a voucher balance by hand, with a reason. Moves no money and records nothing in EET

POST/v1/eet/vouchers/{id}/adjust

Correct a voucher balance by hand, with a reason. Moves no money and records nothing in EET

Nástroj MCP: adjust-eet-voucher

Parametry v cestě

idstringpovinné

Tělo požadavku

amountHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

reasonstringpovinnémin 3 charsmax 300 chars

Odpověď · 200

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

POST/v1/eet/vouchers/{id}/adjust

curl -X POST https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/adjust \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "reason": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/adjust', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amountHaler": 1210000,
    "reason": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/adjust",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "amountHaler": 1210000,
        "reason": "string"
    },
)
data = response.json()

Mark a voucher for named goods as redeemed. No payment happens, so nothing is recorded in EET (popis položek, Příklad 4)

POST/v1/eet/vouchers/{id}/redeem

Mark a voucher for named goods as redeemed. No payment happens, so nothing is recorded in EET (popis položek, Příklad 4)

Nástroj MCP: redeem-eet-voucher

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

POST/v1/eet/vouchers/{id}/redeem

curl -X POST https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/redeem \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/redeem', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/redeem",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "note": "string"
    },
)
data = response.json()

Cancel a voucher, with a reason. What is left on it stops being spendable. Any money back is a separate return

POST/v1/eet/vouchers/{id}/void

Cancel a voucher, with a reason. What is left on it stops being spendable. Any money back is a separate return

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: void-eet-voucher

Parametry v cestě

idstringpovinné

Tělo požadavku

reasonstringpovinnémin 3 charsmax 300 chars

Odpověď · 200

idstringpovinné

codestringpovinné

kindstringpovinné

statusstringpovinné

balanceHalerintegerpovinné

valueHalerintegerpovinné

descriptionnull | stringpovinné

holderNamenull | stringpovinné

contactIdstring | nullpovinné

validUntilnull | stringpovinnédate

expiredbooleanpovinné

notestring | nullpovinné

voidReasonnull | stringpovinné

createdAtstringpovinnédate-time

movementsobject[]

object"eet_voucher_movement"povinné

idstringpovinné

kindstringpovinné

amountHalerintegerpovinné

balanceAfterHalerintegerpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

documentNumbernull | stringpovinné

occurredOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

POST/v1/eet/vouchers/{id}/void

curl -X POST https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/void \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/void', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "reason": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/eet/vouchers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/void",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "reason": "string"
    },
)
data = response.json()

Sign a short statement that this dashboard origin may pair with a local bridge. The bridge checks it against the Origin of the request and still asks for the code it shows

POST/v1/pos/bridge/grants

Sign a short statement that this dashboard origin may pair with a local bridge. The bridge checks it against the Origin of the request and still asks for the code it shows

Nástroj MCP: create-pos-bridge-grant

Tělo požadavku

originstringpovinnémax 200 charsuri

Odpověď · 200

grantstringpovinné

expiresAtstringpovinnédate-time

POST/v1/pos/bridge/grants

curl -X POST https://api.damedoklad.cz/v1/pos/bridge/grants \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "origin": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/bridge/grants', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "origin": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/pos/bridge/grants",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "origin": "string"
    },
)
data = response.json()

The public key the local bridge checks a pairing grant with, for its install command

GET/v1/pos/bridge/key

The public key the local bridge checks a pairing grant with, for its install command

Nástroj MCP: get-pos-bridge-key

Odpověď · 200

algorithmstringpovinné

publicKeystringpovinné

GET/v1/pos/bridge/key

curl https://api.damedoklad.cz/v1/pos/bridge/key \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/bridge/key', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/bridge/key",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

A day closure as an 80 mm slip

GET/v1/pos/closures/{id}/pdf

A day closure as an 80 mm slip

Nástroj MCP: get-pos-closure-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/pos/closures/{id}/pdf

curl https://api.damedoklad.cz/v1/pos/closures/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/pos/closures/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/closures/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Documents from a till without a connection that the server refused, and notices about what changed meanwhile. open=true lists what waits for a person

GET/v1/pos/offline-conflicts

Documents from a till without a connection that the server refused, and notices about what changed meanwhile. open=true lists what waits for a person

Nástroj MCP: list-pos-offline-conflicts

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

open"true" | "false"

Odpověď · 200

dataobject[]povinné

object"pos_offline_conflict"povinné

idstringpovinné

clientIdstringpovinné

documentKindstringpovinné

severitystringpovinné

offlineNumbernull | stringpovinné

happenedAtstringpovinnédate-time

totalHalerinteger | nullpovinné

codenull | stringpovinné

messagestringpovinné

detailsobjectpovinné

itemsobject[]

namenull | stringpovinné

itemIdnull | stringpovinné

soldHalerintegerpovinné

currentHalerintegerpovinné

deviceCodestring | nullpovinné

statusstringpovinné

resolvedNotenull | stringpovinné

resolvedAtnull | stringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/pos/offline-conflicts

curl https://api.damedoklad.cz/v1/pos/offline-conflicts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/offline-conflicts', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/offline-conflicts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

A till says the server refused a document it holds. Reporting the same one again updates it, so everyone can see what waits. The document itself stays on the device

POST/v1/pos/offline-conflicts

A till says the server refused a document it holds. Reporting the same one again updates it, so everyone can see what waits. The document itself stays on the device

Nástroj MCP: report-pos-offline-conflict

Tělo požadavku

clientIdstringpovinnémin 8 charsmax 64 chars

ID of the client.

documentKind"sale" | "return" | "invoice" | "order" | "closure"povinné

severity"refused" | "notice"

offlineNumberstring | null

happenedAtstringpovinnédate-time

totalHalerinteger | null

Integer amount in haléře: 100 = 1 Kč.

codestring | null

messagestringpovinnémax 600 chars

detailsobject

deviceCodestring | null

Odpověď · 201

idstringpovinné

clientIdstringpovinné

documentKindstringpovinné

severitystringpovinné

offlineNumbernull | stringpovinné

happenedAtstringpovinnédate-time

totalHalerinteger | nullpovinné

codenull | stringpovinné

messagestringpovinné

detailsobjectpovinné

itemsobject[]

namenull | stringpovinné

itemIdnull | stringpovinné

soldHalerintegerpovinné

currentHalerintegerpovinné

deviceCodestring | nullpovinné

statusstringpovinné

resolvedNotenull | stringpovinné

resolvedAtnull | stringpovinnédate-time

POST/v1/pos/offline-conflicts

curl -X POST https://api.damedoklad.cz/v1/pos/offline-conflicts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "clientId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "documentKind": "sale",
  "happenedAt": "2026-10-30",
  "message": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/offline-conflicts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "clientId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "documentKind": "sale",
    "happenedAt": "2026-10-30",
    "message": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/pos/offline-conflicts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "clientId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "documentKind": "sale",
        "happenedAt": "2026-10-30",
        "message": "string"
    },
)
data = response.json()

Close a conflict: acknowledged for a notice, discarded when a person decided the document will not be sent, with a note

POST/v1/pos/offline-conflicts/{id}/resolve

Close a conflict: acknowledged for a notice, discarded when a person decided the document will not be sent, with a note. Discarding here closes the report. If the sale really happened, the money and goods have still moved, so whoever discards should say why. A document sent successfully closes its own conflict.

Nástroj MCP: resolve-pos-offline-conflict

Parametry v cestě

idstringpovinné

Tělo požadavku

status"sent" | "discarded" | "acknowledged"povinné

notestring | null

Odpověď · 200

idstringpovinné

clientIdstringpovinné

documentKindstringpovinné

severitystringpovinné

offlineNumbernull | stringpovinné

happenedAtstringpovinnédate-time

totalHalerinteger | nullpovinné

codenull | stringpovinné

messagestringpovinné

detailsobjectpovinné

itemsobject[]

namenull | stringpovinné

itemIdnull | stringpovinné

soldHalerintegerpovinné

currentHalerintegerpovinné

deviceCodestring | nullpovinné

statusstringpovinné

resolvedNotenull | stringpovinné

resolvedAtnull | stringpovinnédate-time

POST/v1/pos/offline-conflicts/{id}/resolve

curl -X POST https://api.damedoklad.cz/v1/pos/offline-conflicts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/resolve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "sent"
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/offline-conflicts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/resolve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "status": "sent"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/pos/offline-conflicts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/resolve",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "status": "sent"
    },
)
data = response.json()

What a till keeps on its device to work without a connection: customers, price lists, serial numbers in stock, kits, the last 30 days of receipts, and where each drawer stands

GET/v1/pos/offline-pack

What a till keeps on its device to work without a connection: customers, price lists, serial numbers in stock, kits, the last 30 days of receipts, and where each drawer stands. A contact with restricted processing is left out. The lists are capped, and truncated says so. The dashboard clears all of it at logout.

Nástroj MCP: get-pos-offline-pack

Odpověď · 200

savedAtstringpovinnédate-time

customersobject[]povinné

idstringpovinné

namenull | stringpovinné

iconull | stringpovinné

dicstring | nullpovinné

usualDueDaysinteger | nullpovinné

preferredPaymentMethodstring | nullpovinné

addressstring | nullpovinné

groupIdsany[]povinné

truncatedbooleanpovinné

priceListsobject[]povinné

idstringpovinné

namenull | stringpovinné

isDefaultbooleanpovinné

discountBpintegerpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

pricesobject[]povinné

itemIdnull | stringpovinné

priceHalerintegerpovinné

minQtyMilliintegerpovinné

rulesobject[]povinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountBpintegerpovinné

serialsobject[]povinné

itemIdnull | stringpovinné

codenull | stringpovinné

warehouseIdnull | stringpovinné

kitsobjectpovinné

vouchersany[]povinné

receiptsobject[]povinné

idstringpovinné

clientSaleIdnull | stringpovinné

numbernull | stringpovinné

externalNumbernull | stringpovinné

soldAtnull | stringpovinnédate-time

registerIdnull | stringpovinné

paymentMethodstringpovinné

totalHalerinteger | nullpovinné

contactNamestring | nullpovinné

linesobject[]povinné

positioninteger | nullpovinné

descriptionnull | stringpovinné

quantityintegerpovinné

returnedQuantityintegerpovinné

unitnull | stringpovinné

unitPriceHalerinteger | nullpovinné

vatRateintegerpovinné

itemIdstring | nullpovinné

serialsany[]povinné

closuresobjectpovinné

denominationsHalerinteger[]povinné

todaystringpovinnédate

GET/v1/pos/offline-pack

curl https://api.damedoklad.cz/v1/pos/offline-pack \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/offline-pack', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/offline-pack",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

A sales receipt sized for an 80 mm thermal printer

GET/v1/pos/receipts/{id}/pdf

A sales receipt sized for an 80 mm thermal printer

Nástroj MCP: get-pos-receipt-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/pos/receipts/{id}/pdf

curl https://api.damedoklad.cz/v1/pos/receipts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/pos/receipts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/receipts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List the cash registers of the till. A company with none gets its first one here

GET/v1/pos/registers

List the cash registers of the till. A company with none gets its first one here

Nástroj MCP: list-pos-registers

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"pos_register"povinné

idstringpovinné

namestringpovinné

codestringpovinné

warehouseIdnull | stringpovinné

openingFloatHalerintegerpovinné

isActivebooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/pos/registers

curl https://api.damedoklad.cz/v1/pos/registers \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/registers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a cash register, with its own warehouse, quick keys, and day closures

POST/v1/pos/registers

Add a cash register, with its own warehouse, quick keys, and day closures

Nástroj MCP: create-pos-register

Tělo požadavku

namestringpovinnémax 120 chars

codestringpovinnémax 16 chars

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

openingFloatHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

isActiveboolean

Odpověď · 201

idstringpovinné

namestringpovinné

codestringpovinné

warehouseIdnull | stringpovinné

openingFloatHalerintegerpovinné

isActivebooleanpovinné

POST/v1/pos/registers

curl -X POST https://api.damedoklad.cz/v1/pos/registers \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/pos/registers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string"
    },
)
data = response.json()

Change a cash register. The starting float only applies until its first closure

PATCH/v1/pos/registers/{id}

Change a cash register. The starting float only applies until its first closure

Nástroj MCP: update-pos-register

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

codestringmax 16 chars

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

openingFloatHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

isActiveboolean

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

warehouseIdnull | stringpovinné

openingFloatHalerintegerpovinné

isActivebooleanpovinné

PATCH/v1/pos/registers/{id}

curl -X PATCH https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string",
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string",
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string",
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

What the drawer should hold now: opening float, cash in and out since the last closure, card total

GET/v1/pos/registers/{id}/closure-preview

What the drawer should hold now: opening float, cash in and out since the last closure, card total

Nástroj MCP: get-pos-closure-preview

Parametry v cestě

idstringpovinné

Odpověď · 200

registerIdnull | stringpovinné

openingCashHalerintegerpovinné

cashSalesHalerintegerpovinné

cashReturnsHalerintegerpovinné

cardTotalHalerintegerpovinné

expectedCashHalerintegerpovinné

receiptCountintegerpovinné

denominationsHalerinteger[]povinné

GET/v1/pos/registers/{id}/closure-preview

curl https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closure-preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closure-preview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closure-preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Past day closures of a cash register

GET/v1/pos/registers/{id}/closures

Past day closures of a cash register

Nástroj MCP: list-pos-closures

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

dataobject[]povinné

object"pos_closure"povinné

idstringpovinné

registerIdstringpovinné

numberstringpovinné

datestringpovinnédate

openingCashHalerintegerpovinné

cashSalesHalerintegerpovinné

cashReturnsHalerintegerpovinné

cardTotalHalerintegerpovinné

receiptCountintegerpovinné

expectedCashHalerintegerpovinné

countedCashHalerintegerpovinné

differenceHalerintegerpovinné

withdrawnHalerintegerpovinné

closingFloatHalerintegerpovinné

denominationsobject[]povinné

valueHalerinteger | nullpovinné

countintegerpovinné

notestring | nullpovinné

offlineNumbernull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/pos/registers/{id}/closures

curl https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Close the till for the day: count the cash, post any difference, and start the next day from what stays in the drawer

POST/v1/pos/registers/{id}/closures

Close the till for the day: count the cash, post any difference, and start the next day from what stays in the drawer. Schodek posts MD 569 / D 211, přebytek MD 211 / D 668, cash taken out MD 261 / D 211. In daňová evidence the difference goes to the peněžní deník; a shortage is not deductible (§ 25 odst. 1 písm. n) ZDP). Send expectedCashHaler from the preview to be stopped if a sale happened since.

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: create-pos-closure

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

countedCashHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

denominationsobject[]

valueHalerintegerpovinnémax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

countintegerpovinnémin 0max 9007199254740991

withdrawnHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

expectedCashHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

notestring | null

clientClosureIdstringmin 8 charsmax 64 chars

ID of the client closure.

offlineobject

soldAtstringpovinnédate-time

numberstringpovinnémax 40 chars

listPricesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

quantitynumberpovinné

Odpověď · 201

idstringpovinné

registerIdstringpovinné

numberstringpovinné

datestringpovinnédate

openingCashHalerintegerpovinné

cashSalesHalerintegerpovinné

cashReturnsHalerintegerpovinné

cardTotalHalerintegerpovinné

receiptCountintegerpovinné

expectedCashHalerintegerpovinné

countedCashHalerintegerpovinné

differenceHalerintegerpovinné

withdrawnHalerintegerpovinné

closingFloatHalerintegerpovinné

denominationsobject[]povinné

valueHalerinteger | nullpovinné

countintegerpovinné

notestring | nullpovinné

offlineNumbernull | string

POST/v1/pos/registers/{id}/closures

curl -X POST https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "countedCashHaler": 1210000,
  "denominations": [
    {
      "valueHaler": 1210000,
      "count": 0
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "countedCashHaler": 1210000,
    "denominations": [
      {
        "valueHaler": 1210000,
        "count": 0
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/closures",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "countedCashHaler": 1210000,
        "denominations": [
            {
                "valueHaler": 1210000,
                "count": 0
            }
        ]
    },
)
data = response.json()

What the local bridge should drive for this till: printer, customer display, scale and payment terminal. Nothing here reaches a device by itself

GET/v1/pos/registers/{id}/hardware

What the local bridge should drive for this till: printer, customer display, scale and payment terminal. Nothing here reaches a device by itself

Nástroj MCP: get-pos-hardware

Parametry v cestě

idstringpovinné

Odpověď · 200

registerIdstringpovinné

devicesobjectpovinné

printerobject

protocolstringpovinné

connectionobjectpovinné

hostnull | stringpovinné

portinteger | nullpovinné

typestringpovinné

terminalobject

protocolstringpovinné

connectionobjectpovinné

hostnull | stringpovinné

portinteger | nullpovinné

typestringpovinné

currencyCodestringpovinné

updatedAtnull | stringpovinnédate-time

GET/v1/pos/registers/{id}/hardware

curl https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save the hardware profile of a till. Only open protocols: ESC/POS, CD5220, MT-SICS, NCI and ZVT. None has met a real device

PUT/v1/pos/registers/{id}/hardware

Save the hardware profile of a till. Only open protocols: ESC/POS, CD5220, MT-SICS, NCI and ZVT. None has met a real device

Nástroj MCP: put-pos-hardware

Parametry v cestě

idstringpovinné

Tělo požadavku

printerobject | null

protocol"escpos"povinné

connectionobjectpovinné

type"tcp"povinné

hoststringpovinnémax 120 chars

portintegerpovinnémin 1max 65535

tlsboolean

enabledboolean

columnsintegermin 20max 64

diacriticsboolean

drawerboolean

displayobject | null

protocol"cd5220" | "escpos"povinné

connectionobjectpovinné

type"tcp"povinné

hoststringpovinnémax 120 chars

portintegerpovinnémin 1max 65535

tlsboolean

enabledboolean

columnsintegermin 10max 40

scaleobject | null

protocol"mt-sics" | "nci"povinné

connectionobjectpovinné

type"tcp"povinné

hoststringpovinnémax 120 chars

portintegerpovinnémin 1max 65535

tlsboolean

enabledboolean

terminalobject | null

protocol"zvt" | "gpe" | "comgate" | "dotypay"povinné

connectionobjectpovinné

type"tcp"povinné

hoststringpovinnémax 120 chars

portintegerpovinnémin 1max 65535

tlsboolean

enabledboolean

currencyCodestring

timeoutSecondsintegermin 10max 300

ecrIdstring | ""

ID of the ecr.

poiIdstringmax 40 chars

ID of the poi.

saleIdstringmax 40 chars

ID of the sale.

Odpověď · 200

registerIdstringpovinné

devicesobjectpovinné

printerobject

protocolstringpovinné

connectionobjectpovinné

hostnull | stringpovinné

portinteger | nullpovinné

typestringpovinné

terminalobject

protocolstringpovinné

connectionobjectpovinné

hostnull | stringpovinné

portinteger | nullpovinné

typestringpovinné

currencyCodestringpovinné

updatedAtnull | stringpovinnédate-time

PUT/v1/pos/registers/{id}/hardware

curl -X PUT https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "printer": {
    "protocol": "escpos",
    "connection": {
      "type": "tcp",
      "host": "string",
      "port": 1
    }
  },
  "display": {
    "protocol": "cd5220",
    "connection": {
      "type": "tcp",
      "host": "string",
      "port": 1
    }
  },
  "scale": {
    "protocol": "mt-sics",
    "connection": {
      "type": "tcp",
      "host": "string",
      "port": 1
    }
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "printer": {
      "protocol": "escpos",
      "connection": {
        "type": "tcp",
        "host": "string",
        "port": 1
      }
    },
    "display": {
      "protocol": "cd5220",
      "connection": {
        "type": "tcp",
        "host": "string",
        "port": 1
      }
    },
    "scale": {
      "protocol": "mt-sics",
      "connection": {
        "type": "tcp",
        "host": "string",
        "port": 1
      }
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/hardware",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "printer": {
            "protocol": "escpos",
            "connection": {
                "type": "tcp",
                "host": "string",
                "port": 1
            }
        },
        "display": {
            "protocol": "cd5220",
            "connection": {
                "type": "tcp",
                "host": "string",
                "port": 1
            }
        },
        "scale": {
            "protocol": "mt-sics",
            "connection": {
                "type": "tcp",
                "host": "string",
                "port": 1
            }
        }
    },
)
data = response.json()

The favourite items on the quick keys of a cash register

GET/v1/pos/registers/{id}/quick-keys

The favourite items on the quick keys of a cash register

Nástroj MCP: get-pos-quick-keys

Parametry v cestě

idstringpovinné

Odpověď · 200

registerIdstringpovinné

dataobject[]povinné

object"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

GET/v1/pos/registers/{id}/quick-keys

curl https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the favourite items on the quick keys of a cash register, in order

PUT/v1/pos/registers/{id}/quick-keys

Set the favourite items on the quick keys of a cash register, in order

Nástroj MCP: put-pos-quick-keys

Parametry v cestě

idstringpovinné

Tělo požadavku

itemIdsstring[]povinné

Odpověď · 200

registerIdstringpovinné

dataobject[]povinné

object"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

PUT/v1/pos/registers/{id}/quick-keys

curl -X PUT https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemIds": [
    "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemIds": [
      "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/pos/registers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/quick-keys",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemIds": [
            "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Numbers missing from a till device's own series (OFF-XXXX-NNNNNN) a day after a later number arrived: documents that may be on a lost or broken device. Enter such a sale afterwards from the receipt copy with POST /sales/pos-sales and offline.number set to the missing number

GET/v1/pos/series-gaps

Numbers missing from a till device's own series (OFF-XXXX-NNNNNN) a day after a later number arrived: documents that may be on a lost or broken device. Enter such a sale afterwards from the receipt copy with POST /sales/pos-sales and offline.number set to the missing number

Nástroj MCP: list-pos-series-gaps

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"pos_series_gap"povinné

deviceCodenull | stringpovinné

countintegerpovinné

firstMissingstringpovinné

lastMissingstringpovinné

missingstring[]povinné

afternull | objectpovinné

numbernull | stringpovinné

soldAtnull | stringpovinnédate-time

beforenull | objectpovinné

numbernull | stringpovinné

soldAtnull | stringpovinnédate-time

arrivedAtstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/pos/series-gaps

curl https://api.damedoklad.cz/v1/pos/series-gaps \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/pos/series-gaps', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/pos/series-gaps",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Pay back all or part of a received advance. Whatever part was taxed gets a corrective tax document (§ 42 ZDPH); books and cash book are posted

POST/v1/proformas/{id}/refund

Pay back all or part of a received advance. Whatever part was taxed gets a corrective tax document (§ 42 ZDPH); books and cash book are posted. amountHaler defaults to everything paid. Refused once the advance has been settled into an invoice: correct that invoice with a credit note.

Nástroj MCP: refund-proforma

Parametry v cestě

idstringpovinné

Tělo požadavku

amountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

refundedOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

method"transfer" | "cash" | "card" | "other"

reasonstringpovinnémax 240 chars

notestring | null

registerIdstring

ID of the register.

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

moneyAmountHalerintegermax 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

allowNegativeboolean

Odpověď · 201

idstringpovinné

numbernull | stringpovinné

variableSymbolnull | stringpovinné

kindstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

totalHalerintegerpovinné

paidHalerintegerpovinné

statusstringpovinné

overduebooleanpovinné

fileIdnull | stringpovinné

customFieldsobject

vatModestring

exchangeRateinteger

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

seriesIdnull | string

currencystring

ourAccountNumbernull | string

ourBankCodenull | string

ourIbannull | string

paymentMethodstring

languagestring

notePublicstring | null

noteInternalstring | null

netHalerinteger

vatHalerinteger

contactIconull | string

contactDicnull | string

contactVatPayerTypenull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

shipToNamestring | null

shipToStreetstring | null

shipToCitystring | null

shipToPostalCodestring | null

shipToCountrystring | null

contactEmailnull | string

sellerNamenull | string

linesobject[]

object"proforma_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumberstring | nullpovinné

lineKindstringpovinné

sourceIdstring | nullpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

lotsany[]povinné

orderLineIdnull | stringpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

vatLinesobject[]

object"invoice_vat_line"povinné

idstringpovinné

vatRatenumberpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

paymentsobject[]

object"proforma_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

taxDocumentsobject[]

object"advance_tax_document"povinné

idstringpovinné

numbernull | stringpovinné

statusstringpovinné

issueDatenull | stringpovinnédate

netHalerintegerpovinné

vatHalerinteger | nullpovinné

totalHalerinteger | nullpovinné

invoiceIdnull | stringpovinné

postingobject

regimestringpovinné

eventstringpovinné

skippedboolean

journalLinesobject[]

accountnull | stringpovinné

sidestringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

balancedboolean

cashJournalobject[]

accountnull | stringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

receivablesBookany[]

payablesBookany[]

assetany[]

carrierIdstring | null

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

refundobject

amountHalerinteger | nullpovinné

paymentIdnull | stringpovinné

correctionIdnull | stringpovinné

correctionNumbernull | stringpovinné

POST/v1/proformas/{id}/refund

curl -X POST https://api.damedoklad.cz/v1/proformas/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/refund \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "refundedOn": "2026-10-30",
  "reason": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/proformas/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/refund', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "refundedOn": "2026-10-30",
    "reason": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/proformas/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/refund",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "refundedOn": "2026-10-30",
        "reason": "string"
    },
)
data = response.json()

List retentions (pozastávky) on issued and received invoices, with what is still open and when it falls due

GET/v1/retentions

List retentions (pozastávky) on issued and received invoices, with what is still open and when it falls due

Nástroj MCP: list-document-retentions

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

kind"invoice" | "received_invoice"

documentIdstring

ID of the document.

contactIdstring

ID of the contact. Find it with list-contacts.

status"open" | "paid" | "cancelled"

Odpověď · 200

dataobject[]povinné

object"document_retention"povinné

idstringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

modestringpovinné

percentinteger | nullpovinné

basestringpovinné

amountHalerintegerpovinné

openHalerintegerpovinné

dueDatestringpovinnédate

notenull | stringpovinné

longTermbooleanpovinné

statusstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/retentions

curl https://api.damedoklad.cz/v1/retentions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/retentions', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/retentions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Hold back part of an invoice as a retention, by percent or amount, with its own later due date. VAT and revenue stay whole

POST/v1/retentions

Hold back part of an invoice as a retention, by percent or amount, with its own later due date. VAT and revenue stay whole. Set it before issuing to have it printed. A PDF already issued is a tax document and is not rewritten: getRetentionNotice prints a notice for it, and e-mailing the invoice adds that notice. The payment QR code asks only for what is due. Several tranches are allowed.

Nástroj MCP: create-document-retention

Tělo požadavku

kind"invoice" | "received_invoice"povinné

documentIdstringpovinné

ID of the document.

mode"percent" | "amount"povinné

percentnumbermax 100

Retained percent, with mode percent.

base"total" | "net"

What the percent is of: the document total (default) or the amount without VAT.

amountHalerintegermax 9007199254740991

Retained amount in the document currency, with mode amount.

dueDatestringpovinnéYYYY-MM-DD

When the retained part falls due. Later than the due date of the document.

notestring | null

Odpověď · 201

idstringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

modestringpovinné

percentinteger | nullpovinné

basestringpovinné

amountHalerintegerpovinné

openHalerintegerpovinné

dueDatestringpovinnédate

notenull | stringpovinné

longTermbooleanpovinné

statusstringpovinné

POST/v1/retentions

curl -X POST https://api.damedoklad.cz/v1/retentions \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "mode": "percent",
  "dueDate": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/retentions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "mode": "percent",
    "dueDate": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/retentions",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "mode": "percent",
        "dueDate": "2026-10-30"
    },
)
data = response.json()

Change a retention: its amount, due date, or note. A long-term one must be moved back before its amount changes

PATCH/v1/retentions/{id}

Change a retention: its amount, due date, or note. A long-term one must be moved back before its amount changes

Nástroj MCP: update-document-retention

Parametry v cestě

idstringpovinné

Tělo požadavku

mode"percent" | "amount"

percentnumbermax 100

Retained percent, with mode percent.

base"total" | "net"

What the percent is of: the document total (default) or the amount without VAT.

amountHalerintegermax 9007199254740991

Retained amount in the document currency, with mode amount.

dueDatestringYYYY-MM-DD

When the retained part falls due. Later than the due date of the document.

notestring | null

Odpověď · 200

idstringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

modestringpovinné

percentinteger | nullpovinné

basestringpovinné

amountHalerintegerpovinné

openHalerintegerpovinné

dueDatestringpovinnédate

notenull | stringpovinné

longTermbooleanpovinné

statusstringpovinné

PATCH/v1/retentions/{id}

curl -X PATCH https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "percent",
  "percent": 1,
  "base": "total"
}'

const response = await fetch('https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mode": "percent",
    "percent": 1,
    "base": "total"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "mode": "percent",
        "percent": 1,
        "base": "total"
    },
)
data = response.json()

Cancel a retention, so the whole amount falls due with the document. A long-term one moves back with today as its date

DELETE/v1/retentions/{id}

Cancel a retention, so the whole amount falls due with the document. A long-term one moves back with today as its date

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-document-retention

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/retentions/{id}

curl -X DELETE https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Move a retention to the long-term analytic account (311900 or 321900) with one correcting entry, or back

POST/v1/retentions/{id}/classify

Move a retention to the long-term analytic account (311900 or 321900) with one correcting entry, or back. Long-term means due more than one year after the balance sheet date (vyhláška 500/2002 Sb. § 10, § 17). Double-entry books only. In a foreign currency it moves at the carrying value of the document.

Nástroj MCP: classify-document-retention

Parametry v cestě

idstringpovinné

Tělo požadavku

longTermbooleanpovinné

true moves the retained amount to the long-term analytic account; false moves it back.

datestringpovinnéYYYY-MM-DD

The date of the correcting entry, usually the balance sheet date.

Odpověď · 200

idstringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

modestringpovinné

percentinteger | nullpovinné

basestringpovinné

amountHalerintegerpovinné

openHalerintegerpovinné

dueDatestringpovinnédate

notenull | stringpovinné

longTermbooleanpovinné

statusstringpovinné

POST/v1/retentions/{id}/classify

curl -X POST https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "longTerm": false,
  "date": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "longTerm": false,
    "date": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/retentions/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/classify",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "longTerm": False,
        "date": "2026-10-30"
    },
)
data = response.json()

Print a retention notice for a document already issued, with the payment due without the retention. The issued PDF itself stays as it is

GET/v1/retentions/notice

Print a retention notice for a document already issued, with the payment due without the retention. The issued PDF itself stays as it is

Nástroj MCP: get-retention-notice

Parametry dotazu

kind"invoice" | "received_invoice"povinné

documentIdstringpovinné

ID of the document.

language"cs" | "en" | "de" | "fr"

Language of the notice. Without it, the language of the document, then the company default.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/retentions/notice

curl https://api.damedoklad.cz/v1/retentions/notice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/retentions/notice', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/retentions/notice",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Sort every open retention by a balance sheet date: what falls due over a year later moves to long-term, and what no longer does moves back. dryRun only says what would move

POST/v1/retentions/reclassify

Sort every open retention by a balance sheet date: what falls due over a year later moves to long-term, and what no longer does moves back. dryRun only says what would move. Long-term means due more than one year after the balance sheet date (vyhláška 500/2002 Sb. § 10, § 17). Double-entry books only. After a period ends this runs by itself, once. A tranche already part paid stays where it is and is named as part_paid.

Nástroj MCP: reclassify-retentions

Tělo požadavku

datestringpovinnéYYYY-MM-DD

The balance sheet date.

dryRunboolean

Say what would move and post nothing.

Odpověď · 200

datestringpovinnédate

dryRunbooleanpovinné

movedintegerpovinné

dataobject[]povinné

idstringpovinné

kindstringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

amountHalerinteger | nullpovinné

dueDatenull | stringpovinnédate

longTermbooleanpovinné

movestringpovinné

POST/v1/retentions/reclassify

curl -X POST https://api.damedoklad.cz/v1/retentions/reclassify \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/retentions/reclassify', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/retentions/reclassify",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30"
    },
)
data = response.json()

Which analytic accounts hold long-term retentions

GET/v1/retentions/settings

Which analytic accounts hold long-term retentions

Nástroj MCP: get-retention-settings

Odpověď · 200

receivableAccountstringpovinné

payableAccountstringpovinné

GET/v1/retentions/settings

curl https://api.damedoklad.cz/v1/retentions/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/retentions/settings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/retentions/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Choose the analytic accounts for long-term retentions, under 311 and 321. A tranche already moved stays where it is. An accountant should choose these

PUT/v1/retentions/settings

Choose the analytic accounts for long-term retentions, under 311 and 321. A tranche already moved stays where it is. An accountant should choose these

Nástroj MCP: update-retention-settings

Tělo požadavku

receivableAccountstring | null

Where a long-term retention on an issued invoice goes. Default 311900.

payableAccountstring | null

Where a long-term retention on a received invoice goes. Default 321900.

Odpověď · 200

receivableAccountstringpovinné

payableAccountstringpovinné

PUT/v1/retentions/settings

curl -X PUT https://api.damedoklad.cz/v1/retentions/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "receivableAccount": "string",
  "payableAccount": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/retentions/settings', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "receivableAccount": "string",
    "payableAccount": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/retentions/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "receivableAccount": "string",
        "payableAccount": "string"
    },
)
data = response.json()

List the cost centers, activities, projects, posting templates, and accounts a document can use

GET/v1/sales/accounting-options

List the cost centers, activities, projects, posting templates, and accounts a document can use

Nástroj MCP: get-sales-accounting-options

Odpověď · 200

centersobject[]povinné

idstringpovinné

kindstringpovinné

codenull | stringpovinné

namenull | stringpovinné

activitiesany[]povinné

projectsobject[]povinné

idstringpovinné

kindstringpovinné

codenull | stringpovinné

namenull | stringpovinné

templatesobject[]povinné

idstringpovinné

codenull | stringpovinné

namenull | stringpovinné

documentTypenull | stringpovinné

debitAccountstringpovinné

creditAccountnull | stringpovinné

accountsobject[]povinné

numbernull | stringpovinné

namenull | stringpovinné

nameEnnull | stringpovinné

typestringpovinné

GET/v1/sales/accounting-options

curl https://api.damedoklad.cz/v1/sales/accounting-options \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/accounting-options', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/accounting-options",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List the e-mails sent for a document

GET/v1/sales/doc/{kind}/{id}/emails

List the e-mails sent for a document

Nástroj MCP: list-sales-document-emails

Parametry v cestě

kindstringpovinné

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"sales_email"povinné

idstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

tostringpovinné

subjectnull | stringpovinné

statusstringpovinné

errornull | stringpovinné

attachmentsstring[]povinné

sentAtnull | stringdate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/doc/{kind}/{id}/emails

curl https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/emails \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/emails', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/emails",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Export an issued document as ISDOC 6.0.2 XML

GET/v1/sales/doc/{kind}/{id}/isdoc

Export an issued document as ISDOC 6.0.2 XML

Nástroj MCP: export-sales-document-isdoc

Parametry v cestě

kindstringpovinné

idstringpovinné

Odpověď · 200

Vrací soubor application/xml.

GET/v1/sales/doc/{kind}/{id}/isdoc

curl https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/isdoc \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/isdoc', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/isdoc",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Download the PDF of any issued sales document

GET/v1/sales/doc/{kind}/{id}/pdf

Download the PDF of any issued sales document

Nástroj MCP: download-sales-document-pdf

Parametry v cestě

kindstringpovinné

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/sales/doc/{kind}/{id}/pdf

curl https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Get or create the no-login public link to an issued document, with its payment QR code

POST/v1/sales/doc/{kind}/{id}/public-link

Get or create the no-login public link to an issued document, with its payment QR code

Nástroj MCP: get-sales-public-link

Parametry v cestě

kindstringpovinné

idstringpovinné

Odpověď · 200

idstring

documentKindstring

documentIdstringpovinné

urlstring

viewCountinteger

lastViewedAtstring | null

revokedAtstring | null

createdAtstringdate-time

revokedboolean

POST/v1/sales/doc/{kind}/{id}/public-link

curl -X POST https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Revoke the public link to a document; anyone holding it loses access

DELETE/v1/sales/doc/{kind}/{id}/public-link

Revoke the public link to a document; anyone holding it loses access

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: revoke-sales-public-link

Parametry v cestě

kindstringpovinné

idstringpovinné

Odpověď · 200

idstring

documentKindstring

documentIdstringpovinné

urlstring

viewCountinteger

lastViewedAtstring | null

revokedAtstring | null

createdAtstringdate-time

revokedboolean

DELETE/v1/sales/doc/{kind}/{id}/public-link

curl -X DELETE https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/public-link",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

E-mail an issued document to the customer with its PDF and ISDOC attached and a public payment link

POST/v1/sales/doc/{kind}/{id}/send

E-mail an issued document to the customer with its PDF and ISDOC attached and a public payment link. Defaults to the contact e-mail and the workspace template for the document type. The attempt is kept in the sent history.

Nástroj MCP: send-sales-document

Parametry v cestě

kindstringpovinné

idstringpovinné

Tělo požadavku

tostringemail

Date as YYYY-MM-DD.

subjectstringmax 300 chars

bodystringmax 10000 chars

attachPdfboolean

attachIsdocboolean

Odpověď · 200

idstringpovinné

documentKindnull | stringpovinné

documentIdnull | stringpovinné

tostringpovinné

subjectnull | stringpovinné

statusstringpovinné

errornull | stringpovinné

attachmentsstring[]povinné

sentAtnull | stringdate-time

POST/v1/sales/doc/{kind}/{id}/send

curl -X POST https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "2026-10-30",
  "subject": "string",
  "body": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "to": "2026-10-30",
    "subject": "string",
    "body": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/doc/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "to": "2026-10-30",
        "subject": "string",
        "body": "string"
    },
)
data = response.json()

List quotes, RFQs, orders, sales receipts, debit notes, other receivables or payables, by kind

GET/v1/sales/documents

List quotes, RFQs, orders, sales receipts, debit notes, other receivables or payables, by kind

Nástroj MCP: list-sales-documents

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

statusstringmax 32 chars

contactIdstring

ID of the contact. Find it with list-contacts.

customFieldKeystring

Only records with this custom field. Alone: it has any value. With customFieldValue: exactly that value, ignoring case.

customFieldValuestringmax 2000 chars

Odpověď · 200

dataobject[]povinné

object"sales_document"povinné

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/documents

curl https://api.damedoklad.cz/v1/sales/documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a quote, RFQ, order, sales receipt, debit note, other receivable or payable; set issue to number it now

POST/v1/sales/documents

Create a quote, RFQ, order, sales receipt, debit note, other receivable or payable; set issue to number it now

Nástroj MCP: create-sales-document

Tělo požadavku

issueboolean

clientSaleIdstringmin 8 charsmax 64 chars

ID of the client sale.

offlineobject

soldAtstringpovinnédate-time

numberstringpovinnémax 40 chars

listPricesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

quantitynumberpovinné

carrierIdstring | null

Who carries the goods. Issuing a received order prepares its shipment.

contactIdstring

ID of the contact. Find it with list-contacts.

contactNamestringmax 160 chars

contactIcostringmax 16 chars

Czech company number (IČO), 8 digits.

contactDicstringmax 16 chars

VAT number (DIČ), for example CZ12345678.

seriesIdstring

ID of the series. Find it with list-series.

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestring | null

Date as YYYY-MM-DD.

validUntilstring | null

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

exchangeRatenumber

templateIdstring | null

ID of the template.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

paymentMethod"transfer" | "cash" | "card" | "cod" | "proforma"

roundingMode"auto" | "crown" | "none"

pricesIncludeVatboolean

language"cs" | "en" | "sk" | "de" | "fr" | "pl"

notePublicstring | null

noteInternalstring | null

reasonstring | null

externalNumberstring | null

originalKind"invoice" | "received_invoice"

originalIdstring

ID of the original.

linesobject[]povinné

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

exemptPercentnumbermin 0max 100

purchaseLineIdstring | null

ID of the purchase line.

descriptionstringmax 240 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

vatRatenumbermin 0max 30

itemIdstring | null

ID of the item. Find it with list-items.

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

recyclingFeeIdstring | null

A fee from the list. null means no fee on this line, whatever the item says

recyclingPerUnitHalerintegermin 0max 9007199254740991

The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee

recyclingTextstringmax 120 chars

recyclingUnit"ks" | "kg"

The unit of a typed fee

recyclingCoefficientnumbermin 0max 1000000

How many times the fee applies to one unit of the line

Odpověď · 201

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents

curl -X POST https://api.damedoklad.cz/v1/sales/documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "kind": "quote",
  "lines": [
    {
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "kind": "quote",
    "lines": [
      {
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "kind": "quote",
        "lines": [
            {
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Get a sales document with lines, payments, fulfilment, and links

GET/v1/sales/documents/{id}

Get a sales document with lines, payments, fulfilment, and links

Nástroj MCP: get-sales-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

GET/v1/sales/documents/{id}

curl https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Edit a draft; after issue only notes and dates can change

PATCH/v1/sales/documents/{id}

Edit a draft; after issue only notes and dates can change

Nástroj MCP: update-sales-document

Parametry v cestě

idstringpovinné

Tělo požadavku

carrierIdstring | null

Who carries the goods. Issuing a received order prepares its shipment.

contactIdstring

ID of the contact. Find it with list-contacts.

contactNamestringmax 160 chars

contactIcostringmax 16 chars

Czech company number (IČO), 8 digits.

contactDicstringmax 16 chars

VAT number (DIČ), for example CZ12345678.

seriesIdstring

ID of the series. Find it with list-series.

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestring | null

Date as YYYY-MM-DD.

validUntilstring | null

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

exchangeRatenumber

templateIdstring | null

ID of the template.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

paymentMethod"transfer" | "cash" | "card" | "cod" | "proforma"

roundingMode"auto" | "crown" | "none"

pricesIncludeVatboolean

language"cs" | "en" | "sk" | "de" | "fr" | "pl"

notePublicstring | null

noteInternalstring | null

reasonstring | null

externalNumberstring | null

originalKind"invoice" | "received_invoice"

originalIdstring

ID of the original.

linesobject[]

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

exemptPercentnumbermin 0max 100

purchaseLineIdstring | null

ID of the purchase line.

descriptionstringmax 240 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

vatRatenumbermin 0max 30

itemIdstring | null

ID of the item. Find it with list-items.

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

recyclingFeeIdstring | null

A fee from the list. null means no fee on this line, whatever the item says

recyclingPerUnitHalerintegermin 0max 9007199254740991

The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee

recyclingTextstringmax 120 chars

recyclingUnit"ks" | "kg"

The unit of a typed fee

recyclingCoefficientnumbermin 0max 1000000

How many times the fee applies to one unit of the line

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

PATCH/v1/sales/documents/{id}

curl -X PATCH https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "contactName": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "contactName": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "contactName": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Delete a draft sales document

DELETE/v1/sales/documents/{id}

Delete a draft sales document

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-sales-document-draft

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/sales/documents/{id}

curl -X DELETE https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Cancel a quote, RFQ, or order and release any stock reservation

POST/v1/sales/documents/{id}/cancel

Cancel a quote, RFQ, or order and release any stock reservation

Nástroj MCP: cancel-sales-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Turn a document into the next one: quote to order or invoice, RFQ to order, order to invoice, delivery note, or receipt

POST/v1/sales/documents/{id}/convert

Turn a document into the next one: quote to order or invoice, RFQ to order, order to invoice, delivery note, or receipt. Pass lines with quantities for a partial conversion; otherwise everything still open is taken. Orders track what is delivered and invoiced.

Nástroj MCP: convert-sales-document

Parametry v cestě

idstringpovinné

Tělo požadavku

issueboolean

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

supplierDocumentNumberstringmax 64 chars

linesobject[]

lineIdstringpovinné

ID of the line.

quantitynumberpovinné

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

exchangeRatenumber

landedCostsobject[]

labelstringpovinnémax 120 chars

amountHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

method"value" | "weight"

Odpověď · 201

targetstringpovinné

createdobjectpovinné

customFieldsobject

vatModestring

exchangeRateinteger | null

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

idnull | stringpovinné

numbernull | string

variableSymbolnull | string

contactIdnull | string

contactNamenull | string

issueDatenull | stringdate

dueDatestring | null

currencynull | string

totalHalerinteger | null

paidHalerinteger

statusstring

overdueboolean

fileIdnull | string

seriesIdnull | string

constantSymbolstring | null

taxPointDatenull | stringdate

paymentMethodstring

languagenull | string

notePublicstring | null

noteInternalstring | null

ourAccountNumbernull | string

ourBankCodenull | string

ourIbannull | string

sellerNamenull | string

sellerIconull | string

sellerDicnull | string

reminderOnDueboolean

reminderWeekAfterboolean

reminder14DaysAfterboolean

reminderMonthAfterboolean

netHalerinteger

vatHalerinteger | null

roundingHalerinteger

recurringIdstring | null

stornoOfIdstring | null

contactIconull | string

contactDicnull | string

contactVatPayerTypenull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

shipToNamestring | null

shipToStreetstring | null

shipToCitystring | null

shipToPostalCodestring | null

shipToCountrystring | null

contactEmailnull | string

linesobject[]

object"delivery_note_line" | "invoice_line" | "proforma_line" | "received_invoice_line" | "sales_document_line"povinné

idstringpovinné

descriptionnull | stringpovinné

quantityintegerpovinné

unitnull | stringpovinné

unitPriceHalerinteger | nullpovinné

vatRateinteger

netHalerinteger

vatHalerinteger | null

totalHalerinteger | null

accountNumberstring | null

lineKindstring

sourceIdstring | null

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

lotsany[]povinné

orderLineIdnull | stringpovinné

fulfilledQuantityinteger

invoicedQuantityinteger

reservedQuantityinteger

returnedQuantityinteger

originalLineIdstring | null

recyclingnull | object

textstringpovinné

unitnull | stringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerinteger | nullpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

vatLinesobject[]

object"invoice_vat_line" | "received_invoice_vat_line"povinné

idstringpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerinteger | nullpovinné

paymentsany[]

linksany[]

postingobject

regimestringpovinné

eventstringpovinné

journalLinesobject[]

accountnull | stringpovinné

sidestringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

balancedboolean

cashJournalany[]

receivablesBookobject[]

documentIdnull | stringpovinné

amountHalerinteger | nullpovinné

statusstringpovinné

payablesBookany[]

assetany[]

skippedboolean

retentionsany[]

totalValueHalerinteger

deliveryDatestringdate

kindstring

taxDocumentsany[]

supplierDocumentNumbernull | string

receivedOnstring | null

theirAccountNumberstring | null

theirBankCodestring | null

theirIbanstring | null

duplicateOfIdstring | null

settlementsany[]

supplierAdvancesany[]

validUntilstring | null

reservationStatusstring

externalNumberstring | null

reasonstring | null

sourceKindnull | string

sourceIdnull | string

originalKindstring | null

originalIdstring | null

originalNumberstring | null

consumedByIdstring | null

receivedHalerinteger | null

registerIdstring | null

closureIdstring | null

changeHalerany

Null in every recorded response.

carrierIdnull | string

sourceobjectpovinné

object"sales_document"povinné

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/convert

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/convert \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "order_received"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/convert', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "target": "order_received"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/convert",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "target": "order_received"
    },
)
data = response.json()

Number a draft and post it to the books; a sales order also requests stock reservation

POST/v1/sales/documents/{id}/issue

Number a draft and post it to the books; a sales order also requests stock reservation. An other receivable or debit note over the contact credit limit is refused with credit_limit_exceeded; an owner or accountant can repeat it with overrideCreditLimit.

Nástroj MCP: issue-sales-document

Parametry v cestě

idstringpovinné

Tělo požadavku

overrideReservationsboolean

overrideDeliveryNotesboolean

deliveryNoteIdsstring[]

overrideCreditLimitboolean

Issue although the customer goes over Kredit max. Owner or accountant only, after the user has seen the warning.

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/issue

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/issue \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "overrideReservations": false,
  "overrideDeliveryNotes": false,
  "deliveryNoteIds": [
    "dln_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/issue', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "overrideReservations": false,
    "overrideDeliveryNotes": false,
    "deliveryNoteIds": [
      "dln_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/issue",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "overrideReservations": False,
        "overrideDeliveryNotes": False,
        "deliveryNoteIds": [
            "dln_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Record a payment of a debit note, other receivable, or other payable. Cash goes through a cash document of a register, a transfer through a bank account, and a later statement line takes it over

POST/v1/sales/documents/{id}/payments

Record a payment of a debit note, other receivable, or other payable. Cash goes through a cash document of a register, a transfer through a bank account, and a later statement line takes it over

Nástroj MCP: add-sales-document-payment

Parametry v cestě

idstringpovinné

Tělo požadavku

amountHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

paidOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

method"transfer" | "cash" | "card" | "other"

inPersonboolean

paidAtstringdate-time

notestring | null

registerIdstring

ID of the register.

bankAccountIdstring

ID of the bank account. Find it with list-bank-accounts.

allowNegativeboolean

Odpověď · 201

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/payments

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "paidOn": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "amountHaler": 1210000,
    "paidOn": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "amountHaler": 1210000,
        "paidOn": "2026-10-30"
    },
)
data = response.json()

Take goods back on a sales receipt, all or part: a negative receipt, money back, stock back at the cost it left with

POST/v1/sales/documents/{id}/pos-return

Take goods back on a sales receipt, all or part: a negative receipt, money back, stock back at the cost it left with. A serial-tracked line needs the serial numbers coming back unless the whole line returns.

Nástroj MCP: create-pos-return

Parametry v cestě

idstringpovinné

Tělo požadavku

paymentMethod"cash" | "card"

reasonstring | null

clientSaleIdstringmin 8 charsmax 64 chars

ID of the client sale.

offlineobject

soldAtstringpovinnédate-time

numberstringpovinnémax 40 chars

listPricesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

quantitynumberpovinné

backToVoucherboolean

linesobject[]povinné

lineIdstringpovinné

ID of the line.

quantitynumberpovinné

serialNumbersstring[]

Odpověď · 201

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/pos-return

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pos-return \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "lines": [
    {
      "lineId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pos-return', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "lines": [
      {
        "lineId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pos-return",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "lines": [
            {
                "lineId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Mark an issued quote as accepted or rejected

POST/v1/sales/documents/{id}/status

Mark an issued quote as accepted or rejected

Nástroj MCP: set-sales-quote-status

Parametry v cestě

idstringpovinné

Tělo požadavku

status"accepted" | "rejected"povinné

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/status

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "accepted"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/status', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "status": "accepted"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/status",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "status": "accepted"
    },
)
data = response.json()

Reverse a posted sales document with a storno document

POST/v1/sales/documents/{id}/storno

Reverse a posted sales document with a storno document

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: storno-sales-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/documents/{id}/storno

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List e-mail and reminder templates per document type and language

GET/v1/sales/email-templates

List e-mail and reminder templates per document type and language

Nástroj MCP: list-sales-email-templates

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"sales_email_template"povinné

typestringpovinné

languagestringpovinné

subjectstringpovinné

bodystringpovinné

customizedbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/email-templates

curl https://api.damedoklad.cz/v1/sales/email-templates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/email-templates', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/email-templates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Replace an e-mail or reminder template

PUT/v1/sales/email-templates/{type}/{language}

Replace an e-mail or reminder template. Placeholders: {{number}}, {{companyName}}, {{contactName}}, {{amount}}, {{dueDate}}, {{variableSymbol}}, {{link}}; reminders also {{outstanding}}, {{interest}}, {{daysOverdue}}, {{newDueDate}}.

Nástroj MCP: put-sales-email-template

Parametry v cestě

typestringpovinné

languagestringpovinné

Tělo požadavku

subjectstringpovinnémax 300 chars

bodystringpovinnémax 10000 chars

Odpověď · 200

typestringpovinné

languagestringpovinné

subjectstringpovinné

bodystringpovinné

customizedbooleanpovinné

PUT/v1/sales/email-templates/{type}/{language}

curl -X PUT https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "string",
  "body": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "subject": "string",
    "body": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "subject": "string",
        "body": "string"
    },
)
data = response.json()

Go back to the default template

DELETE/v1/sales/email-templates/{type}/{language}

Go back to the default template

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: reset-sales-email-template

Parametry v cestě

typestringpovinné

languagestringpovinné

Odpověď · 200

typestringpovinné

languagestringpovinné

subjectstringpovinné

bodystringpovinné

customizedbooleanpovinné

DELETE/v1/sales/email-templates/{type}/{language}

curl -X DELETE https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/sales/email-templates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Import an ISDOC file as a received invoice draft and match or create the supplier contact

POST/v1/sales/import-isdoc

Import an ISDOC file as a received invoice draft and match or create the supplier contact

Nástroj MCP: import-received-invoice-isdoc

Tělo požadavku

fileBase64string

File content encoded as base64.

xmlstring

confirmDuplicateboolean

Odpověď · 201

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

variableSymbolnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

statusstringpovinné

overduebooleanpovinné

fileIdnull | stringpovinné

customFieldsobject

vatModestring

exchangeRateinteger

templateIdnull | string

centerIdstring | null

activityIdstring | null

projectIdnull | string

seriesIdnull | string

constantSymbolstring | null

receivedOnnull | stringdate

taxPointDatestringdate

paymentMethodstring

theirAccountNumbernull | string

theirBankCodenull | string

theirIbannull | string

notePublicstring | null

noteInternalnull | string

netHalerinteger

vatHalerinteger

stornoOfIdnull | string

duplicateOfIdnull | string

contactIconull | string

contactDicnull | string

contactVatPayerTypenull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

shipToNamestring | null

shipToStreetstring | null

shipToCitystring | null

shipToPostalCodestring | null

shipToCountrystring | null

contactEmailnull | string

linesobject[]

object"received_invoice_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

lineKindstringpovinné

sourceIdnull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdnull | stringpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdnull | stringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliinteger

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

typedboolean

vatLinesobject[]

object"received_invoice_vat_line"povinné

idstringpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

settlementsobject[]

object"received_invoice_settlement"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

supplierAdvancesobject[]

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

postingobject

regimestringpovinné

eventstringpovinné

journalLinesobject[]

accountnull | stringpovinné

sidestringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

balancedboolean

cashJournalobject[]

accountnull | stringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

receivablesBookany[]

payablesBookobject[]

documentIdnull | stringpovinné

amountHalerinteger | nullpovinné

statusstringpovinné

assetany[]

retentionsany[]

duplicateobject

existingIdstringpovinné

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

cashDocumentobject

idstringpovinné

numbernull | stringpovinné

warningsany[]povinné

importedobject

uuidstringpovinné

documentTypeinteger | nullpovinné

warningsstring[]povinné

POST/v1/sales/import-isdoc

curl -X POST https://api.damedoklad.cz/v1/sales/import-isdoc \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string",
  "xml": "string",
  "confirmDuplicate": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/import-isdoc', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string",
    "xml": "string",
    "confirmDuplicate": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/import-isdoc",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string",
        "xml": "string",
        "confirmDuplicate": False
    },
)
data = response.json()

Import a supplier's zálohová faktura in ISDOC as a draft advance (a tax document for a payment, DocumentType 5, goes to its advance instead) and match or create the supplier contact. Nothing posts

POST/v1/sales/import-isdoc-advance

Import a supplier's zálohová faktura in ISDOC as a draft advance (a tax document for a payment, DocumentType 5, goes to its advance instead) and match or create the supplier contact. Nothing posts

Nástroj MCP: import-supplier-advance-isdoc

Tělo požadavku

fileBase64string

File content encoded as base64.

xmlstring

confirmDuplicateboolean

Odpověď · 201

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

variableSymbolnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

statusstringpovinné

overduebooleanpovinné

customFieldsobject

stavba_zalohystring

vatModestring

exchangeRateinteger

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

seriesIdnull | string

constantSymbolstring | null

paymentMethodstring

theirAccountNumbernull | string

theirBankCodenull | string

theirIbanstring | null

notePublicstring | null

noteInternalnull | string

netHalerinteger

vatHalerinteger

taxedHalerinteger

advanceAccountstring

selfAssessableboolean

receivedInvoiceIdnull | string

contactIconull | string

contactDicnull | string

contactVatPayerTypenull | string

billToStreetstring | null

billToCitystring | null

billToPostalCodestring | null

billToCountrynull | string

shipToNamestring | null

shipToStreetstring | null

shipToCitystring | null

shipToPostalCodestring | null

shipToCountrystring | null

contactEmailnull | string

linesobject[]

object"supplier_advance_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumberstring | nullpovinné

lineKindstringpovinné

sourceIdstring | nullpovinné

itemIdstring | nullpovinné

warehouseIdstring | nullpovinné

lotsany[]povinné

orderLineIdstring | nullpovinné

vatLinesobject[]

object"supplier_advance_vat_line"povinné

idstringpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

paymentsobject[]

object"supplier_advance_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

exchangeRatenumberpovinné

taxDocumentsobject[]

object"supplier_advance_tax_document"povinné

idstringpovinné

supplierAdvanceIdstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

contactDicnull | stringpovinné

statusstringpovinné

issueDatestringpovinnédate

taxPointDatestringpovinnédate

receivedOnnull | stringpovinnédate

currencystringpovinné

exchangeRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

reasonnull | stringpovinné

correctsNumbernull | stringpovinné

selfAssessedbooleanpovinné

paymentIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

stornoOfIdnull | stringpovinné

linesobject[]povinné

object"supplier_advance_tax_document_line"povinné

idstringpovinné

descriptionstringpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

taxRecordsKindstring

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

refundobject

amountHalerinteger | nullpovinné

paymentIdnull | stringpovinné

correctionIdnull | stringpovinné

correctionNumbernull | stringpovinné

stornoCorrectionobject

reasonnull | stringpovinné

datestringpovinnédate

periodstringpovinné

additionalReturnbooleanpovinné

followUpStatementbooleanpovinné

POST/v1/sales/import-isdoc-advance

curl -X POST https://api.damedoklad.cz/v1/sales/import-isdoc-advance \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string",
  "xml": "string",
  "confirmDuplicate": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/import-isdoc-advance', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string",
    "xml": "string",
    "confirmDuplicate": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/import-isdoc-advance",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string",
        "xml": "string",
        "confirmDuplicate": False
    },
)
data = response.json()

Create an invoice for the late-payment interest on an overdue invoice, optionally with the 1 200 Kč recovery cost

POST/v1/sales/invoices/{id}/penalty-invoice

Create an invoice for the late-payment interest on an overdue invoice, optionally with the 1 200 Kč recovery cost

Nástroj MCP: create-penalty-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

toDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

ratePercentnumbermin 0max 100

includeRecoveryCostboolean

issueboolean

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

numbernull | stringpovinné

variableSymbolnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

statusstringpovinné

overduebooleanpovinné

fileIdnull | stringpovinné

customFieldsobject

zakazka_zakaznikastring

pocetinteger

kampanstring

vatModestring

exchangeRatenumber

templateIdnull | string

centerIdnull | string

activityIdnull | string

projectIdnull | string

seriesIdnull | string

constantSymbolnull | string

taxPointDatestringdate

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

ourAccountNumbernull | string

ourBankCodenull | string

ourIbannull | string

sellerNamenull | string

sellerIconull | string

sellerDicnull | string

reminderOnDueboolean

reminderWeekAfterboolean

reminder14DaysAfterboolean

reminderMonthAfterboolean

netHalerinteger

vatHalerinteger

roundingHalerinteger

recurringIdnull | string

stornoOfIdnull | string

contactIconull | string

contactDicnull | string

contactVatPayerTypenull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

shipToNamestring | null

shipToStreetnull | string

shipToCitynull | string

shipToPostalCodenull | string

shipToCountrynull | string

contactEmailnull | string

linesobject[]

object"invoice_line"povinné

idstringpovinné

descriptionstringpovinné

quantitynumberpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRatenumberpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

lineKindstringpovinné

sourceIdnull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

lotsobject[]povinné

itemIdnull | string

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdnull | stringpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdnull | stringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliinteger

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

typedboolean

vatLinesobject[]

object"invoice_vat_line"povinné

idstringpovinné

vatRatenumberpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

paymentsobject[]

object"invoice_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

postingobject

regimestringpovinné

eventstringpovinné

journalLinesobject[]

accountnull | stringpovinné

sidestringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

balancedboolean

cashJournalobject[]

accountnull | stringpovinné

amountHalerinteger | nullpovinné

documentIdnull | stringpovinné

receivablesBookobject[]

documentIdnull | stringpovinné

amountHalerinteger | nullpovinné

statusstringpovinné

payablesBookany[]

assetany[]

retentionsobject[]

idstringpovinné

amountHalerinteger | nullpovinné

dueDatenull | stringpovinnédate

notestring | nullpovinné

longTermbooleanpovinné

carrierIdnull | string

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHalerinteger | nullpovinné

blockHalerintegerpovinné

availableHalerintegerpovinné

originalany

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

cashDocumentobject

idstringpovinné

numbernull | stringpovinné

warningsany[]povinné

POST/v1/sales/invoices/{id}/penalty-invoice

curl -X POST https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/penalty-invoice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "toDate": "2026-10-30",
  "ratePercent": 0,
  "includeRecoveryCost": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/penalty-invoice', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "toDate": "2026-10-30",
    "ratePercent": 0,
    "includeRecoveryCost": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/penalty-invoice",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "toDate": "2026-10-30",
        "ratePercent": 0,
        "includeRecoveryCost": False
    },
)
data = response.json()

Vytvoření: upomínka, faktura

POST/v1/sales/invoices/{id}/reminders

Create a payment reminder for an overdue invoice, with a PDF, and optionally e-mail it

Nástroj MCP: create-invoice-reminder

Parametry v cestě

idstringpovinné

Tělo požadavku

levelintegermin 1max 3

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

newDueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

ratePercentnumbermin 0max 100

sendboolean

tostringemail

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

invoiceIdstringpovinné

invoiceNumberstringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

levelintegerpovinné

numbernull | stringpovinné

issueDatestringpovinnédate

newDueDatenull | stringpovinnédate

daysOverdueintegerpovinné

outstandingHalerintegerpovinné

interestHalerintegerpovinné

ratePercentnull | numberpovinné

subjectstringpovinné

bodystringpovinné

sentAtnull | stringpovinnédate-time

fileIdnull | stringpovinné

POST/v1/sales/invoices/{id}/reminders

curl -X POST https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reminders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "level": 1,
  "issueDate": "2026-10-30",
  "newDueDate": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reminders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "level": 1,
    "issueDate": "2026-10-30",
    "newDueDate": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reminders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "level": 1,
        "issueDate": "2026-10-30",
        "newDueDate": "2026-10-30"
    },
)
data = response.json()

Calculate Czech statutory late-payment interest (ČNB repo rate on the first day of the half-year + 8 points)

GET/v1/sales/late-interest

Calculate Czech statutory late-payment interest (ČNB repo rate on the first day of the half-year + 8 points). Pass ratePercent for a contractual rate, or when the half-year is not in the verified repo table.

Nástroj MCP: calculate-late-interest

Parametry dotazu

amountHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

dueDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

toDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

ratePercentnumbermin 0max 100

Odpověď · 200

knownbooleanpovinné

delayStartstringpovinnédate

ratePercentnull | numberpovinné

statutorynull | objectpovinné

repoRatenumberpovinné

decidingDatestringpovinnédate

ratePercentnull | numberpovinné

daysintegerpovinné

interestHalerintegerpovinné

periodsobject[]povinné

fromstringpovinnédate

tostringpovinnédate

daysintegerpovinné

principalHalerintegerpovinné

interestHalerintegerpovinné

outstandingHalerinteger

recoveryCostHalerintegerpovinné

GET/v1/sales/late-interest

curl https://api.damedoklad.cz/v1/sales/late-interest \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/late-interest', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/late-interest",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List unpaid invoices past their due date, with late interest and the next reminder level

GET/v1/sales/overdue

List unpaid invoices past their due date, with late interest and the next reminder level

Nástroj MCP: list-overdue-invoices

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

asOfstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

dataobject[]povinné

object"overdue_invoice"povinné

idstringpovinné

numbernull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

contactEmailnull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

currencynull | stringpovinné

totalHalerinteger | nullpovinné

paidHalerintegerpovinné

outstandingHalerintegerpovinné

daysOverdueintegerpovinné

interestHalerintegerpovinné

ratePercentnull | numberpovinné

rateKnownbooleanpovinné

lastReminderLevelintegerpovinné

nextReminderLevelintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/overdue

curl https://api.damedoklad.cz/v1/sales/overdue \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/overdue', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/overdue",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

A return taken without a connection: the sale named by its id or by the till's own id for it, its lines by their place on the receipt

POST/v1/sales/pos-returns

A return taken without a connection: the sale named by its id or by the till's own id for it, its lines by their place on the receipt. The till sends this when the connection is back, after the sale it returns. Sending it again answers the first return.

Nástroj MCP: create-offline-pos-return

Tělo požadavku

originalIdstring

ID of the original.

originalClientSaleIdstringmin 8 charsmax 64 chars

ID of the original client sale.

paymentMethod"cash" | "card"

reasonstring | null

clientSaleIdstringpovinnémin 8 charsmax 64 chars

ID of the client sale.

offlineobjectpovinné

soldAtstringpovinnédate-time

numberstringpovinnémax 40 chars

listPricesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

quantitynumberpovinné

backToVoucherboolean

linesobject[]povinné

positionintegerpovinnémin 0max 9007199254740991

quantitynumberpovinné

serialNumbersstring[]

Odpověď · 201

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/pos-returns

curl -X POST https://api.damedoklad.cz/v1/sales/pos-returns \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "clientSaleId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "offline": {
    "soldAt": "2026-10-30",
    "number": "string"
  },
  "lines": [
    {
      "position": 0,
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/pos-returns', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "clientSaleId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "offline": {
      "soldAt": "2026-10-30",
      "number": "string"
    },
    "lines": [
      {
        "position": 0,
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/pos-returns",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "clientSaleId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "offline": {
            "soldAt": "2026-10-30",
            "number": "string"
        },
        "lines": [
            {
                "position": 0,
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Record a paid till sale: issues a sales receipt at once, posts to the cash desk or card clearing (261)

POST/v1/sales/pos-sales

Record a paid till sale: issues a sales receipt at once, posts to the cash desk or card clearing (261). Prices include VAT. Cash in CZK rounds to whole crowns. Pass receivedHaler to get the change back.

Nástroj MCP: create-pos-sale

Tělo požadavku

clientSaleIdstringmin 8 charsmax 64 chars

ID of the client sale.

offlineobject

soldAtstringpovinnédate-time

numberstringpovinnémax 40 chars

listPricesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

quantitynumberpovinné

registerIdstring

ID of the register.

paymentMethod"cash" | "card"povinné

cashRegisterIdstring

ID of the cash register. Find it with list-cash-registers.

eetPrepaidLoadHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

eetPrepaidUseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

eetVoucherIdstring

ID of the eet voucher. Find it with list-eet-vouchers.

eetOwnSaleboolean

eetMandateIdstring

ID of the eet mandate. Find it with list-eet-mandates.

terminalPaymentobject

protocolstringpovinnémax 20 chars

terminalIdstring | null

ID of the terminal.

receiptNumberstring | null

traceNumberstring | null

authorisationstring | null

cardNamestring | null

approvedAtstring | null

billToCountrystring2 chars

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

exchangeRatenumber

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

receivedHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

contactIdstring

ID of the contact. Find it with list-contacts.

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

seriesIdstring

ID of the series. Find it with list-series.

roundingMode"auto" | "crown" | "none"

linesobject[]povinné

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

exemptPercentnumbermin 0max 100

purchaseLineIdstring | null

ID of the purchase line.

descriptionstringmax 240 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

vatRatenumbermin 0max 30

itemIdstring | null

ID of the item. Find it with list-items.

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

Odpověď · 201

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/sales/pos-sales

curl -X POST https://api.damedoklad.cz/v1/sales/pos-sales \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "paymentMethod": "cash",
  "lines": [
    {
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/pos-sales', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "paymentMethod": "cash",
    "lines": [
      {
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/pos-sales",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "paymentMethod": "cash",
        "lines": [
            {
                "quantity": 1
            }
        ]
    },
)
data = response.json()

List recurring invoice schedules

GET/v1/sales/recurring

List recurring invoice schedules

Nástroj MCP: list-recurring-invoices

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

dataobject[]povinné

object"sales_recurring"povinné

idstringpovinné

namenull | stringpovinné

contactIdnull | stringpovinné

statusstringpovinné

frequencystringpovinné

intervalCountintegerpovinné

startDatestringpovinnédate

nextIssueDatenull | stringpovinnédate

endDatenull | stringpovinnédate

dueDaysintegerpovinné

autoIssuebooleanpovinné

autoSendbooleanpovinné

currencynull | stringpovinné

paymentMethodstringpovinné

languagenull | stringpovinné

vatModestringpovinné

templateIdstring | nullpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

notePublicstring | nullpovinné

linesobject[]povinné

unitnull | string

vatRateintegerpovinné

quantityintegerpovinné

descriptionnull | stringpovinné

unitPriceHalerinteger | nullpovinné

lastIssuedOnnull | stringpovinnédate

lastErrornull | stringpovinné

runsobject[]

object"sales_recurring_run"povinné

idstringpovinné

runDatestringpovinnédate

statusstringpovinné

invoiceIdnull | stringpovinné

errornull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/recurring

curl https://api.damedoklad.cz/v1/sales/recurring \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/recurring",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a schedule that issues an invoice automatically, optionally e-mailing it

POST/v1/sales/recurring

Create a schedule that issues an invoice automatically, optionally e-mailing it

Nástroj MCP: create-recurring-invoice

Tělo požadavku

namestringpovinnémax 200 chars

contactIdstringpovinné

ID of the contact. Find it with list-contacts.

frequency"monthly" | "quarterly" | "half_yearly" | "yearly"povinné

intervalCountintegermin 1max 24

startDatestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

endDatestring | null

Date as YYYY-MM-DD.

dueDaysintegermin 0max 365

autoIssueboolean

autoSendboolean

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

paymentMethod"transfer" | "cash" | "card" | "cod" | "proforma"

language"cs" | "en" | "sk" | "de" | "fr" | "pl"

templateIdstring | null

ID of the template.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

notePublicstring | null

linesobject[]povinné

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

exemptPercentnumbermin 0max 100

purchaseLineIdstring | null

ID of the purchase line.

descriptionstringmax 240 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

vatRatenumbermin 0max 30

itemIdstring | null

ID of the item. Find it with list-items.

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

recyclingFeeIdstring | null

A fee from the list. null means no fee on this line, whatever the item says

recyclingPerUnitHalerintegermin 0max 9007199254740991

The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee

recyclingTextstringmax 120 chars

recyclingUnit"ks" | "kg"

The unit of a typed fee

recyclingCoefficientnumbermin 0max 1000000

How many times the fee applies to one unit of the line

Odpověď · 201

idstringpovinné

namenull | stringpovinné

contactIdnull | stringpovinné

statusstringpovinné

frequencystringpovinné

intervalCountintegerpovinné

startDatestringpovinnédate

nextIssueDatenull | stringpovinnédate

endDatenull | stringpovinnédate

dueDaysintegerpovinné

autoIssuebooleanpovinné

autoSendbooleanpovinné

currencynull | stringpovinné

paymentMethodstringpovinné

languagenull | stringpovinné

vatModestringpovinné

templateIdstring | nullpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

notePublicstring | nullpovinné

linesobject[]povinné

unitnull | string

vatRateintegerpovinné

quantityintegerpovinné

descriptionnull | stringpovinné

unitPriceHalerinteger | nullpovinné

lastIssuedOnnull | stringpovinnédate

lastErrornull | stringpovinné

runsobject[]

object"sales_recurring_run"povinné

idstringpovinné

runDatestringpovinnédate

statusstringpovinné

invoiceIdnull | stringpovinné

errornull | stringpovinné

POST/v1/sales/recurring

curl -X POST https://api.damedoklad.cz/v1/sales/recurring \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "frequency": "monthly",
  "startDate": "2026-10-30",
  "lines": [
    {
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "frequency": "monthly",
    "startDate": "2026-10-30",
    "lines": [
      {
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/recurring",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "frequency": "monthly",
        "startDate": "2026-10-30",
        "lines": [
            {
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Get a recurring invoice schedule with its run history

GET/v1/sales/recurring/{id}

Get a recurring invoice schedule with its run history

Nástroj MCP: get-recurring-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namenull | stringpovinné

contactIdnull | stringpovinné

statusstringpovinné

frequencystringpovinné

intervalCountintegerpovinné

startDatestringpovinnédate

nextIssueDatenull | stringpovinnédate

endDatenull | stringpovinnédate

dueDaysintegerpovinné

autoIssuebooleanpovinné

autoSendbooleanpovinné

currencynull | stringpovinné

paymentMethodstringpovinné

languagenull | stringpovinné

vatModestringpovinné

templateIdstring | nullpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

notePublicstring | nullpovinné

linesobject[]povinné

unitnull | string

vatRateintegerpovinné

quantityintegerpovinné

descriptionnull | stringpovinné

unitPriceHalerinteger | nullpovinné

lastIssuedOnnull | stringpovinnédate

lastErrornull | stringpovinné

runsobject[]

object"sales_recurring_run"povinné

idstringpovinné

runDatestringpovinnédate

statusstringpovinné

invoiceIdnull | stringpovinné

errornull | stringpovinné

GET/v1/sales/recurring/{id}

curl https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change, pause, or resume a recurring invoice schedule

PATCH/v1/sales/recurring/{id}

Change, pause, or resume a recurring invoice schedule

Nástroj MCP: update-recurring-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

contactIdstring

ID of the contact. Find it with list-contacts.

frequency"monthly" | "quarterly" | "half_yearly" | "yearly"

intervalCountintegermin 1max 24

startDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

endDatestring | null

Date as YYYY-MM-DD.

dueDaysintegermin 0max 365

autoIssueboolean

autoSendboolean

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

paymentMethod"transfer" | "cash" | "card" | "cod" | "proforma"

language"cs" | "en" | "sk" | "de" | "fr" | "pl"

templateIdstring | null

ID of the template.

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

notePublicstring | null

linesobject[]

purchaseHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

exemptPercentnumbermin 0max 100

purchaseLineIdstring | null

ID of the purchase line.

descriptionstringmax 240 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegermin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

vatRatenumbermin 0max 30

itemIdstring | null

ID of the item. Find it with list-items.

warehouseIdstring | null

ID of the warehouse. Find it with list-warehouses.

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

lotsobject[]

itemIdstring

ID of the item. Find it with list-items.

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumber

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

recyclingFeeIdstring | null

A fee from the list. null means no fee on this line, whatever the item says

recyclingPerUnitHalerintegermin 0max 9007199254740991

The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee

recyclingTextstringmax 120 chars

recyclingUnit"ks" | "kg"

The unit of a typed fee

recyclingCoefficientnumbermin 0max 1000000

How many times the fee applies to one unit of the line

status"active" | "paused"

Odpověď · 200

idstringpovinné

namenull | stringpovinné

contactIdnull | stringpovinné

statusstringpovinné

frequencystringpovinné

intervalCountintegerpovinné

startDatestringpovinnédate

nextIssueDatenull | stringpovinnédate

endDatenull | stringpovinnédate

dueDaysintegerpovinné

autoIssuebooleanpovinné

autoSendbooleanpovinné

currencynull | stringpovinné

paymentMethodstringpovinné

languagenull | stringpovinné

vatModestringpovinné

templateIdstring | nullpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

notePublicstring | nullpovinné

linesobject[]povinné

unitnull | string

vatRateintegerpovinné

quantityintegerpovinné

descriptionnull | stringpovinné

unitPriceHalerinteger | nullpovinné

lastIssuedOnnull | stringpovinnédate

lastErrornull | stringpovinné

runsobject[]

object"sales_recurring_run"povinné

idstringpovinné

runDatestringpovinnédate

statusstringpovinné

invoiceIdnull | stringpovinné

errornull | stringpovinné

PATCH/v1/sales/recurring/{id}

curl -X PATCH https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "frequency": "monthly"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "frequency": "monthly"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "frequency": "monthly"
    },
)
data = response.json()

End a recurring invoice schedule. Invoices already issued stay.

DELETE/v1/sales/recurring/{id}

End a recurring invoice schedule. Invoices already issued stay.

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: delete-recurring-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/sales/recurring/{id}

curl -X DELETE https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/sales/recurring/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Issue every recurring invoice due by today in this workspace now; safe to repeat

POST/v1/sales/recurring/run-due

Issue every recurring invoice due by today in this workspace now; safe to repeat

Nástroj MCP: run-due-recurring-invoices

Tělo požadavku

asOfstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

schedulesintegerpovinné

issuedintegerpovinné

failedintegerpovinné

errorsobject[]povinné

recurringIdnull | stringpovinné

errornull | stringpovinné

POST/v1/sales/recurring/run-due

curl -X POST https://api.damedoklad.cz/v1/sales/recurring/run-due \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asOf": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/recurring/run-due', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "asOf": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/recurring/run-due",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "asOf": "2026-10-30"
    },
)
data = response.json()

Seznam: upomínky, faktura

GET/v1/sales/reminders

List payment reminders

Nástroj MCP: list-invoice-reminders

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

dataobject[]povinné

object"sales_reminder"povinné

idstringpovinné

invoiceIdstringpovinné

invoiceNumberstringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

levelintegerpovinné

numbernull | stringpovinné

issueDatestringpovinnédate

newDueDatenull | stringpovinnédate

daysOverdueintegerpovinné

outstandingHalerintegerpovinné

interestHalerintegerpovinné

ratePercentnull | numberpovinné

subjectstringpovinné

bodystringpovinné

sentAtnull | stringpovinnédate-time

fileIdnull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/sales/reminders

curl https://api.damedoklad.cz/v1/sales/reminders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/reminders', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/reminders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Stažení: PDF, upomínka, faktura

GET/v1/sales/reminders/{id}/pdf

Download the PDF of a payment reminder

Nástroj MCP: download-invoice-reminder-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/sales/reminders/{id}/pdf

curl https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Odeslání: upomínka, faktura

POST/v1/sales/reminders/{id}/send

E-mail a payment reminder to the customer

Nástroj MCP: send-invoice-reminder

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

invoiceIdstringpovinné

invoiceNumberstringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

levelintegerpovinné

numbernull | stringpovinné

issueDatestringpovinnédate

newDueDatenull | stringpovinnédate

daysOverdueintegerpovinné

outstandingHalerintegerpovinné

interestHalerintegerpovinné

ratePercentnull | numberpovinné

subjectstringpovinné

bodystringpovinné

sentAtnull | stringpovinnédate-time

fileIdnull | stringpovinné

POST/v1/sales/reminders/{id}/send

curl -X POST https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/reminders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/send",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Send the reminders due by today under each contact's reminder settings, in this workspace; safe to repeat. Sends nothing when e-mail is not configured

POST/v1/sales/reminders/run-due

Send the reminders due by today under each contact's reminder settings, in this workspace; safe to repeat. Sends nothing when e-mail is not configured

Nástroj MCP: run-due-reminders

Tělo požadavku

asOfstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

emailConfiguredbooleanpovinné

checkedintegerpovinné

sentintegerpovinné

skippedintegerpovinné

noEmailintegerpovinné

failedintegerpovinné

errorsobject[]povinné

invoiceIdnull | stringpovinné

stagestringpovinné

errornull | stringpovinné

POST/v1/sales/reminders/run-due

curl -X POST https://api.damedoklad.cz/v1/sales/reminders/run-due \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asOf": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/reminders/run-due', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "asOf": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/reminders/run-due",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "asOf": "2026-10-30"
    },
)
data = response.json()

Get seller details and invoicing defaults printed on documents

GET/v1/sales/settings

Get seller details and invoicing defaults printed on documents

Nástroj MCP: get-sales-settings

Odpověď · 200

idnull | stringpovinné

vatPayerbooleanpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

phonenull | stringpovinné

emailnull | stringpovinné

webstring | nullpovinné

registrationstring | nullpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

hasLogobooleanpovinné

defaultDueDaysintegerpovinné

replyTonull | stringpovinné

documentFooterstring | nullpovinné

autoAdvanceTaxDocumentbooleanpovinné

missingstring[]povinné

autoConsumeOrdersboolean

GET/v1/sales/settings

curl https://api.damedoklad.cz/v1/sales/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/sales/settings', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/sales/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Update seller address, bank account, VAT payer status, and invoicing defaults

PUT/v1/sales/settings

Update seller address, bank account, VAT payer status, and invoicing defaults

Nástroj MCP: update-sales-settings

Tělo požadavku

autoConsumeOrdersboolean

Issuing an invoice or a delivery note takes open received orders of the same customer and item, oldest first.

vatPayerboolean

dicstring | null

VAT number (DIČ), for example CZ12345678.

streetstring | null

citystring | null

postalCodestring | null

countrystring2 chars

phonestring | null

emailstring | null

webstring | null

registrationstring | null

accountNumberstring | null

Account number from the chart of accounts, for example 311. list-accounts lists them.

bankCodestring | null

ibanstring | null

IBAN without spaces.

defaultDueDaysintegermin 0max 365

replyTostring | null

Date as YYYY-MM-DD.

documentFooterstring | null

autoAdvanceTaxDocumentboolean

Odpověď · 200

idnull | stringpovinné

vatPayerbooleanpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

phonenull | stringpovinné

emailnull | stringpovinné

webstring | nullpovinné

registrationstring | nullpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

hasLogobooleanpovinné

defaultDueDaysintegerpovinné

replyTonull | stringpovinné

documentFooterstring | nullpovinné

autoAdvanceTaxDocumentbooleanpovinné

missingstring[]povinné

autoConsumeOrdersboolean

PUT/v1/sales/settings

curl -X PUT https://api.damedoklad.cz/v1/sales/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "autoConsumeOrders": false,
  "vatPayer": false,
  "dic": "CZ12345678"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/settings', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "autoConsumeOrders": false,
    "vatPayer": false,
    "dic": "CZ12345678"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/sales/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "autoConsumeOrders": False,
        "vatPayer": False,
        "dic": "CZ12345678"
    },
)
data = response.json()

Upload the logo printed on documents (PNG or JPEG, up to 1 MB)

POST/v1/sales/settings/logo

Upload the logo printed on documents (PNG or JPEG, up to 1 MB)

Nástroj MCP: upload-sales-logo

Tělo požadavku

fileBase64stringpovinné

File content encoded as base64.

contentType"image/png" | "image/jpeg"povinné

Odpověď · 200

idnull | stringpovinné

vatPayerbooleanpovinné

namenull | stringpovinné

iconull | stringpovinné

dicnull | stringpovinné

streetnull | stringpovinné

citynull | stringpovinné

postalCodenull | stringpovinné

countrystringpovinné

phonenull | stringpovinné

emailnull | stringpovinné

webstring | nullpovinné

registrationstring | nullpovinné

accountNumbernull | stringpovinné

bankCodenull | stringpovinné

ibannull | stringpovinné

hasLogobooleanpovinné

defaultDueDaysintegerpovinné

replyTonull | stringpovinné

documentFooterstring | nullpovinné

autoAdvanceTaxDocumentbooleanpovinné

missingstring[]povinné

autoConsumeOrdersboolean

POST/v1/sales/settings/logo

curl -X POST https://api.damedoklad.cz/v1/sales/settings/logo \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string",
  "contentType": "image/png"
}'

const response = await fetch('https://api.damedoklad.cz/v1/sales/settings/logo', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string",
    "contentType": "image/png"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/sales/settings/logo",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string",
        "contentType": "image/png"
    },
)
data = response.json()

List mutual set-offs (vzájemné zápočty)

GET/v1/set-offs

List mutual set-offs (vzájemné zápočty)

Nástroj MCP: list-set-offs

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

contactIdstring

ID of the contact. Find it with list-contacts.

status"posted" | "storno"

Odpověď · 200

dataobject[]povinné

object"set_off"povinné

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamestringpovinné

setOffOnstringpovinnédate

basisstringpovinné

currencystringpovinné

exchangeRatenull | numberpovinné

amountHalerintegerpovinné

notestring | nullpovinné

statusstringpovinné

createdAtstringpovinnédate-time

itemsobject[]povinné

object"set_off_item"povinné

idstringpovinné

sidestringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

documentTotalHalerintegerpovinné

amountHalerintegerpovinné

remainingHalerintegerpovinné

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamestringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/set-offs

curl https://api.damedoklad.cz/v1/set-offs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/set-offs', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/set-offs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set off receivables and payables of one contact. Each document shows as settled in that amount; 395 ends on zero

POST/v1/set-offs

Set off receivables and payables of one contact. Each document shows as settled in that amount; 395 ends on zero. Amounts may be left out: the smaller side goes in whole and the other covers it, oldest due date first. VAT does not change. A declaration needs our claim to be due (§ 1982 OZ); an agreement does not. The answer lists warnings about an unreliable VAT payer among the supplier's invoices and advances (§ 109 ZDPH), as a payment order does, without the account check; they never block.

Nástroj MCP: create-set-off

Tělo požadavku

contactIdstringpovinné

ID of the contact. Find it with list-contacts.

seriesIdstring

A number series of type set_off. Left out: the default series of the year.

setOffOnstringpovinnéYYYY-MM-DD

The day of the set-off. Under § 1982 OZ it takes effect when both claims became eligible; the books use this date.

basis"agreement" | "declaration"

agreement (default): both sides sign, not-yet-due claims allowed. declaration: one-sided under § 1982 OZ, our claim must be due.

exchangeRatenumber

For a foreign currency: CZK for one unit. Left out: the ČNB rate of the day.

notestring | null

itemsobject[]povinné

documentIdstringpovinné

ID of the document.

amountHalerintegermax 9007199254740991

How much of this document to set off. Left out: the side with less goes in whole and the other covers it, oldest due date first.

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamestringpovinné

setOffOnstringpovinnédate

basisstringpovinné

currencystringpovinné

exchangeRatenull | numberpovinné

amountHalerintegerpovinné

notestring | nullpovinné

statusstringpovinné

createdAtstringpovinnédate-time

itemsobject[]povinné

object"set_off_item"povinné

idstringpovinné

sidestringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

documentTotalHalerintegerpovinné

amountHalerintegerpovinné

remainingHalerintegerpovinné

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamestringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

POST/v1/set-offs

curl -X POST https://api.damedoklad.cz/v1/set-offs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "setOffOn": "2026-10-30",
  "items": [
    {
      "kind": "invoice",
      "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
    {
      "kind": "invoice",
      "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/set-offs', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "setOffOn": "2026-10-30",
    "items": [
      {
        "kind": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      },
      {
        "kind": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/set-offs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "setOffOn": "2026-10-30",
        "items": [
            {
                "kind": "invoice",
                "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            },
            {
                "kind": "invoice",
                "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Get a set-off with its documents

GET/v1/set-offs/{id}

Get a set-off with its documents

Nástroj MCP: get-set-off

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamestringpovinné

setOffOnstringpovinnédate

basisstringpovinné

currencystringpovinné

exchangeRatenull | numberpovinné

amountHalerintegerpovinné

notestring | nullpovinné

statusstringpovinné

createdAtstringpovinnédate-time

itemsobject[]povinné

object"set_off_item"povinné

idstringpovinné

sidestringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

documentTotalHalerintegerpovinné

amountHalerintegerpovinné

remainingHalerintegerpovinné

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamestringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

GET/v1/set-offs/{id}

curl https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download the printed set-off agreement or declaration, ready to sign

GET/v1/set-offs/{id}/pdf

Download the printed set-off agreement or declaration, ready to sign

Nástroj MCP: download-set-off-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/set-offs/{id}/pdf

curl https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Cancel a set-off: its payments come off the documents and what they posted is reversed

POST/v1/set-offs/{id}/storno

Cancel a set-off: its payments come off the documents and what they posted is reversed

Nevratná operaceTato operace se nedá vrátit. MCP klienti se před ní ptají na potvrzení.

Nástroj MCP: storno-set-off

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamestringpovinné

setOffOnstringpovinnédate

basisstringpovinné

currencystringpovinné

exchangeRatenull | numberpovinné

amountHalerintegerpovinné

notestring | nullpovinné

statusstringpovinné

createdAtstringpovinnédate-time

itemsobject[]povinné

object"set_off_item"povinné

idstringpovinné

sidestringpovinné

kindstringpovinné

documentIdstringpovinné

documentNumbernull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

documentTotalHalerintegerpovinné

amountHalerintegerpovinné

remainingHalerintegerpovinné

warningsobject[]

receivedInvoiceIdnull | stringpovinné

numberstringpovinné

contactNamestringpovinné

statusnull | stringpovinné

warningsobject[]povinné

codenull | stringpovinné

levelstringpovinné

reasonnull | stringpovinné

liabilitystring

POST/v1/set-offs/{id}/storno

curl -X POST https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/set-offs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()