Settings

Operations in the Settings group.

Base URLhttps://api.damedoklad.cz/v1Authentication Errors and limits Conventions

GET/v1/settings/accounting
PUT/v1/settings/accounting

Get the accounting settings of a period: which series each document type uses by default

GET/v1/settings/accounting

Get the accounting settings of a period: which series each document type uses by default

MCP tool: get-accounting-settings

Query parameters

periodIdstring

Accounting period. Defaults to the current one.

Response · 200

periodIdstringrequired

periodNamestringrequired

defaultsobjectrequired

issued_invoiceobjectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

credit_notenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

proformanull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

delivery_notenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

received_invoicenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

GET/v1/settings/accounting

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

const response = await fetch('https://api.damedoklad.cz/v1/settings/accounting', {
  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/settings/accounting",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Replace the accounting settings of a period

PUT/v1/settings/accounting

Replace the accounting settings of a period

MCP tool: put-accounting-settings

Request body

periodIdstring

ID of the period. Find it with list-periods.

defaultsobjectrequired

issued_invoicestringrequired

credit_notestringrequired

proformastringrequired

delivery_notestringrequired

received_invoicestringrequired

Response · 200

periodIdstringrequired

periodNamestringrequired

defaultsobjectrequired

issued_invoiceobjectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

credit_notenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

proformanull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

delivery_notenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

received_invoicenull | objectrequired

seriesIdnull | stringrequired

namenull | stringrequired

prefixstringrequired

previewstringrequired

PUT/v1/settings/accounting

curl -X PUT https://api.damedoklad.cz/v1/settings/accounting \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "defaults": {
    "issued_invoice": "string",
    "credit_note": "string",
    "proforma": "string",
    "delivery_note": "string",
    "received_invoice": "string"
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/settings/accounting', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "defaults": {
      "issued_invoice": "string",
      "credit_note": "string",
      "proforma": "string",
      "delivery_note": "string",
      "received_invoice": "string"
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/settings/accounting",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "defaults": {
            "issued_invoice": "string",
            "credit_note": "string",
            "proforma": "string",
            "delivery_note": "string",
            "received_invoice": "string"
        }
    },
)
data = response.json()