Přehledy

Operace ve skupině Přehledy.

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

GET/v1/overview
GET/v1/reports/aging
GET/v1/reports/cash-flow
GET/v1/reports/export
GET/v1/reports/income-expense
GET/v1/reports/payment-discipline
GET/v1/reports/top-contacts

Get the financial overview: to-do counts, overdue receivables, cash on hand, year result, monthly revenue and expense with a forecast, and breakdowns by account

GET/v1/overview

Get the financial overview: to-do counts, overdue receivables, cash on hand, year result, monthly revenue and expense with a forecast, and breakdowns by account

Nástroj MCP: get-financial-overview

Parametry dotazu

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Odpověď · 200

asOfstringpovinnédate-time

regimestringpovinné

yearintegerpovinné

toDoobjectpovinné

totalintegerpovinné

documentsintegerpovinné

movementsintegerpovinné

overdueobjectpovinné

amountHalerinteger | nullpovinné

countintegerpovinné

oldestDaysintegerpovinné

oldestBucketnull | stringpovinné

moneyobjectpovinné

balanceHalerintegerpovinné

changePercentinteger | nullpovinné

resultnull | objectpovinné

amountHalerinteger | nullpovinné

revenueHalerintegerpovinné

expenseHalerintegerpovinné

monthsobject[]povinné

monthnull | stringpovinné

revenueHalerintegerpovinné

expenseHalerintegerpovinné

forecastnull | objectpovinné

monthnull | stringpovinné

actualProfitHalerintegerpovinné

estimatedProfitHalerintegerpovinné

estimatedRevenueHalerintegerpovinné

estimatedExpenseHalerintegerpovinné

expensesByAccountobject[]povinné

keystringpovinné

labelnull | stringpovinné

amountHalerinteger | nullpovinné

revenuesByAccountobject[]povinné

keystringpovinné

labelnull | stringpovinné

amountHalerinteger | nullpovinné

toFinishobject[]povinné

typestringpovinné

countintegerpovinné

pathnull | stringpovinné

labelnull | string

labelEnstring

kindstring

requiresstring

fromstringdate

tostringdate

periodIdstring

GET/v1/overview

curl https://api.damedoklad.cz/v1/overview \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/overview', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/overview",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get open receivables or payables by age (not due, 1–30, 31–60, 61–90, over 90 days) in total and per contact

GET/v1/reports/aging

Get open receivables or payables by age (not due, 1–30, 31–60, 61–90, over 90 days) in total and per contact

Nástroj MCP: get-aging-report

Parametry dotazu

kind"receivables" | "payables"výchozí "receivables"

asOfstringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

kindstringpovinné

asOfstringpovinnédate

bucketsobjectpovinné

not_dueintegerpovinné

d1_30integerpovinné

d31_60integerpovinné

d61_90integerpovinné

d90_plusintegerpovinné

totalHalerinteger | nullpovinné

dataobject[]povinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

totalHalerinteger | nullpovinné

not_dueintegerpovinné

d1_30integerpovinné

d31_60integerpovinné

d61_90integerpovinné

d90_plusintegerpovinné

retainedHalerinteger

retainedBucketsobject

not_dueintegerpovinné

d1_30integerpovinné

d31_60integerpovinné

d61_90integerpovinné

d90_plusintegerpovinné

retainedHalerinteger

GET/v1/reports/aging

curl https://api.damedoklad.cz/v1/reports/aging \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/aging', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/aging",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get money in, money out, and closing balance per month for a year

GET/v1/reports/cash-flow

Get money in, money out, and closing balance per month for a year

Nástroj MCP: get-cash-flow-report

Parametry dotazu

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Odpověď · 200

yearintegerpovinné

openingHalerintegerpovinné

dataobject[]povinné

monthnull | stringpovinné

inflowHalerintegerpovinné

outflowHalerintegerpovinné

closingHalerintegerpovinné

fromstringdate

tostringdate

GET/v1/reports/cash-flow

curl https://api.damedoklad.cz/v1/reports/cash-flow \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/cash-flow', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/cash-flow",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download a report or document list as XLSX or CSV

GET/v1/reports/export

Download a report or document list as XLSX or CSV

Nástroj MCP: export-report

Parametry dotazu

format"xlsx" | "csv"výchozí "xlsx"

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

Vrací soubor application/octet-stream.

GET/v1/reports/export

curl https://api.damedoklad.cz/v1/reports/export \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/reports/export', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const file = await response.arrayBuffer();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/export",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

Get monthly revenue, expense, and result for a year (accrual under double entry, cash under tax records)

GET/v1/reports/income-expense

Get monthly revenue, expense, and result for a year (accrual under double entry, cash under tax records)

Nástroj MCP: get-income-expense-report

Parametry dotazu

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

centerIdstring

ID of the center.

Odpověď · 200

yearintegerpovinné

dataobject[]povinné

monthnull | stringpovinné

revenueHalerintegerpovinné

expenseHalerintegerpovinné

resultHalerintegerpovinné

fromstringdate

tostringdate

GET/v1/reports/income-expense

curl https://api.damedoklad.cz/v1/reports/income-expense \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/income-expense', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/income-expense",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get how each customer pays (Platební kázeň): share paid on time, average and longest days late, and what is overdue now

GET/v1/reports/payment-discipline

Get how each customer pays (Platební kázeň): share paid on time, average and longest days late, and what is overdue now. For issued invoices, debit notes, and other receivables of the period, in CZK. Average late days are weighted by amount. A retention falls due on its own date. A set-off counts as paid on its date, an advance as on time.

Nástroj MCP: get-payment-discipline-report

Parametry dotazu

fromstringYYYY-MM-DD

Invoices issued from this day. Defaults to 1 January of the asOf year.

tostringYYYY-MM-DD

Invoices issued up to this day. Defaults to asOf.

asOfstringYYYY-MM-DD

What counts as overdue is read on this day. Defaults to today.

contactIdstring

ID of the contact. Find it with list-contacts.

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

Odpověď · 200

fromstringpovinnédate

tostringpovinnédate

asOfstringpovinnédate

dataobject[]povinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

documentsintegerpovinné

settledHalerintegerpovinné

lateHalerintegerpovinné

maxLateDaysintegerpovinné

openHalerintegerpovinné

overdueHalerintegerpovinné

overdueDaysintegerpovinné

averageLateDaysnumberpovinné

onTimePercentnull | numberpovinné

ratingstringpovinné

GET/v1/reports/payment-discipline

curl https://api.damedoklad.cz/v1/reports/payment-discipline \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/payment-discipline', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/payment-discipline",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Get the largest customers or suppliers by turnover excluding VAT for a year

GET/v1/reports/top-contacts

Get the largest customers or suppliers by turnover excluding VAT for a year

Nástroj MCP: get-top-contacts-report

Parametry dotazu

kind"customers" | "suppliers"výchozí "customers"

yearintegermin 2000max 2100

The year an accounting period starts in, so a hospodářský rok from July 2026 is 2026. Defaults to the current one.

periodIdstring

One accounting period exactly, for two starting in the same year. Takes precedence over year.

Odpověď · 200

kindstringpovinné

yearintegerpovinné

dataobject[]povinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

documentsintegerpovinné

netHalerintegerpovinné

totalHalerinteger | nullpovinné

hasMorebooleanpovinné

fromstringdate

tostringdate

GET/v1/reports/top-contacts

curl https://api.damedoklad.cz/v1/reports/top-contacts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/reports/top-contacts', {
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.damedoklad.cz/v1/reports/top-contacts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()