Delivery notes
Operations in the Delivery notes group.
List delivery notes (dodací listy). `from` and `to` filter on the issue date
/v1/delivery-notesList delivery notes (dodací listy). `from` and `to` filter on the issue date
MCP tool: list-delivery-notes
Query parameters
limitintegermin 1max 500offsetintegermin 0max 9007199254740991searchstringmax 200 charsfromstringYYYY-MM-DDtostringYYYY-MM-DDstatusstringcontactIdstringdueFromstringdueTostringqstringmax 200 charsunpaid"true" | "false"customFieldKeystringcustomFieldValuestringmax 2000 charsResponse · 200
dataobject[]requiredobject"delivery_note"requiredidstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringtotalintegerhasMorebooleanrequiredCreate a delivery note
/v1/delivery-notesCreate a delivery note
MCP tool: create-delivery-note
Request body
vatMode"domestic" | "eu_registration"carrierIdstring | nullcontactIdstringcontactNamestringmax 160 charscontactIcostringmax 16 charscontactDicstringmax 16 charsseriesIdstringissueDatestringrequiredYYYY-MM-DDdeliveryDatestringrequiredYYYY-MM-DDcurrencystring3 charslanguage"cs" | "en" | "sk" | "de" | "fr" | "pl"notePublicstring | nullnoteInternalstring | nullshipToNamestring | nullshipToStreetstring | nullshipToCitystring | nullshipToPostalCodestring | nullshipToCountrystring | nullissuebooleanlinesobject[]requireddescriptionstringrequiredmax 240 charsquantitynumberrequiredunitstringmax 16 charsunitPriceHalerinteger | nullitemIdstringwarehouseIdstringrecyclingFeeIdstring | nullrecyclingPerUnitHalerintegermin 0max 9007199254740991recyclingTextstringmax 120 charsrecyclingUnit"ks" | "kg"recyclingCoefficientnumbermin 0max 1000000lotsobject[]itemIdstringlotIdstringcodestringmax 64 charsquantitynumberexpiryDatestring | nullserialNumbersstring[]orderLineIdstringResponse · 201
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringGet a delivery note with lines
/v1/delivery-notes/{id}Get a delivery note with lines
MCP tool: get-delivery-note
Path parameters
idstringrequiredResponse · 200
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringChange a draft delivery note
/v1/delivery-notes/{id}Change a draft delivery note
MCP tool: update-delivery-note
Path parameters
idstringrequiredRequest body
carrierIdstring | nullcontactIdstringseriesIdstringissueDatestringYYYY-MM-DDdeliveryDatestringYYYY-MM-DDcurrencystring3 charslanguage"cs" | "en" | "sk" | "de" | "fr" | "pl"notePublicstring | nullnoteInternalstring | nullshipToNamestring | nullshipToStreetstring | nullshipToCitystring | nullshipToPostalCodestring | nullshipToCountrystring | nulllinesobject[]descriptionstringrequiredmax 240 charsquantitynumberrequiredunitstringmax 16 charsunitPriceHalerinteger | nullitemIdstringwarehouseIdstringrecyclingFeeIdstring | nullrecyclingPerUnitHalerintegermin 0max 9007199254740991recyclingTextstringmax 120 charsrecyclingUnit"ks" | "kg"recyclingCoefficientnumbermin 0max 1000000lotsobject[]itemIdstringlotIdstringcodestringmax 64 charsquantitynumberexpiryDatestring | nullserialNumbersstring[]orderLineIdstringResponse · 200
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringCancel a delivery note
/v1/delivery-notes/{id}/cancelCancel a delivery note
IrreversibleThis operation cannot be undone. MCP clients ask for confirmation first.
MCP tool: cancel-delivery-note
Path parameters
idstringrequiredResponse · 200
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringCreate a new draft delivery note from an existing one
/v1/delivery-notes/{id}/copyCreate a new draft delivery note from an existing one
MCP tool: copy-delivery-note
Path parameters
idstringrequiredResponse · 201
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringCreate an invoice from an issued delivery note: a draft unless `issue` is true
/v1/delivery-notes/{id}/invoiceCreate an invoice from an issued delivery note: a draft unless `issue` is true. With `issue: true`: Legal effect: this assigns the final document number, creates a tax document, and posts to the books. Confirm with the user first.
MCP tool: invoice-from-delivery-note
Path parameters
idstringrequiredRequest body
issueDatestringtaxPointDatestringissuebooleanvatRatenumberResponse · 201
idstringrequirednumbernull | stringrequiredvariableSymbolnull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedueDatenull | stringrequireddatecurrencystringrequiredtotalHalerintegerrequiredpaidHalerintegerrequiredstatusstringrequiredoverduebooleanrequiredfileIdnull | stringrequiredcustomFieldsobjectzakazka_zakaznikastringpocetintegerkampanstringvatModestringexchangeRatenumbertemplateIdnull | stringcenterIdnull | stringactivityIdnull | stringprojectIdnull | stringseriesIdnull | stringconstantSymbolnull | stringtaxPointDatestringdatepaymentMethodstringlanguagestringnotePublicnull | stringnoteInternalnull | stringourAccountNumbernull | stringourBankCodenull | stringourIbannull | stringsellerNamenull | stringsellerIconull | stringsellerDicnull | stringreminderOnDuebooleanreminderWeekAfterbooleanreminder14DaysAfterbooleanreminderMonthAfterbooleannetHalerintegervatHalerintegerroundingHalerintegerrecurringIdnull | stringstornoOfIdnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamestring | nullshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrynull | stringcontactEmailnull | stringlinesobject[]object"invoice_line"requiredidstringrequireddescriptionstringrequiredquantitynumberrequiredunitstringrequiredunitPriceHalerintegerrequiredvatRatenumberrequirednetHalerintegerrequiredvatHalerintegerrequiredtotalHalerintegerrequiredaccountNumbernull | stringrequiredlineKindstringrequiredsourceIdnull | stringrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requireditemIdnull | stringlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerintegerrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanvatLinesobject[]object"invoice_vat_line"requiredidstringrequiredvatRatenumberrequirednetHalerintegerrequiredvatHalerintegerrequiredpaymentsobject[]object"invoice_payment"requiredidstringrequiredamountHalerintegerrequiredpaidOnstringrequireddatemethodstringrequirednotenull | stringrequiredlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredjournalLinesobject[]accountnull | stringrequiredsidestringrequiredamountHalerinteger | nullrequireddocumentIdnull | stringrequiredbalancedbooleancashJournalobject[]accountnull | stringrequiredamountHalerinteger | nullrequireddocumentIdnull | stringrequiredreceivablesBookobject[]documentIdnull | stringrequiredamountHalerinteger | nullrequiredstatusstringrequiredpayablesBookany[]assetany[]retentionsobject[]idstringrequiredamountHalerinteger | nullrequireddueDatenull | stringrequireddatenotestring | nullrequiredlongTermbooleanrequiredcarrierIdnull | stringcreditWarningobjectlevelstringrequiredexposureHalerintegerrequiredafterHalerintegerrequiredwarnHalerinteger | nullrequiredblockHalerintegerrequiredavailableHalerintegerrequiredoriginalanybankMovementobjectidstringrequiredbankAccountIdstringrequiredcashDocumentobjectidstringrequirednumbernull | stringrequiredwarningsany[]requiredIssue a draft delivery note. With items and a warehouse it moves stock
/v1/delivery-notes/{id}/issueIssue a draft delivery note. With items and a warehouse it moves stock
MCP tool: issue-delivery-note
Path parameters
idstringrequiredRequest body
overrideReservationsbooleanoverrideDeliveryNotesbooleandeliveryNoteIdsstring[]overrideCreditLimitbooleanResponse · 200
idstringrequirednumbernull | stringrequiredcontactIdnull | stringrequiredcontactNamenull | stringrequiredissueDatestringrequireddatedeliveryDatestringrequireddatestatusstringrequiredfileIdnull | stringrequiredcarrierIdstring | nullcustomFieldsobjectseriesIdnull | stringcurrencystringlanguagestringnotePublicstring | nullnoteInternalnull | stringcontactIconull | stringcontactDicnull | stringcontactVatPayerTypenull | stringbillToStreetnull | stringbillToCitynull | stringbillToPostalCodenull | stringbillToCountrynull | stringshipToNamenull | stringshipToStreetnull | stringshipToCitynull | stringshipToPostalCodenull | stringshipToCountrystring | nullcontactEmailnull | stringsellerNamenull | stringlinesobject[]object"delivery_note_line"requiredidstringrequireddescriptionstringrequiredquantityintegerrequiredunitstringrequiredunitPriceHalerinteger | nullrequireditemIdnull | stringrequiredwarehouseIdnull | stringrequiredlotsobject[]requiredlotIdstring | nullrequiredcodenull | stringrequiredquantityintegerrequiredexpiryDatestring | nullrequiredorderLineIdnull | stringrequiredrecyclingnull | objecttextstringrequiredunitstringrequiredfeeIdnull | stringrequiredrateHalerintegerrequiredtotalHalerinteger | nullrequiredweightMilliintegerperUnitHalerintegerrequiredcoefficientMilliintegerrequiredtypedbooleanlinksobject[]object"document_link"requiredidstringrequiredfromKindstringrequiredfromIdstringrequiredtoKindstringrequiredtoIdstringrequiredkindstringrequiredamountHalerinteger | nullpostingobjectregimestringrequiredeventstringrequiredskippedbooleanrequiredvatModestringDownload the delivery note as a PDF
/v1/delivery-notes/{id}/pdfDownload the delivery note as a PDF
MCP tool: get-delivery-note-pdf
Path parameters
idstringrequiredResponse · 200
Returns a application/pdf file.