Skip to content

Operations in the Proformas group.

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

List proforma invoices (zálohové faktury). `from` and `to` filter on the issue date

GET/v1/proformas

List proforma invoices (zálohové faktury). `from` and `to` filter on the issue date

MCP tool: list-proformas

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"proforma"required
idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/proformas
curl https://api.damedoklad.cz/v1/proformas \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a proforma invoice. It is not a tax document

POST/v1/proformas

Create a proforma invoice. It is not a tax document

MCP tool: create-proforma

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.
kind"advance" | "proforma"
issueDatestringrequiredYYYY-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
issueboolean
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
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
POST/v1/proformas
curl -X POST https://api.damedoklad.cz/v1/proformas \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "issueDate": "2026-10-30",
  "lines": [
    {
      "quantity": 1
    }
  ]
}'

Get a proforma invoice with lines and payments

GET/v1/proformas/{id}

Get a proforma invoice with lines and payments

MCP tool: get-proforma

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
GET/v1/proformas/{id}
curl https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Change a draft proforma invoice

PATCH/v1/proformas/{id}

Change a draft proforma invoice

MCP tool: update-proforma

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.
kind"advance" | "proforma"
issueDatestringYYYY-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
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
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
PATCH/v1/proformas/{id}
curl -X PATCH https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "carrierId": "gcr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "vatMode": "domestic",
  "exchangeRate": 1
}'

Cancel a proforma invoice

POST/v1/proformas/{id}/cancel

Cancel a proforma invoice

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

MCP tool: cancel-proforma

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
POST/v1/proformas/{id}/cancel
curl -X POST https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Create a new draft proforma invoice from an existing one

POST/v1/proformas/{id}/copy

Create a new draft proforma invoice from an existing one

MCP tool: copy-proforma

Path parameters

idstringrequired

Response · 201

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
POST/v1/proformas/{id}/copy
curl -X POST https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/copy \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Issue a draft proforma invoice: it gets its number and can be sent

POST/v1/proformas/{id}/issue

Issue a draft proforma invoice: it gets its number and can be sent

MCP tool: issue-proforma

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
POST/v1/proformas/{id}/issue
curl -X POST https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/issue \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record an advance payment of a proforma invoice

POST/v1/proformas/{id}/payments

Record an advance payment of a proforma invoice. Legal effect: posts to the books. Cash goes through a cash document of a register and a transfer through a bank account; with several name registerId or bankAccountId. For a VAT payer, `createTaxDocument: true` also issues the tax document for the received advance.

MCP tool: add-proforma-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
createTaxDocumentboolean

Response · 201

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
POST/v1/proformas/{id}/payments
curl -X POST https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "paidOn": "2026-10-30"
}'

Remove an advance payment recorded on a proforma invoice

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

Remove an advance payment recorded on a proforma invoice. Legal effect: reverses what the payment posted to the books.

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

MCP tool: remove-proforma-payment

Path parameters

idstringrequired
paymentIdstringrequired
ID of the payment.

Response · 200

idstringrequired
numbernull | stringrequired
variableSymbolnull | stringrequired
kindstringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
currencystring
ourAccountNumbernull | string
ourBankCodenull | string
ourIbannull | string
paymentMethodstring
languagestring
notePublicstring | null
noteInternalstring | null
netHalerinteger
vatHalerinteger
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
sellerNamenull | string
linesobject[]
object"proforma_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsany[]required
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdstringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliintegerrequired
perUnitHalerintegerrequired
coefficientMilliintegerrequired
vatLinesobject[]
object"invoice_vat_line"required
idstringrequired
vatRatenumberrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"proforma_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
linksobject[]
object"document_link"required
idstringrequired
fromKindstringrequired
fromIdstringrequired
toKindstringrequired
toIdstringrequired
kindstringrequired
amountHalerinteger | null
taxDocumentsobject[]
object"advance_tax_document"required
idstringrequired
numbernull | stringrequired
statusstringrequired
issueDatenull | stringrequireddate
netHalerintegerrequired
vatHalerinteger | nullrequired
totalHalerinteger | nullrequired
invoiceIdnull | stringrequired
postingobject
regimestringrequired
eventstringrequired
skippedboolean
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookany[]
assetany[]
carrierIdstring | null
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
DELETE/v1/proformas/{id}/payments/{paymentId}
curl -X DELETE https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Download the proforma invoice as a PDF

GET/v1/proformas/{id}/pdf

Download the proforma invoice as a PDF

MCP tool: get-proforma-pdf

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

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

Create the final invoice from a proforma invoice, and issue it unless `issue` is false

POST/v1/proformas/{id}/settle

Create the final invoice from a proforma invoice, and issue it unless `issue` is false. Legal effect: this assigns the final document number, creates a tax document, and posts to the books. Confirm with the user first.

MCP tool: settle-proforma

Path parameters

idstringrequired

Request body

issueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
issueboolean

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/proformas/{id}/settle
curl -X POST https://api.damedoklad.cz/v1/proformas/prf_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30",
  "issue": false
}'