Skip to content

Advances to suppliers

Operations in the Advances to suppliers group.

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

List suppliers' tax documents for paid advances, including corrections and stornos

GET/v1/supplier-advance-tax-documents

List suppliers' tax documents for paid advances, including corrections and stornos

MCP tool: list-supplier-advance-tax-documents

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.

Response · 200

dataobject[]required
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/supplier-advance-tax-documents
curl https://api.damedoklad.cz/v1/supplier-advance-tax-documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Fill in the supplier's number on a tax document, usually a correction booked before the document arrived

PATCH/v1/supplier-advance-tax-documents/{id}

Fill in the supplier's number on a tax document, usually a correction booked before the document arrived

MCP tool: update-supplier-advance-tax-document

Path parameters

idstringrequired

Request body

supplierDocumentNumberstringrequiredmax 64 chars

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
PATCH/v1/supplier-advance-tax-documents/{id}
curl -X PATCH https://api.damedoklad.cz/v1/supplier-advance-tax-documents/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierDocumentNumber": "string"
}'

Cancel a supplier's tax document for a paid advance, or a self-assessment, with a reversing document

POST/v1/supplier-advance-tax-documents/{id}/storno

Cancel a supplier's tax document for a paid advance, or a self-assessment, with a reversing document. Legal effect: reverses the deduction in the period you learn of it. Refused once a final invoice has deducted it or a refund has corrected it. A self-assessment asks why (`reason`): a `mistake` is reversed in the original period, and the answer's `stornoCorrection` says whether that period needs an additional return and a follow-up control statement; a `refund` or a `cancelled` supply is corrected on `occurredOn`, today when left out. A refund that brings money back is better entered as a refund of the advance.

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

MCP tool: storno-supplier-advance-tax-document

Path parameters

idstringrequired

Request body

reason"mistake" | "refund" | "cancelled"
occurredOnstringYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advance-tax-documents/{id}/storno
curl -X POST https://api.damedoklad.cz/v1/supplier-advance-tax-documents/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "mistake",
  "occurredOn": "2026-10-30"
}'

List zálohové faktury from suppliers: advances to pay or paid. `from` and `to` filter on the issue date; `unpaid=true` keeps those still to pay

GET/v1/supplier-advances

List zálohové faktury from suppliers: advances to pay or paid. `from` and `to` filter on the issue date; `unpaid=true` keeps those still to pay

MCP tool: list-supplier-advances

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"supplier_advance"required
idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/supplier-advances
curl https://api.damedoklad.cz/v1/supplier-advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a supplier's zálohová faktura. It is not a tax document: nothing is posted and no VAT is claimed until it is paid and the supplier's tax document arrives

POST/v1/supplier-advances

Record a supplier's zálohová faktura. It is not a tax document: nothing is posted and no VAT is claimed until it is paid and the supplier's tax document arrives. Answers 409 when the supplier document number is already recorded. `record: false` keeps a draft.

MCP tool: create-supplier-advance

Request body

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
advanceAccount"151" | "152" | "153" | "314" | "051" | "052"
taxRecordsKind"expense" | "long_term_asset" | "related_party"
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.
supplierDocumentNumberstringrequiredmax 64 chars
variableSymbolstring | null
constantSymbolstring | null
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"
theirAccountNumberstring | null
theirBankCodestring | null
theirIbanstring | null
IBAN without spaces.
notePublicstring | null
noteInternalstring | null
recordboolean
confirmDuplicateboolean
linesobject[]required
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringrequiredmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRate0 | 10 | 12 | 15 | 21required
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.
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
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances
curl -X POST https://api.damedoklad.cz/v1/supplier-advances \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "supplierDocumentNumber": "string",
  "issueDate": "2026-10-30",
  "lines": [
    {
      "description": "Pečivo, říjen",
      "quantity": 1,
      "unitPriceHaler": 1210000,
      "vatRate": 0
    }
  ]
}'

Get an advance to a supplier with lines, payments, and the supplier's tax documents

GET/v1/supplier-advances/{id}

Get an advance to a supplier with lines, payments, and the supplier's tax documents

MCP tool: get-supplier-advance

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
GET/v1/supplier-advances/{id}
curl https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Change an advance to a supplier. Lines, currency, VAT mode, and supplier only while it is a draft

PATCH/v1/supplier-advances/{id}

Change an advance to a supplier. Lines, currency, VAT mode, and supplier only while it is a draft

MCP tool: update-supplier-advance

Path parameters

idstringrequired

Request body

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
advanceAccount"151" | "152" | "153" | "314" | "051" | "052"
taxRecordsKind"expense" | "long_term_asset" | "related_party"
contactIdstring
ID of the contact. Find it with list-contacts.
seriesIdstring
ID of the series. Find it with list-series.
supplierDocumentNumberstringmax 64 chars
variableSymbolstring | null
constantSymbolstring | null
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"
theirAccountNumberstring | null
theirBankCodestring | null
theirIbanstring | null
IBAN without spaces.
notePublicstring | null
noteInternalstring | null
confirmDuplicateboolean
linesobject[]
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringrequiredmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRate0 | 10 | 12 | 15 | 21required
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.
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
recordboolean
roundingMode"auto" | "crown" | "none"

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
PATCH/v1/supplier-advances/{id}
curl -X PATCH https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vatMode": "domestic",
  "exchangeRate": 1,
  "templateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

Cancel an advance to a supplier that has no payments

POST/v1/supplier-advances/{id}/cancel

Cancel an advance to a supplier that has no payments

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

MCP tool: cancel-supplier-advance

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/cancel
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a payment of an advance to a supplier: MD 314 or the account it sits on / D 221, or an expense in the cash book

POST/v1/supplier-advances/{id}/payments

Record a payment of an advance to a supplier: MD 314 or the account it sits on / D 221, or an expense in the cash book. 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. A later statement line takes the transfer over.

MCP tool: add-supplier-advance-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
exchangeRatenumber

Response · 201

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/payments
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "paidOn": "2026-10-30"
}'

Remove a payment or refund of an advance to a supplier and reverse its posting

DELETE/v1/supplier-advances/{id}/payments/{paymentId}

Remove a payment or refund of an advance to a supplier and reverse its posting. Refused while a tax document stands on the payment or the advance is settled. Removing a refund also cancels its corrective tax document.

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

MCP tool: remove-supplier-advance-payment

Path parameters

idstringrequired
paymentIdstringrequired
ID of the payment.

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
DELETE/v1/supplier-advances/{id}/payments/{paymentId}
curl -X DELETE https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/payments/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Move an advance to a supplier to another account: 314, 051, 052, 151, 152, or 153. Posts MD new / D old for what it holds

POST/v1/supplier-advances/{id}/reclassify

Move an advance to a supplier to another account: 314, 051, 052, 151, 152, or 153. Posts MD new / D old for what it holds. Legal effect: posts to the books. Double-entry only. Refused while a tax document stands on the advance and once it is settled: at the final invoice it clears by itself, MD 042 / D 052 and so on.

MCP tool: reclassify-supplier-advance

Path parameters

idstringrequired

Request body

advanceAccount"151" | "152" | "153" | "314" | "051" | "052"required
datestringYYYY-MM-DD
Date as YYYY-MM-DD.

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/reclassify
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reclassify \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "advanceAccount": "151"
}'

Record a draft advance to a supplier: it gets its number and can be paid

POST/v1/supplier-advances/{id}/record

Record a draft advance to a supplier: it gets its number and can be paid

MCP tool: record-supplier-advance

Path parameters

idstringrequired

Response · 200

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/record
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/record \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record money a supplier paid back on an advance. Whatever part was taxed takes the supplier's corrective tax document (§ 74 ZDPH)

POST/v1/supplier-advances/{id}/refund

Record money a supplier paid back on an advance. Whatever part was taxed takes the supplier's corrective tax document (§ 74 ZDPH). amountHaler defaults to everything paid. Refused once the advance is settled into an invoice. `supplierDocumentNumber` can follow later through update-supplier-advance-tax-document.

MCP tool: refund-supplier-advance

Path parameters

idstringrequired

Request body

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

Response · 201

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/refund
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/refund \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "refundedOn": "2026-10-30",
  "reason": "string"
}'

Record the supplier's final invoice for an advance and deduct the advance from it. Lines default to the advance's. To deduct several, use `supplierAdvanceIds` on create-received-invoice

POST/v1/supplier-advances/{id}/settle

Record the supplier's final invoice for an advance and deduct the advance from it. Lines default to the advance's. To deduct several, use `supplierAdvanceIds` on create-received-invoice. Legal effect: posts costs and VAT and clears the advance against 321: MD 518 / D 314, or MD 042 / D 052 when the advance sits on an account of what it pays for and the line names no account of its own. Storno of the invoice hands the advance back.

MCP tool: settle-supplier-advance

Path parameters

idstringrequired

Request body

supplierDocumentNumberstringrequiredmax 64 chars
issueDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
receivedOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
exchangeRatenumber
confirmDuplicateboolean
linesobject[]
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringrequiredmax 240 chars
quantitynumberrequired
unitstringmax 16 chars
unitPriceHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRate0 | 10 | 12 | 15 | 21required
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.
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
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
fileIdnull | stringrequired
customFieldsobject
vatModestring
exchangeRateinteger
templateIdnull | string
centerIdstring | null
activityIdstring | null
projectIdnull | string
seriesIdnull | string
constantSymbolstring | null
receivedOnnull | stringdate
taxPointDatestringdate
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbannull | string
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
stornoOfIdnull | string
duplicateOfIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetnull | string
billToCitynull | string
billToPostalCodenull | string
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"received_invoice_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumbernull | stringrequired
lineKindstringrequired
sourceIdnull | stringrequired
itemIdnull | stringrequired
warehouseIdnull | stringrequired
lotsobject[]required
lotIdstring | nullrequired
codenull | stringrequired
quantityintegerrequired
expiryDatestring | nullrequired
orderLineIdnull | stringrequired
recyclingnull | object
textstringrequired
unitstringrequired
feeIdnull | stringrequired
rateHalerintegerrequired
totalHalerintegerrequired
weightMilliinteger
perUnitHalerintegerrequired
coefficientMilliintegerrequired
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
settlementsobject[]
object"received_invoice_settlement"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
supplierAdvancesobject[]
idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
postingobject
regimestringrequired
eventstringrequired
journalLinesobject[]
accountnull | stringrequired
sidestringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
balancedboolean
cashJournalobject[]
accountnull | stringrequired
amountHalerinteger | nullrequired
documentIdnull | stringrequired
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringrequired
amountHalerinteger | nullrequired
statusstringrequired
assetany[]
retentionsany[]
duplicateobject
existingIdstringrequired
bankMovementobject
idstringrequired
bankAccountIdstringrequired
cashDocumentobject
idstringrequired
numbernull | stringrequired
warningsany[]required
importedobject
uuidstringrequired
documentTypeinteger | nullrequired
warningsstring[]required
POST/v1/supplier-advances/{id}/settle
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settle \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierDocumentNumber": "string",
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30"
}'

Record the supplier's tax document for a paid advance: MD 343 / D 314 for the VAT, into the VAT register and control statement of its period. For a service from the EU or a third country it records the customer's self-assessment of the payment instead. VAT payers only

POST/v1/supplier-advances/{id}/tax-documents

Record the supplier's tax document for a paid advance: MD 343 / D 314 for the VAT, into the VAT register and control statement of its period. For a service from the EU or a third country it records the customer's self-assessment of the payment instead. VAT payers only. Without `lines` the VAT is taken out of the part paid and not yet taxed, at the advance's rates. `receivedOn` decides the first period the deduction may be claimed in (§ 73 odst. 2 ZDPH). In modes eu_services and third_country_services the tax is due on the day of the payment (§ 24 odst. 3, § 108 odst. 3 ZDPH): `vatRate` (default 21) goes on the payment as the base, `supplierDocumentNumber` is optional, and tax and deduction land in the same period with nothing in the books. Do not record it if the supply is not yet known with enough certainty (§ 24 odst. 3, second sentence): the final invoice then carries the tax.

MCP tool: create-supplier-advance-tax-document

Path parameters

idstringrequired

Request body

supplierDocumentNumberstringmax 64 chars
paymentIdstring
ID of the payment.
vatRate21 | 12
issueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
receivedOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
exchangeRatenumber
amountHalerintegermax 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
linesobject[]
vatRatenumberrequiredmin 0max 30
netHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatHalerintegerrequiredmin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
descriptionstringmax 400 chars

Response · 201

idstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
variableSymbolnull | stringrequired
contactIdnull | stringrequired
contactNamenull | stringrequired
issueDatestringrequireddate
dueDatenull | stringrequireddate
currencystringrequired
totalHalerintegerrequired
paidHalerintegerrequired
statusstringrequired
overduebooleanrequired
customFieldsobject
stavba_zalohystring
vatModestring
exchangeRateinteger
templateIdstring | null
centerIdstring | null
activityIdstring | null
projectIdstring | null
seriesIdnull | string
constantSymbolstring | null
paymentMethodstring
theirAccountNumbernull | string
theirBankCodenull | string
theirIbanstring | null
notePublicstring | null
noteInternalnull | string
netHalerinteger
vatHalerinteger
taxedHalerinteger
advanceAccountstring
selfAssessableboolean
receivedInvoiceIdnull | string
contactIconull | string
contactDicnull | string
contactVatPayerTypenull | string
billToStreetstring | null
billToCitystring | null
billToPostalCodestring | null
billToCountrynull | string
shipToNamestring | null
shipToStreetstring | null
shipToCitystring | null
shipToPostalCodestring | null
shipToCountrystring | null
contactEmailnull | string
linesobject[]
object"supplier_advance_line"required
idstringrequired
descriptionstringrequired
quantityintegerrequired
unitstringrequired
unitPriceHalerintegerrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
accountNumberstring | nullrequired
lineKindstringrequired
sourceIdstring | nullrequired
itemIdstring | nullrequired
warehouseIdstring | nullrequired
lotsany[]required
orderLineIdstring | nullrequired
vatLinesobject[]
object"supplier_advance_vat_line"required
idstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
paymentsobject[]
object"supplier_advance_payment"required
idstringrequired
amountHalerintegerrequired
paidOnstringrequireddate
methodstringrequired
notenull | stringrequired
exchangeRatenumberrequired
taxDocumentsobject[]
object"supplier_advance_tax_document"required
idstringrequired
supplierAdvanceIdstringrequired
numbernull | stringrequired
supplierDocumentNumbernull | stringrequired
contactNamenull | stringrequired
contactDicnull | stringrequired
statusstringrequired
issueDatestringrequireddate
taxPointDatestringrequireddate
receivedOnnull | stringrequireddate
currencystringrequired
exchangeRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
reasonnull | stringrequired
correctsNumbernull | stringrequired
selfAssessedbooleanrequired
paymentIdnull | stringrequired
receivedInvoiceIdnull | stringrequired
stornoOfIdnull | stringrequired
linesobject[]required
object"supplier_advance_tax_document_line"required
idstringrequired
descriptionstringrequired
vatRateintegerrequired
netHalerintegerrequired
vatHalerintegerrequired
totalHalerintegerrequired
taxRecordsKindstring
bankMovementobject
idstringrequired
bankAccountIdstringrequired
refundobject
amountHalerinteger | nullrequired
paymentIdnull | stringrequired
correctionIdnull | stringrequired
correctionNumbernull | stringrequired
stornoCorrectionobject
reasonnull | stringrequired
datestringrequireddate
periodstringrequired
additionalReturnbooleanrequired
followUpStatementbooleanrequired
POST/v1/supplier-advances/{id}/tax-documents
curl -X POST https://api.damedoklad.cz/v1/supplier-advances/sad_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/tax-documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierDocumentNumber": "string",
  "paymentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "vatRate": 21
}'