Agendas

Operace ve skupině Agendas.

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

GET/v1/agendas/enp/batches
POST/v1/agendas/enp/batches
DEL/v1/agendas/enp/batches/{id}
GET/v1/agendas/enp/batches/{id}/csv
GET/v1/agendas/enp/documents
GET/v1/agendas/enp/recognition
PUT/v1/agendas/enp/recognition
POST/v1/bulk/contact-processing-reason
POST/v1/bulk/edit-contacts
POST/v1/bulk/edit-documents
POST/v1/bulk/email
POST/v1/bulk/export
POST/v1/bulk/invoice-contacts
POST/v1/bulk/issue
GET/v1/bulk/jobs
POST/v1/bulk/jobs
GET/v1/bulk/jobs/{id}
GET/v1/bulk/jobs/{id}/file
POST/v1/bulk/match-payments
POST/v1/bulk/match-payments/confirm
POST/v1/bulk/match-payments/preview
POST/v1/bulk/pdf-zip
GET/v1/carriers
POST/v1/carriers
PATCH/v1/carriers/{id}
DEL/v1/carriers/{id}
GET/v1/complaints
POST/v1/complaints
GET/v1/complaints/{id}
PATCH/v1/complaints/{id}
POST/v1/complaints/{id}/cancel
GET/v1/complaints/{id}/pdf
POST/v1/complaints/{id}/resolve
POST/v1/complaints/{id}/start
GET/v1/complaints/settings
PUT/v1/complaints/settings
PATCH/v1/contact-activities/{id}
DEL/v1/contact-activities/{id}
POST/v1/contact-activities/{id}/check
PATCH/v1/contact-processing-reasons/{id}
DEL/v1/contact-processing-reasons/{id}
GET/v1/contacts/{id}/activities
POST/v1/contacts/{id}/activities
GET/v1/contacts/{id}/gdpr
POST/v1/contacts/{id}/gdpr/reasons
POST/v1/contacts/{id}/gdpr/restriction
POST/v1/contacts/mail-merge
GET/v1/contacts/mailings
POST/v1/contacts/mailings
GET/v1/contacts/mailings/{id}
POST/v1/contacts/mailings/preview
GET/v1/contacts/sms
POST/v1/contacts/sms
POST/v1/contacts/sms/preview
GET/v1/contacts/sms/status
PATCH/v1/contract-amendments/{id}
DEL/v1/contract-amendments/{id}
GET/v1/contracts
POST/v1/contracts
GET/v1/contracts/{id}
PATCH/v1/contracts/{id}
DEL/v1/contracts/{id}
POST/v1/contracts/{id}/amendments
GET/v1/custom-fields
POST/v1/custom-fields
PATCH/v1/custom-fields/{id}
DEL/v1/custom-fields/{id}
PUT/v1/custom-fields/values/{entity}/{id}
GET/v1/documents
POST/v1/documents
GET/v1/documents/{id}
PATCH/v1/documents/{id}
DEL/v1/documents/{id}
GET/v1/documents/{id}/download
GET/v1/documents/retention-holds
POST/v1/documents/retention-holds
POST/v1/documents/retention-holds/{id}/release
GET/v1/documents/retention-rules
GET/v1/gdpr/contacts
GET/v1/gdpr/reasons
POST/v1/gdpr/reasons
PATCH/v1/gdpr/reasons/{id}
DEL/v1/gdpr/reasons/{id}
POST/v1/inbox/documents/{id}/approval
GET/v1/intrastat/credits
GET/v1/intrastat/declarations
POST/v1/intrastat/declarations
GET/v1/intrastat/declarations/{id}
DEL/v1/intrastat/declarations/{id}
GET/v1/intrastat/declarations/{id}/csv
POST/v1/intrastat/declarations/{id}/file
POST/v1/intrastat/declarations/{id}/lines
PATCH/v1/intrastat/declarations/{id}/lines/{lineId}
DEL/v1/intrastat/declarations/{id}/lines/{lineId}
POST/v1/intrastat/declarations/{id}/regenerate
POST/v1/intrastat/declarations/{id}/reopen
PUT/v1/intrastat/defaults
GET/v1/intrastat/documents/{kind}/{id}
PUT/v1/intrastat/documents/{kind}/{id}
GET/v1/intrastat/items/{itemId}
PUT/v1/intrastat/items/{itemId}
GET/v1/intrastat/status
GET/v1/invoice-approvals
GET/v1/invoice-approvals/{id}
POST/v1/invoice-approvals/{id}/approve
POST/v1/invoice-approvals/{id}/reject
GET/v1/invoice-approvals/approvers
GET/v1/invoice-approvals/delegations
POST/v1/invoice-approvals/delegations
DEL/v1/invoice-approvals/delegations/{id}
GET/v1/invoice-approvals/scenarios
POST/v1/invoice-approvals/scenarios
PATCH/v1/invoice-approvals/scenarios/{id}
DEL/v1/invoice-approvals/scenarios/{id}
GET/v1/invoice-approvals/settings
PUT/v1/invoice-approvals/settings
GET/v1/job-orders
POST/v1/job-orders
GET/v1/job-orders/{id}
PATCH/v1/job-orders/{id}
DEL/v1/job-orders/{id}
POST/v1/job-orders/{id}/documents
GET/v1/job-orders/report
GET/v1/print-template
PUT/v1/print-template
GET/v1/print-template/catalog
POST/v1/print-template/check
GET/v1/print-template/images
GET/v1/print-template/images/{id}
POST/v1/print-template/labels
GET/v1/print-template/layouts/{documentType}
PUT/v1/print-template/layouts/{documentType}
DEL/v1/print-template/layouts/{documentType}
POST/v1/print-template/postal-order
POST/v1/print-template/preview
POST/v1/print-template/print
GET/v1/print-template/variants
POST/v1/print-template/variants
GET/v1/print-template/variants/{id}
PUT/v1/print-template/variants/{id}
DEL/v1/print-template/variants/{id}
POST/v1/received-invoices/{id}/approval
POST/v1/sales/documents/{id}/approval
GET/v1/saved-reports
POST/v1/saved-reports
GET/v1/saved-reports/{id}
PATCH/v1/saved-reports/{id}
DEL/v1/saved-reports/{id}
GET/v1/saved-reports/{id}/export
GET/v1/saved-reports/{id}/run
GET/v1/saved-reports/catalog
POST/v1/saved-reports/export
POST/v1/saved-reports/run
GET/v1/service-jobs
POST/v1/service-jobs
GET/v1/service-jobs/{id}
PATCH/v1/service-jobs/{id}
DEL/v1/service-jobs/{id}
POST/v1/service-jobs/{id}/close
POST/v1/service-jobs/{id}/invoice
POST/v1/service-jobs/{id}/parts
DEL/v1/service-jobs/{id}/parts/{childId}
GET/v1/service-jobs/{id}/pdf
POST/v1/service-jobs/{id}/status
POST/v1/service-jobs/{id}/work
DEL/v1/service-jobs/{id}/work/{childId}
GET/v1/shipments
POST/v1/shipments
GET/v1/shipments/{id}
PATCH/v1/shipments/{id}
DEL/v1/shipments/{id}
POST/v1/shipments/carrier/labels
POST/v1/shipments/carrier/status
POST/v1/shipments/carrier/submit
POST/v1/shipments/envelopes
POST/v1/shipments/export
POST/v1/shipments/generate
POST/v1/shipments/labels
POST/v1/shipments/postal-report
POST/v1/shipments/status-import
POST/v1/supplier-advances/{id}/approval
GET/v1/tasks

List batches of evidence náhradního plnění

GET/v1/agendas/enp/batches

List batches of evidence náhradního plnění

Nástroj MCP: list-enp-batches

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"enp_batch"povinné

idstringpovinné

namenull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

lineCountintegerpovinné

totalHalerinteger | nullpovinné

linesobject[]povinné

documentTypenull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

amountHalerinteger | nullpovinné

deliveredOnnull | stringpovinnédate

paidOnnull | stringpovinnédate

customerIconull | stringpovinné

customerBirthNumberstring | nullpovinné

customerEmailnull | stringpovinné

deadlinestringpovinnédate

problemsstring[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/agendas/enp/batches

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

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/batches', {
  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/agendas/enp/batches",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save paid documents as a batch. Each keeps the data as it is now: a later change to the document does not reach the batch. A delivery outside the recorded basis (§ 78) stops it

POST/v1/agendas/enp/batches

Save paid documents as a batch. Each keeps the data as it is now: a later change to the document does not reach the batch. A delivery outside the recorded basis (§ 78) stops it

Nástroj MCP: create-enp-batch

Tělo požadavku

namestringpovinnémax 120 chars

documentsobject[]povinné

documentType"invoice" | "pos_receipt" | "other_receivable" | "cash_receipt" | "proforma"povinné

documentIdstringpovinné

ID of the document.

amountHalerintegermax 9007199254740991

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

deliveredOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

overrideRecognitionboolean

Odpověď · 201

idstringpovinné

namenull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

lineCountintegerpovinné

totalHalerinteger | nullpovinné

linesobject[]povinné

documentTypenull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

amountHalerinteger | nullpovinné

deliveredOnnull | stringpovinnédate

paidOnnull | stringpovinnédate

customerIconull | stringpovinné

customerBirthNumberstring | nullpovinné

customerEmailnull | stringpovinné

deadlinestringpovinnédate

problemsstring[]povinné

POST/v1/agendas/enp/batches

curl -X POST https://api.damedoklad.cz/v1/agendas/enp/batches \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "documents": [
    {
      "documentType": "invoice",
      "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/batches', {
  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.",
    "documents": [
      {
        "documentType": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/agendas/enp/batches",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "documents": [
            {
                "documentType": "invoice",
                "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Delete a batch not yet exported, so its invoices are offered again

DELETE/v1/agendas/enp/batches/{id}

Delete a batch not yet exported, so its invoices are offered again

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

Nástroj MCP: delete-enp-batch

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namenull | stringpovinné

exportedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

lineCountintegerpovinné

totalHalerinteger | nullpovinné

linesobject[]povinné

documentTypenull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

amountHalerinteger | nullpovinné

deliveredOnnull | stringpovinnédate

paidOnnull | stringpovinnédate

customerIconull | stringpovinné

customerBirthNumberstring | nullpovinné

customerEmailnull | stringpovinné

deadlinestringpovinnédate

problemsstring[]povinné

DELETE/v1/agendas/enp/batches/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/batches/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/agendas/enp/batches/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download the CSV for the Ministry’s bulk import: CP 1250, semicolons, its own header. Refused while a line would be rejected

GET/v1/agendas/enp/batches/{id}/csv

Download the CSV for the Ministry’s bulk import: CP 1250, semicolons, its own header. Refused while a line would be rejected

Nástroj MCP: export-enp-batch

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor text/csv; charset=windows-1250.

GET/v1/agendas/enp/batches/{id}/csv

curl https://api.damedoklad.cz/v1/agendas/enp/batches/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/batches/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv', {
  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/agendas/enp/batches/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Paid invoices, till receipts, cash receipts and advances not yet in a náhradní plnění batch, with the amount without VAT and the 30-day deadline

GET/v1/agendas/enp/documents

Paid invoices, till receipts, cash receipts and advances not yet in a náhradní plnění batch, with the amount without VAT and the 30-day deadline

Nástroj MCP: list-enp-documents

Parametry dotazu

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

documentTypenull | stringpovinné

documentIdnull | stringpovinné

documentNumbernull | stringpovinné

amountHalerinteger | nullpovinné

deliveredOnnull | stringpovinnédate

paidOnnull | stringpovinnédate

customerIconull | stringpovinné

customerBirthNumberstring | nullpovinné

customerEmailnull | stringpovinné

deadlinestringpovinnédate

problemsstring[]povinné

contactNamenull | stringpovinné

overduebooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/agendas/enp/documents

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

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/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/agendas/enp/documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

On what basis the company supplies náhradní plnění (§ 81 odst. 2 písm. b), § 78 zákona o zaměstnanosti), and until when

GET/v1/agendas/enp/recognition

On what basis the company supplies náhradní plnění (§ 81 odst. 2 písm. b), § 78 zákona o zaměstnanosti), and until when

Nástroj MCP: get-enp-recognition

Odpověď · 200

recordedbooleanpovinné

validTodaybooleanpovinné

basisnull | stringpovinné

referencenull | stringpovinné

officeanypovinné

Null in every recorded response.

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

GET/v1/agendas/enp/recognition

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

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/recognition', {
  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/agendas/enp/recognition",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record the agreement with the Labour Office, or that the company is a self-employed person with a disability or an integrating social enterprise. A batch then checks each delivery against it

PUT/v1/agendas/enp/recognition

Record the agreement with the Labour Office, or that the company is a self-employed person with a disability or an integrating social enterprise. A batch then checks each delivery against it. The Ministry offers no interface to ask whether a company is recognised, so this is what the company states: nothing here reaches or confirms anything at the Labour Office.

Nástroj MCP: set-enp-recognition

Tělo požadavku

basis"agreement_78" | "self_employed_disabled" | "integration_enterprise"povinné

referencestring | null

officestring | null

validFromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

Odpověď · 200

recordedbooleanpovinné

validTodaybooleanpovinné

basisnull | stringpovinné

referencenull | stringpovinné

officeanypovinné

Null in every recorded response.

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

PUT/v1/agendas/enp/recognition

curl -X PUT https://api.damedoklad.cz/v1/agendas/enp/recognition \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "basis": "agreement_78",
  "validFrom": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/agendas/enp/recognition', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "basis": "agreement_78",
    "validFrom": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/agendas/enp/recognition",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "basis": "agreement_78",
        "validFrom": "2026-10-30"
    },
)
data = response.json()

Give many contacts the same reason for processing at once

POST/v1/bulk/contact-processing-reason

Give many contacts the same reason for processing at once

Nástroj MCP: bulk-add-contact-processing-reason

Tělo požadavku

idsstring[]povinné

purposestringmax 200 chars

validFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

reasonIdstring

A reason from the company list (GET /gdpr/reasons). It fills legal basis, purpose, and the end date from its length. Without it, name legalBasis and purpose.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/contact-processing-reason

curl -X POST https://api.damedoklad.cz/v1/bulk/contact-processing-reason \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

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

import os
import requests

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

Change a field on many contacts at once, or add them to a group or take them out. Documents already issued keep the details they were issued with

POST/v1/bulk/edit-contacts

Change a field on many contacts at once, or add them to a group or take them out. Documents already issued keep the details they were issued with

Nástroj MCP: bulk-edit-contacts

Tělo požadavku

idsstring[]povinné

changesobjectpovinné

roles"customer" | "supplier" | "both"

usualDueDaysinteger | null

invoiceLanguage"cs" | "en" | "sk" | "de" | "fr" | "pl" | null

defaultCurrencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

creditWarnHalerinteger | null

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

creditBlockHalerinteger | null

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

reminderOnDueboolean

reminderWeekAfterboolean

reminder14DaysAfterboolean

reminderMonthAfterboolean

addGroupIdstring

ID of the add group.

removeGroupIdstring

ID of the remove group.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/edit-contacts

curl -X POST https://api.damedoklad.cz/v1/bulk/edit-contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "changes": {
    "roles": "customer",
    "usualDueDays": 0,
    "preferredPaymentMethod": "transfer"
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/edit-contacts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "changes": {
      "roles": "customer",
      "usualDueDays": 0,
      "preferredPaymentMethod": "transfer"
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/edit-contacts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "changes": {
            "roles": "customer",
            "usualDueDays": 0,
            "preferredPaymentMethod": "transfer"
        }
    },
)
data = response.json()

Change a field on many documents at once (POHODA Upravit vše). A draft takes all of them; past draft only the due date and notes, and anything else fails for that document

POST/v1/bulk/edit-documents

Change a field on many documents at once (POHODA Upravit vše). A draft takes all of them; past draft only the due date and notes, and anything else fails for that document. Each document goes through its own update, with its own rules. Amounts, dates, and the partner are not offered: a document already issued keeps what it said.

Nástroj MCP: bulk-edit-documents

Tělo požadavku

idsstring[]povinné

changesobjectpovinné

dueDatestring | null

Date as YYYY-MM-DD.

notePublicstring | null

noteInternalstring | null

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

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

centerIdstring | null

ID of the center.

activityIdstring | null

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

projectIdstring | null

ID of the project.

templateIdstring | null

ID of the template.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/edit-documents

curl -X POST https://api.damedoklad.cz/v1/bulk/edit-documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "changes": {
    "dueDate": "2026-10-30",
    "notePublic": "string",
    "noteInternal": "string"
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/edit-documents', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "changes": {
      "dueDate": "2026-10-30",
      "notePublic": "string",
      "noteInternal": "string"
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/edit-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "changes": {
            "dueDate": "2026-10-30",
            "notePublic": "string",
            "noteInternal": "string"
        }
    },
)
data = response.json()

E-mail many issued documents to their customers, each with its PDF. Uses each contact e-mail and the document type template

POST/v1/bulk/email

E-mail many issued documents to their customers, each with its PDF. Uses each contact e-mail and the document type template

Nástroj MCP: bulk-email-documents

Tělo požadavku

idsstring[]povinné

subjectstringmax 300 chars

bodystringmax 10000 chars

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/email

curl -X POST https://api.damedoklad.cz/v1/bulk/email \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/email', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/email",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Export the selected documents as a table: format=xlsx or csv

POST/v1/bulk/export

Export the selected documents as a table: format=xlsx or csv

Nástroj MCP: bulk-export-documents

Tělo požadavku

idsstring[]povinné

format"csv" | "xlsx"

Odpověď · 200

Vrací soubor application/octet-stream.

POST/v1/bulk/export

curl -X POST https://api.damedoklad.cz/v1/bulk/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/bulk/export', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Hromadná fakturace: create one invoice, proforma, quote, or order per contact from the same lines or a sample document. Drafts unless issue=true; each answers on its own

POST/v1/bulk/invoice-contacts

Hromadná fakturace: create one invoice, proforma, quote, or order per contact from the same lines or a sample document. Drafts unless issue=true; each answers on its own. At most 200 at once here: createBulkJob runs more through the queue. Each document takes its address, due days, and language from its contact, and goes through the same rules as one made by hand, including the credit limit when issued.

Nástroj MCP: bulk-invoice-contacts

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

kind"invoice" | "proforma" | "quote" | "order_received" | "order_issued"

Issued invoice (default), proforma, quote, received order or issued order.

sampleIdstring

A draft or issued document to copy lines and terms from, as in POHODA. Its own contact is ignored.

linesobject[]

descriptionstringpovinnémax 200 chars

quantitynumberpovinné

unitstringmax 16 chars

unitPriceHalerintegerpovinnémin -9007199254740991max 9007199254740991

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

vatRatenumbermin 0max 30

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

dueDaysintegermin 0max 2000

Left out: each contact's own usual due days.

seriesIdstring

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

notePublicstring | null

issueboolean

Issue each one at once. Default: leave them as drafts to check first.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/invoice-contacts

curl -X POST https://api.damedoklad.cz/v1/bulk/invoice-contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactIds": [
    "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "kind": "invoice"
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/invoice-contacts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactIds": [
      "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "kind": "invoice"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/invoice-contacts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactIds": [
            "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "kind": "invoice"
    },
)
data = response.json()

Issue many draft documents at once. Each one is numbered and posted on its own; the answer lists successes and failures

POST/v1/bulk/issue

Issue many draft documents at once. Each one is numbered and posted on its own; the answer lists successes and failures. A document over Kredit max fails with credit_limit_exceeded while the rest go on. An owner or accountant may then send those ids again with overrideCreditLimit.

Nástroj MCP: bulk-issue-documents

Tělo požadavku

idsstring[]povinné

overrideCreditLimitboolean

Issue although the customer goes over Kredit max. Owner or accountant only, after the user has seen which documents failed for it.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/issue

curl -X POST https://api.damedoklad.cz/v1/bulk/issue \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/issue",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

List bulk jobs running in the background and how they ended, newest first

GET/v1/bulk/jobs

List bulk jobs running in the background and how they ended, newest first

Nástroj MCP: list-bulk-jobs

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"queued" | "running" | "done" | "failed"

Odpověď · 200

dataobject[]povinné

object"bulk_job"povinné

idstringpovinné

operationstringpovinné

statusstringpovinné

totalintegerpovinné

processedintegerpovinné

succeededintegerpovinné

failedintegerpovinné

resultsobject[]povinné

idstringpovinné

okbooleanpovinné

numbernull | string

statusstring

codenull | string

errornull | string

fileIdnull | stringpovinné

filenamenull | stringpovinné

errorstring | nullpovinné

startedAtnull | stringpovinnédate-time

finishedAtnull | stringpovinnédate-time

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/bulk/jobs

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

const response = await fetch('https://api.damedoklad.cz/v1/bulk/jobs', {
  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/bulk/jobs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Run a bulk operation on any number of documents in the background, up to 20 000. Answers at once with a job to watch; each document still stands on its own

POST/v1/bulk/jobs

Run a bulk operation on any number of documents in the background, up to 20 000. Answers at once with a job to watch; each document still stands on its own. Takes the same body as the operation it names. getBulkJob tells how far it got and what happened to each. PDFs in a ZIP and exports end as a file: downloadBulkJobFile.

Nástroj MCP: create-bulk-job

Tělo požadavku

bodyobjectpovinné

What the operation of that name takes: /bulk/issue, /bulk/email, /bulk/match-payments, /bulk/edit-documents, /bulk/invoice-contacts, /bulk/pdf-zip or /bulk/export. Up to 20 000 documents.

Odpověď · 202

idstringpovinné

operationstringpovinné

statusstringpovinné

totalintegerpovinné

processedintegerpovinné

succeededintegerpovinné

failedintegerpovinné

resultsobject[]povinné

idstringpovinné

okbooleanpovinné

numbernull | string

statusstring

codenull | string

errornull | string

fileIdnull | stringpovinné

filenamenull | stringpovinné

errorstring | nullpovinné

startedAtnull | stringpovinnédate-time

finishedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

POST/v1/bulk/jobs

curl -X POST https://api.damedoklad.cz/v1/bulk/jobs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "operation": "issue",
  "body": {}
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/jobs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "operation": "issue",
        "body": {}
    },
)
data = response.json()

How far a bulk job got, and what happened to each document so far

GET/v1/bulk/jobs/{id}

How far a bulk job got, and what happened to each document so far

Nástroj MCP: get-bulk-job

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

operationstringpovinné

statusstringpovinné

totalintegerpovinné

processedintegerpovinné

succeededintegerpovinné

failedintegerpovinné

resultsobject[]povinné

idstringpovinné

okbooleanpovinné

numbernull | string

statusstring

codenull | string

errornull | string

fileIdnull | stringpovinné

filenamenull | stringpovinné

errorstring | nullpovinné

startedAtnull | stringpovinnédate-time

finishedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

GET/v1/bulk/jobs/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/bulk/jobs/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/bulk/jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download the ZIP or the table a finished bulk job made

GET/v1/bulk/jobs/{id}/file

Download the ZIP or the table a finished bulk job made

Nástroj MCP: download-bulk-job-file

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/bulk/jobs/{id}/file

curl https://api.damedoklad.cz/v1/bulk/jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/bulk/jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file', {
  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/bulk/jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Settle many documents at once: pair each with its one exact bank movement, or with mode=manual record it as paid on a date

POST/v1/bulk/match-payments

Settle many documents at once: pair each with its one exact bank movement, or with mode=manual record it as paid on a date. Bank mode pairs only when exactly one open movement has the same direction, currency, amount, and variable symbol. Anything else is reported, never guessed.

Nástroj MCP: bulk-match-payments

Tělo požadavku

idsstring[]povinné

mode"bank" | "manual"

paidOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

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

registerIdstring

ID of the register.

bankAccountIdstring

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

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/match-payments

curl -X POST https://api.damedoklad.cz/v1/bulk/match-payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/match-payments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/match-payments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Pair the documents and bank movements a person accepted in the review. Each pair posts on its own and answers on its own

POST/v1/bulk/match-payments/confirm

Pair the documents and bank movements a person accepted in the review. Each pair posts on its own and answers on its own

Nástroj MCP: confirm-bulk-match

Tělo požadavku

pairsobject[]povinné

idstringpovinné

movementIdstringpovinné

ID of the movement. Find it with list-movements.

amountHalerintegermax 9007199254740991

How much of the movement goes to this document. Left out: as much as both still have open.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/bulk/match-payments/confirm

curl -X POST https://api.damedoklad.cz/v1/bulk/match-payments/confirm \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "pairs": [
    {
      "id": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/match-payments/confirm', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "pairs": [
      {
        "id": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/match-payments/confirm",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "pairs": [
            {
                "id": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "movementId": "mov_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
            }
        ]
    },
)
data = response.json()

Propose bank movements for many documents, for a person to review: best match first, with why it fits. Pairs nothing

POST/v1/bulk/match-payments/preview

Propose bank movements for many documents, for a person to review: best match first, with why it fits. Pairs nothing. Goes beyond one exact match: part payments, a number in the message, a known account, and more than one candidate. confirmBulkMatch pairs what the person accepts.

Nástroj MCP: preview-bulk-match

Tělo požadavku

idsstring[]povinné

Odpověď · 200

kindstringpovinné

dataobject[]povinné

idstringpovinné

openbooleanpovinné

numbernull | stringpovinné

contactNamenull | stringpovinné

currencynull | stringpovinné

remainingHalerinteger | nullpovinné

proposedMovementIdanypovinné

Null in every recorded response.

candidatesobject[]povinné

movementIdnull | stringpovinné

bankAccountIdstringpovinné

bookedOnstringpovinnédate

amountHalerinteger | nullpovinné

openHalerintegerpovinné

variableSymbolnull | stringpovinné

counterpartyNamestring | nullpovinné

messagestring | nullpovinné

confidencenull | numberpovinné

reasonnull | stringpovinné

suggestedAmountHalerintegerpovinné

POST/v1/bulk/match-payments/preview

curl -X POST https://api.damedoklad.cz/v1/bulk/match-payments/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/bulk/match-payments/preview', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/match-payments/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Download the PDFs of many documents as one ZIP. A document without a PDF is listed in chyby.txt inside

POST/v1/bulk/pdf-zip

Download the PDFs of many documents as one ZIP. A document without a PDF is listed in chyby.txt inside

Nástroj MCP: bulk-download-pdf

Tělo požadavku

idsstring[]povinné

Odpověď · 200

Vrací soubor application/zip.

POST/v1/bulk/pdf-zip

curl -X POST https://api.damedoklad.cz/v1/bulk/pdf-zip \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/bulk/pdf-zip', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "kind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/bulk/pdf-zip",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Seznam: dopravci

GET/v1/carriers

List carriers (dopravci): each is a preset way of sending, with the file format its shipments export in

Nástroj MCP: list-carriers

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"carrier"povinné

idstringpovinné

namestringpovinné

exportFormatstringpovinné

exportFormatPublishedbooleanpovinné

serviceCodenull | stringpovinné

senderCodenull | stringpovinné

defaultWeightGramsinteger | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

adapternull | string

hasApiPasswordboolean

apiUsernamenull | string

senderAddressRefnull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/carriers

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

const response = await fetch('https://api.damedoklad.cz/v1/carriers', {
  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/carriers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: dopravce

POST/v1/carriers

Add a carrier. Česká pošta exports in its published posting sheet (ePA), Packeta in its packet import; any other carrier in generic CSV, or through its own API (Packeta, PPL, DPD, GLS) where the operator allows

Nástroj MCP: create-carrier

Tělo požadavku

namestringpovinnémax 200 chars

exportFormat"generic" | "ceska_posta_epa" | "packeta_csv"

ceska_posta_epa is the posting sheet Česká pošta publishes, packeta_csv the packet import Packeta publishes. Any other carrier takes generic: our own columns, for the carrier's import to map.

adapter"packeta" | "ppl" | "dpd" | "gls" | null

The carrier's own API, used only where the operator allows live calls.

apiUsernamestring | null

PPL: the client ID. GLS: the MyGLS user name, an e-mail address. Packeta and DPD need none.

apiPasswordstring | null

Packeta: the API password. PPL: the client secret. DPD: the API key. GLS: the MyGLS password. Stored encrypted and never returned.

senderAddressRefstring | null

DPD: the numeric ID of the pick-up address registered at DPD.

serviceCodestring | null

For Česká pošta the services of field 3.13, such as S or S+34. For PPL the product type, such as BUSS.

senderCodestring | null

Packeta: the sender indication. DPD: the customer number (DSW). GLS: the client number.

defaultWeightGramsinteger | null

isActiveboolean

notestring | null

Odpověď · 201

idstringpovinné

namestringpovinné

exportFormatstringpovinné

exportFormatPublishedbooleanpovinné

serviceCodenull | stringpovinné

senderCodenull | stringpovinné

defaultWeightGramsinteger | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

adapternull | string

hasApiPasswordboolean

apiUsernamenull | string

senderAddressRefnull | string

POST/v1/carriers

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

const response = await fetch('https://api.damedoklad.cz/v1/carriers', {
  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."
  }),
});
const data = await response.json();

import os
import requests

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

Úprava: dopravce

PATCH/v1/carriers/{id}

Change a carrier, or set it inactive

Nástroj MCP: update-carrier

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

exportFormat"generic" | "ceska_posta_epa" | "packeta_csv"

ceska_posta_epa is the posting sheet Česká pošta publishes, packeta_csv the packet import Packeta publishes. Any other carrier takes generic: our own columns, for the carrier's import to map.

adapter"packeta" | "ppl" | "dpd" | "gls" | null

The carrier's own API, used only where the operator allows live calls.

apiUsernamestring | null

PPL: the client ID. GLS: the MyGLS user name, an e-mail address. Packeta and DPD need none.

apiPasswordstring | null

Packeta: the API password. PPL: the client secret. DPD: the API key. GLS: the MyGLS password. Stored encrypted and never returned.

senderAddressRefstring | null

DPD: the numeric ID of the pick-up address registered at DPD.

serviceCodestring | null

For Česká pošta the services of field 3.13, such as S or S+34. For PPL the product type, such as BUSS.

senderCodestring | null

Packeta: the sender indication. DPD: the customer number (DSW). GLS: the client number.

defaultWeightGramsinteger | null

isActiveboolean

notestring | null

Odpověď · 200

idstringpovinné

namestringpovinné

exportFormatstringpovinné

exportFormatPublishedbooleanpovinné

serviceCodenull | stringpovinné

senderCodenull | stringpovinné

defaultWeightGramsinteger | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

adapternull | string

hasApiPasswordboolean

apiUsernamenull | string

senderAddressRefnull | string

PATCH/v1/carriers/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/carriers/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.",
    "exportFormat": "generic",
    "adapter": "packeta"
  }),
});
const data = await response.json();

import os
import requests

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

Smazání: dopravce

DELETE/v1/carriers/{id}

Delete a carrier no shipment uses. One that has shipments is set inactive instead

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

Nástroj MCP: delete-carrier

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/carriers/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/carriers/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/carriers/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Seznam: reklamace

GET/v1/complaints

List complaints (reklamace) with their deadline state

Nástroj MCP: list-complaints

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"open" | "in_progress" | "resolved" | "rejected" | "cancelled"

contactIdstring

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

open"true" | "false"

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"complaint"povinné

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/complaints

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints', {
  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/complaints",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: reklamace

POST/v1/complaints

Record a complaint against a sale. For a consumer the 30-day deadline of § 19 zákona 634/1992 Sb. is set automatically

Nástroj MCP: create-complaint

Tělo požadavku

contactIdstring

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

consumerboolean

invoiceIdstring | null

ID of the invoice. Find it with list-invoices.

invoiceLineIdstring | null

ID of the invoice line.

itemIdstring | null

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

subjectstringpovinnémax 200 chars

descriptionstringpovinnémax 4000 chars

requestedResolutionstring | null

quantitynumber | null

deliveredOnstring | null

Date as YYYY-MM-DD.

claimedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

agreedDeadlinestring | null

discoveredOnstring | null

Between businesses: when the buyer could first have found the defect (§ 2112 OZ).

warrantyUntilstring | null

End of a warranty given on the goods (§ 2114, § 2115, § 2117 OZ).

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

POST/v1/complaints

curl -X POST https://api.damedoklad.cz/v1/complaints \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "subject": "string",
  "description": "Pečivo, říjen"
}'

const response = await fetch('https://api.damedoklad.cz/v1/complaints', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "subject": "string",
    "description": "Pečivo, říjen"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/complaints",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "subject": "string",
        "description": "Pečivo, říjen"
    },
)
data = response.json()

Detail: reklamace

GET/v1/complaints/{id}

Get a complaint

Nástroj MCP: get-complaint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

GET/v1/complaints/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints/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/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: reklamace

PATCH/v1/complaints/{id}

Edit an open complaint. Changing the claim date or the agreed deadline recomputes the deadline

Nástroj MCP: update-complaint

Parametry v cestě

idstringpovinné

Tělo požadavku

contactIdstring

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

consumerboolean

invoiceIdstring | null

ID of the invoice. Find it with list-invoices.

invoiceLineIdstring | null

ID of the invoice line.

itemIdstring | null

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

subjectstringmax 200 chars

descriptionstringmax 4000 chars

requestedResolutionstring | null

quantitynumber | null

deliveredOnstring | null

Date as YYYY-MM-DD.

claimedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

agreedDeadlinestring | null

discoveredOnstring | null

Between businesses: when the buyer could first have found the defect (§ 2112 OZ).

warrantyUntilstring | null

End of a warranty given on the goods (§ 2114, § 2115, § 2117 OZ).

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

PATCH/v1/complaints/{id}

curl -X PATCH https://api.damedoklad.cz/v1/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "consumer": false,
  "invoiceId": "inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "consumer": false,
    "invoiceId": "inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "consumer": False,
        "invoiceId": "inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Zrušení: reklamace

POST/v1/complaints/{id}/cancel

Cancel a complaint recorded by mistake

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

Nástroj MCP: cancel-complaint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

POST/v1/complaints/{id}/cancel

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints/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/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Complaint protocol PDF: the intake confirmation of § 19 odst. 2, or the resolution confirmation of § 19 odst. 5

GET/v1/complaints/{id}/pdf

Complaint protocol PDF: the intake confirmation of § 19 odst. 2, or the resolution confirmation of § 19 odst. 5

Nástroj MCP: download-complaint-protocol

Parametry v cestě

idstringpovinné

Parametry dotazu

document"intake" | "resolution"

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

Language of the protocol. Without it, the language set on the contact, then the company default.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/complaints/{id}/pdf

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints/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/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Close a complaint: repair, replacement, refund, discount, or rejection. Refund and discount create a credit note on the sale

POST/v1/complaints/{id}/resolve

Close a complaint: repair, replacement, refund, discount, or rejection. Refund and discount create a credit note on the sale. The credit note stays a draft to check unless issueCreditNote is set. Replacement with a warehouse issues the goods from stock.

Nástroj MCP: resolve-complaint

Parametry v cestě

idstringpovinné

Tělo požadavku

outcome"repair" | "replacement" | "refund" | "discount" | "rejected"povinné

resolvedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

notestringmax 4000 chars

quantitynumbermax 1000000000

discountNetHalerintegermax 9007199254740991

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

issueCreditNoteboolean

replacementWarehouseIdstring

ID of the replacement warehouse.

replacementItemIdstring

ID of the replacement item.

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

POST/v1/complaints/{id}/resolve

curl -X POST https://api.damedoklad.cz/v1/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/resolve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "outcome": "repair"
}'

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

import os
import requests

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

Mark a complaint as being worked on

POST/v1/complaints/{id}/start

Mark a complaint as being worked on

Nástroj MCP: start-complaint

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

consumerbooleanpovinné

invoiceIdnull | stringpovinné

invoiceLineIdnull | stringpovinné

itemIdnull | stringpovinné

subjectstringpovinné

descriptionstringpovinné

requestedResolutionstring | nullpovinné

quantityinteger | nullpovinné

deliveredOnnull | stringpovinnédate

claimedOnstringpovinnédate

agreedDeadlinenull | stringpovinnédate

deadlineOnnull | stringpovinnédate

deadlineobjectpovinné

statestringpovinné

daysLeftinteger | nullpovinné

withinTwoYearsboolean | nullpovinné

statusstringpovinné

outcomenull | stringpovinné

resolvedOnnull | stringpovinnédate

resolutionNotenull | stringpovinné

creditNoteIdnull | stringpovinné

serviceJobIdstring | nullpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

discoveredOnnull | stringdate

warrantyUntilnull | stringdate

businessPeriodsnull | object

hiddenDefectLimitnull | stringpovinnédate

withinHiddenDefectLimitboolean | nullpovinné

daysFromDiscoveryinteger | nullpovinné

warrantyUntilnull | stringpovinnédate

withinWarrantyboolean | nullpovinné

customFieldsobject

invoiceNumberany

Null in every recorded response.

creditNoteNumberany

Null in every recorded response.

creditNoteStatusany

Null in every recorded response.

POST/v1/complaints/{id}/start

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/start', {
  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/complaints/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/start",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Detail: nastavení, reklamace

GET/v1/complaints/settings

How many days the company works to on a complaint between businesses. The law sets no number for them

Nástroj MCP: get-complaint-settings

Odpověď · 200

businessDeadlineDaysinteger | nullpovinné

GET/v1/complaints/settings

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

const response = await fetch('https://api.damedoklad.cz/v1/complaints/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/complaints/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: nastavení, reklamace

PUT/v1/complaints/settings

Set how many days the company works to on a complaint between businesses. An agreed date always wins, and consumers keep their 30 days

Nástroj MCP: update-complaint-settings

Tělo požadavku

businessDeadlineDaysinteger | nullpovinné

Between businesses the law sets no number of days, so the company may choose how many it works to. Null: only an agreed date counts.

Odpověď · 200

businessDeadlineDaysinteger | nullpovinné

PUT/v1/complaints/settings

curl -X PUT https://api.damedoklad.cz/v1/complaints/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "businessDeadlineDays": 1
}'

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

import os
import requests

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

Úprava: aktivita, kontakt

PATCH/v1/contact-activities/{id}

Edit an activity, or mark a task done

Nástroj MCP: update-contact-activity

Parametry v cestě

idstringpovinné

Tělo požadavku

kind"note" | "call" | "meeting" | "task"

subjectstringmax 200 chars

bodystring | null

occurredOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

dueOnstring | null

Date as YYYY-MM-DD.

assignedToIdstring | null

The colleague a task is for. They get an e-mail when it is given to them.

parentIdstring | null

The task this one is a subtask of, on the same contact. A task cannot be finished while a subtask is open.

checkerIdstring | null

The colleague who checks the work. A finished task waits for them, and only their approval completes it.

Repeat: when a task with a due date is completed, the next one appears with its subtasks. Our choice of steps; the Stormware pages we could read do not list POHODA's.

recurrenceUntilstring | null

No further repeat falls due after this day.

remindDaysBeforeinteger | null

Days before the due date to remind the assignee, or the author of an unassigned task, in the bell and by e-mail.

doneboolean

Odpověď · 200

idstringpovinné

contactIdstringpovinné

kindstringpovinné

subjectstringpovinné

bodynull | stringpovinné

occurredOnstringpovinnédate

dueOnnull | stringpovinnédate

donebooleanpovinné

doneAtnull | stringpovinnédate-time

assignedToIdnull | stringpovinné

createdAtstringpovinnédate-time

parentIdnull | string

checkerIdnull | string

checkedboolean

checkedAtnull | stringdate-time

waitingForCheckboolean

recurrencenull | string

recurrenceUntilnull | stringdate

nextTaskIdnull | string

remindDaysBeforeinteger | null

contactNamenull | string

assignedToNamestring

PATCH/v1/contact-activities/{id}

curl -X PATCH https://api.damedoklad.cz/v1/contact-activities/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "note",
  "subject": "string",
  "body": "string"
}'

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/contact-activities/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "kind": "note",
        "subject": "string",
        "body": "string"
    },
)
data = response.json()

Smazání: aktivita, kontakt

DELETE/v1/contact-activities/{id}

Delete an activity

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

Nástroj MCP: delete-contact-activity

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/contact-activities/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contact-activities/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/contact-activities/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

As the checking person, approve a finished task, which completes it and starts its next repeat, or send it back to the assignee

POST/v1/contact-activities/{id}/check

As the checking person, approve a finished task, which completes it and starts its next repeat, or send it back to the assignee. Only the person named as checker, an owner, or an accountant may do this. Sending it back reopens the task and adds the note to its text.

Nástroj MCP: check-contact-task

Parametry v cestě

idstringpovinné

Tělo požadavku

approvedbooleanpovinné

true completes the task. false reopens it and tells the assignee.

notestring | null

Odpověď · 200

idstringpovinné

contactIdstringpovinné

kindstringpovinné

subjectstringpovinné

bodynull | stringpovinné

occurredOnstringpovinnédate

dueOnnull | stringpovinnédate

donebooleanpovinné

doneAtnull | stringpovinnédate-time

assignedToIdnull | stringpovinné

createdAtstringpovinnédate-time

parentIdnull | string

checkerIdnull | string

checkedboolean

checkedAtnull | stringdate-time

waitingForCheckboolean

recurrencenull | string

recurrenceUntilnull | stringdate

nextTaskIdnull | string

remindDaysBeforeinteger | null

contactNamenull | string

assignedToNamestring

POST/v1/contact-activities/{id}/check

curl -X POST https://api.damedoklad.cz/v1/contact-activities/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "approved": false
}'

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

import os
import requests

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

Change a reason for processing, for example end it when consent is withdrawn

PATCH/v1/contact-processing-reasons/{id}

Change a reason for processing, for example end it when consent is withdrawn

Nástroj MCP: update-contact-processing-reason

Parametry v cestě

idstringpovinné

Tělo požadavku

purposestringmax 200 chars

validFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

contactIdstringpovinné

legalBasisstringpovinné

purposestringpovinné

validFromstringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

statestringpovinné

reasonIdnull | string

PATCH/v1/contact-processing-reasons/{id}

curl -X PATCH https://api.damedoklad.cz/v1/contact-processing-reasons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "legalBasis": "consent",
  "purpose": "string",
  "validFrom": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/contact-processing-reasons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "legalBasis": "consent",
    "purpose": "string",
    "validFrom": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/contact-processing-reasons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "legalBasis": "consent",
        "purpose": "string",
        "validFrom": "2026-10-30"
    },
)
data = response.json()

Remove a reason for processing entered by mistake. To end one, set its end date instead, so the history stays

DELETE/v1/contact-processing-reasons/{id}

Remove a reason for processing entered by mistake. To end one, set its end date instead, so the history stays

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

Nástroj MCP: delete-contact-processing-reason

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/contact-processing-reasons/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contact-processing-reasons/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/contact-processing-reasons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Seznam: aktivita, kontakt

GET/v1/contacts/{id}/activities

List the notes, calls, meetings, and tasks of a contact, newest first

Nástroj MCP: list-contact-activities

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.

kind"note" | "call" | "meeting" | "task"

openTasks"true" | "false"

Odpověď · 200

dataobject[]povinné

object"contact_activity"povinné

idstringpovinné

contactIdstringpovinné

kindstringpovinné

subjectstringpovinné

bodynull | stringpovinné

occurredOnstringpovinnédate

dueOnnull | stringpovinnédate

donebooleanpovinné

doneAtnull | stringpovinnédate-time

assignedToIdnull | stringpovinné

createdAtstringpovinnédate-time

parentIdnull | string

checkerIdnull | string

checkedboolean

checkedAtnull | stringdate-time

waitingForCheckboolean

recurrencenull | string

recurrenceUntilnull | stringdate

nextTaskIdnull | string

remindDaysBeforeinteger | null

contactNamenull | string

assignedToNamestring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/contacts/{id}/activities

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/activities', {
  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/activities",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: aktivita, kontakt

POST/v1/contacts/{id}/activities

Add a note, call, meeting, or task to a contact. A task with a due date shows in K vyřízení, and can have subtasks, a checker, a repeat, and a reminder

Nástroj MCP: create-contact-activity

Parametry v cestě

idstringpovinné

Tělo požadavku

kind"note" | "call" | "meeting" | "task"

subjectstringpovinnémax 200 chars

bodystring | null

occurredOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

dueOnstring | null

Date as YYYY-MM-DD.

assignedToIdstring | null

The colleague a task is for. They get an e-mail when it is given to them.

parentIdstring | null

The task this one is a subtask of, on the same contact. A task cannot be finished while a subtask is open.

checkerIdstring | null

The colleague who checks the work. A finished task waits for them, and only their approval completes it.

Repeat: when a task with a due date is completed, the next one appears with its subtasks. Our choice of steps; the Stormware pages we could read do not list POHODA's.

recurrenceUntilstring | null

No further repeat falls due after this day.

remindDaysBeforeinteger | null

Days before the due date to remind the assignee, or the author of an unassigned task, in the bell and by e-mail.

Odpověď · 201

idstringpovinné

contactIdstringpovinné

kindstringpovinné

subjectstringpovinné

bodynull | stringpovinné

occurredOnstringpovinnédate

dueOnnull | stringpovinnédate

donebooleanpovinné

doneAtnull | stringpovinnédate-time

assignedToIdnull | stringpovinné

createdAtstringpovinnédate-time

parentIdnull | string

checkerIdnull | string

checkedboolean

checkedAtnull | stringdate-time

waitingForCheckboolean

recurrencenull | string

recurrenceUntilnull | stringdate

nextTaskIdnull | string

remindDaysBeforeinteger | null

contactNamenull | string

assignedToNamestring

POST/v1/contacts/{id}/activities

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

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

import os
import requests

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

Get the GDPR overview of a contact: reasons for processing and their validity, last use on documents, restriction, unsubscribe

GET/v1/contacts/{id}/gdpr

Get the GDPR overview of a contact: reasons for processing and their validity, last use on documents, restriction, unsubscribe

Nástroj MCP: get-contact-gdpr

Parametry v cestě

idstringpovinné

Odpověď · 200

contactIdnull | stringpovinné

statestringpovinné

restrictedbooleanpovinné

restrictedAtnull | stringpovinnédate-time

marketingOptOutbooleanpovinné

marketingOptOutAtnull | stringpovinnédate-time

reasonsobject[]povinné

object"contact_processing_reason"povinné

idstringpovinné

contactIdstringpovinné

legalBasisstringpovinné

purposestringpovinné

validFromstringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

statestringpovinné

reasonIdnull | string

usageobjectpovinné

lastPreSaleOnnull | stringpovinnédate

lastSaleOnnull | stringpovinnédate

lastPostSaleOnnull | stringpovinnédate

GET/v1/contacts/{id}/gdpr

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gdpr', {
  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/gdpr",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a legal reason for processing the personal data of a contact, picked from the company list or written out, with how long it lasts

POST/v1/contacts/{id}/gdpr/reasons

Add a legal reason for processing the personal data of a contact, picked from the company list or written out, with how long it lasts

Nástroj MCP: add-contact-processing-reason

Parametry v cestě

idstringpovinné

Tělo požadavku

purposestringmax 200 chars

validFromstringYYYY-MM-DD

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

reasonIdstring

A reason from the company list (GET /gdpr/reasons). It fills legal basis, purpose, and the end date from its length. Without it, name legalBasis and purpose.

Odpověď · 201

idstringpovinné

contactIdstringpovinné

legalBasisstringpovinné

purposestringpovinné

validFromstringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

statestringpovinné

reasonIdnull | string

POST/v1/contacts/{id}/gdpr/reasons

curl -X POST https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gdpr/reasons \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "legalBasis": "consent",
  "purpose": "string",
  "validFrom": "2026-10-30"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gdpr/reasons",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "legalBasis": "consent",
        "purpose": "string",
        "validFrom": "2026-10-30"
    },
)
data = response.json()

Restrict processing of a contact (GDPR Art. 18): it leaves the ordinary contact list and cannot go on a new document. Or lift the restriction

POST/v1/contacts/{id}/gdpr/restriction

Restrict processing of a contact (GDPR Art. 18): it leaves the ordinary contact list and cannot go on a new document. Or lift the restriction

Nástroj MCP: restrict-contact-processing

Parametry v cestě

idstringpovinné

Tělo požadavku

restrictedbooleanpovinné

Odpověď · 200

contactIdnull | stringpovinné

statestringpovinné

restrictedbooleanpovinné

restrictedAtnull | stringpovinnédate-time

marketingOptOutbooleanpovinné

marketingOptOutAtnull | stringpovinnédate-time

reasonsobject[]povinné

object"contact_processing_reason"povinné

idstringpovinné

contactIdstringpovinné

legalBasisstringpovinné

purposestringpovinné

validFromstringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

statestringpovinné

reasonIdnull | string

usageobjectpovinné

lastPreSaleOnnull | stringpovinnédate

lastSaleOnnull | stringpovinnédate

lastPostSaleOnnull | stringpovinnédate

POST/v1/contacts/{id}/gdpr/restriction

curl -X POST https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gdpr/restriction \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "restricted": false
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gdpr/restriction",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "restricted": False
    },
)
data = response.json()

Mail merge (hromadná korespondence): a letter per contact as PDF files in a ZIP, format=docx to fill a Word template per contact in a ZIP, or format=csv for the merge data

POST/v1/contacts/mail-merge

Mail merge (hromadná korespondence): a letter per contact as PDF files in a ZIP, format=docx to fill a Word template per contact in a ZIP, or format=csv for the merge data. A Word template marks its places with {{name}} or a Word MERGEFIELD of the same name: name, person, ico, dic, email, phone, street, city, postalCode, companyName. An unknown one is refused, so a typo does not leave a gap in a letter.

Nástroj MCP: contact-mail-merge

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

format"pdf" | "csv" | "docx"

titlestringmax 200 chars

bodystringmax 20000 chars

templateBase64stringmax 14000000 chars

format=docx: a Word template, base64, with {{name}} or Word MERGEFIELD fields of the same names. At most 10 MB.

Odpověď · 200

Vrací soubor application/octet-stream.

POST/v1/contacts/mail-merge

curl -X POST https://api.damedoklad.cz/v1/contacts/mail-merge \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactIds": [
    "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "format": "pdf"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/contacts/mail-merge', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactIds": [
      "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "format": "pdf"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/mail-merge",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactIds": [
            "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "groupId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "format": "pdf"
    },
)
content = response.content

List bulk e-mails sent, newest first, with how many went out

GET/v1/contacts/mailings

List bulk e-mails sent, newest first, with how many went out

Nástroj MCP: list-contact-mailings

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"contact_mailing"povinné

idstringpovinné

purposestringpovinné

subjectstringpovinné

recipientCountintegerpovinné

sentCountintegerpovinné

failedCountintegerpovinné

skippedCountintegerpovinné

resultsobject[]

contactIdnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

statusstringpovinné

reasonnull | stringpovinné

statusstring

finishedAtnull | stringdate-time

createdAtstringdate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/contacts/mailings

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/mailings', {
  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/mailings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Queue a bulk e-mail to contacts of this company, and answer at once. A marketing message is labelled, names the sender, and carries an unsubscribe link and List-Unsubscribe headers

POST/v1/contacts/mailings

Queue a bulk e-mail to contacts of this company, and answer at once. A marketing message is labelled, names the sender, and carries an unsubscribe link and List-Unsubscribe headers. Fields {{name}}, {{person}}, {{ico}}, {{dic}}, {{email}}, {{phone}}, {{street}}, {{city}}, {{postalCode}}, {{companyName}} fill per contact. Marketing goes only to contacts with consent or to customers, and never to one who unsubscribed (§ 7 zákona č. 480/2004 Sb.). At most 200 recipients per message and 1000 per day. It goes out in the background: follow it on GET /contacts/mailings/{id}.

Nástroj MCP: send-contact-mailing

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

purpose"service" | "marketing"povinné

service: a business message, such as a changed bank account. marketing: an obchodní sdělení under § 7 zákona č. 480/2004 Sb., labelled and with an unsubscribe link.

subjectstringpovinnémax 200 chars

bodystringpovinnémax 20000 chars

Odpověď · 201

idstringpovinné

purposestringpovinné

subjectstringpovinné

recipientCountintegerpovinné

sentCountintegerpovinné

failedCountintegerpovinné

skippedCountintegerpovinné

resultsobject[]

contactIdnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

statusstringpovinné

reasonnull | stringpovinné

statusstring

finishedAtnull | stringdate-time

createdAtstringdate-time

POST/v1/contacts/mailings

curl -X POST https://api.damedoklad.cz/v1/contacts/mailings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "purpose": "service",
  "subject": "string",
  "body": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/mailings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "purpose": "service",
        "subject": "string",
        "body": "string"
    },
)
data = response.json()

See how a bulk e-mail is going: its status, and what happened to each recipient

GET/v1/contacts/mailings/{id}

See how a bulk e-mail is going: its status, and what happened to each recipient

Nástroj MCP: get-contact-mailing

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

purposestringpovinné

subjectstringpovinné

recipientCountintegerpovinné

sentCountintegerpovinné

failedCountintegerpovinné

skippedCountintegerpovinné

resultsobject[]

contactIdnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

statusstringpovinné

reasonnull | stringpovinné

statusstring

finishedAtnull | stringdate-time

createdAtstringdate-time

GET/v1/contacts/mailings/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/mailings/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/contacts/mailings/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

See who a bulk e-mail would reach and why anyone is left out, with the first message filled in. Sends nothing

POST/v1/contacts/mailings/preview

See who a bulk e-mail would reach and why anyone is left out, with the first message filled in. Sends nothing

Nástroj MCP: preview-contact-mailing

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

purpose"service" | "marketing"povinné

service: a business message, such as a changed bank account. marketing: an obchodní sdělení under § 7 zákona č. 480/2004 Sb., labelled and with an unsubscribe link.

subjectstringpovinnémax 200 chars

bodystringpovinnémax 20000 chars

Odpověď · 200

willSendintegerpovinné

skippedintegerpovinné

limitPerMailingintegerpovinné

limitPerDayintegerpovinné

sentTodayintegerpovinné

recipientsobject[]povinné

contactIdnull | stringpovinné

namenull | stringpovinné

emailnull | stringpovinné

willSendbooleanpovinné

skipReasonnull | stringpovinné

sampleobjectpovinné

subjectnull | stringpovinné

textstringpovinné

POST/v1/contacts/mailings/preview

curl -X POST https://api.damedoklad.cz/v1/contacts/mailings/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "purpose": "service",
  "subject": "string",
  "body": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/mailings/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "purpose": "service",
        "subject": "string",
        "body": "string"
    },
)
data = response.json()

List SMS messages, newest first, with what happened to each. contactId narrows it to one contact

GET/v1/contacts/sms

List SMS messages, newest first, with what happened to each. contactId narrows it to one contact

Nástroj MCP: list-contact-sms

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"pending" | "sent" | "failed" | "skipped"

Odpověď · 200

dataobject[]povinné

object"contact_sms"povinné

idstringpovinné

batchIdstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

phonenull | stringpovinné

purposenull | stringpovinné

textstringpovinné

statusstringpovinné

reasonnull | stringpovinné

providernull | stringpovinné

providerIdnull | stringpovinné

sentAtnull | stringpovinnédate-time

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/contacts/sms

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/sms', {
  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/sms",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Queue a business SMS to contacts, and answer at once. Answers sms_not_configured until an SMS gateway is set up by the operator

POST/v1/contacts/sms

Queue a business SMS to contacts, and answer at once. Answers sms_not_configured until an SMS gateway is set up by the operator. Goes out in the background: follow it on GET /contacts/sms. A marketing text is labelled, names the sender, and carries a way out, and goes only to contacts with consent or to customers (§ 7 zákona č. 480/2004 Sb.). At most 200 per sending and 1000 per day. The status says the gateway accepted a text; delivery reports are not read.

Nástroj MCP: send-contact-sms

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

purpose"service" | "marketing"

service, the default: a business message. marketing: an obchodní sdělení under § 7 zákona č. 480/2004 Sb., labelled and with a way out, only to contacts with consent or to customers.

textstringpovinnémax 612 chars

Fields such as {{name}} fill per contact. At most 612 characters, or 268 with diacritics, once filled in.

Odpověď · 201

resultsobject[]povinné

idstringpovinné

okboolean

providerIdnull | string

contactIdnull | string

statusstring

reasonnull | string

totalintegerpovinné

succeededinteger

failedinteger

idstring

queuedinteger

skippedinteger

POST/v1/contacts/sms

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

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

import os
import requests

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

See who a text would reach and why anyone is left out, with the first message filled in. Sends nothing

POST/v1/contacts/sms/preview

See who a text would reach and why anyone is left out, with the first message filled in. Sends nothing

Nástroj MCP: preview-contact-sms

Tělo požadavku

contactIdsstring[]

groupIdstring

ID of the group.

purpose"service" | "marketing"

service, the default: a business message. marketing: an obchodní sdělení under § 7 zákona č. 480/2004 Sb., labelled and with a way out, only to contacts with consent or to customers.

textstringpovinnémax 612 chars

Fields such as {{name}} fill per contact. At most 612 characters, or 268 with diacritics, once filled in.

Odpověď · 200

configuredbooleanpovinné

willSendintegerpovinné

skippedintegerpovinné

limitPerSendingintegerpovinné

limitPerDayintegerpovinné

sentTodayintegerpovinné

recipientsobject[]povinné

contactIdnull | stringpovinné

namenull | stringpovinné

phonenull | stringpovinné

willSendbooleanpovinné

skipReasonnull | stringpovinné

tooLongbooleanpovinné

sampleobjectpovinné

textstringpovinné

lengthintegerpovinné

limitintegerpovinné

POST/v1/contacts/sms/preview

curl -X POST https://api.damedoklad.cz/v1/contacts/sms/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/contacts/sms/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "text": "string"
    },
)
data = response.json()

Say whether an SMS gateway is connected, and how many texts may still go out today

GET/v1/contacts/sms/status

Say whether an SMS gateway is connected, and how many texts may still go out today

Nástroj MCP: get-contact-sms-status

Odpověď · 200

configuredbooleanpovinné

providernull | stringpovinné

sentTodayintegerpovinné

limitPerDayintegerpovinné

limitPerSendingintegerpovinné

GET/v1/contacts/sms/status

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

const response = await fetch('https://api.damedoklad.cz/v1/contacts/sms/status', {
  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/sms/status",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change an amendment

PATCH/v1/contract-amendments/{id}

Change an amendment

Nástroj MCP: update-contract-amendment

Parametry v cestě

idstringpovinné

Tělo požadavku

titlestringmax 200 chars

signedOnstring | null

Date as YYYY-MM-DD.

effectiveFromstring | null

Date as YYYY-MM-DD.

newValidTostring | null

The contract now runs to this day.

valueChangeHalerinteger | null

How much this amendment adds to the value of the contract; negative lowers it.

notestring | null

Odpověď · 200

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

createdAtstringpovinnédate-time

PATCH/v1/contract-amendments/{id}

curl -X PATCH https://api.damedoklad.cz/v1/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "signedOn": "2026-10-30",
  "effectiveFrom": "2026-10-30"
}'

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "title": "string",
        "signedOn": "2026-10-30",
        "effectiveFrom": "2026-10-30"
    },
)
data = response.json()

Delete an amendment recorded by mistake

DELETE/v1/contract-amendments/{id}

Delete an amendment recorded by mistake

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

Nástroj MCP: delete-contract-amendment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/contract-amendments/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contract-amendments/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/contract-amendments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List contracts (smlouvy) with their partner, status, and end date as amended

GET/v1/contracts

List contracts (smlouvy) with their partner, status, and end date as amended

Nástroj MCP: list-contracts

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"draft" | "active" | "ended" | "terminated"

Odpověď · 200

dataobject[]povinné

object"business_contract"povinné

idstringpovinné

numbernull | stringpovinné

titlenull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

contractTypestringpovinné

categorystring | nullpovinné

statusstringpovinné

signedOnnull | stringpovinnédate

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

effectiveValidTonull | stringpovinnédate

noticeDaysinteger | nullpovinné

remindDaysinteger | nullpovinné

valueHalerinteger | nullpovinné

effectiveValueHalerinteger | nullpovinné

currencynull | stringpovinné

externalNumberstring | nullpovinné

notestring | nullpovinné

amendmentCountintegerpovinné

amendmentsobject[]povinné

object"contract_amendment"povinné

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

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/contracts

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

const response = await fetch('https://api.damedoklad.cz/v1/contracts', {
  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/contracts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Record a contract with a partner. It gets its own number; attach the signed file to it through the document archive

POST/v1/contracts

Record a contract with a partner. It gets its own number; attach the signed file to it through the document archive

Nástroj MCP: create-contract

Tělo požadavku

titlestringpovinnémax 200 chars

contactIdstring | null

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

categorystring | null

status"draft" | "active" | "ended" | "terminated"

signedOnstring | null

Date as YYYY-MM-DD.

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

noticeDaysinteger | null

remindDaysinteger | null

Show in K vyřízení this many days before the contract ends. Default 30.

valueHalerinteger | null

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

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

externalNumberstring | null

notestring | null

Odpověď · 201

idstringpovinné

numbernull | stringpovinné

titlenull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

contractTypestringpovinné

categorystring | nullpovinné

statusstringpovinné

signedOnnull | stringpovinnédate

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

effectiveValidTonull | stringpovinnédate

noticeDaysinteger | nullpovinné

remindDaysinteger | nullpovinné

valueHalerinteger | nullpovinné

effectiveValueHalerinteger | nullpovinné

currencynull | stringpovinné

externalNumberstring | nullpovinné

notestring | nullpovinné

amendmentCountintegerpovinné

amendmentsobject[]povinné

object"contract_amendment"povinné

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

createdAtstringpovinnédate-time

POST/v1/contracts

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

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

import os
import requests

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

Get a contract with its amendments

GET/v1/contracts/{id}

Get a contract with its amendments

Nástroj MCP: get-contract

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numbernull | stringpovinné

titlenull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

contractTypestringpovinné

categorystring | nullpovinné

statusstringpovinné

signedOnnull | stringpovinnédate

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

effectiveValidTonull | stringpovinnédate

noticeDaysinteger | nullpovinné

remindDaysinteger | nullpovinné

valueHalerinteger | nullpovinné

effectiveValueHalerinteger | nullpovinné

currencynull | stringpovinné

externalNumberstring | nullpovinné

notestring | nullpovinné

amendmentCountintegerpovinné

amendmentsobject[]povinné

object"contract_amendment"povinné

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

createdAtstringpovinnédate-time

GET/v1/contracts/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contracts/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/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change a contract, including ending or terminating it

PATCH/v1/contracts/{id}

Change a contract, including ending or terminating it

Nástroj MCP: update-contract

Parametry v cestě

idstringpovinné

Tělo požadavku

titlestringmax 200 chars

contactIdstring | null

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

categorystring | null

status"draft" | "active" | "ended" | "terminated"

signedOnstring | null

Date as YYYY-MM-DD.

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

noticeDaysinteger | null

remindDaysinteger | null

Show in K vyřízení this many days before the contract ends. Default 30.

valueHalerinteger | null

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

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

externalNumberstring | null

notestring | null

Odpověď · 200

idstringpovinné

numbernull | stringpovinné

titlenull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

contractTypestringpovinné

categorystring | nullpovinné

statusstringpovinné

signedOnnull | stringpovinnédate

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

effectiveValidTonull | stringpovinnédate

noticeDaysinteger | nullpovinné

remindDaysinteger | nullpovinné

valueHalerinteger | nullpovinné

effectiveValueHalerinteger | nullpovinné

currencynull | stringpovinné

externalNumberstring | nullpovinné

notestring | nullpovinné

amendmentCountintegerpovinné

amendmentsobject[]povinné

object"contract_amendment"povinné

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

createdAtstringpovinnédate-time

PATCH/v1/contracts/{id}

curl -X PATCH https://api.damedoklad.cz/v1/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "contractType": "sale"
}'

const response = await fetch('https://api.damedoklad.cz/v1/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "string",
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "contractType": "sale"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "title": "string",
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "contractType": "sale"
    },
)
data = response.json()

Delete a contract recorded by mistake, with its amendments. An ended contract is kept by setting its status

DELETE/v1/contracts/{id}

Delete a contract recorded by mistake, with its amendments. An ended contract is kept by setting its status

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

Nástroj MCP: delete-contract

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/contracts/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/contracts/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/contracts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add an amendment (dodatek) to a contract. It can move the end date and change the value

POST/v1/contracts/{id}/amendments

Add an amendment (dodatek) to a contract. It can move the end date and change the value

Nástroj MCP: create-contract-amendment

Parametry v cestě

idstringpovinné

Tělo požadavku

titlestringpovinnémax 200 chars

signedOnstring | null

Date as YYYY-MM-DD.

effectiveFromstring | null

Date as YYYY-MM-DD.

newValidTostring | null

The contract now runs to this day.

valueChangeHalerinteger | null

How much this amendment adds to the value of the contract; negative lowers it.

notestring | null

Odpověď · 201

idstringpovinné

contractIdstringpovinné

positionintegerpovinné

titlestringpovinné

signedOnstring | nullpovinné

effectiveFromstring | nullpovinné

newValidTonull | stringpovinnédate

valueChangeHalerinteger | nullpovinné

notestring | nullpovinné

createdAtstringpovinnédate-time

POST/v1/contracts/{id}/amendments

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

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

import os
import requests

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

List the custom fields a company defined, optionally for one kind of record. Most companies have none

GET/v1/custom-fields

List the custom fields a company defined, optionally for one kind of record. Most companies have none

Nástroj MCP: list-custom-fields

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"custom_field"povinné

idstringpovinné

entitystringpovinné

keystringpovinné

labelnull | stringpovinné

kindstringpovinné

optionsstring[]povinné

positioninteger | nullpovinné

isActivebooleanpovinné

searchablebooleanpovinné

printedbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/custom-fields

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

const response = await fetch('https://api.damedoklad.cz/v1/custom-fields', {
  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/custom-fields",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Define a custom field: text, number, date, or a choice from options, on contacts, items, or one kind of document

POST/v1/custom-fields

Define a custom field: text, number, date, or a choice from options, on contacts, items, or one kind of document

Nástroj MCP: create-custom-field

Tělo požadavku

keystring

labelstringpovinnémax 80 chars

kind"text" | "number" | "date" | "choice"povinné

optionsstring[]

positionintegermin 0max 1000

searchableboolean

The search finds a record by this field.

printedboolean

The value prints on documents. Only for fields on a document.

Odpověď · 201

idstringpovinné

entitystringpovinné

keystringpovinné

labelnull | stringpovinné

kindstringpovinné

optionsstring[]povinné

positioninteger | nullpovinné

isActivebooleanpovinné

searchablebooleanpovinné

printedbooleanpovinné

POST/v1/custom-fields

curl -X POST https://api.damedoklad.cz/v1/custom-fields \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "entity": "contact",
  "label": "string",
  "kind": "text"
}'

const response = await fetch('https://api.damedoklad.cz/v1/custom-fields', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "entity": "contact",
    "label": "string",
    "kind": "text"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/custom-fields",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "entity": "contact",
        "label": "string",
        "kind": "text"
    },
)
data = response.json()

Rename a custom field, change its options, or switch it off. Stored values stay

PATCH/v1/custom-fields/{id}

Rename a custom field, change its options, or switch it off. Stored values stay

Nástroj MCP: update-custom-field

Parametry v cestě

idstringpovinné

Tělo požadavku

searchableboolean

printedboolean

labelstringmax 80 chars

optionsstring[]

positionintegermin 0max 1000

isActiveboolean

Odpověď · 200

idstringpovinné

entitystringpovinné

keystringpovinné

labelnull | stringpovinné

kindstringpovinné

optionsstring[]povinné

positioninteger | nullpovinné

isActivebooleanpovinné

searchablebooleanpovinné

printedbooleanpovinné

PATCH/v1/custom-fields/{id}

curl -X PATCH https://api.damedoklad.cz/v1/custom-fields/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "searchable": false,
  "printed": false,
  "label": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/custom-fields/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "searchable": false,
    "printed": false,
    "label": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/custom-fields/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "searchable": False,
        "printed": False,
        "label": "string"
    },
)
data = response.json()

Delete a custom field definition. Values already stored stay on the records and in exports, and are no longer shown

DELETE/v1/custom-fields/{id}

Delete a custom field definition. Values already stored stay on the records and in exports, and are no longer shown

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

Nástroj MCP: delete-custom-field

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/custom-fields/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/custom-fields/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/custom-fields/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set custom field values on one record. Pass only the fields to change, null clears one. Works on issued documents too: it changes nothing they say

PUT/v1/custom-fields/values/{entity}/{id}

Set custom field values on one record. Pass only the fields to change, null clears one. Works on issued documents too: it changes nothing they say

Nástroj MCP: set-custom-field-values

Parametry v cestě

entitystringpovinné

idstringpovinné

Tělo požadavku

valuesobjectpovinné

Odpověď · 200

entitystringpovinné

idstringpovinné

valuesobjectpovinné

regionnull | string

slevainteger

smlouva_odstringdate

poznamka_obchodustring

vyrobcestring

zakazka_zakaznikastring

cislo_zakaznikastring

tajnestring

akcestring

regalstring

stavbastring

cislo_stavbystring

internistring

terminstringdate

oblaststring

stavba_zalohystring

tistene_polestring

PUT/v1/custom-fields/values/{entity}/{id}

curl -X PUT https://api.damedoklad.cz/v1/custom-fields/values/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "values": {}
}'

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

import os
import requests

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

Seznam: přílohy, doklad

GET/v1/documents

Search the document archive by title, file name, note, or the words inside PDF, Office, text and XML files; filter by what it is attached to, date, or retention

Nástroj MCP: list-document-attachments

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.

entityIdstring

ID of the entity.

retention"expired" | "kept" | "held"

Odpověď · 200

dataobject[]povinné

object"document_attachment"povinné

idstringpovinné

entityKindstringpovinné

entityIdnull | stringpovinné

titlestringpovinné

filenamestringpovinné

notestring | nullpovinné

documentDatestringpovinnédate

contentTypestringpovinné

byteSizeinteger | nullpovinné

retentionRulestringpovinné

retentionCitationnull | stringpovinné

retentionYearsinteger | nullpovinné

retentionUntilnull | stringpovinnédate

retentionExpiredbooleanpovinné

createdAtstringpovinnédate-time

scanStatusnull | string

contentStatenull | string

retentionHoldnull | object

idstringpovinné

reasonnull | stringpovinné

citationstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/documents

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

const response = await fetch('https://api.damedoklad.cz/v1/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/documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Upload a file to the archive, optionally attached to a document or contact. Its retention date follows from the type and date

POST/v1/documents

Upload a file to the archive, optionally attached to a document or contact. Its retention date follows from the type and date. fileBase64 up to 25 MB. Without retentionRule the type follows from what it is attached to. The custom rule takes retentionUntil.

Nástroj MCP: upload-document-attachment

Tělo požadavku

entityIdstring | null

ID of the entity.

filenamestringpovinnémax 255 chars

contentTypestringpovinnémax 120 chars

fileBase64stringpovinné

File content encoded as base64.

titlestring | null

notestring | null

documentDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

retentionUntilstring | null

Odpověď · 201

idstringpovinné

entityKindstringpovinné

entityIdnull | stringpovinné

titlestringpovinné

filenamestringpovinné

notestring | nullpovinné

documentDatestringpovinnédate

contentTypestringpovinné

byteSizeinteger | nullpovinné

retentionRulestringpovinné

retentionCitationnull | stringpovinné

retentionYearsinteger | nullpovinné

retentionUntilnull | stringpovinnédate

retentionExpiredbooleanpovinné

createdAtstringpovinnédate-time

scanStatusnull | string

contentStatenull | string

retentionHoldnull | object

idstringpovinné

reasonnull | stringpovinné

citationstringpovinné

POST/v1/documents

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

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

import os
import requests

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

Detail: příloha, doklad

GET/v1/documents/{id}

Get a document

Nástroj MCP: get-document-attachment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

entityKindstringpovinné

entityIdnull | stringpovinné

titlestringpovinné

filenamestringpovinné

notestring | nullpovinné

documentDatestringpovinnédate

contentTypestringpovinné

byteSizeinteger | nullpovinné

retentionRulestringpovinné

retentionCitationnull | stringpovinné

retentionYearsinteger | nullpovinné

retentionUntilnull | stringpovinnédate

retentionExpiredbooleanpovinné

createdAtstringpovinnédate-time

scanStatusnull | string

contentStatenull | string

retentionHoldnull | object

idstringpovinné

reasonnull | stringpovinné

citationstringpovinné

GET/v1/documents/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/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/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: příloha, doklad

PATCH/v1/documents/{id}

Change the title, note, date, or retention type of a document

Nástroj MCP: update-document-attachment

Parametry v cestě

idstringpovinné

Tělo požadavku

titlestring | null

notestring | null

documentDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

retentionUntilstring | null

Odpověď · 200

idstringpovinné

entityKindstringpovinné

entityIdnull | stringpovinné

titlestringpovinné

filenamestringpovinné

notestring | nullpovinné

documentDatestringpovinnédate

contentTypestringpovinné

byteSizeinteger | nullpovinné

retentionRulestringpovinné

retentionCitationnull | stringpovinné

retentionYearsinteger | nullpovinné

retentionUntilnull | stringpovinnédate

retentionExpiredbooleanpovinné

createdAtstringpovinnédate-time

scanStatusnull | string

contentStatenull | string

retentionHoldnull | object

idstringpovinné

reasonnull | stringpovinné

citationstringpovinné

PATCH/v1/documents/{id}

curl -X PATCH https://api.damedoklad.cz/v1/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "note": "string",
  "retentionRule": "accounting_statement"
}'

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "title": "string",
        "note": "string",
        "retentionRule": "accounting_statement"
    },
)
data = response.json()

Smazání: příloha, doklad

DELETE/v1/documents/{id}

Shred a document, removing the file. Refused while the statutory retention period runs, or while an inspection or dispute holds it

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

Nástroj MCP: delete-document-attachment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/documents/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/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/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Stažení: příloha, doklad

GET/v1/documents/{id}/download

Download a document

Nástroj MCP: download-document-attachment

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/documents/{id}/download

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

const response = await fetch('https://api.damedoklad.cz/v1/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/download', {
  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/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/download",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

List what keeps documents past their period: an inspection, a dispute, a complaint, an unpaid debt

GET/v1/documents/retention-holds

List what keeps documents past their period: an inspection, a dispute, a complaint, an unpaid debt

Nástroj MCP: list-retention-holds

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"retention_hold"povinné

idstringpovinné

reasonstringpovinné

coversFromnull | stringpovinnédate

coversTonull | stringpovinnédate

untilnull | stringpovinnédate

notenull | stringpovinné

citationnull | stringpovinné

activebooleanpovinné

releasedAtnull | stringpovinnédate-time

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/documents/retention-holds

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

const response = await fetch('https://api.damedoklad.cz/v1/documents/retention-holds', {
  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/documents/retention-holds",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Keep documents of a period past their retention, for an inspection or a dispute. Until it ends, none of them can be shredded, whatever its type

POST/v1/documents/retention-holds

Keep documents of a period past their retention, for an inspection or a dispute. Until it ends, none of them can be shredded, whatever its type. No dates means every document. It covers documents by their date, so what is uploaded later falls under it too. The law names no end date for these, so it holds until `until` or until it is released. Citation: § 32 of zákon 563/1991 Sb., § 148 of zákon 280/2009 Sb.

Nástroj MCP: create-retention-hold

Tělo požadavku

reason"inspection" | "dispute" | "complaint" | "unpaid" | "other"povinné

coversFromstring | null

Date as YYYY-MM-DD.

coversTostring | null

Date as YYYY-MM-DD.

untilstring | null

notestring | null

Odpověď · 201

idstringpovinné

reasonstringpovinné

coversFromnull | stringpovinnédate

coversTonull | stringpovinnédate

untilnull | stringpovinnédate

notenull | stringpovinné

citationnull | stringpovinné

activebooleanpovinné

releasedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

POST/v1/documents/retention-holds

curl -X POST https://api.damedoklad.cz/v1/documents/retention-holds \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "inspection"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/documents/retention-holds",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "reason": "inspection"
    },
)
data = response.json()

End an extended retention once the inspection or dispute is over. Ordinary periods apply again

POST/v1/documents/retention-holds/{id}/release

End an extended retention once the inspection or dispute is over. Ordinary periods apply again

Nástroj MCP: release-retention-hold

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

reasonstringpovinné

coversFromnull | stringpovinnédate

coversTonull | stringpovinnédate

untilnull | stringpovinnédate

notenull | stringpovinné

citationnull | stringpovinné

activebooleanpovinné

releasedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

POST/v1/documents/retention-holds/{id}/release

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

const response = await fetch('https://api.damedoklad.cz/v1/documents/retention-holds/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release', {
  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/documents/retention-holds/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Statutory retention periods (skartační lhůty) with their legal citation

GET/v1/documents/retention-rules

Statutory retention periods (skartační lhůty) with their legal citation

Nástroj MCP: list-retention-rules

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"retention_rule"povinné

keystringpovinné

yearsinteger | nullpovinné

citationnull | stringpovinné

csstringpovinné

enstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/documents/retention-rules

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

const response = await fetch('https://api.damedoklad.cz/v1/documents/retention-rules', {
  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/documents/retention-rules",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List contacts by the state of their GDPR reasons (none, valid, expiring, expired, future, or restricted), on a given day, or by POHODA's searches over chosen reasons

GET/v1/gdpr/contacts

List contacts by the state of their GDPR reasons (none, valid, expiring, expired, future, or restricted), on a given day, or by POHODA's searches over chosen reasons

Nástroj MCP: list-contacts-gdpr

Parametry dotazu

asOfstringYYYY-MM-DD

The state on this day. Defaults to today.

reasonIdstring

Only contacts holding this reason from the list.

POHODA's searches. all_valid: has a reason and all of them hold. any_valid: at least one holds. any_of and all_of: of the reasons in reasonIds, one or all are on the contact and hold. expired: a reason has run out. no_reason: none on the contact.

reasonIdsstringmax 2000 chars

Reasons from the list, separated by commas, for match=any_of or all_of.

includeNoReason"true" | "false"

With match=expired, a contact with no reason counts as expired too.

includeDocuments"true" | "false"

Count an issued document as a reason holding from its date, for any_valid, all_valid, and no_reason. Our reading: POHODA offers this but does not say how it derives such a reason.

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"contact_gdpr_row"povinné

idstringpovinné

namenull | stringpovinné

statestringpovinné

reasonCountintegerpovinné

marketingOptOutbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/gdpr/contacts

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

const response = await fetch('https://api.damedoklad.cz/v1/gdpr/contacts', {
  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/gdpr/contacts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List the company list of reasons for processing that a reason on a contact is picked from. A company without any gets four to start from

GET/v1/gdpr/reasons

List the company list of reasons for processing that a reason on a contact is picked from. A company without any gets four to start from

Nástroj MCP: list-gdpr-reason-codes

Parametry dotazu

active"true" | "false"

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"gdpr_reason_code"povinné

idstringpovinné

namestringpovinné

legalBasisstringpovinné

descriptionnull | stringpovinné

validityMonthsinteger | nullpovinné

isActivebooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/gdpr/reasons

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

const response = await fetch('https://api.damedoklad.cz/v1/gdpr/reasons', {
  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/gdpr/reasons",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a reason for processing to the company list: its name, legal basis, description, and how long it lasts

POST/v1/gdpr/reasons

Add a reason for processing to the company list: its name, legal basis, description, and how long it lasts

Nástroj MCP: create-gdpr-reason-code

Tělo požadavku

namestringpovinnémax 200 chars

descriptionstring | null

validityMonthsinteger | null

How long a reason lasts from its start. Empty: until someone ends it.

isActiveboolean

Odpověď · 201

idstringpovinné

namestringpovinné

legalBasisstringpovinné

descriptionnull | stringpovinné

validityMonthsinteger | nullpovinné

isActivebooleanpovinné

POST/v1/gdpr/reasons

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

const response = await fetch('https://api.damedoklad.cz/v1/gdpr/reasons', {
  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.",
    "legalBasis": "consent"
  }),
});
const data = await response.json();

import os
import requests

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

Change a reason on the company list or stop offering it. Reasons already on contacts keep what they said

PATCH/v1/gdpr/reasons/{id}

Change a reason on the company list or stop offering it. Reasons already on contacts keep what they said

Nástroj MCP: update-gdpr-reason-code

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

descriptionstring | null

validityMonthsinteger | null

How long a reason lasts from its start. Empty: until someone ends it.

isActiveboolean

Odpověď · 200

idstringpovinné

namestringpovinné

legalBasisstringpovinné

descriptionnull | stringpovinné

validityMonthsinteger | nullpovinné

isActivebooleanpovinné

PATCH/v1/gdpr/reasons/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/gdpr/reasons/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.",
    "legalBasis": "consent",
    "description": "Pečivo, říjen"
  }),
});
const data = await response.json();

import os
import requests

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

Remove a reason from the company list. One already used on a contact stays and can only be stopped being offered

DELETE/v1/gdpr/reasons/{id}

Remove a reason from the company list. One already used on a contact stays and can only be stopped being offered

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

Nástroj MCP: delete-gdpr-reason-code

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/gdpr/reasons/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/gdpr/reasons/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/gdpr/reasons/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Send a document still in the inbox for approval, before any invoice is made from it. Until it is approved it cannot become a document; once approved, the document made from it is approved too

POST/v1/inbox/documents/{id}/approval

Send a document still in the inbox for approval, before any invoice is made from it. Until it is approved it cannot become a document; once approved, the document made from it is approved too

Nástroj MCP: request-inbox-document-approval

Parametry v cestě

idstringpovinné

Tělo požadavku

approverIdstring | null

ID of the approver.

scenarioIdstring | null

ID of the scenario.

commentstring | null

Odpověď · 201

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

POST/v1/inbox/documents/{id}/approval

curl -X POST https://api.damedoklad.cz/v1/inbox/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "comment": "string"
}'

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

import os
import requests

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

The credit notes of a month: which brought goods back (reported with code 21), and which only changed a price, with whether the original declaration must be corrected (over 5 %, or the whole price)

GET/v1/intrastat/credits

The credit notes of a month: which brought goods back (reported with code 21), and which only changed a price, with whether the original declaration must be corrected (over 5 %, or the whole price)

Nástroj MCP: list-intrastat-credits

Parametry dotazu

yearintegerpovinnémin 2020max 2100

monthintegerpovinnémin 1max 12

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

kindstringpovinné

documentIdnull | stringpovinné

numbernull | stringpovinné

contactNamenull | stringpovinné

taxPointDatenull | stringpovinnédate

creditKindnull | stringpovinné

directionstringpovinné

valueHalerinteger | nullpovinné

correctsDirectionstring

correctsYearinteger

correctsMonthinteger

originalNumbernull | string

percentinteger | null

fullboolean

mustCorrectboolean

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/intrastat/credits

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/credits', {
  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/intrastat/credits",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List Intrastat declarations

GET/v1/intrastat/declarations

List Intrastat declarations

Nástroj MCP: list-intrastat-declarations

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.

yearintegermin -9007199254740991max 9007199254740991

direction"dispatch" | "arrival"

Odpověď · 200

dataobject[]povinné

object"intrastat_declaration"povinné

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/intrastat/declarations

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations', {
  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/intrastat/declarations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Prepare the declaration for a month and direction from EU goods invoices. Kind negative or simplified carries no goods lines

POST/v1/intrastat/declarations

Prepare the declaration for a month and direction from EU goods invoices. Kind negative or simplified carries no goods lines

Nástroj MCP: create-intrastat-declaration

Tělo požadavku

yearintegerpovinnémin 2020max 2100

monthintegerpovinnémin 1max 12

direction"dispatch" | "arrival"povinné

kind"standard" | "negative" | "simplified"

Odpověď · 201

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

POST/v1/intrastat/declarations

curl -X POST https://api.damedoklad.cz/v1/intrastat/declarations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026,
  "month": 1,
  "direction": "dispatch"
}'

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026,
    "month": 1,
    "direction": "dispatch"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/intrastat/declarations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026,
        "month": 1,
        "direction": "dispatch"
    },
)
data = response.json()

Get a declaration with its lines and what stops each line from being filed

GET/v1/intrastat/declarations/{id}

Get a declaration with its lines and what stops each line from being filed

Nástroj MCP: get-intrastat-declaration

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

GET/v1/intrastat/declarations/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Delete a declaration that has not been filed

DELETE/v1/intrastat/declarations/{id}

Delete a declaration that has not been filed

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

Nástroj MCP: delete-intrastat-declaration

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/intrastat/declarations/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download the declaration as the CSV file that InstatEvo imports (structure valid from 1 January 2026)

GET/v1/intrastat/declarations/{id}/csv

Download the declaration as the CSV file that InstatEvo imports (structure valid from 1 January 2026)

Nástroj MCP: download-intrastat-csv

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor text/csv.

GET/v1/intrastat/declarations/{id}/csv

curl https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv', {
  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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/csv",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Mark a declaration as filed in InstatEvo and lock it. Filing itself happens in the customs application; this API cannot submit

POST/v1/intrastat/declarations/{id}/file

Mark a declaration as filed in InstatEvo and lock it. Filing itself happens in the customs application; this API cannot submit

Nástroj MCP: mark-intrastat-filed

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

POST/v1/intrastat/declarations/{id}/file

curl -X POST https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file', {
  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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Add a line by hand: a return (21), a free replacement (22, 23), or goods without an invoice

POST/v1/intrastat/declarations/{id}/lines

Add a line by hand: a return (21), a free replacement (22, 23), or goods without an invoice

Nástroj MCP: add-intrastat-line

Parametry v cestě

idstringpovinné

Tělo požadavku

commodityCodestring | null

statisticalSignstring | null

countryCodestring | null

originCountrystring | null

transaction"11" | "12" | "21" | "22" | "23" | "31" | "32" | "33" | "34" | "41" | "42" | "51" | "52" | "71" | "72" | "80" | "91" | "99" | null

transport"2" | "3" | "4" | "5" | "7" | "8" | "9" | null

deliveryTerms"K" | "L" | "M" | "N" | null

recordType"ST" | "MZ" | "ZI" | "ZR" | "ZL" | "ZP" | "ZZ" | "ZT" | "ZM" | "ZK" | "ZO"

partnerVatstring | null

descriptionstring | null

massGramsintegermin 0max 9007199254740991

supplementaryMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

valueHalerintegermin 0max 9007199254740991

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

Odpověď · 201

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

POST/v1/intrastat/declarations/{id}/lines

curl -X POST https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "commodityCode": "string",
  "statisticalSign": "string",
  "countryCode": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "commodityCode": "string",
        "statisticalSign": "string",
        "countryCode": "string"
    },
)
data = response.json()

Correct a line of a draft declaration. Reading the documents again replaces corrections to generated lines: fix the item or document data to keep them

PATCH/v1/intrastat/declarations/{id}/lines/{lineId}

Correct a line of a draft declaration. Reading the documents again replaces corrections to generated lines: fix the item or document data to keep them

Nástroj MCP: update-intrastat-line

Parametry v cestě

idstringpovinné

lineIdstringpovinné

ID of the line.

Tělo požadavku

commodityCodestring | null

statisticalSignstring | null

countryCodestring | null

originCountrystring | null

transaction"11" | "12" | "21" | "22" | "23" | "31" | "32" | "33" | "34" | "41" | "42" | "51" | "52" | "71" | "72" | "80" | "91" | "99" | null

transport"2" | "3" | "4" | "5" | "7" | "8" | "9" | null

deliveryTerms"K" | "L" | "M" | "N" | null

recordType"ST" | "MZ" | "ZI" | "ZR" | "ZL" | "ZP" | "ZZ" | "ZT" | "ZM" | "ZK" | "ZO"

partnerVatstring | null

descriptionstring | null

massGramsintegermin 0max 9007199254740991

supplementaryMilliintegermin 0max 9007199254740991

Integer thousandths: 1500 means 1.5.

valueHalerintegermin 0max 9007199254740991

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

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

PATCH/v1/intrastat/declarations/{id}/lines/{lineId}

curl -X PATCH https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "commodityCode": "string",
  "statisticalSign": "string",
  "countryCode": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "commodityCode": "string",
    "statisticalSign": "string",
    "countryCode": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "commodityCode": "string",
        "statisticalSign": "string",
        "countryCode": "string"
    },
)
data = response.json()

Remove a line of a draft declaration

DELETE/v1/intrastat/declarations/{id}/lines/{lineId}

Remove a line of a draft declaration

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

Nástroj MCP: remove-intrastat-line

Parametry v cestě

idstringpovinné

lineIdstringpovinné

ID of the line.

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

DELETE/v1/intrastat/declarations/{id}/lines/{lineId}

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines/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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/lines/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Read the documents again after changing item or document data. Manual lines stay

POST/v1/intrastat/declarations/{id}/regenerate

Read the documents again after changing item or document data. Manual lines stay

Nástroj MCP: regenerate-intrastat-declaration

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

POST/v1/intrastat/declarations/{id}/regenerate

curl -X POST https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/regenerate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/regenerate', {
  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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/regenerate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Unlock a filed declaration to correct it. A correction must also be sent in InstatEvo

POST/v1/intrastat/declarations/{id}/reopen

Unlock a filed declaration to correct it. A correction must also be sent in InstatEvo

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

Nástroj MCP: reopen-intrastat-declaration

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

yearintegerpovinné

monthintegerpovinné

directionstringpovinné

kindstringpovinné

statusstringpovinné

deadlinestringpovinnédate

filedAtnull | stringpovinnédate-time

linesobject[]povinné

object"intrastat_line"povinné

idstringpovinné

sourcestringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

countryCodenull | stringpovinné

originCountrynull | stringpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

recordTypestringpovinné

partnerVatnull | stringpovinné

descriptionnull | stringpovinné

massGramsintegerpovinné

supplementaryMilliintegerpovinné

valueHalerintegerpovinné

documentNumbersstring[]povinné

problemsstring[]povinné

totalValueHalerintegerpovinné

problemCountintegerpovinné

POST/v1/intrastat/declarations/{id}/reopen

curl -X POST https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen', {
  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/intrastat/declarations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reopen",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the default transaction nature, transport, and delivery terms used for documents without their own

PUT/v1/intrastat/defaults

Set the default transaction nature, transport, and delivery terms used for documents without their own

Nástroj MCP: update-intrastat-defaults

Tělo požadavku

transaction"11" | "12" | "21" | "22" | "23" | "31" | "32" | "33" | "34" | "41" | "42" | "51" | "52" | "71" | "72" | "80" | "91" | "99"povinné

transport"2" | "3" | "4" | "5" | "7" | "8" | "9"povinné

deliveryTerms"K" | "L" | "M" | "N"povinné

Odpověď · 200

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

PUT/v1/intrastat/defaults

curl -X PUT https://api.damedoklad.cz/v1/intrastat/defaults \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "transaction": "11",
  "transport": "2",
  "deliveryTerms": "K"
}'

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/defaults', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "transaction": "11",
    "transport": "2",
    "deliveryTerms": "K"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/intrastat/defaults",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "transaction": "11",
        "transport": "2",
        "deliveryTerms": "K"
    },
)
data = response.json()

Get the Intrastat data of a document: transaction nature, transport, delivery terms, or that it is excluded

GET/v1/intrastat/documents/{kind}/{id}

Get the Intrastat data of a document: transaction nature, transport, delivery terms, or that it is excluded

Nástroj MCP: get-intrastat-document

Parametry v cestě

kindstringpovinné

idstringpovinné

Odpověď · 200

kindstringpovinné

documentIdnull | stringpovinné

transactionstring

transportnull | string

deliveryTermsnull | string

countryCodenull | string

excludedbooleanpovinné

creditKindnull | string

GET/v1/intrastat/documents/{kind}/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/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/intrastat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the Intrastat data of a document, overriding the defaults, or exclude it from declarations

PUT/v1/intrastat/documents/{kind}/{id}

Set the Intrastat data of a document, overriding the defaults, or exclude it from declarations

Nástroj MCP: update-intrastat-document

Parametry v cestě

kindstringpovinné

idstringpovinné

Tělo požadavku

transaction"11" | "12" | "21" | "22" | "23" | "31" | "32" | "33" | "34" | "41" | "42" | "51" | "52" | "71" | "72" | "80" | "91" | "99" | null

transport"2" | "3" | "4" | "5" | "7" | "8" | "9" | null

deliveryTerms"K" | "L" | "M" | "N" | null

countryCodestring | null

excludedboolean

creditKind"return" | "price" | null

Odpověď · 200

kindstringpovinné

documentIdnull | stringpovinné

transactionstring

transportnull | string

deliveryTermsnull | string

countryCodenull | string

excludedbooleanpovinné

creditKindnull | string

PUT/v1/intrastat/documents/{kind}/{id}

curl -X PUT https://api.damedoklad.cz/v1/intrastat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "transaction": "11",
  "transport": "2",
  "deliveryTerms": "K"
}'

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "transaction": "11",
    "transport": "2",
    "deliveryTerms": "K"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/intrastat/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "transaction": "11",
        "transport": "2",
        "deliveryTerms": "K"
    },
)
data = response.json()

Get the Intrastat data of a stock item: commodity code, mass per unit, country of origin

GET/v1/intrastat/items/{itemId}

Get the Intrastat data of a stock item: commodity code, mass per unit, country of origin

Nástroj MCP: get-intrastat-item

Parametry v cestě

itemIdstringpovinné

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

Odpověď · 200

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

originCountrynull | stringpovinné

massGramsinteger | nullpovinné

supplementaryMilliinteger | nullpovinné

GET/v1/intrastat/items/{itemId}

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/items/itm_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/intrastat/items/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the Intrastat data of a stock item

PUT/v1/intrastat/items/{itemId}

Set the Intrastat data of a stock item

Nástroj MCP: update-intrastat-item

Parametry v cestě

itemIdstringpovinné

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

Tělo požadavku

commodityCodestring | null

statisticalSignstring | null

originCountrystring | null

massGramsinteger | null

supplementaryMilliinteger | null

Integer thousandths: 1500 means 1.5.

Odpověď · 200

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

commodityCodenull | stringpovinné

statisticalSignstring | nullpovinné

originCountrynull | stringpovinné

massGramsinteger | nullpovinné

supplementaryMilliinteger | nullpovinné

PUT/v1/intrastat/items/{itemId}

curl -X PUT https://api.damedoklad.cz/v1/intrastat/items/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "commodityCode": "string",
  "statisticalSign": "string",
  "originCountry": "string"
}'

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

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/intrastat/items/itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "commodityCode": "string",
        "statisticalSign": "string",
        "originCountry": "string"
    },
)
data = response.json()

Whether Intrastat is due this month in each direction: running total against the 15 million CZK threshold, duty carried from last year, deadline

GET/v1/intrastat/status

Whether Intrastat is due this month in each direction: running total against the 15 million CZK threshold, duty carried from last year, deadline

Nástroj MCP: get-intrastat-status

Parametry dotazu

yearintegermin 2020max 2100

monthintegermin 1max 12

Odpověď · 200

yearintegerpovinné

monthinteger | nullpovinné

thresholdHalerintegerpovinné

simplifiedLimitHalerintegerpovinné

deadlinestringpovinnédate

vatRegisteredbooleanpovinné

defaultsobjectpovinné

transactionstringpovinné

transportnull | stringpovinné

deliveryTermsnull | stringpovinné

dispatchobjectpovinné

directionstringpovinné

monthsobjectpovinné

previousYearHalerintegerpovinné

yearintegerpovinné

monthinteger | nullpovinné

requiredbooleanpovinné

carriedOverbooleanpovinné

reachedInMonthinteger | nullpovinné

firstMonthinteger | nullpovinné

runningHalerintegerpovinné

yearTotalHalerintegerpovinné

thresholdHalerintegerpovinné

remainingHalerinteger | nullpovinné

simplifiedPossiblebooleanpovinné

requiredUntilYearinteger | nullpovinné

deadlinestringpovinnédate

simplifiedBlockersstring[]

coveredBySimplifiedboolean

arrivalobjectpovinné

directionstringpovinné

monthsobjectpovinné

previousYearHalerintegerpovinné

yearintegerpovinné

monthinteger | nullpovinné

requiredbooleanpovinné

carriedOverbooleanpovinné

reachedInMonthanypovinné

Null in every recorded response.

firstMonthanypovinné

Null in every recorded response.

runningHalerintegerpovinné

yearTotalHalerintegerpovinné

thresholdHalerintegerpovinné

remainingHalerinteger | nullpovinné

simplifiedPossiblebooleanpovinné

requiredUntilYearanypovinné

Null in every recorded response.

deadlinestringpovinnédate

simplifiedBlockersany[]

coveredBySimplifiedboolean

GET/v1/intrastat/status

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

const response = await fetch('https://api.damedoklad.cz/v1/intrastat/status', {
  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/intrastat/status",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List received invoices and advances to suppliers in approval, with their status and approver

GET/v1/invoice-approvals

List received invoices and advances to suppliers in approval, with their status and approver

Nástroj MCP: list-invoice-approvals

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"pending" | "approved" | "rejected" | "cancelled"

Odpověď · 200

dataobject[]povinné

object"invoice_approval"povinné

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/invoice-approvals

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals', {
  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/invoice-approvals",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get one approval with its history

GET/v1/invoice-approvals/{id}

Get one approval with its history

Nástroj MCP: get-invoice-approval

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

GET/v1/invoice-approvals/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/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/invoice-approvals/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Approve a received invoice or an advance to a supplier for payment, or one step of its scenario. Only the named approver, an owner, or an accountant can, and one person decides one step

POST/v1/invoice-approvals/{id}/approve

Approve a received invoice or an advance to a supplier for payment, or one step of its scenario. Only the named approver, an owner, or an accountant can, and one person decides one step

Nástroj MCP: approve-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

commentstring | null

Odpověď · 200

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

POST/v1/invoice-approvals/{id}/approve

curl -X POST https://api.damedoklad.cz/v1/invoice-approvals/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "comment": "string"
}'

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

import os
import requests

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

Reject a received invoice or an advance to a supplier with a comment. It stays out of payment orders until sent for approval again

POST/v1/invoice-approvals/{id}/reject

Reject a received invoice or an advance to a supplier with a comment. It stays out of payment orders until sent for approval again

Nástroj MCP: reject-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

commentstringpovinnémax 2000 chars

Odpověď · 200

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

POST/v1/invoice-approvals/{id}/reject

curl -X POST https://api.damedoklad.cz/v1/invoice-approvals/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reject \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "comment": "string"
}'

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

import os
import requests

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

Members of the company who can be named as approvers

GET/v1/invoice-approvals/approvers

Members of the company who can be named as approvers

Nástroj MCP: list-invoice-approvers

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"invoice_approver"povinné

idstringpovinné

namenull | stringpovinné

emailnull | stringpovinné

rolestringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/invoice-approvals/approvers

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/approvers', {
  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/invoice-approvals/approvers",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List who stands in for whom in approvals, and when

GET/v1/invoice-approvals/delegations

List who stands in for whom in approvals, and when

Nástroj MCP: list-approval-delegations

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/invoice-approvals/delegations

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/delegations', {
  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/invoice-approvals/delegations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Name who stands in during an absence: between the dates they may decide what waits on the person away. One person still decides one step

POST/v1/invoice-approvals/delegations

Name who stands in during an absence: between the dates they may decide what waits on the person away. One person still decides one step

Nástroj MCP: create-approval-delegation

Tělo požadavku

delegatorIdstring

Who is away. Left out: the person asking. Only an owner or accountant can name someone else.

delegateIdstringpovinné

ID of the delegate.

startsOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

endsOnstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

delegatorIdstringpovinné

delegatorNamestringpovinné

delegateIdstringpovinné

delegateNamestringpovinné

startsOnstringpovinnédate

endsOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

POST/v1/invoice-approvals/delegations

curl -X POST https://api.damedoklad.cz/v1/invoice-approvals/delegations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "delegateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "startsOn": "2026-10-30",
  "endsOn": "2026-10-30"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/invoice-approvals/delegations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "delegateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "startsOn": "2026-10-30",
        "endsOn": "2026-10-30"
    },
)
data = response.json()

End a stand-in

DELETE/v1/invoice-approvals/delegations/{id}

End a stand-in

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

Nástroj MCP: delete-approval-delegation

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/invoice-approvals/delegations/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/delegations/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/invoice-approvals/delegations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List approval scenarios: several approvers in order, optionally applied on their own from an amount

GET/v1/invoice-approvals/scenarios

List approval scenarios: several approvers in order, optionally applied on their own from an amount

Nástroj MCP: list-approval-scenarios

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"approval_scenario"povinné

idstringpovinné

namestringpovinné

minTotalHalerinteger | nullpovinné

activebooleanpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

stagesarray | null

modestringpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

processornull | object

idstringpovinné

namestringpovinné

documentKindsstring[]

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/invoice-approvals/scenarios

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/scenarios', {
  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/invoice-approvals/scenarios",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create an approval scenario: at least two members in the order they approve, and optionally the amount in haléře from which it applies on its own

POST/v1/invoice-approvals/scenarios

Create an approval scenario: at least two members in the order they approve, and optionally the amount in haléře from which it applies on its own. A document already in approval stays on its route. With no scenario a document goes to one approver, as before.

Nástroj MCP: create-approval-scenario

Tělo požadavku

namestringpovinnémax 120 chars

approverIdsstring[]

Approvers one after another. For parallel steps use stages instead.

stagesobject[]

Steps in order; the people of one step decide at the same time.

approverIdsstring[]povinné

mode"all" | "any"

all: each of them must approve. any: one is enough.

processorIdstring | null

Who prepares the document before the first step.

What the scenario applies to. Default: received invoices and advances to suppliers.

minTotalHalerinteger | null

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

activeboolean

Odpověď · 201

idstringpovinné

namestringpovinné

minTotalHalerinteger | nullpovinné

activebooleanpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

stagesarray | null

modestringpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

processornull | object

idstringpovinné

namestringpovinné

documentKindsstring[]

POST/v1/invoice-approvals/scenarios

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/scenarios', {
  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."
  }),
});
const data = await response.json();

import os
import requests

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

Change an approval scenario. A document already in approval stays on the steps it started with

PATCH/v1/invoice-approvals/scenarios/{id}

Change an approval scenario. A document already in approval stays on the steps it started with

Nástroj MCP: update-approval-scenario

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

approverIdsstring[]

Approvers one after another. For parallel steps use stages instead.

stagesobject[]

Steps in order; the people of one step decide at the same time.

approverIdsstring[]povinné

mode"all" | "any"

all: each of them must approve. any: one is enough.

processorIdstring | null

Who prepares the document before the first step.

What the scenario applies to. Default: received invoices and advances to suppliers.

minTotalHalerinteger | null

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

activeboolean

Odpověď · 200

idstringpovinné

namestringpovinné

minTotalHalerinteger | nullpovinné

activebooleanpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

stagesarray | null

modestringpovinné

approversobject[]povinné

idstringpovinné

namestringpovinné

processornull | object

idstringpovinné

namestringpovinné

documentKindsstring[]

PATCH/v1/invoice-approvals/scenarios/{id}

curl -X PATCH https://api.damedoklad.cz/v1/invoice-approvals/scenarios/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "approverIds": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "stages": [
    {
      "approverIds": [
        "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
      ]
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/scenarios/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.",
    "approverIds": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "stages": [
      {
        "approverIds": [
          "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/invoice-approvals/scenarios/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "approverIds": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "stages": [
            {
                "approverIds": [
                    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
                ]
            }
        ]
    },
)
data = response.json()

Delete an approval scenario. Documents under way keep their steps

DELETE/v1/invoice-approvals/scenarios/{id}

Delete an approval scenario. Documents under way keep their steps

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

Nástroj MCP: delete-approval-scenario

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/invoice-approvals/scenarios/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/scenarios/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/invoice-approvals/scenarios/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Whether received invoices must be approved before a payment order, and who approves by default

GET/v1/invoice-approvals/settings

Whether received invoices must be approved before a payment order, and who approves by default

Nástroj MCP: get-invoice-approval-settings

Odpověď · 200

requiredbooleanpovinné

defaultApproverIdnull | stringpovinné

defaultProcessorIdnull | string

salesKindsstring[]

GET/v1/invoice-approvals/settings

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

const response = await fetch('https://api.damedoklad.cz/v1/invoice-approvals/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/invoice-approvals/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Turn approval on or off. Turning it on sends every unpaid recorded invoice and advance to a supplier for approval

PUT/v1/invoice-approvals/settings

Turn approval on or off. Turning it on sends every unpaid recorded invoice and advance to a supplier for approval

Nástroj MCP: update-invoice-approval-settings

Tělo požadavku

requiredbooleanpovinné

defaultApproverIdstring | null

ID of the default approver.

defaultProcessorIdstring | null

Who prepares a document first and hands it on to the approvers.

Kinds of sales document that cannot be issued until approved, such as issued orders.

Odpověď · 200

requiredbooleanpovinné

defaultApproverIdnull | stringpovinné

defaultProcessorIdnull | string

salesKindsstring[]

PUT/v1/invoice-approvals/settings

curl -X PUT https://api.damedoklad.cz/v1/invoice-approvals/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "required": false
}'

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

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/invoice-approvals/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "required": False
    },
)
data = response.json()

List job orders (zakázky) with revenue, cost, and margin from the books

GET/v1/job-orders

List job orders (zakázky) with revenue, cost, and margin from the books

Nástroj MCP: list-job-orders

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"planned" | "active" | "finished" | "cancelled"

contactIdstring

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

Odpověď · 200

dataobject[]povinné

object"job_order"povinné

idstringpovinné

numberstringpovinné

namestringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

dimensionIdstringpovinné

statusstringpovinné

startsOnnull | stringpovinnédate

endsOnstring | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

notestring | nullpovinné

profitabilityobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

monthsobject[]

monthnull | stringpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

documentsobject[]

kindstringpovinné

tabnull | stringpovinné

idstringpovinné

numberstringpovinné

statusstringpovinné

contactNamenull | stringpovinné

datestringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/job-orders

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

const response = await fetch('https://api.damedoklad.cz/v1/job-orders', {
  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/job-orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Create a job order. It gets its own project dimension to choose on documents, so their postings count toward it

POST/v1/job-orders

Create a job order. It gets its own project dimension to choose on documents, so their postings count toward it

Nástroj MCP: create-job-order

Tělo požadavku

namestringpovinnémax 200 chars

contactIdstring | null

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

status"planned" | "active" | "finished" | "cancelled"

startsOnstring | null

Date as YYYY-MM-DD.

endsOnstring | null

Date as YYYY-MM-DD.

budgetRevenueHalerintegermin 0max 9007199254740991

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

budgetCostHalerintegermin 0max 9007199254740991

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

notestring | null

Odpověď · 201

idstringpovinné

numberstringpovinné

namestringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

dimensionIdstringpovinné

statusstringpovinné

startsOnnull | stringpovinnédate

endsOnstring | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

notestring | nullpovinné

profitabilityobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

monthsobject[]

monthnull | stringpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

documentsobject[]

kindstringpovinné

tabnull | stringpovinné

idstringpovinné

numberstringpovinné

statusstringpovinné

contactNamenull | stringpovinné

datestringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

POST/v1/job-orders

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

const response = await fetch('https://api.damedoklad.cz/v1/job-orders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "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/job-orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Get a job order with its documents, monthly revenue and cost, and profitability

GET/v1/job-orders/{id}

Get a job order with its documents, monthly revenue and cost, and profitability

Nástroj MCP: get-job-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

namestringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

dimensionIdstringpovinné

statusstringpovinné

startsOnnull | stringpovinnédate

endsOnstring | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

notestring | nullpovinné

profitabilityobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

monthsobject[]

monthnull | stringpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

documentsobject[]

kindstringpovinné

tabnull | stringpovinné

idstringpovinné

numberstringpovinné

statusstringpovinné

contactNamenull | stringpovinné

datestringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

GET/v1/job-orders/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/job-orders/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/job-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Update a job order. Cancelling it hides its dimension from new documents

PATCH/v1/job-orders/{id}

Update a job order. Cancelling it hides its dimension from new documents

Nástroj MCP: update-job-order

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

contactIdstring | null

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

status"planned" | "active" | "finished" | "cancelled"

startsOnstring | null

Date as YYYY-MM-DD.

endsOnstring | null

Date as YYYY-MM-DD.

budgetRevenueHalerintegermin 0max 9007199254740991

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

budgetCostHalerintegermin 0max 9007199254740991

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

notestring | null

Odpověď · 200

idstringpovinné

numberstringpovinné

namestringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

dimensionIdstringpovinné

statusstringpovinné

startsOnnull | stringpovinnédate

endsOnstring | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

notestring | nullpovinné

profitabilityobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

monthsobject[]

monthnull | stringpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

documentsobject[]

kindstringpovinné

tabnull | stringpovinné

idstringpovinné

numberstringpovinné

statusstringpovinné

contactNamenull | stringpovinné

datestringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

PATCH/v1/job-orders/{id}

curl -X PATCH https://api.damedoklad.cz/v1/job-orders/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",
  "status": "planned"
}'

const response = await fetch('https://api.damedoklad.cz/v1/job-orders/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",
    "status": "planned"
  }),
});
const data = await response.json();

import os
import requests

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

Delete a job order nothing was posted or linked to. Otherwise cancel it

DELETE/v1/job-orders/{id}

Delete a job order nothing was posted or linked to. Otherwise cancel it

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

Nástroj MCP: delete-job-order

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/job-orders/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/job-orders/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/job-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Assign a draft document to a job order. A posted document cannot move: its journal entry already carries the dimension

POST/v1/job-orders/{id}/documents

Assign a draft document to a job order. A posted document cannot move: its journal entry already carries the dimension

Nástroj MCP: link-job-order-document

Parametry v cestě

idstringpovinné

Tělo požadavku

kind"invoice" | "received_invoice" | "credit_note" | "proforma"povinné

documentIdstringpovinné

ID of the document.

Odpověď · 200

jobOrderIdnull | stringpovinné

kindstringpovinné

documentIdnull | stringpovinné

POST/v1/job-orders/{id}/documents

curl -X POST https://api.damedoklad.cz/v1/job-orders/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

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

import os
import requests

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

Profitability report across job orders: revenue, cost, margin, and budget use, with totals

GET/v1/job-orders/report

Profitability report across job orders: revenue, cost, margin, and budget use, with totals

Nástroj MCP: get-job-order-report

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"planned" | "active" | "finished" | "cancelled"

contactIdstring

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

Odpověď · 200

dataobject[]povinné

object"job_order"povinné

idstringpovinné

numberstringpovinné

namestringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

dimensionIdstringpovinné

statusstringpovinné

startsOnnull | stringpovinnédate

endsOnstring | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

notestring | nullpovinné

profitabilityobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

monthsobject[]

monthnull | stringpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

documentsobject[]

kindstringpovinné

tabnull | stringpovinné

idstringpovinné

numberstringpovinné

statusstringpovinné

contactNamenull | stringpovinné

datestringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

totalsobjectpovinné

revenueHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentinteger | nullpovinné

budgetRevenueHalerintegerpovinné

budgetCostHalerintegerpovinné

budgetMarginHalerintegerpovinné

revenueBudgetUsedPercentinteger | nullpovinné

costBudgetUsedPercentinteger | nullpovinné

costBudgetLeftHalerinteger | nullpovinné

overBudgetbooleanpovinné

GET/v1/job-orders/report

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

const response = await fetch('https://api.damedoklad.cz/v1/job-orders/report', {
  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/job-orders/report",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get the document print options: logo position, accent colour, footer, and what shows

GET/v1/print-template

Get the document print options: logo position, accent colour, footer, and what shows

Nástroj MCP: get-print-template

Odpověď · 200

logoPositionstringpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

showBankDetailsbooleanpovinné

showNotesbooleanpovinné

showSellerContactbooleanpovinné

showSignaturebooleanpovinné

hasLogobooleanpovinné

hasStampboolean

GET/v1/print-template

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template', {
  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/print-template",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the document print options. New PDFs use them; an issued document keeps the PDF it was issued with

PUT/v1/print-template

Set the document print options. New PDFs use them; an issued document keeps the PDF it was issued with. What the law requires on a tax document, such as seller and buyer, VAT breakdown, and tax wording, cannot be switched off.

Nástroj MCP: update-print-template

Tělo požadavku

logoPosition"left" | "center" | "right"

accentColorstring | null

footerTextstring | null

showLogoboolean

showQrCodeboolean

showBankDetailsboolean

showNotesboolean

showSellerContactboolean

showSignatureboolean

Odpověď · 200

logoPositionstringpovinné

accentColornull | stringpovinné

footerTextnull | stringpovinné

showLogobooleanpovinné

showQrCodebooleanpovinné

showBankDetailsbooleanpovinné

showNotesbooleanpovinné

showSellerContactbooleanpovinné

showSignaturebooleanpovinné

hasLogobooleanpovinné

hasStampboolean

PUT/v1/print-template

curl -X PUT https://api.damedoklad.cz/v1/print-template \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "logoPosition": "left",
  "accentColor": "string",
  "footerText": "string"
}'

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

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/print-template",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "logoPosition": "left",
        "accentColor": "string",
        "footerText": "string"
    },
)
data = response.json()

List the document types with a print layout: their blocks and columns, which of them the law keeps on the document, and the languages each prints in

GET/v1/print-template/catalog

List the document types with a print layout: their blocks and columns, which of them the law keeps on the document, and the languages each prints in

Nástroj MCP: get-print-catalog

Odpověď · 200

typesobject[]povinné

typestringpovinné

languagesstring[]povinné

blocksobject[]povinné

keystringpovinné

requiredbooleanpovinné

columnsobject[]povinné

keystringpovinné

widthintegerpovinné

requiredbooleanpovinné

flexiblebooleanpovinné

freeOnlyboolean

designobject

typestringpovinné

freeOnlybooleanpovinné

pagesstring[]povinné

customPagebooleanpovinné

sheetbooleanpovinné

blocksobject[]povinné

keystringpovinné

requiredbooleanpovinné

reasonnull | stringpovinné

minWidthintegerpovinné

fieldsobject[]povinné

keystringpovinné

kindstringpovinné

listbooleanpovinné

linkKindsstring[]povinné

requiredFieldsstring[]povinné

optionsobject

elementsstring[]povinné

formatsstring[]povinné

alignsstring[]povinné

symbologiesstring[]povinné

contentKindsstring[]povinné

imageSourcesstring[]povinné

chartsstring[]povinné

shapesstring[]povinné

functionsstring[]povinné

pagesobjectpovinné

a4objectpovinné

widthintegerpovinné

heightintegerpovinné

a4_landscapeobjectpovinné

widthintegerpovinné

heightintegerpovinné

a5objectpovinné

widthintegerpovinné

heightintegerpovinné

receipt80objectpovinné

widthintegerpovinné

heightanypovinné

Null in every recorded response.

GET/v1/print-template/catalog

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/catalog', {
  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/print-template/catalog",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Check a layout without saving it, and say by name what stops it being used: anything the law requires that is missing or covered, a formula that cannot be read, a field the document does not have

POST/v1/print-template/check

Check a layout without saving it, and say by name what stops it being used: anything the law requires that is missing or covered, a formula that cannot be read, a field the document does not have

Nástroj MCP: check-print-layout

Tělo požadavku

layoutobjectpovinné

mode"free"povinné

pageobjectpovinné

elementsobject[]povinné

columnsobject[]

keystringpovinnémax 40 chars

visibleboolean

widthnumbermin 0max 200

Odpověď · 200

okbooleanpovinné

problemsobject[]povinné

codenull | stringpovinné

messagenull | stringpovinné

blockstring

POST/v1/print-template/check

curl -X POST https://api.damedoklad.cz/v1/print-template/check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "layout": {
    "mode": "free",
    "page": {},
    "elements": [
      {}
    ]
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/print-template/check', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "layout": {
      "mode": "free",
      "page": {},
      "elements": [
        {}
      ]
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/print-template/check",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "layout": {
            "mode": "free",
            "page": {},
            "elements": [
                {}
            ]
        }
    },
)
data = response.json()

Get the pictures a layout can use: PNG and JPEG images from the document archive, and pictures of stock items

GET/v1/print-template/images

Get the pictures a layout can use: PNG and JPEG images from the document archive, and pictures of stock items

Nástroj MCP: get-print-images

Odpověď · 200

archiveobject[]povinné

fileIdnull | stringpovinné

titlenull | stringpovinné

itemsobject[]povinné

fileIdnull | stringpovinné

itemIdnull | stringpovinné

titlenull | stringpovinné

GET/v1/print-template/images

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/images', {
  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/print-template/images",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download a picture from the archive or a stock item, to show it in the layout editor

GET/v1/print-template/images/{id}

Download a picture from the archive or a stock item, to show it in the layout editor

Nástroj MCP: get-print-image

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor image/png.

GET/v1/print-template/images/{id}

curl https://api.damedoklad.cz/v1/print-template/images/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/print-template/images/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  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/print-template/images/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Print labels on a sheet: stock items or the addresses of contacts, in the default variant or the one asked for. A part-used sheet can go through again with `skip`

POST/v1/print-template/labels

Print labels on a sheet: stock items or the addresses of contacts, in the default variant or the one asked for. A part-used sheet can go through again with `skip`

Nástroj MCP: print-labels

Tělo požadavku

documentType"item_label" | "contact_label"povinné

idsstring[]povinné

copiesintegermin 1max 100

skipintegermin 0max 479

variantIdstring

ID of the variant.

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/print-template/labels

curl -X POST https://api.damedoklad.cz/v1/print-template/labels \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "item_label",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/print-template/labels', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "item_label",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/print-template/labels",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "item_label",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Get the print layout of a document type: which blocks appear in what order, the line table columns and their widths, added text. Language optional; without it, the layout all languages share

GET/v1/print-template/layouts/{documentType}

Get the print layout of a document type: which blocks appear in what order, the line table columns and their widths, added text. Language optional; without it, the layout all languages share

Nástroj MCP: get-print-layout

Parametry v cestě

documentTypestringpovinné

Parametry dotazu

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

Odpověď · 200

documentTypenull | stringpovinné

languagenull | stringpovinné

customizedbooleanpovinné

blocksobject[]povinné

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]povinné

keystringpovinné

visiblebooleanpovinné

widthintegerpovinné

GET/v1/print-template/layouts/{documentType}

curl https://api.damedoklad.cz/v1/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/print-template/layouts/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/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Set the print layout of a document type, for one language or for all. New PDFs use it; an issued document keeps the PDF it was issued with

PUT/v1/print-template/layouts/{documentType}

Set the print layout of a document type, for one language or for all. New PDFs use it; an issued document keeps the PDF it was issued with. Blocks and columns the law requires are refused when hidden, so a tax document stays a tax document. To place things freely on the page, save a free layout as a print variant.

Nástroj MCP: update-print-layout

Parametry v cestě

documentTypestringpovinné

Tělo požadavku

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

blocksobject[]povinné

keystringpovinnémax 60 chars

visibleboolean

textstringmax 1000 chars

columnsobject[]

keystringpovinnémax 40 chars

visibleboolean

widthnumbermin 0max 200

Odpověď · 200

documentTypenull | stringpovinné

languagenull | stringpovinné

customizedbooleanpovinné

blocksobject[]povinné

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]povinné

keystringpovinné

visiblebooleanpovinné

widthintegerpovinné

PUT/v1/print-template/layouts/{documentType}

curl -X PUT https://api.damedoklad.cz/v1/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "blocks": [
    {
      "key": "string"
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "blocks": [
      {
        "key": "string"
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "blocks": [
            {
                "key": "string"
            }
        ]
    },
)
data = response.json()

Forget the print layout of a document type and go back to the built-in one

DELETE/v1/print-template/layouts/{documentType}

Forget the print layout of a document type and go back to the built-in one

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

Nástroj MCP: reset-print-layout

Parametry v cestě

documentTypestringpovinné

Parametry dotazu

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

Odpověď · 200

documentTypenull | stringpovinné

languagenull | stringpovinné

customizedbooleanpovinné

blocksobject[]povinné

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]povinné

keystringpovinné

visiblebooleanpovinné

widthintegerpovinné

DELETE/v1/print-template/layouts/{documentType}

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/layouts/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/print-template/layouts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Fill in Poštovní poukázka A for what a document asks to be paid, to print over a form from Česká pošta

POST/v1/print-template/postal-order

Fill in Poštovní poukázka A for what a document asks to be paid, to print over a form from Česká pošta. Values follow the Česká pošta notice for account holders: whole crowns, equals signs in empty places, the account checked by modulo 11, codes 110 and 116. Field positions of the starting layout come from the dimensioned drawing in its Technická specifikace Pk A of 1. 6. 2019, read from a web archive's copy, with OCR-B type in the boxes and reading zone. A saved layout keeps its own positions. The notice requires machine-printed forms to be approved by Česká pošta from 20 samples, and the file number it assigns to be on each. Nothing has been printed on paper, and approval is the post's decision.

Nástroj MCP: print-postal-order

Tělo požadavku

documentType"invoice" | "proforma" | "reminder"povinné

documentIdstringpovinné

ID of the document.

kind"standard" | "cash_on_delivery"

variantIdstring

ID of the variant.

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/print-template/postal-order

curl -X POST https://api.damedoklad.cz/v1/print-template/postal-order \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/print-template/postal-order', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/print-template/postal-order",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
content = response.content

Render a sample PDF of a document type with these options and this layout, without saving them. Refreshing it after each change is a live preview

POST/v1/print-template/preview

Render a sample PDF of a document type with these options and this layout, without saving them. Refreshing it after each change is a live preview

Nástroj MCP: preview-print-template

Parametry dotazu

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

Tělo požadavku

logoPosition"left" | "center" | "right"

accentColorstring | null

footerTextstring | null

showLogoboolean

showQrCodeboolean

showBankDetailsboolean

showNotesboolean

showSellerContactboolean

showSignatureboolean

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

layoutobject

mode"free"povinné

pageobjectpovinné

elementsobject[]povinné

columnsobject[]

keystringpovinnémax 40 chars

visibleboolean

widthnumbermin 0max 200

variantIdstring

ID of the variant.

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/print-template/preview

curl -X POST https://api.damedoklad.cz/v1/print-template/preview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "logoPosition": "left",
  "accentColor": "string",
  "footerText": "string"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/print-template/preview', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "logoPosition": "left",
    "accentColor": "string",
    "footerText": "string"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/print-template/preview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "logoPosition": "left",
        "accentColor": "string",
        "footerText": "string"
    },
)
content = response.content

Print a document in a variant, together with what is linked to that variant, as one PDF. The PDF stored when it was issued stays its original

POST/v1/print-template/print

Print a document in a variant, together with what is linked to that variant, as one PDF. The PDF stored when it was issued stays its original. Without a variant it uses the default for the document. `alone` leaves linked reports out.

Nástroj MCP: print-document-variant

Tělo požadavku

documentIdstringpovinné

ID of the document.

variantIdstring

ID of the variant.

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

aloneboolean

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/print-template/print

curl -X POST https://api.damedoklad.cz/v1/print-template/print \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "invoice",
  "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/print-template/print', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/print-template/print",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "documentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
content = response.content

List the saved variants of the reports, for one document type or all, with which is the default

GET/v1/print-template/variants

List the saved variants of the reports, for one document type or all, with which is the default

Nástroj MCP: list-print-variants

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"print_variant"povinné

idstringpovinné

documentTypestringpovinné

languagenull | stringpovinné

namestringpovinné

isDefaultbooleanpovinné

modestringpovinné

layoutobjectpovinné

modestringpovinné

pageobject

presetstringpovinné

sheetobject

elementsobject[]

hintegerpovinné

wintegerpovinné

xintegerpovinné

yintegerpovinné

idstringpovinné

keystring

typestringpovinné

textstring

boldboolean

colorstring

fieldnull | string

expressionstring

contentobject

symbologystring

chartstring

labelsstring

valuesstring

fileIdnull | string

sourcestring

itemImagesboolean

lineinteger

itemIdnull | string

blocksobject[]

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]

keystringpovinné

widthintegerpovinné

visiblebooleanpovinné

linkedobject[]povinné

kindstringpovinné

variantIdstring

problemsobject[]povinné

codenull | stringpovinné

blockstringpovinné

messagenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/print-template/variants

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/variants', {
  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/print-template/variants",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save a named variant of a report. Without a layout it starts from a free layout that holds everything the document requires

POST/v1/print-template/variants

Save a named variant of a report. Without a layout it starts from a free layout that holds everything the document requires. A free layout places elements anywhere on the page in millimetres. A layout that leaves out or covers something the law requires is refused with the reason by name in `problems`. Marking it as the default makes new PDFs use it; an issued document keeps the PDF it was issued with.

Nástroj MCP: create-print-variant

Tělo požadavku

namestringpovinnémax 80 chars

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

isDefaultboolean

layoutobject

mode"free"povinné

pageobjectpovinné

elementsobject[]povinné

columnsobject[]

keystringpovinnémax 40 chars

visibleboolean

widthnumbermin 0max 200

linkedobject[]

kindstringpovinnémax 40 chars

variantIdstring

ID of the variant.

Odpověď · 201

idstringpovinné

documentTypestringpovinné

languagenull | stringpovinné

namestringpovinné

isDefaultbooleanpovinné

modestringpovinné

layoutobjectpovinné

modestringpovinné

pageobject

presetstringpovinné

sheetobject

gapXintegerpovinné

gapYintegerpovinné

rowsintegerpovinné

columnsintegerpovinné

offsetXintegerpovinné

offsetYintegerpovinné

labelWidthintegerpovinné

labelHeightintegerpovinné

elementsobject[]

hintegerpovinné

wintegerpovinné

xintegerpovinné

yintegerpovinné

idstringpovinné

keystring

typestringpovinné

textstring

boldboolean

colorstring

fieldnull | string

expressionstring

contentobject

kindstringpovinné

valuestring

symbologystring

chartstring

labelsstring

valuesstring

fileIdnull | string

sourcestring

itemImagesboolean

lineinteger

itemIdnull | string

blocksobject[]

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]

keystringpovinné

widthintegerpovinné

visiblebooleanpovinné

linkedobject[]povinné

kindstringpovinné

variantIdstring

problemsobject[]povinné

codenull | stringpovinné

blockstringpovinné

messagenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

POST/v1/print-template/variants

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/variants', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "documentType": "invoice",
    "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/print-template/variants",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "invoice",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Get one saved variant of a report with its layout, what prints with it, and anything that stops it printing

GET/v1/print-template/variants/{id}

Get one saved variant of a report with its layout, what prints with it, and anything that stops it printing

Nástroj MCP: get-print-variant

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

documentTypestringpovinné

languagenull | stringpovinné

namestringpovinné

isDefaultbooleanpovinné

modestringpovinné

layoutobjectpovinné

modestringpovinné

pageobject

presetstringpovinné

sheetobject

gapXintegerpovinné

gapYintegerpovinné

rowsintegerpovinné

columnsintegerpovinné

offsetXintegerpovinné

offsetYintegerpovinné

labelWidthintegerpovinné

labelHeightintegerpovinné

elementsobject[]

hintegerpovinné

wintegerpovinné

xintegerpovinné

yintegerpovinné

idstringpovinné

keystring

typestringpovinné

textstring

boldboolean

colorstring

fieldnull | string

expressionstring

contentobject

kindstringpovinné

valuestring

symbologystring

chartstring

labelsstring

valuesstring

fileIdnull | string

sourcestring

itemImagesboolean

lineinteger

itemIdnull | string

blocksobject[]

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]

keystringpovinné

widthintegerpovinné

visiblebooleanpovinné

linkedobject[]povinné

kindstringpovinné

variantIdstring

problemsobject[]povinné

codenull | stringpovinné

blockstringpovinné

messagenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

GET/v1/print-template/variants/{id}

curl https://api.damedoklad.cz/v1/print-template/variants/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/print-template/variants/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/print-template/variants/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change a saved variant: its name, layout, what prints with it, or whether it is the default

PUT/v1/print-template/variants/{id}

Change a saved variant: its name, layout, what prints with it, or whether it is the default. A layout that leaves out or covers something the law requires is refused with the reason by name in `problems`.

Nástroj MCP: update-print-variant

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 80 chars

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

isDefaultboolean

layoutobject

mode"free"povinné

pageobjectpovinné

elementsobject[]povinné

columnsobject[]

keystringpovinnémax 40 chars

visibleboolean

widthnumbermin 0max 200

linkedobject[]

kindstringpovinnémax 40 chars

variantIdstring

ID of the variant.

Odpověď · 200

idstringpovinné

documentTypestringpovinné

languagenull | stringpovinné

namestringpovinné

isDefaultbooleanpovinné

modestringpovinné

layoutobjectpovinné

modestringpovinné

pageobject

presetstringpovinné

sheetobject

gapXintegerpovinné

gapYintegerpovinné

rowsintegerpovinné

columnsintegerpovinné

offsetXintegerpovinné

offsetYintegerpovinné

labelWidthintegerpovinné

labelHeightintegerpovinné

elementsobject[]

hintegerpovinné

wintegerpovinné

xintegerpovinné

yintegerpovinné

idstringpovinné

keystring

typestringpovinné

textstring

boldboolean

colorstring

fieldnull | string

expressionstring

contentobject

kindstringpovinné

valuestring

symbologystring

chartstring

labelsstring

valuesstring

fileIdnull | string

sourcestring

itemImagesboolean

lineinteger

itemIdnull | string

blocksobject[]

keystringpovinné

visiblebooleanpovinné

textstring

columnsobject[]

keystringpovinné

widthintegerpovinné

visiblebooleanpovinné

linkedobject[]povinné

kindstringpovinné

variantIdstring

problemsobject[]povinné

codenull | stringpovinné

blockstringpovinné

messagenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

PUT/v1/print-template/variants/{id}

curl -X PUT https://api.damedoklad.cz/v1/print-template/variants/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "language": "cs",
  "isDefault": false
}'

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

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/print-template/variants/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "language": "cs",
        "isDefault": False
    },
)
data = response.json()

Delete a saved variant. If it was the default, the section layout prints again. Other variants linked to it stop printing it

DELETE/v1/print-template/variants/{id}

Delete a saved variant. If it was the default, the section layout prints again. Other variants linked to it stop printing it

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

Nástroj MCP: delete-print-variant

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/print-template/variants/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/print-template/variants/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/print-template/variants/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Send a received invoice for approval, or again after a rejection: to one approver (one click, the default) or through a scenario of several in order

POST/v1/received-invoices/{id}/approval

Send a received invoice for approval, or again after a rejection: to one approver (one click, the default) or through a scenario of several in order

Nástroj MCP: request-invoice-approval

Parametry v cestě

idstringpovinné

Tělo požadavku

approverIdstring | null

ID of the approver.

scenarioIdstring | null

ID of the scenario.

commentstring | null

Odpověď · 201

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

POST/v1/received-invoices/{id}/approval

curl -X POST https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "comment": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "comment": "string"
    },
)
data = response.json()

Send a draft sales document, such as an issued order, for approval before it is issued: to one approver or through a scenario

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

Send a draft sales document, such as an issued order, for approval before it is issued: to one approver or through a scenario. Which kinds must be approved before issue is a company setting (salesKinds). Changing the lines, partner or currency of an approved draft cancels the approval.

Nástroj MCP: request-sales-document-approval

Parametry v cestě

idstringpovinné

Tělo požadavku

approverIdstring | null

ID of the approver.

scenarioIdstring | null

ID of the scenario.

commentstring | null

Odpověď · 201

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

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

curl -X POST https://api.damedoklad.cz/v1/sales/documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "comment": "string"
}'

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

import os
import requests

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

List saved custom reports

GET/v1/saved-reports

List saved custom reports

Nástroj MCP: list-saved-reports

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"saved_report"povinné

idstringpovinné

namestringpovinné

agendastringpovinné

sortByanypovinné

Null in every recorded response.

totalsstring[]povinné

columnsstring[]povinné

filtersobject[]povinné

valuestringpovinné

columnstringpovinné

operatorstringpovinné

groupByanypovinné

Null in every recorded response.

sortDirectionstringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/saved-reports

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports', {
  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/saved-reports",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Save a custom report

POST/v1/saved-reports

Save a custom report

Nástroj MCP: create-saved-report

Tělo požadavku

namestringpovinnémax 200 chars

agendastringpovinnémax 60 chars

columnsstring[]povinné

filtersobject[]

columnstringpovinnémax 60 chars

operator"eq" | "ne" | "contains" | "gte" | "lte" | "empty" | "not_empty"povinné

valuestring | number | null

totalsstring[]

sortBystring | null

sortDirection"asc" | "desc"

groupBystring | null

Odpověď · 201

idstringpovinné

namestringpovinné

agendastringpovinné

sortByanypovinné

Null in every recorded response.

totalsstring[]povinné

columnsstring[]povinné

filtersobject[]povinné

valuestringpovinné

columnstringpovinné

operatorstringpovinné

groupByanypovinné

Null in every recorded response.

sortDirectionstringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

POST/v1/saved-reports

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports', {
  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.",
    "agenda": "string",
    "columns": [
      "string"
    ]
  }),
});
const data = await response.json();

import os
import requests

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

Get a saved report

GET/v1/saved-reports/{id}

Get a saved report

Nástroj MCP: get-saved-report

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namestringpovinné

agendastringpovinné

sortByanypovinné

Null in every recorded response.

totalsstring[]povinné

columnsstring[]povinné

filtersobject[]povinné

valuestringpovinné

columnstringpovinné

operatorstringpovinné

groupByanypovinné

Null in every recorded response.

sortDirectionstringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

GET/v1/saved-reports/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/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/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Change a saved report

PATCH/v1/saved-reports/{id}

Change a saved report

Nástroj MCP: update-saved-report

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

agendastringmax 60 chars

columnsstring[]

filtersobject[]

columnstringpovinnémax 60 chars

operator"eq" | "ne" | "contains" | "gte" | "lte" | "empty" | "not_empty"povinné

valuestring | number | null

totalsstring[]

sortBystring | null

sortDirection"asc" | "desc"

groupBystring | null

Odpověď · 200

idstringpovinné

namestringpovinné

agendastringpovinné

sortByanypovinné

Null in every recorded response.

totalsstring[]povinné

columnsstring[]povinné

filtersobject[]povinné

valuestringpovinné

columnstringpovinné

operatorstringpovinné

groupByanypovinné

Null in every recorded response.

sortDirectionstringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

PATCH/v1/saved-reports/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/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.",
    "agenda": "string",
    "columns": [
      "string"
    ]
  }),
});
const data = await response.json();

import os
import requests

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

Delete a saved report

DELETE/v1/saved-reports/{id}

Delete a saved report

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

Nástroj MCP: delete-saved-report

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/saved-reports/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/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/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Export a saved report as format=xlsx, csv, or pdf

GET/v1/saved-reports/{id}/export

Export a saved report as format=xlsx, csv, or pdf

Nástroj MCP: export-saved-report

Parametry v cestě

idstringpovinné

Parametry dotazu

format"csv" | "xlsx" | "pdf"

language"cs" | "en"

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/saved-reports/{id}/export

curl https://api.damedoklad.cz/v1/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/export', {
  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/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Run a saved report

GET/v1/saved-reports/{id}/run

Run a saved report

Nástroj MCP: run-saved-report

Parametry v cestě

idstringpovinné

Parametry dotazu

format"csv" | "xlsx" | "pdf"

language"cs" | "en"

Odpověď · 200

agendastringpovinné

columnsobject[]povinné

keystringpovinné

typestringpovinné

labelnull | stringpovinné

rowsobject[]povinné

accountNumbernull | string

debitHalerinteger

pairingSymbolnull | string

documentTypenull | string

numbernull | string

totalHalerinteger | null

contactNamenull | string

statusstring

netHalerinteger

namenull | string

icostring | null

dicstring | null

emailnull | string

phonestring | null

rolesstring

totalsobjectpovinné

overallobjectpovinné

debitHalerinteger

netHalerinteger

totalHalerinteger | null

groupsobject[]povinné

valuestringpovinné

countintegerpovinné

totalsobjectpovinné

netHalerintegerpovinné

totalHalerinteger | nullpovinné

truncatedbooleanpovinné

mixedCurrenciesbooleanpovinné

namenull | string

GET/v1/saved-reports/{id}/run

curl https://api.damedoklad.cz/v1/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/run \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/run', {
  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/saved-reports/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/run",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

What a custom report can show: agendas, their columns, and the conditions each column allows

GET/v1/saved-reports/catalog

What a custom report can show: agendas, their columns, and the conditions each column allows

Nástroj MCP: get-report-catalog

Odpověď · 200

agendasobject[]povinné

keystringpovinné

csstringpovinné

enstringpovinné

defaultColumnsstring[]povinné

columnsobject[]povinné

keystringpovinné

typestringpovinné

csstringpovinné

enstringpovinné

operatorsstring[]povinné

GET/v1/saved-reports/catalog

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

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/catalog', {
  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/saved-reports/catalog",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Export a custom report as format=xlsx, csv, or pdf without saving it

POST/v1/saved-reports/export

Export a custom report as format=xlsx, csv, or pdf without saving it

Nástroj MCP: export-custom-report

Parametry dotazu

format"csv" | "xlsx" | "pdf"

language"cs" | "en"

Tělo požadavku

agendastringpovinnémax 60 chars

columnsstring[]povinné

filtersobject[]

columnstringpovinnémax 60 chars

operator"eq" | "ne" | "contains" | "gte" | "lte" | "empty" | "not_empty"povinné

valuestring | number | null

totalsstring[]

sortBystring | null

sortDirection"asc" | "desc"

groupBystring | null

Odpověď · 200

Vrací soubor application/octet-stream.

POST/v1/saved-reports/export

curl -X POST https://api.damedoklad.cz/v1/saved-reports/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agenda": "string",
  "columns": [
    "string"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/export', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "agenda": "string",
    "columns": [
      "string"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/saved-reports/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "agenda": "string",
        "columns": [
            "string"
        ]
    },
)
content = response.content

Run a custom report without saving it. Returns rows and totals, up to 5000 rows

POST/v1/saved-reports/run

Run a custom report without saving it. Returns rows and totals, up to 5000 rows

Nástroj MCP: run-report

Parametry dotazu

format"csv" | "xlsx" | "pdf"

language"cs" | "en"

Tělo požadavku

agendastringpovinnémax 60 chars

columnsstring[]povinné

filtersobject[]

columnstringpovinnémax 60 chars

operator"eq" | "ne" | "contains" | "gte" | "lte" | "empty" | "not_empty"povinné

valuestring | number | null

totalsstring[]

sortBystring | null

sortDirection"asc" | "desc"

groupBystring | null

Odpověď · 200

agendastringpovinné

columnsobject[]povinné

keystringpovinné

typestringpovinné

labelnull | stringpovinné

rowsobject[]povinné

accountNumbernull | string

debitHalerinteger

pairingSymbolnull | string

documentTypenull | string

numbernull | string

totalHalerinteger | null

contactNamenull | string

statusstring

netHalerinteger

namenull | string

icostring | null

dicstring | null

emailnull | string

phonestring | null

rolesstring

totalsobjectpovinné

overallobjectpovinné

debitHalerinteger

netHalerinteger

totalHalerinteger | null

groupsobject[]povinné

valuestringpovinné

countintegerpovinné

totalsobjectpovinné

netHalerintegerpovinné

totalHalerinteger | nullpovinné

truncatedbooleanpovinné

mixedCurrenciesbooleanpovinné

namenull | string

POST/v1/saved-reports/run

curl -X POST https://api.damedoklad.cz/v1/saved-reports/run \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agenda": "string",
  "columns": [
    "string"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/saved-reports/run', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "agenda": "string",
    "columns": [
      "string"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/saved-reports/run",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "agenda": "string",
        "columns": [
            "string"
        ]
    },
)
data = response.json()

List service jobs

GET/v1/service-jobs

List service jobs

Nástroj MCP: list-service-jobs

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.

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"service_job"povinné

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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é

orderLineIdnull | stringpovinné

recyclingnull | object

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[]

balancedboolean

cashJournalobject[]

receivablesBookobject[]

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é

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/service-jobs

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs', {
  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/service-jobs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Take in a device for service

POST/v1/service-jobs

Take in a device for service

Nástroj MCP: create-service-job

Tělo požadavku

contactIdstringpovinné

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

deviceNamestringpovinnémax 200 chars

serialNumberstring | null

problemstringpovinnémax 4000 chars

accessoriesstring | null

diagnosisstring | null

receivedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

promisedOnstring | null

Date as YYYY-MM-DD.

warrantyboolean

jobOrderIdstring | null

ID of the job order. Find it with list-job-orders.

notestring | null

seriesIdstring

Number series of service jobs. Without it, the default one.

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs

curl -X POST https://api.damedoklad.cz/v1/service-jobs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "deviceName": "Pekárna U Lípy s.r.o.",
  "problem": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/service-jobs",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "deviceName": "Pekárna U Lípy s.r.o.",
        "problem": "string"
    },
)
data = response.json()

Get a service job with its work log, parts, and totals

GET/v1/service-jobs/{id}

Get a service job with its work log, parts, and totals

Nástroj MCP: get-service-job

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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é

GET/v1/service-jobs/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Edit an open service job

PATCH/v1/service-jobs/{id}

Edit an open service job

Nástroj MCP: update-service-job

Parametry v cestě

idstringpovinné

Tělo požadavku

contactIdstring

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

deviceNamestringmax 200 chars

serialNumberstring | null

problemstringmax 4000 chars

accessoriesstring | null

diagnosisstring | null

receivedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

promisedOnstring | null

Date as YYYY-MM-DD.

warrantyboolean

jobOrderIdstring | null

ID of the job order. Find it with list-job-orders.

notestring | null

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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é

PATCH/v1/service-jobs/{id}

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

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

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "deviceName": "Pekárna U Lípy s.r.o.",
        "serialNumber": "string"
    },
)
data = response.json()

Delete a service job that has no parts yet. Otherwise cancel it

DELETE/v1/service-jobs/{id}

Delete a service job that has no parts yet. Otherwise cancel it

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

Nástroj MCP: delete-service-job

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/service-jobs/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Close a service job without an invoice, such as a warranty repair

POST/v1/service-jobs/{id}/close

Close a service job without an invoice, such as a warranty repair

Nástroj MCP: close-service-job

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs/{id}/close

curl -X POST https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close', {
  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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/close",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Turn a service job into an invoice from its work log and parts, as a draft unless issue is set

POST/v1/service-jobs/{id}/invoice

Turn a service job into an invoice from its work log and parts, as a draft unless issue is set

Nástroj MCP: invoice-service-job

Parametry v cestě

idstringpovinné

Tělo požadavku

issueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

taxPointDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

dueDatestringYYYY-MM-DD

Date as YYYY-MM-DD.

issueboolean

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs/{id}/invoice

curl -X POST https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/invoice \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30",
  "dueDate": "2026-10-30"
}'

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

import os
import requests

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

Use a part from stock on a service job. The stock issue posts at once; there must be enough in the warehouse. On a warranty repair it posts as a cost (548), not as a sale

POST/v1/service-jobs/{id}/parts

Use a part from stock on a service job. The stock issue posts at once; there must be enough in the warehouse. On a warranty repair it posts as a cost (548), not as a sale

Nástroj MCP: add-service-job-part

Parametry v cestě

idstringpovinné

Tělo požadavku

itemIdstringpovinné

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

warehouseIdstringpovinné

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

quantitynumberpovinnémax 1000000000

unitPriceHalerintegermin 0max 9007199254740991

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

vatRate0 | 10 | 12 | 15 | 21

usedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs/{id}/parts

curl -X POST https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/parts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "quantity": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/parts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "quantity": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/parts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
    },
)
data = response.json()

Remove a part from a service job and return it to stock by reversing the issue

DELETE/v1/service-jobs/{id}/parts/{childId}

Remove a part from a service job and return it to stock by reversing the issue

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

Nástroj MCP: remove-service-job-part

Parametry v cestě

idstringpovinné

childIdstringpovinné

ID of the child.

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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é

DELETE/v1/service-jobs/{id}/parts/{childId}

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/parts/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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/parts/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Service protocol PDF with device, problem, work, and parts, in Czech, English, German or French

GET/v1/service-jobs/{id}/pdf

Service protocol PDF with device, problem, work, and parts, in Czech, English, German or French

Nástroj MCP: download-service-job-protocol

Parametry v cestě

idstringpovinné

Parametry dotazu

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

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/service-jobs/{id}/pdf

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Move a service job between received, in progress, ready, and cancelled. Cancelling needs its parts removed first

POST/v1/service-jobs/{id}/status

Move a service job between received, in progress, ready, and cancelled. Cancelling needs its parts removed first

Nástroj MCP: set-service-job-status

Parametry v cestě

idstringpovinné

Tělo požadavku

status"received" | "in_progress" | "ready" | "cancelled"povinné

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs/{id}/status

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

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

import os
import requests

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

Log work on a service job

POST/v1/service-jobs/{id}/work

Log work on a service job

Nástroj MCP: add-service-job-work

Parametry v cestě

idstringpovinné

Tělo požadavku

workedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

descriptionstringpovinnémax 400 chars

workerNamestring | null

minutesintegerpovinnémax 100000

hourlyRateHalerintegermin 0max 9007199254740991

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

vatRate0 | 10 | 12 | 15 | 21

Odpověď · 201

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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/service-jobs/{id}/work

curl -X POST https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/work \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Pečivo, říjen",
  "minutes": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/work', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "Pečivo, říjen",
    "minutes": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/work",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "description": "Pečivo, říjen",
        "minutes": 1
    },
)
data = response.json()

Remove a work log entry

DELETE/v1/service-jobs/{id}/work/{childId}

Remove a work log entry

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

Nástroj MCP: remove-service-job-work

Parametry v cestě

idstringpovinné

childIdstringpovinné

ID of the child.

Odpověď · 200

idstringpovinné

numberstringpovinné

contactIdstringpovinné

contactNamenull | stringpovinné

deviceNamestringpovinné

serialNumbernull | stringpovinné

problemstringpovinné

accessoriesstring | nullpovinné

diagnosisstring | nullpovinné

receivedOnstringpovinnédate

promisedOnstring | nullpovinné

finishedOnnull | stringpovinnédate

warrantybooleanpovinné

statusstringpovinné

invoiceIdnull | stringpovinné

jobOrderIdnull | stringpovinné

notenull | stringpovinné

createdAtstringpovinnédate-time

updatedAtstringpovinnédate-time

seriesIdnull | string

customFieldsobject

tistene_polestring

invoiceNumbernull | string

workobject[]

object"service_job_work"povinné

idstringpovinné

workedOnstringpovinnédate

descriptionstringpovinné

workerNamestring | nullpovinné

minutesintegerpovinné

hourlyRateHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

partsobject[]

object"service_job_part"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

descriptionstringpovinné

unitstringpovinné

quantityintegerpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

usedOnstringpovinnédate

netHalerintegerpovinné

workNetHalerinteger

partsNetHalerinteger

totalNetHalerinteger

invoiceobject

object"invoice"povinné

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é

DELETE/v1/service-jobs/{id}/work/{childId}

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

const response = await fetch('https://api.damedoklad.cz/v1/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/work/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/service-jobs/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/work/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Seznam: zásilky

GET/v1/shipments

List shipments (zásilky), by carrier, status, document, or contact

Nástroj MCP: list-shipments

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.

carrierIdstring

ID of the carrier. Find it with list-carriers.

sourceIdstring

ID of the source.

contactIdstring

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

Odpověď · 200

dataobject[]povinné

object"shipment"povinné

idstringpovinné

numberstringpovinné

carrierIdstringpovinné

carrierNamestringpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

sourceNumbernull | stringpovinné

contactIdnull | stringpovinné

recipientNamestringpovinné

recipientStreetnull | stringpovinné

recipientCitynull | stringpovinné

recipientPostalCodenull | stringpovinné

recipientCountrystringpovinné

recipientPhonenull | stringpovinné

recipientEmailnull | stringpovinné

weightGramsinteger | nullpovinné

parcelCountintegerpovinné

codHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

currencystringpovinné

variableSymbolnull | stringpovinné

trackingNumbernull | stringpovinné

pickupPointIdnull | stringpovinné

statusstringpovinné

statusDetailnull | stringpovinné

statusAtnull | stringpovinnédate-time

exportedAtnull | stringpovinnédate-time

shippedOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

externalIdnull | string

preferredDeliveryOnnull | stringdate

preferredDeliveryFromnull | string

preferredDeliveryTonull | string

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/shipments

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

const response = await fetch('https://api.damedoklad.cz/v1/shipments', {
  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/shipments",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Vytvoření: zásilka

POST/v1/shipments

Create a shipment for a carrier. Named from a document, it takes the delivery address and cash on delivery from it; from a contact, its address

Nástroj MCP: create-shipment

Tělo požadavku

carrierIdstringpovinné

ID of the carrier. Find it with list-carriers.

sourceKind"invoice" | "delivery_note" | "proforma" | "order_received"

sourceIdstring

ID of the source.

contactIdstring

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

recipientNamestringmax 160 chars

recipientStreetstring | null

recipientCitystring | null

recipientPostalCodestring | null

recipientCountrystring2 chars

recipientPhonestring | null

recipientEmailstring | null

weightGramsinteger | null

parcelCountintegermax 99

codHalerinteger | null

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

valueHalerinteger | null

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

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

variableSymbolstring | null

trackingNumberstring | null

pickupPointIdstring | null

ID of the pickup point.

preferredDeliveryOnstring | null

The day the recipient asks for. PPL only.

preferredDeliveryFromstring | null

From this time on that day, HH:MM. PPL only.

preferredDeliveryTostring | null

Until this time on that day, HH:MM. PPL only.

shippedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

numberstringpovinné

carrierIdstringpovinné

carrierNamestringpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

sourceNumbernull | stringpovinné

contactIdnull | stringpovinné

recipientNamestringpovinné

recipientStreetnull | stringpovinné

recipientCitynull | stringpovinné

recipientPostalCodenull | stringpovinné

recipientCountrystringpovinné

recipientPhonenull | stringpovinné

recipientEmailnull | stringpovinné

weightGramsinteger | nullpovinné

parcelCountintegerpovinné

codHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

currencystringpovinné

variableSymbolnull | stringpovinné

trackingNumbernull | stringpovinné

pickupPointIdnull | stringpovinné

statusstringpovinné

statusDetailnull | stringpovinné

statusAtnull | stringpovinnédate-time

exportedAtnull | stringpovinnédate-time

shippedOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

externalIdnull | string

preferredDeliveryOnnull | stringdate

preferredDeliveryFromnull | string

preferredDeliveryTonull | string

POST/v1/shipments

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

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

import os
import requests

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

Detail: zásilka

GET/v1/shipments/{id}

Get a shipment

Nástroj MCP: get-shipment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

carrierIdstringpovinné

carrierNamestringpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

sourceNumbernull | stringpovinné

contactIdnull | stringpovinné

recipientNamestringpovinné

recipientStreetnull | stringpovinné

recipientCitynull | stringpovinné

recipientPostalCodenull | stringpovinné

recipientCountrystringpovinné

recipientPhonenull | stringpovinné

recipientEmailnull | stringpovinné

weightGramsinteger | nullpovinné

parcelCountintegerpovinné

codHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

currencystringpovinné

variableSymbolnull | stringpovinné

trackingNumbernull | stringpovinné

pickupPointIdnull | stringpovinné

statusstringpovinné

statusDetailnull | stringpovinné

statusAtnull | stringpovinnédate-time

exportedAtnull | stringpovinnédate-time

shippedOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

externalIdnull | string

preferredDeliveryOnnull | stringdate

preferredDeliveryFromnull | string

preferredDeliveryTonull | string

GET/v1/shipments/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/shipments/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/shipments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Úprava: zásilka

PATCH/v1/shipments/{id}

Change a shipment or its status. Once exported, only its tracking number, status, and note can change, as the carrier already holds the rest

Nástroj MCP: update-shipment

Parametry v cestě

idstringpovinné

Tělo požadavku

carrierIdstring

ID of the carrier. Find it with list-carriers.

sourceKind"invoice" | "delivery_note" | "proforma" | "order_received"

sourceIdstring

ID of the source.

contactIdstring

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

recipientNamestringmax 160 chars

recipientStreetstring | null

recipientCitystring | null

recipientPostalCodestring | null

recipientCountrystring2 chars

recipientPhonestring | null

recipientEmailstring | null

weightGramsinteger | null

parcelCountintegermax 99

codHalerinteger | null

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

valueHalerinteger | null

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

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

variableSymbolstring | null

trackingNumberstring | null

pickupPointIdstring | null

ID of the pickup point.

preferredDeliveryOnstring | null

The day the recipient asks for. PPL only.

preferredDeliveryFromstring | null

From this time on that day, HH:MM. PPL only.

preferredDeliveryTostring | null

Until this time on that day, HH:MM. PPL only.

shippedOnstringYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

statusDetailstring | null

Odpověď · 200

idstringpovinné

numberstringpovinné

carrierIdstringpovinné

carrierNamestringpovinné

sourceKindnull | stringpovinné

sourceIdnull | stringpovinné

sourceNumbernull | stringpovinné

contactIdnull | stringpovinné

recipientNamestringpovinné

recipientStreetnull | stringpovinné

recipientCitynull | stringpovinné

recipientPostalCodenull | stringpovinné

recipientCountrystringpovinné

recipientPhonenull | stringpovinné

recipientEmailnull | stringpovinné

weightGramsinteger | nullpovinné

parcelCountintegerpovinné

codHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

currencystringpovinné

variableSymbolnull | stringpovinné

trackingNumbernull | stringpovinné

pickupPointIdnull | stringpovinné

statusstringpovinné

statusDetailnull | stringpovinné

statusAtnull | stringpovinnédate-time

exportedAtnull | stringpovinnédate-time

shippedOnstringpovinnédate

notenull | stringpovinné

createdAtstringpovinnédate-time

externalIdnull | string

preferredDeliveryOnnull | stringdate

preferredDeliveryFromnull | string

preferredDeliveryTonull | string

PATCH/v1/shipments/{id}

curl -X PATCH https://api.damedoklad.cz/v1/shipments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "sourceKind": "invoice",
  "sourceId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/shipments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "sourceKind": "invoice",
    "sourceId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/shipments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "sourceKind": "invoice",
        "sourceId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Smazání: zásilka

DELETE/v1/shipments/{id}

Delete a shipment not yet handed to the carrier

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

Nástroj MCP: delete-shipment

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/shipments/{id}

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

const response = await fetch('https://api.damedoklad.cz/v1/shipments/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/shipments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download the carrier's own labels through its API (Packeta, PPL, DPD, GLS). Only for shipments it already holds, and only where the operator allows live calls

POST/v1/shipments/carrier/labels

Download the carrier's own labels through its API (Packeta, PPL, DPD, GLS). Only for shipments it already holds, and only where the operator allows live calls

Nástroj MCP: download-carrier-labels

Tělo požadavku

idsstring[]povinné

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/shipments/carrier/labels

curl -X POST https://api.damedoklad.cz/v1/shipments/carrier/labels \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/shipments/carrier/labels', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/carrier/labels",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Ask the carrier for the status of shipments it holds (Packeta, PPL, DPD, GLS). Only where the operator allows live calls. A sweep also does this by itself

POST/v1/shipments/carrier/status

Ask the carrier for the status of shipments it holds (Packeta, PPL, DPD, GLS). Only where the operator allows live calls. A sweep also does this by itself

Nástroj MCP: sync-carrier-status

Tělo požadavku

idsstring[]povinné

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/shipments/carrier/status

curl -X POST https://api.damedoklad.cz/v1/shipments/carrier/status \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

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

import os
import requests

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

Hand shipments to the carrier through its own API (Packeta, PPL, DPD, GLS). Only where the operator allows live calls. Each answers on its own

POST/v1/shipments/carrier/submit

Hand shipments to the carrier through its own API (Packeta, PPL, DPD, GLS). Only where the operator allows live calls. Each answers on its own. The carrier assigns the tracking number: Packeta and DPD straight away, PPL when it has processed the batch, GLS with the first label.

Nástroj MCP: submit-shipments-to-carrier

Tělo požadavku

idsstring[]povinné

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/shipments/carrier/submit

curl -X POST https://api.damedoklad.cz/v1/shipments/carrier/submit \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

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

import os
import requests

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

Print addressed envelopes, DL by default or C6 or C5, for shipments or for contacts, one per page at envelope size

POST/v1/shipments/envelopes

Print addressed envelopes, DL by default or C6 or C5, for shipments or for contacts, one per page at envelope size

Nástroj MCP: print-envelopes

Tělo požadavku

idsstring[]

contactIdsstring[]

size"DL" | "C6" | "C5"

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/shipments/envelopes

curl -X POST https://api.damedoklad.cz/v1/shipments/envelopes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "contactIds": [
    "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ],
  "size": "DL"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/shipments/envelopes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "contactIds": [
      "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ],
    "size": "DL"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/envelopes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "contactIds": [
            "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ],
        "size": "DL"
    },
)
content = response.content

Export: zásilka

POST/v1/shipments/export

Download the carrier file: the Česká pošta posting sheet (ePA), or generic CSV for any other carrier. Exported shipments leave later exports

Nástroj MCP: export-shipments

Tělo požadavku

carrierIdstringpovinné

ID of the carrier. Find it with list-carriers.

idsstring[]

Left out: everything of this carrier still to process.

Odpověď · 200

Vrací soubor text/csv.

POST/v1/shipments/export

curl -X POST https://api.damedoklad.cz/v1/shipments/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/shipments/export', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
content = response.content

Make shipments for documents, as POHODA's Vygenerovat zásilky: one per document that has none yet, each answering on its own

POST/v1/shipments/generate

Make shipments for documents, as POHODA's Vygenerovat zásilky: one per document that has none yet, each answering on its own

Nástroj MCP: generate-shipments

Tělo požadavku

carrierIdstringpovinné

ID of the carrier. Find it with list-carriers.

sourceKind"invoice" | "order_received" | "delivery_note" | "proforma"povinné

idsstring[]povinné

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/shipments/generate

curl -X POST https://api.damedoklad.cz/v1/shipments/generate \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "sourceKind": "invoice",
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/shipments/generate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "sourceKind": "invoice",
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/generate",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "sourceKind": "invoice",
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Print shipment labels as a PDF, one per parcel, A6 or four on an A4 sheet: our own layout with a Code 128 of the tracking number, not a carrier's label

POST/v1/shipments/labels

Print shipment labels as a PDF, one per parcel, A6 or four on an A4 sheet: our own layout with a Code 128 of the tracking number, not a carrier's label. A carrier that scans its own label needs that one: downloadCarrierLabels, where its API is connected.

Nástroj MCP: print-shipment-labels

Tělo požadavku

idsstring[]povinné

size"A6" | "A4"

A6: one label a page, for a label printer. A4: four labels on a sheet.

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/shipments/labels

curl -X POST https://api.damedoklad.cz/v1/shipments/labels \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/shipments/labels', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/labels",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Print a posting report (podací arch) of shipments: our own layout listing what goes out, not a form of a carrier

POST/v1/shipments/postal-report

Print a posting report (podací arch) of shipments: our own layout listing what goes out, not a form of a carrier

Nástroj MCP: print-postal-report

Tělo požadavku

idsstring[]povinné

Odpověď · 200

Vrací soubor application/pdf.

POST/v1/shipments/postal-report

curl -X POST https://api.damedoklad.cz/v1/shipments/postal-report \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}' \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/shipments/postal-report', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/postal-report",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
content = response.content

Read a CSV of shipment statuses from a carrier. Generic: a header row with a shipment or tracking number column and a status column

POST/v1/shipments/status-import

Read a CSV of shipment statuses from a carrier. Generic: a header row with a shipment or tracking number column and a status column. Each row answers on its own. A status worded in a way we do not know is kept as text and changes nothing. No carrier publishes one status file format we could read, so columns go by name, not by carrier.

Nástroj MCP: import-shipment-status

Tělo požadavku

csvstringpovinnémax 5000000 chars

CSV with a header row: a shipment number or tracking number column, and a status column.

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/shipments/status-import

curl -X POST https://api.damedoklad.cz/v1/shipments/status-import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "csv": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/shipments/status-import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "csv": "string"
    },
)
data = response.json()

Send an advance to a supplier for approval, or again after a rejection: to one approver (one click, the default) or through a scenario of several in order

POST/v1/supplier-advances/{id}/approval

Send an advance to a supplier for approval, or again after a rejection: to one approver (one click, the default) or through a scenario of several in order

Nástroj MCP: request-supplier-advance-approval

Parametry v cestě

idstringpovinné

Tělo požadavku

approverIdstring | null

ID of the approver.

scenarioIdstring | null

ID of the scenario.

commentstring | null

Odpověď · 201

idstringpovinné

documentKindnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

supplierAdvanceIdnull | stringpovinné

statusstringpovinné

approverIdnull | stringpovinné

approverNamenull | stringpovinné

commentnull | stringpovinné

decidedByIdnull | stringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

createdAtstringpovinnédate-time

invoicenull | objectpovinné

idstringpovinné

numbernull | stringpovinné

supplierDocumentNumbernull | stringpovinné

contactNamenull | stringpovinné

issueDatenull | stringpovinnédate

dueDatenull | stringpovinnédate

totalHalerinteger | nullpovinné

currencynull | stringpovinné

statusstringpovinné

scenarioIdnull | string

currentStepinteger | null

stepCountinteger | null

salesDocumentIdnull | string

inboxDocumentIdnull | string

waitingOnobject[]

idstringpovinné

namenull | stringpovinné

kindstringpovinné

historyobject[]

actionstringpovinné

actorNamenull | stringpovinné

commentnull | stringpovinné

atstringpovinnédate-time

stepsobject[]

positioninteger | nullpovinné

approverIdnull | stringpovinné

approverNamestringpovinné

statusstringpovinné

decidedByNamenull | stringpovinné

decidedAtnull | stringpovinnédate-time

commentnull | stringpovinné

stageinteger

modestring

kindstring

decidedForNamenull | string

POST/v1/supplier-advances/{id}/approval

curl -X POST https://api.damedoklad.cz/v1/supplier-advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "comment": "string"
}'

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

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/supplier-advances/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/approval",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "approverId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "scenarioId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "comment": "string"
    },
)
data = response.json()

List tasks across all contacts, soonest first: assignedTo=me for my own or a colleague, checker=me and toCheck=true for what waits for my check

GET/v1/tasks

List tasks across all contacts, soonest first: assignedTo=me for my own or a colleague, checker=me and toCheck=true for what waits for my check

Nástroj MCP: list-tasks

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.

assignedTostringmax 40 chars

`me`, a user ID, or left out for everyone.

open"true" | "false"

checkerstringmax 40 chars

`me` or a user ID: tasks this person checks.

toCheck"true" | "false"

true: only finished tasks still waiting for their checker.

Odpověď · 200

dataobject[]povinné

object"contact_activity"povinné

idstringpovinné

contactIdstringpovinné

kindstringpovinné

subjectstringpovinné

bodynull | stringpovinné

occurredOnstringpovinnédate

dueOnnull | stringpovinnédate

donebooleanpovinné

doneAtnull | stringpovinnédate-time

assignedToIdnull | stringpovinné

createdAtstringpovinnédate-time

parentIdnull | string

checkerIdnull | string

checkedboolean

checkedAtnull | stringdate-time

waitingForCheckboolean

recurrencenull | string

recurrenceUntilnull | stringdate

nextTaskIdnull | string

remindDaysBeforeinteger | null

contactNamenull | string

assignedToNamestring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

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

GET/v1/tasks

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

const response = await fetch('https://api.damedoklad.cz/v1/tasks', {
  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/tasks",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()