Skip to content

Issued invoices

Operations in the Issued invoices group.

Base URLhttps://api.damedoklad.cz/v1AuthenticationErrors and limitsConventions

List issued invoices (faktury vydané). `from` and `to` filter on the issue date; `unpaid=true` keeps those with an open balance

GET/v1/invoices

List issued invoices (faktury vydané). `from` and `to` filter on the issue date; `unpaid=true` keeps those with an open balance

MCP tool: list-invoices

Query parameters

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.
statusstring
Document status, for example draft, issued, partially_paid, paid, storno.
contactIdstring
Only documents of this contact.
dueFromstring
Due on or after this date, YYYY-MM-DD.
dueTostring
Due on or before this date, YYYY-MM-DD.
qstringmax 200 chars
Older name for `search`.
unpaid"true" | "false"
`true`: only documents with an open balance.
customFieldKeystring
Only records with this custom field. Alone: it has any value. With customFieldValue: exactly that value, ignoring case.
customFieldValuestringmax 2000 chars

Response · 200

dataobject[]required
object"invoice"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/invoices
curl https://api.damedoklad.cz/v1/invoices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create an invoice, as a draft unless `issue` is true

POST/v1/invoices

Create an invoice, as a draft unless `issue` is true. Pass contactId from list-contacts, or contactName for a one-off customer. Prices are per unit before VAT, in haléře. Legal effect: with `issue: true` this assigns the final document number, creates a tax document, and posts to the books. Confirm with the user first.

MCP tool: create-invoice

Request body

carrierIdstring | null
ID of the carrier. Find it with list-carriers.
vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
contactNamestringmax 160 chars
contactIcostringmax 16 chars
Czech company number (IČO), 8 digits.
contactDicstringmax 16 chars
VAT number (DIČ), for example CZ12345678.
seriesIdstring
ID of the series. Find it with list-series.
issueDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
language"cs" | "en" | "sk" | "de" | "fr" | "pl"
notePublicstring | null
noteInternalstring | null
constantSymbolstring | null
ourAccountNumberstring | null
ourBankCodestring | null
ourIbanstring | null
IBAN without spaces.
issueboolean
overrideDeliveryNotesboolean
deliveryNoteIdsstring[]
overrideCreditLimitboolean
proformaIdsstring[]
clientDocumentIdstringmin 8 charsmax 64 chars
ID of the client document.
offlineobject
soldAtstringrequireddate-time
numberstringrequiredmax 40 chars
listPricesobject[]
itemIdstringrequired
ID of the item. Find it with list-items.
priceHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
quantitynumberrequired
linesobject[]required
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRatenumbermin 0max 30
itemIdstring
ID of the item. Find it with list-items.
warehouseIdstring
ID of the warehouse. Find it with list-warehouses.
lotsobject[]
itemIdstring
ID of the item. Find it with list-items.
lotIdstring
ID of the lot.
codestringmax 64 chars
quantitynumber
expiryDatestring | null
Date as YYYY-MM-DD.
serialNumbersstring[]
orderLineIdstring
ID of the order line.
recyclingFeeIdstring | null
A fee from the list. null means no fee on this line, whatever the item says
recyclingPerUnitHalerintegermin 0max 9007199254740991
The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee
recyclingTextstringmax 120 chars
recyclingUnit"ks" | "kg"
The unit of a typed fee
recyclingCoefficientnumbermin 0max 1000000
How many times the fee applies to one unit of the line
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
roundingMode"auto" | "crown" | "none"

Response · 201

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
POST/v1/invoices
curl -X POST https://api.damedoklad.cz/v1/invoices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30",
  "lines": [
    {
      "quantity": 1
    }
  ]
}'

Get an invoice with lines, VAT recap, payments, and the amount still owed

GET/v1/invoices/{id}

Get an invoice with lines, VAT recap, payments, and the amount still owed

MCP tool: get-invoice

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
GET/v1/invoices/{id}
curl https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Change a draft invoice. An issued invoice cannot be changed: storno it or create a credit note

PATCH/v1/invoices/{id}

Change a draft invoice. An issued invoice cannot be changed: storno it or create a credit note

MCP tool: update-invoice

Path parameters

idstringrequired

Request body

carrierIdstring | null
ID of the carrier. Find it with list-carriers.
vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
seriesIdstring
ID of the series. Find it with list-series.
issueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestring | null
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
language"cs" | "en" | "sk" | "de" | "fr" | "pl"
notePublicstring | null
noteInternalstring | null
constantSymbolstring | null
ourAccountNumberstring | null
ourBankCodestring | null
ourIbanstring | null
IBAN without spaces.
linesobject[]
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRatenumbermin 0max 30
itemIdstring
ID of the item. Find it with list-items.
warehouseIdstring
ID of the warehouse. Find it with list-warehouses.
lotsobject[]
itemIdstring
ID of the item. Find it with list-items.
lotIdstring
ID of the lot.
codestringmax 64 chars
quantitynumber
expiryDatestring | null
Date as YYYY-MM-DD.
serialNumbersstring[]
orderLineIdstring
ID of the order line.
recyclingFeeIdstring | null
A fee from the list. null means no fee on this line, whatever the item says
recyclingPerUnitHalerintegermin 0max 9007199254740991
The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee
recyclingTextstringmax 120 chars
recyclingUnit"ks" | "kg"
The unit of a typed fee
recyclingCoefficientnumbermin 0max 1000000
How many times the fee applies to one unit of the line
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
roundingMode"auto" | "crown" | "none"

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
PATCH/v1/invoices/{id}
curl -X PATCH https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "vatMode": "domestic",
  "exchangeRate": 1
}'

Create a new draft invoice from an existing one

POST/v1/invoices/{id}/copy

Create a new draft invoice from an existing one

MCP tool: copy-invoice

Path parameters

idstringrequired

Response · 201

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
POST/v1/invoices/{id}/copy
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/copy \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a draft credit note (dobropis) for an issued invoice. Line prices are negative

POST/v1/invoices/{id}/credit-notes

Create a draft credit note (dobropis) for an issued invoice. Line prices are negative

MCP tool: create-credit-note-from-invoice

Path parameters

idstringrequired

Request body

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
contactNamestringmax 160 chars
contactIcostringmax 16 chars
Czech company number (IČO), 8 digits.
contactDicstringmax 16 chars
VAT number (DIČ), for example CZ12345678.
seriesIdstring
ID of the series. Find it with list-series.
invoiceIdstring
ID of the invoice. Find it with list-invoices.
originalInvoiceNumberstring | null
reasonstringmax 500 chars
issueDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
khDphDatestring | null
Date as YYYY-MM-DD.
dueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
language"cs" | "en" | "sk" | "de" | "fr" | "pl"
notePublicstring | null
noteInternalstring | null
issueboolean
linesobject[]
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringrequiredmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRatenumberrequiredmin 0max 30
itemIdstring
ID of the item. Find it with list-items.
warehouseIdstring
ID of the warehouse. Find it with list-warehouses.
lotsobject[]
itemIdstring
ID of the item. Find it with list-items.
lotIdstring
ID of the lot.
codestringmax 64 chars
quantitynumber
expiryDatestring | null
Date as YYYY-MM-DD.
serialNumbersstring[]
orderLineIdstring
ID of the order line.
recyclingFeeIdstring | null
A fee from the list. null means no fee on this line, whatever the item says
recyclingPerUnitHalerintegermin 0max 9007199254740991
The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee
recyclingTextstringmax 120 chars
recyclingUnit"ks" | "kg"
The unit of a typed fee
recyclingCoefficientnumbermin 0max 1000000
How many times the fee applies to one unit of the line
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
roundingMode"auto" | "crown" | "none"

Response · 201

customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
originalInvoiceNumbernull | stringrequired
seriesIdnull | string
reasonnull | string
taxPointDatestringdate
khDphDatenull | stringdate
currencystring
paymentMethodstring
languagestring
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
stornoOfIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"credit_note_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdstring | nullrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
paymentsobject[]
object"credit_note_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalany[]
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
bankMovementobject
idstringrequired
bankAccountIdstringrequired
POST/v1/invoices/{id}/credit-notes
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/credit-notes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30"
}'

Issue a draft invoice

POST/v1/invoices/{id}/issue

Issue a draft invoice. Legal effect: this assigns the final document number, creates a tax document, and posts to the books. Confirm with the user first. Refused with uninvoiced_delivery_note when a line would move stock while the customer has issued, not yet invoiced delivery notes for the item: name them in deliveryNoteIds to bill them, or set overrideDeliveryNotes if this is a further sale.

MCP tool: issue-invoice

Path parameters

idstringrequired

Request body

overrideReservationsboolean
overrideDeliveryNotesboolean
deliveryNoteIdsstring[]
overrideCreditLimitboolean
Issue although the customer goes over Kredit max. Owner or accountant only, after the user has seen the warning.

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
POST/v1/invoices/{id}/issue
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/issue \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "overrideReservations": false,
  "overrideDeliveryNotes": false,
  "deliveryNoteIds": [
    "dln_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

List the payments of an invoice

GET/v1/invoices/{id}/payments

List the payments of an invoice

MCP tool: list-invoice-payments

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

dataobject[]required
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/invoices/{id}/payments
curl https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a payment of an invoice. Cash goes through a cash document of a register, a transfer through a bank account, and a later statement line takes it over

POST/v1/invoices/{id}/payments

Record a payment of an invoice. Cash goes through a cash document of a register, a transfer through a bank account, and a later statement line takes it over. Legal effect: posts to the books. With several registers or accounts name registerId or bankAccountId. In another currency than the document, moneyAmountHaler says what moved on the account.

MCP tool: add-invoice-payment

Path parameters

idstringrequired

Request body

amountHalerintegerrequiredmax 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
paidOnstringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
method"transfer" | "cash" | "card" | "other"
inPersonboolean
notestring | null
registerIdstring
ID of the register.
bankAccountIdstring
ID of the bank account. Find it with list-bank-accounts.
moneyAmountHalerintegermax 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
allowNegativeboolean
eetPrepaidLoadHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
eetPrepaidUseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
eetVoucherIdstring
ID of the eet voucher. Find it with list-eet-vouchers.
eetMandateIdstring
ID of the eet mandate. Find it with list-eet-mandates.
eetOwnSaleboolean
paidAtstringdate-time

Response · 201

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
POST/v1/invoices/{id}/payments
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "paidOn": "2026-10-30"
}'

Remove a payment from an invoice and reverse its posting

DELETE/v1/invoices/{id}/payments/{paymentId}

Remove a payment from an invoice and reverse its posting

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: delete-invoice-payment

Path parameters

idstringrequired
paymentIdstringrequired
ID of the payment.

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
DELETE/v1/invoices/{id}/payments/{paymentId}
curl -X DELETE https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Download the invoice as a PDF

GET/v1/invoices/{id}/pdf

Download the invoice as a PDF

MCP tool: get-invoice-pdf

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

GET/v1/invoices/{id}/pdf
curl https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

Cancel an issued invoice with a reversing document

POST/v1/invoices/{id}/storno

Cancel an issued invoice with a reversing document. Legal effect: reverses the tax document and the bookings. Fails when the invoice has payments or its period is closed. Confirm with the user first.

IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.

MCP tool: storno-invoice

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
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"required
idstringrequired
descriptionstringrequired
quantitynumberrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
itemIdnull | string
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"invoice_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
payablesBookany[]
assetany[]
retentionsobject[]
idstringrequired
amountHalerinteger | nullrequired
dueDatenull | stringrequireddate
notestring | nullrequired
longTermbooleanrequired
carrierIdnull | string
creditWarningobject
levelstringrequired
exposureHalerintegerrequired
afterHalerintegerrequired
warnHalerinteger | nullrequired
blockHalerintegerrequired
availableHalerintegerrequired
originalany
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
POST/v1/invoices/{id}/storno
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"