Přejít na obsah

Přijaté faktury

Operace ve skupině Přijaté faktury.

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

Seznam: přijaté faktury

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

Nástroj MCP: list-received-invoices

Parametry dotazu

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

Odpověď · 200

dataobject[]povinné
object"received_invoice"povinné
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
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"

Vytvoření: přijatá faktura

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.

Nástroj MCP: create-received-invoice

Tělo požadavku

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
contactNamestringmax 160 chars
contactIcostringmax 16 chars
Czech company number (IČO), 8 digits.
contactDicstringmax 16 chars
VAT number (DIČ), for example CZ12345678.
seriesIdstring
ID of the series. Find it with list-series.
supplierDocumentNumberstringpovinnémax 64 chars
variableSymbolstring | null
constantSymbolstring | null
receivedOnstringYYYY-MM-DD
Date as YYYY-MM-DD.
issueDatestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
taxPointDatestringpovinnéYYYY-MM-DD
Date as YYYY-MM-DD.
dueDatestringYYYY-MM-DD
Date as YYYY-MM-DD.
currencystring3 chars
ISO 4217 currency code, for example CZK or EUR.
paymentMethod"transfer" | "cash" | "proforma" | "card" | "cod"
theirAccountNumberstring | null
theirBankCodestring | null
theirIbanstring | null
IBAN without spaces.
notePublicstring | null
noteInternalstring | null
recordboolean
confirmDuplicateboolean
supplierAdvanceIdsstring[]
linesobject[]povinné
purchaseHalerintegermin 0max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
exemptPercentnumbermin 0max 100
purchaseLineIdstring | null
ID of the purchase line.
descriptionstringpovinnémax 240 chars
quantitynumberpovinné
unitstringmax 16 chars
unitPriceHalerintegerpovinnémin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRate0 | 10 | 12 | 15 | 21povinné
itemIdstring
ID of the item. Find it with list-items.
warehouseIdstring
ID of the warehouse. Find it with list-warehouses.
lotsobject[]
itemIdstring
ID of the item. Find it with list-items.
lotIdstring
ID of the lot.
codestringmax 64 chars
quantitynumber
expiryDatestring | null
Date as YYYY-MM-DD.
serialNumbersstring[]
orderLineIdstring
ID of the order line.
recyclingFeeIdstring | null
A fee from the list. null means no fee on this line, whatever the item says
recyclingPerUnitHalerintegermin 0max 9007199254740991
The amount per fee unit: with recyclingFeeId it replaces the rate of the fee on this line, without it the line carries a typed fee
recyclingTextstringmax 120 chars
recyclingUnit"ks" | "kg"
The unit of a typed fee
recyclingCoefficientnumbermin 0max 1000000
How many times the fee applies to one unit of the line
accountNumberstring | null
Account number from the chart of accounts, for example 311. list-accounts lists them.
roundingMode"auto" | "crown" | "none"

Odpověď · 201

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
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
    }
  ]
}'

Detail: přijatá faktura

GET/v1/received-invoices/{id}

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

Nástroj MCP: get-received-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
GET/v1/received-invoices/{id}
curl https://api.damedoklad.cz/v1/received-invoices/rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Úprava: přijatá faktura

PATCH/v1/received-invoices/{id}

Change a received invoice

Nástroj MCP: update-received-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

vatMode"domestic" | "reverse_charge" | "eu_goods" | "eu_services" | "third_country_goods" | "third_country_services" | "oss" | "eu_triangular" | "eu_new_vehicle" | "goods_installation_networks" | "eu_registration" | "eu_sme" | "group_internal" | "margin_used_goods" | "margin_art" | "margin_collectibles" | "margin_travel" | "exempt" | "none"
exchangeRatenumber
templateIdstring | null
ID of the template.
centerIdstring | null
ID of the center.
activityIdstring | null
ID of the activity. Find it with list-activity.
projectIdstring | null
ID of the project.
contactIdstring
ID of the contact. Find it with list-contacts.
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.
descriptionstringpovinnémax 240 chars
quantitynumberpovinné
unitstringmax 16 chars
unitPriceHalerintegerpovinnémin -9007199254740991max 9007199254740991
Integer amount in haléře: 100 = 1 Kč.
vatRate0 | 10 | 12 | 15 | 21povinné
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"

Odpověď · 200

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
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"
}'

Příloha: přijatá faktura

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

Attach the scan or PDF of a received invoice

Nástroj MCP: attach-received-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 200

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
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."
}'

Detail: příloha, přijatá faktura

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

Download the attached scan or PDF

Nástroj MCP: get-received-invoice-attachment

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/pdf.

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

Seznam: likvidace, přijatá faktura

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

List the payments of a received invoice

Nástroj MCP: list-received-invoice-settlements

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500
offsetintegermin 0max 9007199254740991
searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
totalinteger
Rows that match, on all pages.
hasMorebooleanpovinné
More rows follow. Ask again with offset + the number of rows received.
GET/v1/received-invoices/{id}/settlements
curl https://api.damedoklad.cz/v1/received-invoices/rin_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/settlements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

Přidání: likvidace, přijatá faktura

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.

Nástroj MCP: add-received-invoice-settlement

Parametry v cestě

idstringpovinné

Tělo požadavku

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

Odpověď · 201

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
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"
}'

Storno: přijatá faktura

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.

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

Nástroj MCP: storno-received-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
variableSymbolnull | stringpovinné
contactIdnull | stringpovinné
contactNamenull | stringpovinné
issueDatestringpovinnédate
dueDatenull | stringpovinnédate
currencystringpovinné
totalHalerintegerpovinné
paidHalerintegerpovinné
statusstringpovinné
overduebooleanpovinné
fileIdnull | stringpovinné
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"povinné
idstringpovinné
descriptionstringpovinné
quantityintegerpovinné
unitstringpovinné
unitPriceHalerintegerpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
totalHalerintegerpovinné
accountNumbernull | stringpovinné
lineKindstringpovinné
sourceIdnull | stringpovinné
itemIdnull | stringpovinné
warehouseIdnull | stringpovinné
lotsobject[]povinné
lotIdstring | nullpovinné
codenull | stringpovinné
quantityintegerpovinné
expiryDatestring | nullpovinné
orderLineIdnull | stringpovinné
recyclingnull | object
textstringpovinné
unitstringpovinné
feeIdnull | stringpovinné
rateHalerintegerpovinné
totalHalerintegerpovinné
weightMilliinteger
perUnitHalerintegerpovinné
coefficientMilliintegerpovinné
typedboolean
vatLinesobject[]
object"received_invoice_vat_line"povinné
idstringpovinné
vatRateintegerpovinné
netHalerintegerpovinné
vatHalerintegerpovinné
settlementsobject[]
object"received_invoice_settlement"povinné
idstringpovinné
amountHalerintegerpovinné
paidOnstringpovinnédate
methodstringpovinné
notenull | stringpovinné
supplierAdvancesobject[]
idstringpovinné
numbernull | stringpovinné
supplierDocumentNumbernull | stringpovinné
postingobject
regimestringpovinné
eventstringpovinné
journalLinesobject[]
accountnull | stringpovinné
sidestringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
balancedboolean
cashJournalobject[]
accountnull | stringpovinné
amountHalerinteger | nullpovinné
documentIdnull | stringpovinné
receivablesBookany[]
payablesBookobject[]
documentIdnull | stringpovinné
amountHalerinteger | nullpovinné
statusstringpovinné
assetany[]
retentionsany[]
duplicateobject
existingIdstringpovinné
bankMovementobject
idstringpovinné
bankAccountIdstringpovinné
cashDocumentobject
idstringpovinné
numbernull | stringpovinné
warningsany[]povinné
importedobject
uuidstringpovinné
documentTypeinteger | nullpovinné
warningsstring[]povinné
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"

Kontrola duplicity přijaté faktury

GET/v1/received-invoices/duplicate-check

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

Nástroj MCP: duplicate-check-received-invoice

Parametry dotazu

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

Odpověď · 200

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