Přejít na obsah

Vydané faktury

Operace ve skupině Vydané faktury.

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

Seznam: faktury

GET/v1/invoices

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

Nástroj MCP: list-invoices

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
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

Odpověď · 200

dataobject[]povinné
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é
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: faktura

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.

Nástroj MCP: create-invoice

Tělo požadavku

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.
issueDatestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringpovinnéYYYY-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
soldAtstringpovinnédate-time
numberstringpovinnémax 40 chars
listPricesobject[]
itemIdstringpovinné
ID of the item. Find it with list-items.
priceHalerintegerpovinnémin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
quantitynumberpovinné
linesobject[]povinné
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringmax 240 chars
quantitynumberpovinné
unitstringmax 16 chars
unitPriceHalerintegermin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRatenumbermin 0max 30
itemIdstring
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"

Odpověď · 201

idstringpovinné
numbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
customFieldsobject
zakazka_zakaznikastring
pocetinteger
kampanstring
vatModestring
exchangeRatenumber
templateIdnull | string
centerIdnull | string
activityIdnull | string
projectIdnull | string
seriesIdnull | string
constantSymbolnull | string
taxPointDatestringdate
paymentMethodstring
languagestring
notePublicnull | string
noteInternalnull | string
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
sellerNamenull | string
sellerIconull | string
sellerDicnull | string
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
netHalerinteger
vatHalerinteger
roundingHalerinteger
recurringIdnull | string
stornoOfIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetnull | string
shipToCitynull | string
shipToPostalCodenull | string
shipToCountrynull | string
contactEmailnull | string
linesobject[]
object"invoice_line"povinné
idstringpovinné
descriptionstringpovinné
quantitynumberpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
itemIdnull | string
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"invoice_vat_line"povinné
idstringpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
paymentsobject[]
object"invoice_payment"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
linksobject[]
object"document_link"povinné
idstringpovinné
fromKindstringpovinné
fromIdstringpovinné
toKindstringpovinné
toIdstringpovinné
kindstringpovinné
amountHalerinteger | null
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
payablesBookany[]
assetany[]
retentionsobject[]
idstringpovinné
amountHalerinteger | nullpovinné
dueDatenull | stringpovinnédate
notestring | nullpovinné
longTermbooleanpovinné
carrierIdnull | string
creditWarningobject
levelstringpovinné
exposureHalerintegerpovinné
afterHalerintegerpovinné
warnHalerinteger | nullpovinné
blockHalerintegerpovinné
availableHalerintegerpovinné
originalany
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
POST/v1/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
    }
  ]
}'

Detail: faktura

GET/v1/invoices/{id}

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

Nástroj MCP: get-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

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/invoices/{id}
curl https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Úprava: faktura

PATCH/v1/invoices/{id}

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

Nástroj MCP: update-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

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
quantitynumberpovinné
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"

Odpověď · 200

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/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
}'

Kopie: faktura

POST/v1/invoices/{id}/copy

Create a new draft invoice from an existing one

Nástroj MCP: copy-invoice

Parametry v cestě

idstringpovinné

Odpověď · 201

idstringpovinné
numbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
customFieldsobject
zakazka_zakaznikastring
pocetinteger
kampanstring
vatModestring
exchangeRatenumber
templateIdnull | string
centerIdnull | string
activityIdnull | string
projectIdnull | string
seriesIdnull | string
constantSymbolnull | string
taxPointDatestringdate
paymentMethodstring
languagestring
notePublicnull | string
noteInternalnull | string
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
sellerNamenull | string
sellerIconull | string
sellerDicnull | string
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
netHalerinteger
vatHalerinteger
roundingHalerinteger
recurringIdnull | string
stornoOfIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetnull | string
shipToCitynull | string
shipToPostalCodenull | string
shipToCountrynull | string
contactEmailnull | string
linesobject[]
object"invoice_line"povinné
idstringpovinné
descriptionstringpovinné
quantitynumberpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
itemIdnull | string
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"invoice_vat_line"povinné
idstringpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
paymentsobject[]
object"invoice_payment"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
linksobject[]
object"document_link"povinné
idstringpovinné
fromKindstringpovinné
fromIdstringpovinné
toKindstringpovinné
toIdstringpovinné
kindstringpovinné
amountHalerinteger | null
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
payablesBookany[]
assetany[]
retentionsobject[]
idstringpovinné
amountHalerinteger | nullpovinné
dueDatenull | stringpovinnédate
notestring | nullpovinné
longTermbooleanpovinné
carrierIdnull | string
creditWarningobject
levelstringpovinné
exposureHalerintegerpovinné
afterHalerintegerpovinné
warnHalerinteger | nullpovinné
blockHalerintegerpovinné
availableHalerintegerpovinné
originalany
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
POST/v1/invoices/{id}/copy
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/copy \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Vytvoření: dobropis z faktury

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

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

Nástroj MCP: create-credit-note-from-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

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
issueDatestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringpovinnéYYYY-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.
descriptionstringpovinnémax 240 chars
quantitynumberpovinné
unitstringmax 16 chars
unitPriceHalerintegerpovinnémin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRatenumberpovinnémin 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"

Odpověď · 201

customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
idstringpovinné
numbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
originalInvoiceNumbernull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumberstring | nullpovinné
lineKindstringpovinné
sourceIdstring | nullpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsany[]povinné
orderLineIdstring | nullpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
paymentsobject[]
object"credit_note_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
cashJournalany[]
receivablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
payablesBookany[]
assetany[]
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
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"
}'

Vystavení: faktura

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.

Nástroj MCP: issue-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 200

idstringpovinné
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/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"
  ]
}'

Seznam: úhrady, faktura

GET/v1/invoices/{id}/payments

List the payments of an invoice

Nástroj MCP: list-invoice-payments

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"invoice_payment"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Přidání: úhrada, faktura

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.

Nástroj MCP: add-invoice-payment

Parametry v cestě

idstringpovinné

Tělo požadavku

amountHalerintegerpovinnémax 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
paidOnstringpovinnéYYYY-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

Odpověď · 201

idstringpovinné
numbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
customFieldsobject
zakazka_zakaznikastring
pocetinteger
kampanstring
vatModestring
exchangeRatenumber
templateIdnull | string
centerIdnull | string
activityIdnull | string
projectIdnull | string
seriesIdnull | string
constantSymbolnull | string
taxPointDatestringdate
paymentMethodstring
languagestring
notePublicnull | string
noteInternalnull | string
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
sellerNamenull | string
sellerIconull | string
sellerDicnull | string
reminderOnDueboolean
reminderWeekAfterboolean
reminder14DaysAfterboolean
reminderMonthAfterboolean
netHalerinteger
vatHalerinteger
roundingHalerinteger
recurringIdnull | string
stornoOfIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetnull | string
shipToCitynull | string
shipToPostalCodenull | string
shipToCountrynull | string
contactEmailnull | string
linesobject[]
object"invoice_line"povinné
idstringpovinné
descriptionstringpovinné
quantitynumberpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
itemIdnull | string
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"invoice_vat_line"povinné
idstringpovinné
vatRatenumberpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
paymentsobject[]
object"invoice_payment"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
linksobject[]
object"document_link"povinné
idstringpovinné
fromKindstringpovinné
fromIdstringpovinné
toKindstringpovinné
toIdstringpovinné
kindstringpovinné
amountHalerinteger | null
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
payablesBookany[]
assetany[]
retentionsobject[]
idstringpovinné
amountHalerinteger | nullpovinné
dueDatenull | stringpovinnédate
notestring | nullpovinné
longTermbooleanpovinné
carrierIdnull | string
creditWarningobject
levelstringpovinné
exposureHalerintegerpovinné
afterHalerintegerpovinné
warnHalerinteger | nullpovinné
blockHalerintegerpovinné
availableHalerintegerpovinné
originalany
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
POST/v1/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"
}'

Smazání: úhrada, faktura

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

Remove a payment from an invoice and reverse its posting

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

Nástroj MCP: delete-invoice-payment

Parametry v cestě

idstringpovinné
paymentIdstringpovinné
ID of the payment.

Odpověď · 200

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/invoices/{id}/payments/{paymentId}
curl -X DELETE https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Detail: PDF, faktura

GET/v1/invoices/{id}/pdf

Download the invoice as a PDF

Nástroj MCP: get-invoice-pdf

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

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

Storno: faktura

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.

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

Nástroj MCP: storno-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

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/invoices/{id}/storno
curl -X POST https://api.damedoklad.cz/v1/invoices/inv_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"