Skip to content

Received invoices

Operations in the Received invoices group.

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

List received invoices (faktury přijaté). `from` and `to` filter on the issue date; `unpaid=true` keeps those still to pay

GET/v1/received-invoices

List received invoices (faktury přijaté). `from` and `to` filter on the issue date; `unpaid=true` keeps those still to pay

MCP tool: list-received-invoices

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars
fromstringYYYY-MM-DD
Date as YYYY-MM-DD.
tostringYYYY-MM-DD
Date as YYYY-MM-DD.
statusstring
Document status, for example draft, issued, partially_paid, paid, storno.
contactIdstring
Only documents of this contact.
dueFromstring
Due on or after this date, YYYY-MM-DD.
dueTostring
Due on or before this date, YYYY-MM-DD.
qstringmax 200 chars
Older name for `search`.
unpaid"true" | "false"
`true`: only documents with an open balance.
customFieldKeystring
Only records with this custom field. Alone: it has any value. With customFieldValue: exactly that value, ignoring case.
customFieldValuestringmax 2000 chars

Response · 200

dataobject[]required
object"received_invoice"required
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
totalinteger
Rows that match, on all pages.
hasMorebooleanrequired
More rows follow. Ask again with offset + the number of rows received.
GET/v1/received-invoices
curl https://api.damedoklad.cz/v1/received-invoices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Record a received invoice

POST/v1/received-invoices

Record a received invoice. Legal effect: posts to the books, and to the VAT evidence when the supplier is a VAT payer. Answers 409 when the supplier document number is already recorded. To record one from a PDF or a photo, use record-received-invoice-from-file.

MCP tool: create-received-invoice

Request body

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
contactNamestringmax 160 chars
contactIcostringmax 16 chars
Czech company number (IČO), 8 digits.
contactDicstringmax 16 chars
VAT number (DIČ), for example CZ12345678.
seriesIdstring
ID of the series. Find it with list-series.
supplierDocumentNumberstringrequiredmax 64 chars
variableSymbolstring | null
constantSymbolstring | null
receivedOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
issueDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringrequiredYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
theirAccountNumberstring | null
theirBankCodestring | null
theirIbanstring | null
IBAN without spaces.
notePublicstring | null
noteInternalstring | null
recordboolean
confirmDuplicateboolean
supplierAdvanceIdsstring[]
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.
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
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/received-invoices
curl -X POST https://api.damedoklad.cz/v1/received-invoices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "supplierDocumentNumber": "string",
  "issueDate": "2026-10-30",
  "taxPointDate": "2026-10-30",
  "lines": [
    {
      "description": "Pečivo, říjen",
      "quantity": 1,
      "unitPriceHaler": 1210000,
      "vatRate": 0
    }
  ]
}'

Get a received invoice with lines, VAT recap, settlements, and the amount still to pay

GET/v1/received-invoices/{id}

Get a received invoice with lines, VAT recap, settlements, and the amount still to pay

MCP tool: get-received-invoice

Path parameters

idstringrequired

Response · 200

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

Change a received invoice

PATCH/v1/received-invoices/{id}

Change a received invoice

MCP tool: update-received-invoice

Path parameters

idstringrequired

Request body

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
seriesIdstring
ID of the series. Find it with list-series.
supplierDocumentNumberstringmax 64 chars
variableSymbolstring | null
constantSymbolstring | null
receivedOnstring | null
Date as YYYY-MM-DD.
issueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestring | null
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
theirAccountNumberstring | null
theirBankCodestring | null
theirIbanstring | null
IBAN without spaces.
notePublicstring | null
noteInternalstring | null
confirmDuplicateboolean
supplierAdvanceIdsstring[]
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.
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.
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
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
PATCH/v1/received-invoices/{id}
curl -X PATCH https://api.damedoklad.cz/v1/received-invoices/rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "vatMode": "domestic",
  "exchangeRate": 1,
  "templateId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

Attach the scan or PDF of a received invoice

POST/v1/received-invoices/{id}/attach

Attach the scan or PDF of a received invoice

MCP tool: attach-received-invoice

Path parameters

idstringrequired

Request body

fileIdstring
ID of the file.
fileBase64string
File content encoded as base64.
filenamestringmax 200 chars
contentTypestringmax 120 chars

Response · 200

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/received-invoices/{id}/attach
curl -X POST https://api.damedoklad.cz/v1/received-invoices/rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/attach \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileId": "fil_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "fileBase64": "string",
  "filename": "Pekárna U Lípy s.r.o."
}'

Download the attached scan or PDF

GET/v1/received-invoices/{id}/attachment

Download the attached scan or PDF

MCP tool: get-received-invoice-attachment

Path parameters

idstringrequired

Response · 200

Returns a application/pdf file.

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

List the payments of a received invoice

GET/v1/received-invoices/{id}/settlements

List the payments of a received invoice

MCP tool: list-received-invoice-settlements

Path parameters

idstringrequired

Query parameters

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Response · 200

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

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

POST/v1/received-invoices/{id}/settlements

Record a payment of a received invoice. Cash goes through a cash document of a register, a transfer through a bank account, and a later statement line takes it over. Legal effect: posts to the books. With several registers or accounts name registerId or bankAccountId. In another currency than the document, moneyAmountHaler says what moved on the account. A cash expense that would take the register below zero is refused unless allowNegative is true.

MCP tool: add-received-invoice-settlement

Path parameters

idstringrequired

Request body

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

Response · 201

idstringrequired
numbernull | stringrequired
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/received-invoices/{id}/settlements
curl -X POST https://api.damedoklad.cz/v1/received-invoices/rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settlements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "amountHaler": 1210000,
  "paidOn": "2026-10-30"
}'

Cancel a received invoice with a reversing document

POST/v1/received-invoices/{id}/storno

Cancel a received invoice with a reversing document. Legal effect: reverses the bookings and the VAT evidence. Confirm with the user first.

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

MCP tool: storno-received-invoice

Path parameters

idstringrequired

Response · 200

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

Check whether this supplier document number is already recorded. Call before create-received-invoice

GET/v1/received-invoices/duplicate-check

Check whether this supplier document number is already recorded. Call before create-received-invoice

MCP tool: duplicate-check-received-invoice

Query parameters

contactIdstring
Supplier contact ID.
supplierDocumentNumberstring
The supplier's own document number.

Response · 200

duplicatebooleanrequired
existingIdstring
GET/v1/received-invoices/duplicate-check
curl https://api.damedoklad.cz/v1/received-invoices/duplicate-check \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"