Sklad

Operace ve skupině Sklad.

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

GET/v1/boms
POST/v1/boms
GET/v1/boms/{id}
PATCH/v1/boms/{id}
DEL/v1/boms/{id}
GET/v1/catalog-categories
POST/v1/catalog-categories
PATCH/v1/catalog-categories/{id}
DEL/v1/catalog-categories/{id}
GET/v1/catalog-parameters
POST/v1/catalog-parameters
PATCH/v1/catalog-parameters/{id}
DEL/v1/catalog-parameters/{id}
GET/v1/delivery-notes/uninvoiced
GET/v1/gpsr-records
POST/v1/gpsr-records
GET/v1/gpsr-records/{id}
PATCH/v1/gpsr-records/{id}
DEL/v1/gpsr-records/{id}
GET/v1/gpsr-records/{id}/certificates
POST/v1/gpsr-records/{id}/certificates
DEL/v1/gpsr-records/{id}/certificates/{certificateId}
GET/v1/gpsr-records/{id}/certificates/{certificateId}/file
GET/v1/gpsr-records/export.xml
GET/v1/inventory/margin-warnings
GET/v1/inventory/purchase-planning
POST/v1/inventory/purchase-planning/orders
GET/v1/inventory/reports/slow-movers
GET/v1/inventory/reports/stock-card
GET/v1/inventory/reports/turnover
GET/v1/inventory/reports/valuation
GET/v1/inventory/reports/value
GET/v1/inventory/settings
PATCH/v1/inventory/settings
GET/v1/inventory/year-end
POST/v1/inventory/year-end
GET/v1/item-groups
POST/v1/item-groups
PATCH/v1/item-groups/{id}
DEL/v1/item-groups/{id}
GET/v1/items
POST/v1/items
GET/v1/items/{id}
PATCH/v1/items/{id}
DEL/v1/items/{id}
GET/v1/items/{id}/catalog
PUT/v1/items/{id}/catalog
GET/v1/items/{id}/images
POST/v1/items/{id}/images
GET/v1/items/{id}/images/{imageId}
DEL/v1/items/{id}/images/{imageId}
GET/v1/items/{id}/kit
PUT/v1/items/{id}/kit
GET/v1/items/{id}/price
GET/v1/items/{id}/purchase-info
GET/v1/items/{id}/revaluation
POST/v1/items/{id}/revaluation
GET/v1/items/{id}/stock
GET/v1/items/{id}/units
PUT/v1/items/{id}/units
GET/v1/items/{id}/variants
POST/v1/items/{id}/variants
GET/v1/items/export
POST/v1/items/import
GET/v1/items/labels
GET/v1/items/lookup
POST/v1/items/product-data/assign
GET/v1/movements
POST/v1/movements
GET/v1/price-lists
POST/v1/price-lists
GET/v1/price-lists/{id}
PATCH/v1/price-lists/{id}
DEL/v1/price-lists/{id}
GET/v1/price-lists/{id}/export
POST/v1/price-lists/{id}/import
PUT/v1/price-lists/{id}/items
DEL/v1/price-lists/{id}/items/{rowId}
POST/v1/price-lists/{id}/rules
DEL/v1/price-lists/{id}/rules/{ruleId}
GET/v1/production-requests
POST/v1/production-requests
GET/v1/production-requests/{id}
PATCH/v1/production-requests/{id}
POST/v1/production-requests/{id}/cancel
PUT/v1/production-requests/{id}/components
POST/v1/production-requests/{id}/produce
POST/v1/production-requests/{id}/reserve
POST/v1/production-requests/{id}/unreserve
POST/v1/production-requests/from-order
POST/v1/production-requests/many
POST/v1/production-requests/produce-many
POST/v1/received-invoices/{id}/landed-cost
DEL/v1/received-invoices/{id}/landed-cost
GET/v1/received-invoices/{id}/stock-costs
GET/v1/recycling-fees
POST/v1/recycling-fees
GET/v1/recycling-fees/{id}
PATCH/v1/recycling-fees/{id}
DEL/v1/recycling-fees/{id}
GET/v1/recycling-fees/export.xml
GET/v1/recycling-fees/report
GET/v1/stock
GET/v1/stock-documents
POST/v1/stock-documents
GET/v1/stock-documents/{id}
PATCH/v1/stock-documents/{id}
DEL/v1/stock-documents/{id}
GET/v1/stock-documents/{id}/pdf
POST/v1/stock-documents/{id}/post
POST/v1/stock-documents/{id}/storno
GET/v1/stock-locations
POST/v1/stock-locations/transfer
GET/v1/stock-lots
PATCH/v1/stock-lots/{id}
GET/v1/stock-reservations
POST/v1/stock-reservations
POST/v1/stock-reservations/{id}/fulfil
POST/v1/stock-reservations/{id}/release
GET/v1/stock/availability
GET/v1/stock/summary
GET/v1/stocktakes
POST/v1/stocktakes
GET/v1/stocktakes/{id}
POST/v1/stocktakes/{id}/cancel
POST/v1/stocktakes/{id}/counts
POST/v1/stocktakes/{id}/import
POST/v1/stocktakes/{id}/post
GET/v1/supplier-prices
POST/v1/supplier-prices
PATCH/v1/supplier-prices/{id}
DEL/v1/supplier-prices/{id}
GET/v1/warehouse-locations
POST/v1/warehouse-locations
PATCH/v1/warehouse-locations/{id}
DEL/v1/warehouse-locations/{id}
GET/v1/warehouses
POST/v1/warehouses
GET/v1/warehouses/{id}
PATCH/v1/warehouses/{id}
DEL/v1/warehouses/{id}

Seznam: kusovník

GET/v1/boms

List bills of materials

Nástroj MCP: list-boms

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"bom"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

namestringpovinné

outputQuantityintegerpovinné

extraCostHalerintegerpovinné

isActivebooleanpovinné

notestring | nullpovinné

linesobject[]povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

unitnull | stringpovinné

quantityintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/boms

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

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

Vytvoření: kusovník

POST/v1/boms

Create a bill of materials: what one batch of a finished item consumes. extraCostHaler is labour and overhead per batch, added to the cost of the finished goods.

Nástroj MCP: create-bom

Tělo požadavku

itemIdstringpovinné

ID of the item. Find it with list-items.

namestringpovinnémax 200 chars

outputQuantitynumbermax 1000000000

extraCostHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

isActiveboolean

notestring | null

linesobject[]povinné

itemIdstringpovinné

ID of the item. Find it with list-items.

quantitynumberpovinnémax 1000000000

Odpověď · 201

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

namestringpovinné

outputQuantityintegerpovinné

extraCostHalerintegerpovinné

isActivebooleanpovinné

notestring | nullpovinné

linesobject[]povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

unitnull | stringpovinné

quantityintegerpovinné

POST/v1/boms

curl -X POST https://api.damedoklad.cz/v1/boms \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "name": "Pekárna U Lípy s.r.o.",
  "lines": [
    {
      "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/boms', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "name": "Pekárna U Lípy s.r.o.",
    "lines": [
      {
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/boms",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "name": "Pekárna U Lípy s.r.o.",
        "lines": [
            {
                "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Detail: kusovník

GET/v1/boms/{id}

Get a bill of materials with its components

Nástroj MCP: get-bom

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

namestringpovinné

outputQuantityintegerpovinné

extraCostHalerintegerpovinné

isActivebooleanpovinné

notestring | nullpovinné

linesobject[]povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

unitnull | stringpovinné

quantityintegerpovinné

GET/v1/boms/{id}

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

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

Úprava: kusovník

PATCH/v1/boms/{id}

Update a bill of materials. Production already posted keeps the quantities it used

Nástroj MCP: update-bom

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

outputQuantitynumbermax 1000000000

extraCostHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

isActiveboolean

notestring | null

linesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

quantitynumberpovinnémax 1000000000

Odpověď · 200

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

namestringpovinné

outputQuantityintegerpovinné

extraCostHalerintegerpovinné

isActivebooleanpovinné

notestring | nullpovinné

linesobject[]povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

unitnull | stringpovinné

quantityintegerpovinné

PATCH/v1/boms/{id}

curl -X PATCH https://api.damedoklad.cz/v1/boms/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "outputQuantity": 1,
  "extraCostHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/boms/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "outputQuantity": 1,
    "extraCostHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/boms/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "outputQuantity": 1,
        "extraCostHaler": 1210000
    },
)
data = response.json()

Smazání: kusovník

DELETE/v1/boms/{id}

Delete a bill of materials never used in production. A used one can only be deactivated

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

Nástroj MCP: delete-bom

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/boms/{id}

curl -X DELETE https://api.damedoklad.cz/v1/boms/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

The category tree for e-shops. An empty list for a company with no shop

GET/v1/catalog-categories

The category tree for e-shops. An empty list for a company with no shop

Nástroj MCP: list-catalog-categories

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"catalog_category"povinné

idstringpovinné

numberintegerpovinné

parentIdnull | stringpovinné

namestringpovinné

descriptionstring | nullpovinné

positionintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/catalog-categories

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

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

Add a category for e-shops, optionally under a parent

POST/v1/catalog-categories

Add a category for e-shops, optionally under a parent

Nástroj MCP: create-catalog-category

Tělo požadavku

namestringpovinnémax 160 chars

parentIdstring | null

ID of the parent.

descriptionstring | null

positionintegermin 0max 100000

Odpověď · 201

idstringpovinné

numberintegerpovinné

parentIdnull | stringpovinné

namestringpovinné

descriptionstring | nullpovinné

positionintegerpovinné

POST/v1/catalog-categories

curl -X POST https://api.damedoklad.cz/v1/catalog-categories \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/catalog-categories', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/catalog-categories",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Rename or move a category

PATCH/v1/catalog-categories/{id}

Rename or move a category

Nástroj MCP: update-catalog-category

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 160 chars

parentIdstring | null

ID of the parent.

descriptionstring | null

positionintegermin 0max 100000

Odpověď · 200

idstringpovinné

numberintegerpovinné

parentIdnull | stringpovinné

namestringpovinné

descriptionstring | nullpovinné

positionintegerpovinné

PATCH/v1/catalog-categories/{id}

curl -X PATCH https://api.damedoklad.cz/v1/catalog-categories/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "parentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "description": "Pečivo, říjen"
}'

const response = await fetch('https://api.damedoklad.cz/v1/catalog-categories/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "parentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "description": "Pečivo, říjen"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/catalog-categories/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "parentId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "description": "Pečivo, říjen"
    },
)
data = response.json()

Delete a category with no subcategories. Items keep their other categories

DELETE/v1/catalog-categories/{id}

Delete a category with no subcategories. Items keep their other categories

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

Nástroj MCP: delete-catalog-category

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/catalog-categories/{id}

curl -X DELETE https://api.damedoklad.cz/v1/catalog-categories/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Attributes an item can have in an e-shop, such as colour or size

GET/v1/catalog-parameters

Attributes an item can have in an e-shop, such as colour or size

Nástroj MCP: list-catalog-parameters

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"catalog_parameter"povinné

idstringpovinné

numberintegerpovinné

namestringpovinné

typestringpovinné

unitnull | stringpovinné

optionsstring[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/catalog-parameters

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

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

Add an attribute for e-shops. Types follow POHODA: text, number, date, yes or no, list, unit, currency

POST/v1/catalog-parameters

Add an attribute for e-shops. Types follow POHODA: text, number, date, yes or no, list, unit, currency

Nástroj MCP: create-catalog-parameter

Tělo požadavku

namestringpovinnémax 120 chars

unitstring | null

optionsstring[]

Odpověď · 201

idstringpovinné

numberintegerpovinné

namestringpovinné

typestringpovinné

unitnull | stringpovinné

optionsstring[]povinné

POST/v1/catalog-parameters

curl -X POST https://api.damedoklad.cz/v1/catalog-parameters \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/catalog-parameters', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/catalog-parameters",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Change an attribute for e-shops

PATCH/v1/catalog-parameters/{id}

Change an attribute for e-shops

Nástroj MCP: update-catalog-parameter

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

unitstring | null

optionsstring[]

Odpověď · 200

idstringpovinné

numberintegerpovinné

namestringpovinné

typestringpovinné

unitnull | stringpovinné

optionsstring[]povinné

PATCH/v1/catalog-parameters/{id}

curl -X PATCH https://api.damedoklad.cz/v1/catalog-parameters/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "type": "text",
  "unit": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/catalog-parameters/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "type": "text",
    "unit": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/catalog-parameters/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "type": "text",
        "unit": "string"
    },
)
data = response.json()

Delete an attribute for e-shops and its values on items

DELETE/v1/catalog-parameters/{id}

Delete an attribute for e-shops and its values on items

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

Nástroj MCP: delete-catalog-parameter

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/catalog-parameters/{id}

curl -X DELETE https://api.damedoklad.cz/v1/catalog-parameters/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

A customer's issued delivery notes with what is not invoiced yet, optionally for given items. Name them on issue-invoice in deliveryNoteIds so the goods do not leave twice

GET/v1/delivery-notes/uninvoiced

A customer's issued delivery notes with what is not invoiced yet, optionally for given items. Name them on issue-invoice in deliveryNoteIds so the goods do not leave twice

Nástroj MCP: list-uninvoiced-delivery-notes

Parametry dotazu

contactIdstringpovinné

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

itemIdsstringmax 2000 chars

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"uninvoiced_delivery_note"povinné

deliveryNoteIdnull | stringpovinné

numbernull | stringpovinné

deliveryDatestringpovinnédate

itemsobject[]povinné

itemIdnull | stringpovinné

namenull | stringpovinné

unitnull | stringpovinné

quantityintegerpovinné

lineIdstringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/delivery-notes/uninvoiced

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

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

List GpsrRecords

GET/v1/gpsr-records

List GpsrRecords

Nástroj MCP: list-gpsr-records

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"gpsr_record"povinné

idstringpovinné

codestringpovinné

namestringpovinné

manufacturerNamenull | stringpovinné

manufacturerAddressnull | stringpovinné

manufacturerEmailnull | stringpovinné

manufacturerWebnull | stringpovinné

euRepresentativeNamenull | stringpovinné

euRepresentativeAddressnull | stringpovinné

euRepresentativeEmailnull | stringpovinné

safetyInfonull | stringpovinné

isActivebooleanpovinné

notenull | string

attachmentsobject[]

kindstringpovinné

namestringpovinné

urlstring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/gpsr-records

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

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

Create a GpsrRecord

POST/v1/gpsr-records

Create a GpsrRecord

Nástroj MCP: create-gpsr-record

Tělo požadavku

codestringpovinnémax 32 chars

namestringpovinnémax 200 chars

manufacturerNamestring | null

manufacturerAddressstring | null

manufacturerEmailstring | null | ""

manufacturerWebstring | null

euRepresentativeNamestring | null

euRepresentativeAddressstring | null

euRepresentativeEmailstring | null | ""

safetyInfostring | null

notestring | null

isActiveboolean

Odpověď · 201

idstringpovinné

codestringpovinné

namestringpovinné

manufacturerNamenull | stringpovinné

manufacturerAddressnull | stringpovinné

manufacturerEmailnull | stringpovinné

manufacturerWebnull | stringpovinné

euRepresentativeNamenull | stringpovinné

euRepresentativeAddressnull | stringpovinné

euRepresentativeEmailnull | stringpovinné

safetyInfonull | stringpovinné

isActivebooleanpovinné

notenull | string

attachmentsobject[]

kindstringpovinné

namestringpovinné

urlstring

POST/v1/gpsr-records

curl -X POST https://api.damedoklad.cz/v1/gpsr-records \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "name": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/gpsr-records', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "string",
    "name": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/gpsr-records",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "code": "string",
        "name": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Get a GpsrRecord

GET/v1/gpsr-records/{id}

Get a GpsrRecord

Nástroj MCP: get-gpsr-record

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

codestringpovinné

namestringpovinné

manufacturerNamenull | stringpovinné

manufacturerAddressnull | stringpovinné

manufacturerEmailnull | stringpovinné

manufacturerWebnull | stringpovinné

euRepresentativeNamenull | stringpovinné

euRepresentativeAddressnull | stringpovinné

euRepresentativeEmailnull | stringpovinné

safetyInfonull | stringpovinné

isActivebooleanpovinné

notenull | string

attachmentsobject[]

kindstringpovinné

namestringpovinné

urlstring

GET/v1/gpsr-records/{id}

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

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

Update a GpsrRecord

PATCH/v1/gpsr-records/{id}

Update a GpsrRecord

Nástroj MCP: update-gpsr-record

Parametry v cestě

idstringpovinné

Tělo požadavku

codestringmax 32 chars

namestringmax 200 chars

manufacturerNamestring | null

manufacturerAddressstring | null

manufacturerEmailstring | null | ""

manufacturerWebstring | null

euRepresentativeNamestring | null

euRepresentativeAddressstring | null

euRepresentativeEmailstring | null | ""

safetyInfostring | null

notestring | null

isActiveboolean

Odpověď · 200

idstringpovinné

codestringpovinné

namestringpovinné

manufacturerNamenull | stringpovinné

manufacturerAddressnull | stringpovinné

manufacturerEmailnull | stringpovinné

manufacturerWebnull | stringpovinné

euRepresentativeNamenull | stringpovinné

euRepresentativeAddressnull | stringpovinné

euRepresentativeEmailnull | stringpovinné

safetyInfonull | stringpovinné

isActivebooleanpovinné

notenull | string

attachmentsobject[]

kindstringpovinné

namestringpovinné

urlstring

PATCH/v1/gpsr-records/{id}

curl -X PATCH https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "manufacturerName": "Pekárna U Lípy s.r.o."
}'

const response = await fetch('https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "manufacturerName": "Pekárna U Lípy s.r.o."
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "code": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "manufacturerName": "Pekárna U Lípy s.r.o."
    },
)
data = response.json()

Delete a GpsrRecord

DELETE/v1/gpsr-records/{id}

Delete a GpsrRecord

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

Nástroj MCP: delete-gpsr-record

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/gpsr-records/{id}

curl -X DELETE https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Certificates and declarations kept on a GPSR record

GET/v1/gpsr-records/{id}/certificates

Certificates and declarations kept on a GPSR record

Nástroj MCP: list-gpsr-certificates

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"gpsr_certificate"povinné

idstringpovinné

gpsrIdstringpovinné

namestringpovinné

issuedOnnull | stringpovinnédate

validUntilnull | stringpovinnédate

notenull | stringpovinné

contentTypestringpovinné

byteSizeinteger | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/gpsr-records/{id}/certificates

curl https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Keep a certificate or declaration on a GPSR record: PDF, PNG or JPEG, up to 10 MB. The dates are for your own overview

POST/v1/gpsr-records/{id}/certificates

Keep a certificate or declaration on a GPSR record: PDF, PNG or JPEG, up to 10 MB. The dates are for your own overview

Nástroj MCP: upload-gpsr-certificate

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringpovinnémax 200 chars

fileBase64stringpovinnémax 14000000 chars

File content encoded as base64.

contentType"application/pdf" | "image/png" | "image/jpeg"povinné

issuedOnstring | null

Date as YYYY-MM-DD.

validUntilstring | null

notestring | null

Odpověď · 201

idstringpovinné

gpsrIdstringpovinné

namestringpovinné

issuedOnnull | stringpovinnédate

validUntilnull | stringpovinnédate

notenull | stringpovinné

contentTypestringpovinné

byteSizeinteger | nullpovinné

POST/v1/gpsr-records/{id}/certificates

curl -X POST https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "fileBase64": "string",
  "contentType": "application/pdf"
}'

const response = await fetch('https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "fileBase64": "string",
    "contentType": "application/pdf"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "fileBase64": "string",
        "contentType": "application/pdf"
    },
)
data = response.json()

Remove a certificate from a GPSR record and delete its file

DELETE/v1/gpsr-records/{id}/certificates/{certificateId}

Remove a certificate from a GPSR record and delete its file

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

Nástroj MCP: delete-gpsr-certificate

Parametry v cestě

idstringpovinné

certificateIdstringpovinné

ID of the certificate.

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/gpsr-records/{id}/certificates/{certificateId}

curl -X DELETE https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Download a certificate kept on a GPSR record

GET/v1/gpsr-records/{id}/certificates/{certificateId}/file

Download a certificate kept on a GPSR record

Nástroj MCP: get-gpsr-certificate-file

Parametry v cestě

idstringpovinné

certificateIdstringpovinné

ID of the certificate.

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/gpsr-records/{id}/certificates/{certificateId}/file

curl https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

const response = await fetch('https://api.damedoklad.cz/v1/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file', {
  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/gpsr-records/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/certificates/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/file",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
content = response.content

All GPSR records as a POHODA XML file (GPSR.xsd, version 2.0), with the names of their certificates, to load into POHODA

GET/v1/gpsr-records/export.xml

All GPSR records as a POHODA XML file (GPSR.xsd, version 2.0), with the names of their certificates, to load into POHODA

Nástroj MCP: export-gpsr-records-xml

Odpověď · 200

Vrací soubor application/xml.

GET/v1/gpsr-records/export.xml

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

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

Items selling below their cost or below the minimum margin set in inventory settings, worst first

GET/v1/inventory/margin-warnings

Items selling below their cost or below the minimum margin set in inventory settings, worst first

Nástroj MCP: list-margin-warnings

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

salePriceHalerintegerpovinné

costHalerintegerpovinné

marginHalerintegerpovinné

marginPercentintegerpovinné

warningstringpovinné

lastPurchaseOnstringpovinnédate

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/inventory/margin-warnings

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

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

Reorder suggestions from minimum and maximum stock and sales velocity, with supplier, price, and quantity

GET/v1/inventory/purchase-planning

Reorder suggestions from minimum and maximum stock and sales velocity, with supplier, price, and quantity. Projected stock = on hand − reserved + on order. Reorder point = minimum + sales during the lead time. Below it, the suggestion goes up to the maximum, or to the reorder point plus the cover period, rounded up to packs and the supplier minimum.

Nástroj MCP: get-purchase-planning

Parametry dotazu

supplierIdstring

ID of the supplier.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

periodDaysintegermin 7max 730

leadDaysintegermin 0max 365

coverDaysintegermin 0max 365

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

datestringpovinnédate

periodDaysintegerpovinné

leadDaysinteger | nullpovinné

coverDaysintegerpovinné

rowsobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

supplierIdstringpovinné

supplierNamestringpovinné

supplierSkustring | nullpovinné

onHandintegerpovinné

reservedintegerpovinné

onOrderintegerpovinné

minStockintegerpovinné

maxStockinteger | nullpovinné

soldInPeriodintegerpovinné

soldPerDayintegerpovinné

leadDaysinteger | nullpovinné

projectedintegerpovinné

reorderPointintegerpovinné

targetintegerpovinné

neededintegerpovinné

quantityintegerpovinné

unitPriceHalerinteger | nullpovinné

currencynull | stringpovinné

priceSourcestringpovinné

lineValueHalerintegerpovinné

lastPurchasenull | objectpovinné

datestringpovinnédate

documentNumbernull | stringpovinné

supplierIdanypovinné

Null in every recorded response.

supplierNameanypovinné

Null in every recorded response.

unitPriceHalerinteger | nullpovinné

landedUnitCostHalerintegerpovinné

marginWarninganypovinné

Null in every recorded response.

marginPercentinteger | nullpovinné

GET/v1/inventory/purchase-planning

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

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

Turn reorder lines into one issued order per supplier, in one call

POST/v1/inventory/purchase-planning/orders

Turn reorder lines into one issued order per supplier, in one call. Prices default to the supplier price list, then the last purchase, then the item. Set issue to false to get drafts. Sending the order to the supplier is a separate step.

Nástroj MCP: create-purchase-orders

Tělo požadavku

linesobject[]povinné

itemIdstringpovinné

ID of the item. Find it with list-items.

quantitynumberpovinnémax 1000000000

supplierIdstring

ID of the supplier.

unitPriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

issueboolean

Odpověď · 201

dataobject[]povinné

object"sales_document"povinné

idstringpovinné

kindstringpovinné

numbernull | stringpovinné

statusstringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

issueDatestringpovinnédate

dueDatenull | stringpovinnédate

validUntilnull | stringpovinnédate

currencystringpovinné

totalHalerintegerpovinné

paidHalerintegerpovinné

overduebooleanpovinné

reservationStatusstringpovinné

externalNumbernull | stringpovinné

fileIdnull | stringpovinné

customFieldsobject

kanalstring

seriesIdnull | string

variableSymbolnull | string

constantSymbolnull | string

contactIconull | string

contactDicnull | string

contactEmailnull | string

billToStreetnull | string

billToCitynull | string

billToPostalCodenull | string

billToCountrynull | string

taxPointDatenull | stringdate

exchangeRateinteger

vatModestring

templateIdstring | null

centerIdstring | null

activityIdstring | null

projectIdstring | null

paymentMethodstring

languagestring

notePublicnull | string

noteInternalnull | string

reasonnull | string

sourceKindnull | string

sourceIdnull | string

originalKindnull | string

originalIdnull | string

originalNumbernull | string

consumedByIdstring | null

stornoOfIdnull | string

netHalerinteger

vatHalerinteger

roundingHalerinteger

receivedHalerinteger | null

registerIdnull | string

closureIdstring | null

changeHalerinteger | null

linesobject[]

object"sales_document_line"povinné

idstringpovinné

descriptionstringpovinné

quantityintegerpovinné

unitstringpovinné

unitPriceHalerintegerpovinné

vatRateintegerpovinné

netHalerintegerpovinné

vatHalerintegerpovinné

totalHalerintegerpovinné

accountNumbernull | stringpovinné

itemIdnull | stringpovinné

warehouseIdnull | stringpovinné

fulfilledQuantitynumberpovinné

invoicedQuantityintegerpovinné

reservedQuantityintegerpovinné

returnedQuantityintegerpovinné

originalLineIdnull | stringpovinné

lotsobject[]povinné

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

orderLineIdstring | nullpovinné

recyclingnull | object

textstringpovinné

unitstringpovinné

feeIdstringpovinné

rateHalerintegerpovinné

totalHalerintegerpovinné

weightMilliintegerpovinné

perUnitHalerintegerpovinné

coefficientMilliintegerpovinné

paymentsobject[]

object"sales_document_payment"povinné

idstringpovinné

amountHalerintegerpovinné

paidOnstringpovinnédate

methodstringpovinné

notenull | stringpovinné

linksobject[]

object"document_link"povinné

idstringpovinné

fromKindstringpovinné

fromIdstringpovinné

toKindstringpovinné

toIdstringpovinné

kindstringpovinné

amountHalerinteger | null

carrierIdnull | string

bankMovementobject

idstringpovinné

bankAccountIdstringpovinné

POST/v1/inventory/purchase-planning/orders

curl -X POST https://api.damedoklad.cz/v1/inventory/purchase-planning/orders \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "lines": [
    {
      "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/inventory/purchase-planning/orders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "lines": [
      {
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/inventory/purchase-planning/orders",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "lines": [
            {
                "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Items in stock with no issue for at least a number of days, largest tied-up value first

GET/v1/inventory/reports/slow-movers

Items in stock with no issue for at least a number of days, largest tied-up value first

Nástroj MCP: get-slow-movers-report

Parametry dotazu

daysintegermin 1max 3650

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

Odpověď · 200

datestringpovinnédate

daysintegerpovinné

totalValueHalerintegerpovinné

rowsobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

quantityintegerpovinné

valueHalerinteger | nullpovinné

lastIssueOnnull | stringpovinnédate

idleDaysintegerpovinné

GET/v1/inventory/reports/slow-movers

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

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

Stock card of an item: every movement over a period with running quantity and value

GET/v1/inventory/reports/stock-card

Stock card of an item: every movement over a period with running quantity and value

Nástroj MCP: get-stock-card

Parametry dotazu

itemIdstringpovinné

ID of the item. Find it with list-items.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

valuationstringpovinné

warehouseIdstring | nullpovinné

fromstringpovinnédate

tostringpovinnédate

openingobjectpovinné

quantityintegerpovinné

valueHalerinteger | nullpovinné

receivedintegerpovinné

issuedintegerpovinné

closingobjectpovinné

quantityintegerpovinné

valueHalerinteger | nullpovinné

rowsobject[]povinné

idstringpovinné

datestringpovinnédate

typestringpovinné

reasonnull | stringpovinné

documentIdnull | stringpovinné

documentTypenull | stringpovinné

documentNumbernull | stringpovinné

contactNamestring | nullpovinné

warehouseIdnull | stringpovinné

warehouseNamestringpovinné

isReversalbooleanpovinné

receivedintegerpovinné

issuedintegerpovinné

movedanypovinné

Null in every recorded response.

valueDeltaHalerintegerpovinné

unitCostHalerinteger | nullpovinné

balanceintegerpovinné

balanceValueHalerintegerpovinné

notestring | nullpovinné

GET/v1/inventory/reports/stock-card

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

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

Stock turnover per item over a period: receipts, issues at cost, average stock, turnover ratio and days

GET/v1/inventory/reports/turnover

Stock turnover per item over a period: receipts, issues at cost, average stock, turnover ratio and days

Nástroj MCP: get-stock-turnover-report

Parametry dotazu

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

Odpověď · 200

fromstringpovinnédate

tostringpovinnédate

daysintegerpovinné

rowsobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

openingValueHalerintegerpovinné

receivedQuantityintegerpovinné

receivedValueHalerintegerpovinné

issuedQuantityintegerpovinné

issuedValueHalerintegerpovinné

closingValueHalerintegerpovinné

averageValueHalerintegerpovinné

rationull | numberpovinné

daysinteger | nullpovinné

GET/v1/inventory/reports/turnover

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

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

Inventory value by account on a date, against the ledger balance of 112, 123, and 132, for reconciliation

GET/v1/inventory/reports/valuation

Inventory value by account on a date, against the ledger balance of 112, 123, and 132, for reconciliation. Under accounting method B the accounts only move at year end, so differences during the year are expected. Daňová evidence has no ledger to compare with.

Nástroj MCP: get-stock-valuation

Parametry dotazu

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 200

datestringpovinnédate

modestringpovinné

totalStockValueHalerintegerpovinné

totalLedgerValueHalerinteger | nullpovinné

totalDifferenceHalerinteger | nullpovinné

rowsobject[]povinné

accountNumbernull | stringpovinné

syntheticstringpovinné

stockValueHalerintegerpovinné

ledgerValueHalerinteger | nullpovinné

itemsobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

warehouseIdnull | stringpovinné

warehouseNamestringpovinné

quantityintegerpovinné

valueHalerinteger | nullpovinné

differenceHalerinteger | nullpovinné

GET/v1/inventory/reports/valuation

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

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

Stock quantity and value per item on a given date, from the movement ledger

GET/v1/inventory/reports/value

Stock quantity and value per item on a given date, from the movement ledger

Nástroj MCP: get-stock-value-report

Parametry dotazu

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

Odpověď · 200

datestringpovinnédate

totalValueHalerintegerpovinné

rowsobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

typestringpovinné

quantityintegerpovinné

averageCostHalerintegerpovinné

valueHalerinteger | nullpovinné

GET/v1/inventory/reports/value

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

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

Detail: nastavení, sklad

GET/v1/inventory/settings

Stock accounting method (A or B), negative stock policy, which advanced options are on, and document number series

Nástroj MCP: get-inventory-settings

Odpověď · 200

regimestringpovinné

accountingMethodstringpovinné

allowNegativeStockbooleanpovinné

featuresobjectpovinné

purchasingbooleanpovinné

landedCostsbooleanpovinné

variantsbooleanpovinné

unitsbooleanpovinné

kitsbooleanpovinné

imagesbooleanpovinné

locationsbooleanpovinné

registersbooleanpovinné

minMarginPercentnumberpovinné

planningobjectpovinné

periodDaysintegerpovinné

leadDaysinteger | nullpovinné

coverDaysintegerpovinné

seriesobject[]povinné

documentTypenull | stringpovinné

prefixstringpovinné

padintegerpovinné

GET/v1/inventory/settings

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

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

Úprava: nastavení, sklad

PATCH/v1/inventory/settings

Change the stock accounting method, negative stock policy, advanced options, or number series prefixes. The accounting method can only change while the current year has no stock movements.

Nástroj MCP: update-inventory-settings

Tělo požadavku

accountingMethod"A" | "B"

allowNegativeStockboolean

featuresobject

purchasingboolean

landedCostsboolean

variantsboolean

unitsboolean

kitsboolean

imagesboolean

locationsboolean

registersboolean

minMarginPercentnumbermin 0max 100

planningobject

periodDaysintegermin 7max 730

leadDaysintegermin 0max 365

coverDaysintegermin 0max 365

seriesobject[]

documentType"receipt" | "issue" | "transfer" | "production" | "stocktake"povinné

prefixstringpovinné

padintegermin 3max 6

Odpověď · 200

regimestringpovinné

accountingMethodstringpovinné

allowNegativeStockbooleanpovinné

featuresobjectpovinné

purchasingbooleanpovinné

landedCostsbooleanpovinné

variantsbooleanpovinné

unitsbooleanpovinné

kitsbooleanpovinné

imagesbooleanpovinné

locationsbooleanpovinné

registersbooleanpovinné

minMarginPercentnumberpovinné

planningobjectpovinné

periodDaysintegerpovinné

leadDaysinteger | nullpovinné

coverDaysintegerpovinné

seriesobject[]povinné

documentTypenull | stringpovinné

prefixstringpovinné

padintegerpovinné

PATCH/v1/inventory/settings

curl -X PATCH https://api.damedoklad.cz/v1/inventory/settings \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "accountingMethod": "A",
  "allowNegativeStock": false,
  "features": {
    "purchasing": false,
    "landedCosts": false,
    "variants": false
  }
}'

const response = await fetch('https://api.damedoklad.cz/v1/inventory/settings', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "accountingMethod": "A",
    "allowNegativeStock": false,
    "features": {
      "purchasing": false,
      "landedCosts": false,
      "variants": false
    }
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/inventory/settings",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "accountingMethod": "A",
        "allowNegativeStock": False,
        "features": {
            "purchasing": False,
            "landedCosts": False,
            "variants": False
        }
    },
)
data = response.json()

Opening and closing stock value of a year, and the entry it needs under accounting method B

GET/v1/inventory/year-end

Opening and closing stock value of a year, and the entry it needs under accounting method B. In daňová evidence this is the year-end inventory value to record; nothing is posted during the year.

Nástroj MCP: get-stock-year-end

Parametry dotazu

yearintegerpovinnémin 2000max 2100

Odpověď · 200

yearintegerpovinné

canPostboolean

modestring

openingValueHalerintegerpovinné

closingValueHalerintegerpovinné

positionsobject[]

categorynull | stringpovinné

analyticanypovinné

Null in every recorded response.

openingValueHalerintegerpovinné

closingValueHalerintegerpovinné

linesobject[]

debitHalerintegerpovinné

creditHalerintegerpovinné

accountNumbernull | stringpovinné

postedany

Null in every recorded response.

journalEntryIdnull | string

GET/v1/inventory/year-end

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

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

Post the year-end stock change under accounting method B: opening to expense, closing back to stock

POST/v1/inventory/year-end

Post the year-end stock change under accounting method B: opening to expense, closing back to stock. Refused for method A and outside double-entry. Once posted, repost reverses the old entry and writes a new one.

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

Nástroj MCP: post-stock-year-end

Tělo požadavku

yearintegerpovinnémin 2000max 2100

repostboolean

Odpověď · 200

yearintegerpovinné

canPostboolean

modestring

openingValueHalerintegerpovinné

closingValueHalerintegerpovinné

positionsobject[]

categorynull | stringpovinné

analyticanypovinné

Null in every recorded response.

openingValueHalerintegerpovinné

closingValueHalerintegerpovinné

linesobject[]

debitHalerintegerpovinné

creditHalerintegerpovinné

accountNumbernull | stringpovinné

postedany

Null in every recorded response.

journalEntryIdnull | string

POST/v1/inventory/year-end

curl -X POST https://api.damedoklad.cz/v1/inventory/year-end \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "year": 2026
}'

const response = await fetch('https://api.damedoklad.cz/v1/inventory/year-end', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "year": 2026
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/inventory/year-end",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "year": 2026
    },
)
data = response.json()

Seznam: skupiny, zásoba

GET/v1/item-groups

List item groups

Nástroj MCP: list-item-groups

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"item_group"povinné

idstringpovinné

namestringpovinné

codestringpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/item-groups

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

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

Vytvoření: skupina, zásoba

POST/v1/item-groups

Create an item group

Nástroj MCP: create-item-group

Tělo požadavku

namestringpovinnémax 200 chars

codestringpovinnémax 64 chars

Odpověď · 201

idstringpovinné

namestringpovinné

codestringpovinné

POST/v1/item-groups

curl -X POST https://api.damedoklad.cz/v1/item-groups \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/item-groups', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/item-groups",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string"
    },
)
data = response.json()

Úprava: skupina, zásoba

PATCH/v1/item-groups/{id}

Rename an item group

Nástroj MCP: update-item-group

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

codestringmax 64 chars

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

PATCH/v1/item-groups/{id}

curl -X PATCH https://api.damedoklad.cz/v1/item-groups/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/item-groups/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/item-groups/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string"
    },
)
data = response.json()

Smazání: skupina, zásoba

DELETE/v1/item-groups/{id}

Delete an empty item group

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

Nástroj MCP: delete-item-group

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/item-groups/{id}

curl -X DELETE https://api.damedoklad.cz/v1/item-groups/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Seznam: zásoby

GET/v1/items

List stock items and services with their prices

Nástroj MCP: list-items

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

type"goods" | "material" | "product" | "service"

groupIdstring

ID of the group.

active"true" | "false"

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"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/items

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

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

Vytvoření: zásoba

POST/v1/items

Create a stock item or service

Nástroj MCP: create-item

Tělo požadavku

skustringpovinnémax 64 chars

namestringpovinnémax 160 chars

eanstring | null

groupIdstring | null

ID of the group.

unitstringmax 16 chars

vatRate0 | 10 | 12 | 15 | 21

type"goods" | "material" | "product" | "service"povinné

purchasePriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

salePriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

supplierIdstring | null

ID of the supplier.

minStocknumber | null

maxStocknumber | null

valuation"fifo" | "weighted_average"

tracking"none" | "serial" | "lot"

tracksExpiryboolean

allowNegativeboolean | null

isActiveboolean

notestring | null

weightKgnumber | null

gpsrIdstring | null

ID of the gpsr.

recyclingFeeIdstring | null

ID of the recycling fee. Find it with list-recycling-fees.

recyclingCoefficientnumber | null

portableBatteryboolean

attributesobject

Odpověď · 201

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

POST/v1/items

curl -X POST https://api.damedoklad.cz/v1/items \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sku": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "type": "goods"
}'

const response = await fetch('https://api.damedoklad.cz/v1/items', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "sku": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "type": "goods"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/items",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "sku": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "type": "goods"
    },
)
data = response.json()

Detail: zásoba

GET/v1/items/{id}

Get one item

Nástroj MCP: get-item

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

GET/v1/items/{id}

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

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

Úprava: zásoba

PATCH/v1/items/{id}

Update an item. Valuation and tracking can only change while it holds no stock

Nástroj MCP: update-item

Parametry v cestě

idstringpovinné

Tělo požadavku

skustringmax 64 chars

namestringmax 160 chars

eanstring | null

groupIdstring | null

ID of the group.

unitstringmax 16 chars

vatRate0 | 10 | 12 | 15 | 21

type"goods" | "material" | "product" | "service"

purchasePriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

salePriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

supplierIdstring | null

ID of the supplier.

minStocknumber | null

maxStocknumber | null

valuation"fifo" | "weighted_average"

tracking"none" | "serial" | "lot"

tracksExpiryboolean

allowNegativeboolean | null

isActiveboolean

notestring | null

weightKgnumber | null

gpsrIdstring | null

ID of the gpsr.

recyclingFeeIdstring | null

ID of the recycling fee. Find it with list-recycling-fees.

recyclingCoefficientnumber | null

portableBatteryboolean

attributesobject

Odpověď · 200

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

PATCH/v1/items/{id}

curl -X PATCH https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sku": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "ean": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "sku": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "ean": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "sku": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "ean": "string"
    },
)
data = response.json()

Smazání: zásoba

DELETE/v1/items/{id}

Delete an item that was never used. Used items can only be deactivated

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

Nástroj MCP: delete-item

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/items/{id}

curl -X DELETE https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

What an item shows in e-shops: categories, attributes, descriptions, and the shops it is sold in

GET/v1/items/{id}/catalog

What an item shows in e-shops: categories, attributes, descriptions, and the shops it is sold in

Nástroj MCP: get-item-catalog

Parametry v cestě

idstringpovinné

Odpověď · 200

itemIdnull | stringpovinné

listedbooleanpovinné

shortDescriptionnull | stringpovinné

descriptionnull | stringpovinné

categoryIdsstring[]povinné

parametersobjectpovinné

shopIdsstring[]povinné

GET/v1/items/{id}/catalog

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

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

Set what an item shows in e-shops. Stock goes out only for an item listed in that shop

PUT/v1/items/{id}/catalog

Set what an item shows in e-shops. Stock goes out only for an item listed in that shop

Nástroj MCP: put-item-catalog

Parametry v cestě

idstringpovinné

Tělo požadavku

listedboolean

shortDescriptionstring | null

descriptionstring | null

categoryIdsstring[]

parametersobject

Values by parameter ID

shopIdsstring[]

The shops this item is sold in. Stock goes only to these

Odpověď · 200

itemIdnull | stringpovinné

listedbooleanpovinné

shortDescriptionnull | stringpovinné

descriptionnull | stringpovinné

categoryIdsstring[]povinné

parametersobjectpovinné

shopIdsstring[]povinné

PUT/v1/items/{id}/catalog

curl -X PUT https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/catalog \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "listed": false,
  "shortDescription": "Pečivo, říjen",
  "description": "Pečivo, říjen"
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/catalog', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "listed": false,
    "shortDescription": "Pečivo, říjen",
    "description": "Pečivo, říjen"
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/catalog",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "listed": False,
        "shortDescription": "Pečivo, říjen",
        "description": "Pečivo, říjen"
    },
)
data = response.json()

List the images of an item

GET/v1/items/{id}/images

List the images of an item

Nástroj MCP: list-item-images

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"item_image"povinné

idstringpovinné

itemIdstringpovinné

positionintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/items/{id}/images

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

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

Upload an image of an item (PNG, JPEG, or WebP, up to 2 MB)

POST/v1/items/{id}/images

Upload an image of an item (PNG, JPEG, or WebP, up to 2 MB)

Nástroj MCP: upload-item-image

Parametry v cestě

idstringpovinné

Tělo požadavku

fileBase64stringpovinnémax 4000000 chars

File content encoded as base64.

contentType"image/png" | "image/jpeg" | "image/webp"povinné

Odpověď · 201

idstringpovinné

itemIdstringpovinné

positionintegerpovinné

POST/v1/items/{id}/images

curl -X POST https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/images \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string",
  "contentType": "image/png"
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/images', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string",
    "contentType": "image/png"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/images",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string",
        "contentType": "image/png"
    },
)
data = response.json()

Download an image of an item

GET/v1/items/{id}/images/{imageId}

Download an image of an item

Nástroj MCP: get-item-image

Parametry v cestě

idstringpovinné

imageIdstringpovinné

ID of the image.

Odpověď · 200

Vrací soubor image/png.

GET/v1/items/{id}/images/{imageId}

curl https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/images/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

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

Remove an image from an item

DELETE/v1/items/{id}/images/{imageId}

Remove an image from an item

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

Nástroj MCP: delete-item-image

Parametry v cestě

idstringpovinné

imageIdstringpovinné

ID of the image.

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/items/{id}/images/{imageId}

curl -X DELETE https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/images/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Components of a kit and how many whole sets the free stock makes

GET/v1/items/{id}/kit

Components of a kit and how many whole sets the free stock makes

Nástroj MCP: get-item-kit

Parametry v cestě

idstringpovinné

Odpověď · 200

itemIdnull | stringpovinné

isKitbooleanpovinné

availableSetsinteger | nullpovinné

componentCostHalerintegerpovinné

componentsarray | nullpovinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstringpovinné

quantityintegerpovinné

GET/v1/items/{id}/kit

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

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

Make the item a kit sold as a bundle: selling it moves its components. An empty list makes it an ordinary item again

PUT/v1/items/{id}/kit

Make the item a kit sold as a bundle: selling it moves its components. An empty list makes it an ordinary item again. A kit has no stock of its own. A sale of a kit moves its components: lots are taken by what expires first, and a serial-tracked component must be named on the document line, as a lot entry with its itemId.

Nástroj MCP: put-item-kit

Parametry v cestě

idstringpovinné

Tělo požadavku

componentsobject[]povinné

itemIdstringpovinné

ID of the item. Find it with list-items.

quantitynumberpovinnémax 1000000000

Odpověď · 200

itemIdnull | stringpovinné

isKitbooleanpovinné

availableSetsinteger | nullpovinné

componentCostHalerintegerpovinné

componentsarray | nullpovinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstringpovinné

quantityintegerpovinné

PUT/v1/items/{id}/kit

curl -X PUT https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/kit \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "components": [
    {
      "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/kit', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "components": [
      {
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/kit",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "components": [
            {
                "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Sale price of an item for a customer, date, and quantity, after price lists and discounts

GET/v1/items/{id}/price

Sale price of an item for a customer, date, and quantity, after price lists and discounts

Nástroj MCP: get-item-price

Parametry v cestě

idstringpovinné

Parametry dotazu

contactIdstring

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

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

quantitynumber

Odpověď · 200

itemIdnull | stringpovinné

vatRateintegerpovinné

grossPriceHalerintegerpovinné

priceHalerintegerpovinné

basePriceHalerintegerpovinné

priceListIdnull | stringpovinné

sourcestringpovinné

discountPercentintegerpovinné

GET/v1/items/{id}/price

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

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

What an item costs: last purchase price with and without landed costs, supplier prices, and the margin on its sale price

GET/v1/items/{id}/purchase-info

What an item costs: last purchase price with and without landed costs, supplier prices, and the margin on its sale price

Nástroj MCP: get-item-purchase-info

Parametry v cestě

idstringpovinné

Odpověď · 200

itemIdnull | stringpovinné

salePriceHalerintegerpovinné

lastPurchaseobjectpovinné

datestringpovinnédate

documentNumbernull | stringpovinné

supplierIdnull | stringpovinné

supplierNamenull | stringpovinné

unitPriceHalerinteger | nullpovinné

landedUnitCostHalerintegerpovinné

supplierPricesany[]povinné

minMarginPercentintegerpovinné

marginobjectpovinné

costHalerintegerpovinné

marginHalerinteger | nullpovinné

marginPercentinteger | nullpovinné

warningnull | stringpovinné

GET/v1/items/{id}/purchase-info

curl https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/purchase-info \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

Recompute an item in date order and show how it differs from the posted values, without changing anything

GET/v1/items/{id}/revaluation

Recompute an item in date order and show how it differs from the posted values, without changing anything. Differences appear when documents were backdated. Posted costs stay as they are unless a correction is posted. A corrected component cost is carried into the finished goods made from it: `carried` lists them, and `totalDifferenceHaler` is the whole effect.

Nástroj MCP: preview-item-revaluation

Parametry v cestě

idstringpovinné

Odpověď · 200

itemIdnull | stringpovinné

valuationstring

warehousesobject[]

warehouseIdnull | stringpovinné

quantityintegerpovinné

computedQuantityintegerpovinné

valueHalerinteger | nullpovinné

computedValueHalerintegerpovinné

differenceHalerintegerpovinné

layersobject[]povinné

idstringpovinné

seqintegerpovinné

receivedOnnull | stringpovinnédate

lotIdnull | stringpovinné

qtyMilliintegerpovinné

valueHalerinteger | nullpovinné

issuesobject[]

idstringpovinné

postedCostHalerintegerpovinné

computedCostHalerintegerpovinné

differenceHalerintegerpovinné

differenceHalerinteger

carriedobject[]

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

differenceHalerintegerpovinné

warehousesobject[]povinné

warehouseIdnull | stringpovinné

quantityintegerpovinné

computedQuantityintegerpovinné

valueHalerinteger | nullpovinné

computedValueHalerintegerpovinné

differenceHalerintegerpovinné

layersobject[]povinné

idstringpovinné

seqintegerpovinné

receivedOnnull | stringpovinnédate

lotIdstring | nullpovinné

qtyMilliintegerpovinné

valueHalerinteger | nullpovinné

totalDifferenceHalerinteger

postedHalerinteger

journalEntryIdnull | string

GET/v1/items/{id}/revaluation

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

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

Post the recompute difference as a dated correction. Earlier postings are never edited

POST/v1/items/{id}/revaluation

Post the recompute difference as a dated correction. Earlier postings are never edited. Send the differences the preview showed, of the item and of the finished goods it carries into: if history changed since, nothing is posted. Refused in a closed period. Everything posts in one entry, and earlier documents stay as they were.

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

Nástroj MCP: post-item-revaluation

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

expectedDifferenceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

expectedCarriedobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

differenceHalerintegerpovinnémin -9007199254740991max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

Odpověď · 200

itemIdnull | stringpovinné

valuationstring

warehousesobject[]

warehouseIdnull | stringpovinné

quantityintegerpovinné

computedQuantityintegerpovinné

valueHalerinteger | nullpovinné

computedValueHalerintegerpovinné

differenceHalerintegerpovinné

layersobject[]povinné

idstringpovinné

seqintegerpovinné

receivedOnnull | stringpovinnédate

lotIdnull | stringpovinné

qtyMilliintegerpovinné

valueHalerinteger | nullpovinné

issuesobject[]

idstringpovinné

postedCostHalerintegerpovinné

computedCostHalerintegerpovinné

differenceHalerintegerpovinné

differenceHalerinteger

carriedobject[]

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

differenceHalerintegerpovinné

warehousesobject[]povinné

warehouseIdnull | stringpovinné

quantityintegerpovinné

computedQuantityintegerpovinné

valueHalerinteger | nullpovinné

computedValueHalerintegerpovinné

differenceHalerintegerpovinné

layersobject[]povinné

idstringpovinné

seqintegerpovinné

receivedOnnull | stringpovinnédate

lotIdstring | nullpovinné

qtyMilliintegerpovinné

valueHalerinteger | nullpovinné

totalDifferenceHalerinteger

postedHalerinteger

journalEntryIdnull | string

POST/v1/items/{id}/revaluation

curl -X POST https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revaluation \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "expectedDifferenceHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revaluation', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "expectedDifferenceHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/revaluation",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "expectedDifferenceHaler": 1210000
    },
)
data = response.json()

Item card: balance per warehouse, cost layers, lots, reservations, and movement history

GET/v1/items/{id}/stock

Item card: balance per warehouse, cost layers, lots, reservations, and movement history

Nástroj MCP: get-item-stock

Parametry v cestě

idstringpovinné

Odpověď · 200

itemobjectpovinné

object"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

positionobjectpovinné

object"stock_position"povinné

idstringpovinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

eannull | stringpovinné

unitnull | stringpovinné

typestringpovinné

valuationstringpovinné

trackingstringpovinné

onHandnumberpovinné

reservedintegerpovinné

availablenumberpovinné

averageCostHalerintegerpovinné

valueHalerinteger | nullpovinné

minStockinteger | nullpovinné

maxStockanypovinné

Null in every recorded response.

lowStockbooleanpovinné

warehousesobject[]povinné

warehouseIdnull | stringpovinné

namenull | stringpovinné

onHandnumberpovinné

reservedintegerpovinné

availablenumberpovinné

valueHalerinteger | nullpovinné

averageCostHalerintegerpovinné

layersobject[]povinné

object"stock_layer"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

lotIdnull | stringpovinné

receivedOnstringpovinnédate

quantitynumberpovinné

valueHalerintegerpovinné

unitCostHalerinteger | nullpovinné

originalQuantityintegerpovinné

originalValueHalerintegerpovinné

warehouseNamestringpovinné

lotsobject[]povinné

object"stock_lot"povinné

idstringpovinné

itemIdstringpovinné

kindstringpovinné

codestringpovinné

expiryDatenull | stringpovinnédate

receivedOnstringpovinnédate

notenull | stringpovinné

onHandinteger

itemNamestring

itemSkustring

unitnull | string

warehousesobject[]

warehouseIdnull | stringpovinné

namenull | stringpovinné

onHandintegerpovinné

reservationsobject[]povinné

object"stock_reservation"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

quantitynumberpovinné

fulfilledintegerpovinné

remainingnumberpovinné

statusstringpovinné

orderIdnull | stringpovinné

orderLineIdnull | stringpovinné

orderNumbernull | stringpovinné

contactIdnull | stringpovinné

reservedUntilnull | stringpovinnédate

notestring | nullpovinné

itemNamestring

itemSkustring

unitnull | string

warehouseNamestring

movementsobject[]povinné

object"movement"povinné

idstringpovinné

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

itemIdstringpovinné

typestringpovinné

quantitynumberpovinné

deltanumberpovinné

valueDeltaHalerintegerpovinné

datestringpovinnédate

documentIdnull | stringpovinné

stocktakeIdnull | stringpovinné

invoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

reversalOfIdnull | stringpovinné

reversedByIdnull | stringpovinné

notenull | stringpovinné

warehouseNamestring

documentNumbernull | string

documentTypenull | string

balanceinteger

GET/v1/items/{id}/stock

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

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

List an item's alternative units with their conversion to the base unit

GET/v1/items/{id}/units

List an item's alternative units with their conversion to the base unit

Nástroj MCP: get-item-units

Parametry v cestě

idstringpovinné

Odpověď · 200

itemIdstringpovinné

baseUnitstringpovinné

unitsobject[]povinné

object"item_unit"povinné

idstringpovinné

itemIdstringpovinné

unitstringpovinné

factorintegerpovinné

eannull | stringpovinné

GET/v1/items/{id}/units

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

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

Replace an item's alternative units, for example 1 balení = 12 ks, each optionally with its own barcode

PUT/v1/items/{id}/units

Replace an item's alternative units, for example 1 balení = 12 ks, each optionally with its own barcode. A document line in such a unit moves the converted quantity of the base unit. Stock always stays in the base unit.

Nástroj MCP: put-item-units

Parametry v cestě

idstringpovinné

Tělo požadavku

unitsobject[]povinné

unitstringpovinnémax 16 chars

factornumberpovinnémax 1000000000

eanstring | null

Odpověď · 200

itemIdstringpovinné

baseUnitstringpovinné

unitsobject[]povinné

object"item_unit"povinné

idstringpovinné

itemIdstringpovinné

unitstringpovinné

factorintegerpovinné

eannull | stringpovinné

PUT/v1/items/{id}/units

curl -X PUT https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/units \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "units": [
    {
      "unit": "string",
      "factor": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/units', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "units": [
      {
        "unit": "string",
        "factor": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/units",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "units": [
            {
                "unit": "string",
                "factor": 1
            }
        ]
    },
)
data = response.json()

List the variants of an item with their attributes

GET/v1/items/{id}/variants

List the variants of an item with their attributes

Nástroj MCP: list-item-variants

Parametry v cestě

idstringpovinné

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/items/{id}/variants

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

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

Create a variant for every combination of attributes, for example Barva × Velikost. Each variant is an ordinary item with its own stock

POST/v1/items/{id}/variants

Create a variant for every combination of attributes, for example Barva × Velikost. Each variant is an ordinary item with its own stock. Variants take the unit, prices, VAT, valuation, and tracking of the parent. A combination that already exists is skipped, so the call can be repeated with a new value.

Nástroj MCP: create-item-variants

Parametry v cestě

idstringpovinné

Tělo požadavku

axesobject[]povinné

namestringpovinnémax 40 chars

valuesstring[]povinné

Odpověď · 201

itemIdnull | stringpovinné

createdintegerpovinné

dataobject[]povinné

object"item"povinné

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

POST/v1/items/{id}/variants

curl -X POST https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/variants \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "axes": [
    {
      "name": "Pekárna U Lípy s.r.o.",
      "values": [
        "string"
      ]
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/variants', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "axes": [
      {
        "name": "Pekárna U Lípy s.r.o.",
        "values": [
          "string"
        ]
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/variants",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "axes": [
            {
                "name": "Pekárna U Lípy s.r.o.",
                "values": [
                    "string"
                ]
            }
        ]
    },
)
data = response.json()

Export: zásoba

GET/v1/items/export

Download all items as an XLSX workbook, ready to edit and import again

Nástroj MCP: export-items

Odpověď · 200

Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.

GET/v1/items/export

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

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

Import: zásoba

POST/v1/items/import

Create or update items from an XLSX workbook, matched by SKU. Send the file as base64. With dryRun nothing is saved and the answer says what would happen. Rows with an error are skipped and listed.

Nástroj MCP: import-items

Tělo požadavku

fileBase64stringpovinnémax 40000000 chars

File content encoded as base64.

dryRunboolean

Odpověď · 200

dryRunbooleanpovinné

createdintegerpovinné

updatedintegerpovinné

errorsobject[]povinné

lineintegerpovinné

messagenull | stringpovinné

POST/v1/items/import

curl -X POST https://api.damedoklad.cz/v1/items/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

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

Labels with name, price, EAN bars, and a QR code as PDF: an A4 sheet of 3 × 8, or one 50 × 30 mm label per page for a label printer

GET/v1/items/labels

Labels with name, price, EAN bars, and a QR code as PDF: an A4 sheet of 3 × 8, or one 50 × 30 mm label per page for a label printer. Pass item ids separated by commas. An item with no valid EAN-13, EAN-8, or UPC-12 prints the QR code and its SKU only.

Nástroj MCP: get-item-labels

Parametry dotazu

idsstringpovinnémax 20000 chars

copiesintegermin 1max 500

layout"sheet" | "roll"

withPrice"true" | "false"

withGpsr"true" | "false"

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/items/labels

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

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

Vyhledání: zásoba

GET/v1/items/lookup

Find one item by exact SKU or EAN, as a barcode scanner would. A pack barcode also returns the pack unit and its size

Nástroj MCP: lookup-item

Parametry dotazu

codestringpovinnémax 64 chars

Odpověď · 200

idstringpovinné

skustringpovinné

namestringpovinné

eannull | stringpovinné

groupIdnull | stringpovinné

unitstringpovinné

vatRateintegerpovinné

typestringpovinné

trackingstringpovinné

tracksExpirybooleanpovinné

valuationstringpovinné

purchasePriceHalerintegerpovinné

salePriceHalerintegerpovinné

supplierIdnull | stringpovinné

minStocknull | numberpovinné

maxStockinteger | nullpovinné

allowNegativeboolean | nullpovinné

isActivebooleanpovinné

notestring | nullpovinné

weightKgnull | numberpovinné

gpsrIdnull | stringpovinné

recyclingFeeIdnull | stringpovinné

recyclingCoefficientnull | numberpovinné

customFieldsobjectpovinné

barvastring

zimnistring

prumerinteger

zarukastringdate

vyrobcestring

parentIdnull | stringpovinné

attributesobjectpovinné

Barvastring

Velikoststring

isKitbooleanpovinné

portableBatteryboolean

scannedUnitstring

scannedFactorinteger

GET/v1/items/lookup

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

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

Give many items the same GPSR record or recycling fee at once. Name only what should change; null clears it. Nothing already on a document changes, those lines are frozen

POST/v1/items/product-data/assign

Give many items the same GPSR record or recycling fee at once. Name only what should change; null clears it. Nothing already on a document changes, those lines are frozen

Nástroj MCP: assign-item-product-data

Tělo požadavku

itemIdsstring[]povinné

gpsrIdstring | null

ID of the gpsr.

recyclingFeeIdstring | null

ID of the recycling fee. Find it with list-recycling-fees.

recyclingCoefficientnumber | null

Odpověď · 200

updatedCountintegerpovinné

requestedCountintegerpovinné

POST/v1/items/product-data/assign

curl -X POST https://api.damedoklad.cz/v1/items/product-data/assign \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemIds": [
    "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/items/product-data/assign', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemIds": [
      "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/items/product-data/assign",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemIds": [
            "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Seznam: skladové pohyby

GET/v1/movements

List stock movements, newest first, with quantity and value changes

Nástroj MCP: list-movements

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

fromstringYYYY-MM-DD

Date as YYYY-MM-DD.

tostringYYYY-MM-DD

Date as YYYY-MM-DD.

itemIdstring

ID of the item. Find it with list-items.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

typestringmax 32 chars

Odpověď · 200

dataobject[]povinné

object"movement"povinné

idstringpovinné

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

itemIdstringpovinné

typestringpovinné

quantitynumberpovinné

deltanumberpovinné

valueDeltaHalerintegerpovinné

datestringpovinnédate

documentIdnull | stringpovinné

stocktakeIdnull | stringpovinné

invoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

reversalOfIdnull | stringpovinné

reversedByIdnull | stringpovinné

notenull | stringpovinné

warehouseNamestring

documentNumbernull | string

documentTypenull | string

balanceinteger

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/movements

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

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

Vytvoření: skladový pohyb

POST/v1/movements

Record one stock movement without a document. Prefer stock documents, which have numbers, PDFs, and storno. Refuses to oversell unless negative stock is allowed. Items tracked by lot or serial need a document. A stocktake quantity is signed: the difference to apply.

Nástroj MCP: create-movement

Tělo požadavku

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring

ID of the to warehouse.

itemIdstringpovinné

ID of the item. Find it with list-items.

type"receipt" | "issue" | "transfer" | "stocktake"povinné

quantitynumberpovinné

unitPriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

documentIdstring

ID of the document.

notestringmax 2000 chars

Odpověď · 201

idstringpovinné

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

itemIdstringpovinné

typestringpovinné

quantitynumberpovinné

deltanumberpovinné

valueDeltaHalerintegerpovinné

datestringpovinnédate

documentIdnull | stringpovinné

stocktakeIdnull | stringpovinné

invoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

reversalOfIdnull | stringpovinné

reversedByIdnull | stringpovinné

notenull | stringpovinné

warehouseNamestring

documentNumbernull | string

documentTypenull | string

balanceinteger

POST/v1/movements

curl -X POST https://api.damedoklad.cz/v1/movements \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "type": "receipt",
  "quantity": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/movements', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "type": "receipt",
    "quantity": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/movements",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "type": "receipt",
        "quantity": 1
    },
)
data = response.json()

List price lists

GET/v1/price-lists

List price lists

Nástroj MCP: list-price-lists

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"price_list"povinné

idstringpovinné

namestringpovinné

codestringpovinné

isDefaultbooleanpovinné

discountPercentintegerpovinné

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

itemsobject[]

object"price_list_item"povinné

idstringpovinné

priceListIdstringpovinné

itemIdstringpovinné

priceHalerintegerpovinné

minQuantityintegerpovinné

itemNamestringpovinné

itemSkustringpovinné

rulesobject[]

object"price_list_rule"povinné

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/price-lists

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

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

Create a price list with an optional overall discount and validity dates

POST/v1/price-lists

Create a price list with an optional overall discount and validity dates

Nástroj MCP: create-price-list

Tělo požadavku

namestringpovinnémax 200 chars

codestringpovinnémax 64 chars

isDefaultboolean

discountPercentnumbermin 0max 100

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 201

idstringpovinné

namestringpovinné

codestringpovinné

isDefaultbooleanpovinné

discountPercentintegerpovinné

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

itemsobject[]

object"price_list_item"povinné

idstringpovinné

priceListIdstringpovinné

itemIdstringpovinné

priceHalerintegerpovinné

minQuantityintegerpovinné

itemNamestringpovinné

itemSkustringpovinné

rulesobject[]

object"price_list_rule"povinné

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

POST/v1/price-lists

curl -X POST https://api.damedoklad.cz/v1/price-lists \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/price-lists', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/price-lists",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string"
    },
)
data = response.json()

Get a price list with its prices and contact or group discounts

GET/v1/price-lists/{id}

Get a price list with its prices and contact or group discounts

Nástroj MCP: get-price-list

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

isDefaultbooleanpovinné

discountPercentintegerpovinné

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

itemsobject[]

object"price_list_item"povinné

idstringpovinné

priceListIdstringpovinné

itemIdstringpovinné

priceHalerintegerpovinné

minQuantityintegerpovinné

itemNamestringpovinné

itemSkustringpovinné

rulesobject[]

object"price_list_rule"povinné

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

GET/v1/price-lists/{id}

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

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

Update a price list

PATCH/v1/price-lists/{id}

Update a price list

Nástroj MCP: update-price-list

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 200 chars

codestringmax 64 chars

isDefaultboolean

discountPercentnumbermin 0max 100

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

isDefaultbooleanpovinné

discountPercentintegerpovinné

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

itemsobject[]

object"price_list_item"povinné

idstringpovinné

priceListIdstringpovinné

itemIdstringpovinné

priceHalerintegerpovinné

minQuantityintegerpovinné

itemNamestringpovinné

itemSkustringpovinné

rulesobject[]

object"price_list_rule"povinné

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

PATCH/v1/price-lists/{id}

curl -X PATCH https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string",
  "isDefault": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string",
    "isDefault": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string",
        "isDefault": False
    },
)
data = response.json()

Delete a price list with its prices and rules

DELETE/v1/price-lists/{id}

Delete a price list with its prices and rules

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

Nástroj MCP: delete-price-list

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/price-lists/{id}

curl -X DELETE https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Download a price list as an XLSX workbook

GET/v1/price-lists/{id}/export

Download a price list as an XLSX workbook

Nástroj MCP: export-price-list

Parametry v cestě

idstringpovinné

Odpověď · 200

Vrací soubor application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.

GET/v1/price-lists/{id}/export

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

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

Set prices on a price list from an XLSX workbook, matched by SKU

POST/v1/price-lists/{id}/import

Set prices on a price list from an XLSX workbook, matched by SKU

Nástroj MCP: import-price-list

Parametry v cestě

idstringpovinné

Tělo požadavku

fileBase64stringpovinnémax 40000000 chars

File content encoded as base64.

dryRunboolean

Odpověď · 200

dryRunbooleanpovinné

importedintegerpovinné

errorsobject[]povinné

lineintegerpovinné

messagenull | stringpovinné

POST/v1/price-lists/{id}/import

curl -X POST https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "fileBase64": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fileBase64": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "fileBase64": "string"
    },
)
data = response.json()

Set prices on a price list. A row with a minimum quantity is a quantity break

PUT/v1/price-lists/{id}/items

Set prices on a price list. A row with a minimum quantity is a quantity break

Nástroj MCP: put-price-list-items

Parametry v cestě

idstringpovinné

Tělo požadavku

itemsobject[]povinné

itemIdstringpovinné

ID of the item. Find it with list-items.

priceHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

minQuantitynumbermin 0

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

isDefaultbooleanpovinné

discountPercentintegerpovinné

validFromnull | stringpovinnédate

validTonull | stringpovinnédate

notestring | nullpovinné

itemsobject[]

object"price_list_item"povinné

idstringpovinné

priceListIdstringpovinné

itemIdstringpovinné

priceHalerintegerpovinné

minQuantityintegerpovinné

itemNamestringpovinné

itemSkustringpovinné

rulesobject[]

object"price_list_rule"povinné

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

PUT/v1/price-lists/{id}/items

curl -X PUT https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "priceHaler": 1210000
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "items": [
      {
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "priceHaler": 1210000
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "items": [
            {
                "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "priceHaler": 1210000
            }
        ]
    },
)
data = response.json()

Remove one price from a price list

DELETE/v1/price-lists/{id}/items/{rowId}

Remove one price from a price list

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

Nástroj MCP: delete-price-list-item

Parametry v cestě

idstringpovinné

rowIdstringpovinné

ID of the row.

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/price-lists/{id}/items/{rowId}

curl -X DELETE https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/items/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Assign a price list to a contact or contact group, with an optional extra discount

POST/v1/price-lists/{id}/rules

Assign a price list to a contact or contact group, with an optional extra discount

Nástroj MCP: create-price-list-rule

Parametry v cestě

idstringpovinné

Tělo požadavku

contactIdstring

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

contactGroupIdstring

ID of the contact group. Find it with list-contact-groups.

discountPercentnumbermin 0max 100

Odpověď · 201

idstringpovinné

priceListIdstringpovinné

contactIdnull | stringpovinné

contactGroupIdstring | nullpovinné

discountPercentintegerpovinné

POST/v1/price-lists/{id}/rules

curl -X POST https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "contactGroupId": "cgr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "priceHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "contactGroupId": "cgr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "priceHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "contactGroupId": "cgr_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "priceHaler": 1210000
    },
)
data = response.json()

Remove a contact or group assignment from a price list

DELETE/v1/price-lists/{id}/rules/{ruleId}

Remove a contact or group assignment from a price list

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

Nástroj MCP: delete-price-list-rule

Parametry v cestě

idstringpovinné

ruleIdstringpovinné

ID of the rule.

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/price-lists/{id}/rules/{ruleId}

curl -X DELETE https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/price-lists/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/rules/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

List production requests: what should be produced, before anything moves in stock

GET/v1/production-requests

List production requests: what should be produced, before anything moves in stock

Nástroj MCP: list-production-requests

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"production_request"povinné

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/production-requests

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

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

Plan a production from a bill of materials. Moves nothing in stock

POST/v1/production-requests

Plan a production from a bill of materials. Moves nothing in stock

Nástroj MCP: create-production-request

Tělo požadavku

bomIdstringpovinné

ID of the bom. Find it with list-boms.

quantitynumberpovinnémax 1000000000

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring | null

ID of the to warehouse.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

orderIdstring | null

ID of the order.

orderLineIdstring | null

ID of the order line.

notestring | null

Odpověď · 201

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

POST/v1/production-requests

curl -X POST https://api.damedoklad.cz/v1/production-requests \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "quantity": 1,
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "quantity": 1,
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/production-requests",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1,
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Get a production request with the components it needs

GET/v1/production-requests/{id}

Get a production request with the components it needs

Nástroj MCP: get-production-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

GET/v1/production-requests/{id}

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

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

Change an open production request. A reserved one cannot change its quantity or warehouse. Components of its own follow a new quantity, and lots picked for the old one are cleared

PATCH/v1/production-requests/{id}

Change an open production request. A reserved one cannot change its quantity or warehouse. Components of its own follow a new quantity, and lots picked for the old one are cleared

Nástroj MCP: update-production-request

Parametry v cestě

idstringpovinné

Tělo požadavku

quantitynumbermax 1000000000

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring | null

ID of the to warehouse.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

PATCH/v1/production-requests/{id}

curl -X PATCH https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "quantity": 1,
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "toWarehouseId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "quantity": 1,
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "toWarehouseId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "quantity": 1,
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "toWarehouseId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Cancel an open production request and give back what it reserved

POST/v1/production-requests/{id}/cancel

Cancel an open production request and give back what it reserved

Nástroj MCP: cancel-production-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

POST/v1/production-requests/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

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

Change what one production request uses: add, remove or change components, in the item unit or a pack, and pick lots or serial numbers. The bill of materials stays as it is

PUT/v1/production-requests/{id}/components

Change what one production request uses: add, remove or change components, in the item unit or a pack, and pick lots or serial numbers. The bill of materials stays as it is. components: null goes back to the bill of materials. A reserved request has to give its reservation back first, because the reservation holds the old components.

Nástroj MCP: put-production-request-components

Parametry v cestě

idstringpovinné

Tělo požadavku

componentsobject[] | nullpovinné

What this request uses. null goes back to the bill of materials

itemIdstringpovinné

ID of the item. Find it with list-items.

quantitynumberpovinnémax 1000000000

unitstringmax 16 chars

lotsobject[]

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumberpovinnémax 1000000000

expiryDatestring | null

Date as YYYY-MM-DD.

outputLotsobject[]

The lot or serial numbers the finished product will carry, when it is tracked

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumberpovinnémax 1000000000

expiryDatestring | null

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

PUT/v1/production-requests/{id}/components

curl -X PUT https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/components \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "components": [
    {
      "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/components', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "components": [
      {
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.put(
    "https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/components",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "components": [
            {
                "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Send a request to production: posts the production stock document, taking out components and adding the product

POST/v1/production-requests/{id}/produce

Send a request to production: posts the production stock document, taking out components and adding the product. What it reserved is given back first, because this is the production it was reserved for.

Nástroj MCP: produce-production-request

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

overrideReservationsboolean

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

POST/v1/production-requests/{id}/produce

curl -X POST https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/produce \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "overrideReservations": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/produce', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "overrideReservations": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/produce",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "overrideReservations": False
    },
)
data = response.json()

Reserve all components of a production request. A request is reserved whole or not at all

POST/v1/production-requests/{id}/reserve

Reserve all components of a production request. A request is reserved whole or not at all

Nástroj MCP: reserve-production-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

POST/v1/production-requests/{id}/reserve

curl -X POST https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reserve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/reserve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

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

Give back what a production request reserved

POST/v1/production-requests/{id}/unreserve

Give back what a production request reserved

Nástroj MCP: unreserve-production-request

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

POST/v1/production-requests/{id}/unreserve

curl -X POST https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unreserve \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/unreserve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

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

Make one production request for each line of one or several received orders whose item has an active bill of materials, or only for the lines named

POST/v1/production-requests/from-order

Make one production request for each line of one or several received orders whose item has an active bill of materials, or only for the lines named. Lines already in a request are left out, so it can run again after the order changes. Give orderId, or orderIds for several at once.

Nástroj MCP: create-production-requests-from-order

Tělo požadavku

orderIdstring

ID of the order.

orderIdsstring[]

Several received orders at once, POHODA's Přenést vše

lineIdsstring[]

Only these lines, POHODA's Přenést s výběrem položek

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

Odpověď · 201

dataobject[]povinné

object"production_request"povinné

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

totalintegerpovinné

hasMorebooleanpovinné

POST/v1/production-requests/from-order

curl -X POST https://api.damedoklad.cz/v1/production-requests/from-order \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/from-order', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/production-requests/from-order",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Plan several products at once, each from its bill of materials. All or none, and nothing moves in stock

POST/v1/production-requests/many

Plan several products at once, each from its bill of materials. All or none, and nothing moves in stock

Nástroj MCP: create-production-requests

Tělo požadavku

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring | null

ID of the to warehouse.

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

linesobject[]povinné

bomIdstringpovinné

ID of the bom. Find it with list-boms.

quantitynumberpovinnémax 1000000000

Odpověď · 201

dataobject[]povinné

object"production_request"povinné

idstringpovinné

numberstringpovinné

datestringpovinnédate

bomIdstringpovinné

itemIdstringpovinné

itemNamestringpovinné

quantityintegerpovinné

unitnull | stringpovinné

warehouseIdstringpovinné

toWarehouseIdstring | nullpovinné

orderIdnull | stringpovinné

orderNumberstring | nullpovinné

reservedbooleanpovinné

statusstringpovinné

stockDocumentIdnull | stringpovinné

notenull | stringpovinné

outputTrackingstring

outputLotsobject[]

lotIdstring | nullpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

componentsChangedboolean

componentsarray | nullpovinné

itemIdstringpovinné

namenull | stringpovinné

unitnull | stringpovinné

trackingstring

quantitynumberpovinné

enteredUnitstring | null

enteredQuantityany

Null in every recorded response.

lotsobject[]

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatestring | nullpovinné

totalintegerpovinné

hasMorebooleanpovinné

POST/v1/production-requests/many

curl -X POST https://api.damedoklad.cz/v1/production-requests/many \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "lines": [
    {
      "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/many', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "lines": [
      {
        "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/production-requests/many",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "lines": [
            {
                "bomId": "wbm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Send many requests to production at once. Each runs on its own, so one that lacks stock or a lot stops nothing else, and the answer says what happened to each

POST/v1/production-requests/produce-many

Send many requests to production at once. Each runs on its own, so one that lacks stock or a lot stops nothing else, and the answer says what happened to each

Nástroj MCP: produce-production-requests

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

overrideReservationsboolean

idsstring[]povinné

Odpověď · 200

resultsobject[]povinné

idstring

okbooleanpovinné

errornull | string

codenull | string

numbernull | string

stockDocumentIdnull | string

documentIdnull | string

statusstring

contactNamenull | string

namenull | string

tostring

amountHalerinteger | null

movementIdnull | string

rowinteger

recognisedboolean

shipmentIdstring

trackingNumbernull | string

totalintegerpovinné

succeededintegerpovinné

failedintegerpovinné

POST/v1/production-requests/produce-many

curl -X POST https://api.damedoklad.cz/v1/production-requests/produce-many \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": [
    "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/production-requests/produce-many', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ids": [
      "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/production-requests/produce-many",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "ids": [
            "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Add a transport or customs invoice to the cost of receipts: it moves to 131/111, and what the receipts did not expect is added to the goods

POST/v1/received-invoices/{id}/landed-cost

Add a transport or customs invoice to the cost of receipts: it moves to 131/111, and what the receipts did not expect is added to the goods. Legal effect: posts to the books. By default the invoice lines that do not move stock are allocated. Several receipts share the amount by value, each receipt's lines by value or weight. The first invoice answers for the landed cost the receipt stated, so a difference can be negative. Whatever has left stock goes to 504/501.

Nástroj MCP: allocate-landed-cost-invoice

Parametry v cestě

idstringpovinné

Tělo požadavku

stockDocumentIdsstring[]povinné

lineIdsstring[]

method"value" | "weight"

Odpověď · 201

receivedInvoiceIdnull | stringpovinné

dataobject[]povinné

object"stock_cost_adjustment"povinné

idstringpovinné

kindstringpovinné

stockDocumentIdnull | stringpovinné

stockDocumentNumberstringpovinné

itemIdstringpovinné

statedHalerintegerpovinné

amountHalerintegerpovinné

stockHalerintegerpovinné

soldHalerintegerpovinné

POST/v1/received-invoices/{id}/landed-cost

curl -X POST https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "stockDocumentIds": [
    "wdc_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "stockDocumentIds": [
      "wdc_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "stockDocumentIds": [
            "wdc_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
        ]
    },
)
data = response.json()

Take a transport or customs invoice off the receipts it was added to and reverse the postings

DELETE/v1/received-invoices/{id}/landed-cost

Take a transport or customs invoice off the receipts it was added to and reverse the postings

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

Nástroj MCP: remove-landed-cost-invoice

Parametry v cestě

idstringpovinné

Odpověď · 200

receivedInvoiceIdnull | stringpovinné

dataobject[]povinné

object"stock_cost_adjustment"povinné

idstringpovinné

kindstringpovinné

stockDocumentIdnull | stringpovinné

stockDocumentNumberstringpovinné

itemIdstringpovinné

statedHalerintegerpovinné

amountHalerintegerpovinné

stockHalerintegerpovinné

soldHalerintegerpovinné

DELETE/v1/received-invoices/{id}/landed-cost

curl -X DELETE https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.delete(
    "https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/landed-cost",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

What this received invoice changed on the value of receipts: a price difference against the receipt, or transport allocated to it

GET/v1/received-invoices/{id}/stock-costs

What this received invoice changed on the value of receipts: a price difference against the receipt, or transport allocated to it

Nástroj MCP: get-received-invoice-stock-costs

Parametry v cestě

idstringpovinné

Odpověď · 200

receivedInvoiceIdnull | stringpovinné

dataobject[]povinné

object"stock_cost_adjustment"povinné

idstringpovinné

kindstringpovinné

stockDocumentIdnull | stringpovinné

stockDocumentNumberstringpovinné

itemIdstringpovinné

statedHalerintegerpovinné

amountHalerintegerpovinné

stockHalerintegerpovinné

soldHalerintegerpovinné

GET/v1/received-invoices/{id}/stock-costs

curl https://api.damedoklad.cz/v1/received-invoices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/stock-costs \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

List RecyclingFees

GET/v1/recycling-fees

List RecyclingFees

Nástroj MCP: list-recycling-fees

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"recycling_fee"povinné

idstringpovinné

codestringpovinné

namestringpovinné

rateHalerintegerpovinné

unitstringpovinné

documentTextnull | stringpovinné

isActivebooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/recycling-fees

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

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

Create a RecyclingFee

POST/v1/recycling-fees

Create a RecyclingFee

Nástroj MCP: create-recycling-fee

Tělo požadavku

codestringpovinnémax 32 chars

namestringpovinnémax 200 chars

rateHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

unitstringmax 10 chars

documentTextstring | null

isActiveboolean

Odpověď · 201

idstringpovinné

codestringpovinné

namestringpovinné

rateHalerintegerpovinné

unitstringpovinné

documentTextnull | stringpovinné

isActivebooleanpovinné

POST/v1/recycling-fees

curl -X POST https://api.damedoklad.cz/v1/recycling-fees \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "rateHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/recycling-fees', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "rateHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/recycling-fees",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "code": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "rateHaler": 1210000
    },
)
data = response.json()

Get a RecyclingFee

GET/v1/recycling-fees/{id}

Get a RecyclingFee

Nástroj MCP: get-recycling-fee

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

codestringpovinné

namestringpovinné

rateHalerintegerpovinné

unitstringpovinné

documentTextnull | stringpovinné

isActivebooleanpovinné

GET/v1/recycling-fees/{id}

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

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

Update a RecyclingFee

PATCH/v1/recycling-fees/{id}

Update a RecyclingFee

Nástroj MCP: update-recycling-fee

Parametry v cestě

idstringpovinné

Tělo požadavku

codestringmax 32 chars

namestringmax 200 chars

rateHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

unitstringmax 10 chars

documentTextstring | null

isActiveboolean

Odpověď · 200

idstringpovinné

codestringpovinné

namestringpovinné

rateHalerintegerpovinné

unitstringpovinné

documentTextnull | stringpovinné

isActivebooleanpovinné

PATCH/v1/recycling-fees/{id}

curl -X PATCH https://api.damedoklad.cz/v1/recycling-fees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "rateHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/recycling-fees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "rateHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/recycling-fees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "code": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "rateHaler": 1210000
    },
)
data = response.json()

Delete a RecyclingFee

DELETE/v1/recycling-fees/{id}

Delete a RecyclingFee

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

Nástroj MCP: delete-recycling-fee

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/recycling-fees/{id}

curl -X DELETE https://api.damedoklad.cz/v1/recycling-fees/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

All recycling fees as a POHODA XML file (recyclingContrib.xsd, version 2.0), to load into POHODA

GET/v1/recycling-fees/export.xml

All recycling fees as a POHODA XML file (recyclingContrib.xsd, version 2.0), to load into POHODA

Nástroj MCP: export-recycling-fees-xml

Odpověď · 200

Vrací soubor application/xml.

GET/v1/recycling-fees/export.xml

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

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

Recycling fees charged in a period, per fee: quantity sold, weight, and total in crowns, from issued invoices, credit notes, and receipts

GET/v1/recycling-fees/report

Recycling fees charged in a period, per fee: quantity sold, weight, and total in crowns, from issued invoices, credit notes, and receipts

Nástroj MCP: get-recycling-report

Parametry dotazu

fromstringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

tostringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

direction"sold" | "purchased"

sold: what this company charged. purchased: what suppliers stated on received invoices

Odpověď · 200

dataobject[]povinné

object"recycling_report_row"povinné

feeIdnull | stringpovinné

typedbooleanpovinné

codenull | stringpovinné

namenull | stringpovinné

quantityMilliinteger | nullpovinné

weightMilliintegerpovinné

totalHalerinteger | nullpovinné

unitnull | stringpovinné

totalintegerpovinné

hasMorebooleanpovinné

totalHalerinteger | nullpovinné

GET/v1/recycling-fees/report

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

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

List stock positions: on hand, reserved, available, average cost, value, and low-stock flag per item

GET/v1/stock

List stock positions: on hand, reserved, available, average cost, value, and low-stock flag per item

Nástroj MCP: list-stock

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

groupIdstring

ID of the group.

lowStock"true" | "false"

inStock"true" | "false"

Odpověď · 200

dataobject[]povinné

object"stock_position"povinné

idstringpovinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

eannull | stringpovinné

unitnull | stringpovinné

typestringpovinné

valuationstringpovinné

trackingstringpovinné

onHandnumberpovinné

reservedintegerpovinné

availablenumberpovinné

averageCostHalerintegerpovinné

valueHalerinteger | nullpovinné

minStockinteger | nullpovinné

maxStockanypovinné

Null in every recorded response.

lowStockbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stock

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

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

List stock documents: receipts, issues, transfers, and production

GET/v1/stock-documents

List stock documents: receipts, issues, transfers, and production

Nástroj MCP: list-stock-documents

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.

type"receipt" | "issue" | "transfer" | "production"

status"draft" | "posted" | "storno"

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

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"stock_document"povinné

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stock-documents

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

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

Create a stock document as a draft, or post it at once with post: true

POST/v1/stock-documents

Create a stock document as a draft, or post it at once with post: true. Production documents take bomId and quantity and fill their lines from the bill of materials.

Nástroj MCP: create-stock-document

Tělo požadavku

type"receipt" | "issue" | "transfer" | "production"povinné

landedCostsobject[]

labelstringpovinnémax 120 chars

amountHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

method"value" | "weight"

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring | null

ID of the to warehouse.

extraCostHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

bomIdstring

ID of the bom. Find it with list-boms.

quantitynumbermax 1000000000

linesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

unitstringmax 16 chars

locationIdstring | null

ID of the location.

toLocationIdstring | null

ID of the to location.

role"line" | "component" | "output"

quantitynumberpovinnémax 1000000000

unitPriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

valueHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

lotsobject[]

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumbermax 1000000000

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

reservationIdstring

ID of the reservation.

notestringmax 2000 chars

postboolean

overrideReservationsboolean

overrideCreditLimitboolean

contactIdstring | null

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

invoiceIdstring | null

ID of the invoice. Find it with list-invoices.

receivedInvoiceIdstring | null

ID of the received invoice. Find it with list-received-invoices.

deliveryNoteIdstring | null

ID of the delivery note. Find it with list-delivery-notes.

orderIdstring | null

ID of the order.

orderNumberstring | null

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

notestring | null

Odpověď · 201

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

POST/v1/stock-documents

curl -X POST https://api.damedoklad.cz/v1/stock-documents \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "type": "receipt",
  "date": "2026-10-30",
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-documents', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "type": "receipt",
    "date": "2026-10-30",
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-documents",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "type": "receipt",
        "date": "2026-10-30",
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL"
    },
)
data = response.json()

Get a stock document with its lines

GET/v1/stock-documents/{id}

Get a stock document with its lines

Nástroj MCP: get-stock-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

GET/v1/stock-documents/{id}

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

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

Edit a draft stock document

PATCH/v1/stock-documents/{id}

Edit a draft stock document

Nástroj MCP: update-stock-document

Parametry v cestě

idstringpovinné

Tělo požadavku

landedCostsobject[]

labelstringpovinnémax 120 chars

amountHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

method"value" | "weight"

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

toWarehouseIdstring | null

ID of the to warehouse.

extraCostHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

bomIdstring

ID of the bom. Find it with list-boms.

quantitynumbermax 1000000000

linesobject[]

itemIdstringpovinné

ID of the item. Find it with list-items.

unitstringmax 16 chars

locationIdstring | null

ID of the location.

toLocationIdstring | null

ID of the to location.

role"line" | "component" | "output"

quantitynumberpovinnémax 1000000000

unitPriceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

valueHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

lotsobject[]

lotIdstring

ID of the lot.

codestringmax 64 chars

quantitynumbermax 1000000000

expiryDatestring | null

Date as YYYY-MM-DD.

serialNumbersstring[]

reservationIdstring

ID of the reservation.

notestringmax 2000 chars

overrideCreditLimitboolean

contactIdstring | null

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

invoiceIdstring | null

ID of the invoice. Find it with list-invoices.

receivedInvoiceIdstring | null

ID of the received invoice. Find it with list-received-invoices.

deliveryNoteIdstring | null

ID of the delivery note. Find it with list-delivery-notes.

orderIdstring | null

ID of the order.

orderNumberstring | null

centerIdstring | null

ID of the center.

activityIdstring | null

ID of the activity. Find it with list-activity.

projectIdstring | null

ID of the project.

notestring | null

Odpověď · 200

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

PATCH/v1/stock-documents/{id}

curl -X PATCH https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "landedCosts": [
    {
      "label": "string",
      "amountHaler": 1210000
    }
  ],
  "reason": "purchase",
  "date": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "landedCosts": [
      {
        "label": "string",
        "amountHaler": 1210000
      }
    ],
    "reason": "purchase",
    "date": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "landedCosts": [
            {
                "label": "string",
                "amountHaler": 1210000
            }
        ],
        "reason": "purchase",
        "date": "2026-10-30"
    },
)
data = response.json()

Delete a draft stock document

DELETE/v1/stock-documents/{id}

Delete a draft stock document

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

Nástroj MCP: delete-stock-document

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/stock-documents/{id}

curl -X DELETE https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Download a stock document as PDF, in Czech, English, German or French

GET/v1/stock-documents/{id}/pdf

Download a stock document as PDF, in Czech, English, German or French

Nástroj MCP: get-stock-document-pdf

Parametry v cestě

idstringpovinné

Parametry dotazu

language"cs" | "en" | "de" | "fr"

Odpověď · 200

Vrací soubor application/pdf.

GET/v1/stock-documents/{id}/pdf

curl https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/pdf \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -o soubor

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

Post a draft: assign a number, move stock, and write the accounting entry

POST/v1/stock-documents/{id}/post

Post a draft: assign a number, move stock, and write the accounting entry. Refuses to oversell unless negative stock is allowed. Set overrideReservations to issue stock reserved for other orders. A sale to a contact over Kredit max is refused with credit_limit_exceeded; an owner or accountant may set overrideCreditLimit.

Nástroj MCP: post-stock-document

Parametry v cestě

idstringpovinné

Tělo požadavku

overrideReservationsboolean

overrideCreditLimitboolean

Odpověď · 200

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

POST/v1/stock-documents/{id}/post

curl -X POST https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "overrideReservations": false,
  "overrideCreditLimit": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "overrideReservations": false,
    "overrideCreditLimit": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "overrideReservations": False,
        "overrideCreditLimit": False
    },
)
data = response.json()

Reverse a posted stock document with opposite movements and journal entries

POST/v1/stock-documents/{id}/storno

Reverse a posted stock document with opposite movements and journal entries. Refused when received stock was already issued, or when the document came from an invoice or delivery note: storno that document instead.

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

Nástroj MCP: storno-stock-document

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

notestringmax 2000 chars

Odpověď · 200

idstringpovinné

typestringpovinné

reasonstringpovinné

statusstringpovinné

numbernull | stringpovinné

datestringpovinnédate

warehouseIdstringpovinné

toWarehouseIdnull | stringpovinné

contactIdnull | stringpovinné

contactNamenull | stringpovinné

bomIdnull | stringpovinné

quantityinteger | nullpovinné

extraCostHalerintegerpovinné

landedCostsobject[]povinné

labelnull | stringpovinné

methodnull | string

amountHalerinteger | nullpovinné

totalValueHalerintegerpovinné

invoiceIdnull | stringpovinné

receivedInvoiceIdnull | stringpovinné

deliveryNoteIdnull | stringpovinné

orderIdnull | stringpovinné

orderNumbernull | stringpovinné

sourceTypenull | stringpovinné

sourceIdnull | stringpovinné

centerIdstring | nullpovinné

activityIdstring | nullpovinné

projectIdstring | nullpovinné

stornoDatenull | stringpovinnédate

notenull | stringpovinné

customFieldsobject

tistene_polestring

linesobject[]

object"stock_document_line"povinné

idstringpovinné

rolestringpovinné

itemIdstringpovinné

warehouseIdnull | stringpovinné

quantitynumberpovinné

unitPriceHalerinteger | nullpovinné

valueHalerinteger | nullpovinné

postedValueHalerinteger | nullpovinné

lotsobject[]povinné

lotIdnull | stringpovinné

codenull | stringpovinné

quantityintegerpovinné

expiryDatenull | stringpovinnédate

reservationIdnull | stringpovinné

orderLineIdnull | stringpovinné

landedCostHalerintegerpovinné

enteredUnitnull | stringpovinné

enteredQuantityinteger | nullpovinné

locationIdnull | stringpovinné

toLocationIdnull | stringpovinné

notestring | nullpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

creditWarningobject

levelstringpovinné

exposureHalerintegerpovinné

afterHalerintegerpovinné

warnHaleranypovinné

Null in every recorded response.

blockHalerintegerpovinné

availableHalerintegerpovinné

POST/v1/stock-documents/{id}/storno

curl -X POST https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-documents/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/storno",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "note": "string"
    },
)
data = response.json()

What sits on which location, per item and lot. Stock on no location is listed as unplaced when an item is given

GET/v1/stock-locations

What sits on which location, per item and lot. Stock on no location is listed as unplaced when an item is given

Nástroj MCP: list-stock-location-balances

Parametry dotazu

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

itemIdstring

ID of the item. Find it with list-items.

locationIdstring

ID of the location.

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

itemIdnull | stringpovinné

skustringpovinné

namenull | stringpovinné

unitnull | stringpovinné

locationIdnull | stringpovinné

locationCodestringpovinné

warehouseIdnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

quantityintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stock-locations

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

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

Move goods between locations of one warehouse. Quantity only: no value change and no accounting entry

POST/v1/stock-locations/transfer

Move goods between locations of one warehouse. Quantity only: no value change and no accounting entry. Leave fromLocationId empty to shelve unplaced stock, toLocationId empty to take it off a location. A lot- or serial-tracked item names lotId or lotCode.

Nástroj MCP: transfer-stock-location

Tělo požadavku

itemIdstringpovinné

ID of the item. Find it with list-items.

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

fromLocationIdstring | null

ID of the from location.

toLocationIdstring | null

ID of the to location.

lotIdstring | null

ID of the lot.

lotCodestring | null

quantitynumberpovinnémax 1000000000

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

notestringmax 2000 chars

Odpověď · 200

movementIdnull | stringpovinné

itemIdnull | stringpovinné

quantityintegerpovinné

fromLocationIdnull | stringpovinné

toLocationIdnull | stringpovinné

lotIdnull | stringpovinné

POST/v1/stock-locations/transfer

curl -X POST https://api.damedoklad.cz/v1/stock-locations/transfer \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "quantity": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-locations/transfer', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "quantity": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-locations/transfer",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
    },
)
data = response.json()

List lots and serial numbers with expiry and quantity in stock

GET/v1/stock-lots

List lots and serial numbers with expiry and quantity in stock

Nástroj MCP: list-stock-lots

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

itemIdstring

ID of the item. Find it with list-items.

expiringBeforestringYYYY-MM-DD

Date as YYYY-MM-DD.

inStock"true" | "false"

Odpověď · 200

dataobject[]povinné

object"stock_lot"povinné

idstringpovinné

itemIdstringpovinné

kindstringpovinné

codestringpovinné

expiryDatenull | stringpovinnédate

receivedOnstringpovinnédate

notenull | stringpovinné

onHandinteger

itemNamestring

itemSkustring

unitnull | string

warehousesobject[]

warehouseIdnull | stringpovinné

namenull | stringpovinné

onHandintegerpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stock-lots

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

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

Correct the expiry date or note of a lot

PATCH/v1/stock-lots/{id}

Correct the expiry date or note of a lot

Nástroj MCP: update-stock-lot

Parametry v cestě

idstringpovinné

Tělo požadavku

expiryDatestring | null

Date as YYYY-MM-DD.

notestring | null

Odpověď · 200

idstringpovinné

itemIdstringpovinné

kindstringpovinné

codestringpovinné

expiryDatenull | stringpovinnédate

receivedOnstringpovinnédate

notenull | stringpovinné

onHandinteger

itemNamestring

itemSkustring

unitnull | string

warehousesobject[]

warehouseIdnull | stringpovinné

namenull | stringpovinné

onHandintegerpovinné

PATCH/v1/stock-lots/{id}

curl -X PATCH https://api.damedoklad.cz/v1/stock-lots/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expiryDate": "2026-10-30",
  "note": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-lots/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "expiryDate": "2026-10-30",
    "note": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/stock-lots/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "expiryDate": "2026-10-30",
        "note": "string"
    },
)
data = response.json()

List stock reservations for received orders

GET/v1/stock-reservations

List stock reservations for received orders

Nástroj MCP: list-stock-reservations

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

itemIdstring

ID of the item. Find it with list-items.

status"active" | "fulfilled" | "released"

orderIdstringmax 64 chars

ID of the order.

Odpověď · 200

dataobject[]povinné

object"stock_reservation"povinné

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

quantitynumberpovinné

fulfilledintegerpovinné

remainingnumberpovinné

statusstringpovinné

orderIdnull | stringpovinné

orderLineIdnull | stringpovinné

orderNumbernull | stringpovinné

contactIdnull | stringpovinné

reservedUntilnull | stringpovinnédate

notestring | nullpovinné

itemNamestring

itemSkustring

unitnull | string

warehouseNamestring

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stock-reservations

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

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

Reserve stock for a received order

POST/v1/stock-reservations

Reserve stock for a received order. Refused when less is available than requested, unless allowShort is set. Set orderLineId to make repeated calls for one order line idempotent.

Nástroj MCP: create-stock-reservation

Tělo požadavku

itemIdstringpovinné

ID of the item. Find it with list-items.

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

quantitynumberpovinnémax 1000000000

orderIdstring | null

ID of the order.

orderLineIdstring | null

ID of the order line.

orderNumberstring | null

contactIdstring | null

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

reservedUntilstring | null

notestring | null

allowShortboolean

Odpověď · 201

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

quantitynumberpovinné

fulfilledintegerpovinné

remainingnumberpovinné

statusstringpovinné

orderIdnull | stringpovinné

orderLineIdnull | stringpovinné

orderNumbernull | stringpovinné

contactIdnull | stringpovinné

reservedUntilnull | stringpovinnédate

notestring | nullpovinné

itemNamestring

itemSkustring

unitnull | string

warehouseNamestring

POST/v1/stock-reservations

curl -X POST https://api.damedoklad.cz/v1/stock-reservations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "quantity": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-reservations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "quantity": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-reservations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "contactId": "con_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "quantity": 1
    },
)
data = response.json()

Mark a reservation as fulfilled when the goods left on a document without a link to it

POST/v1/stock-reservations/{id}/fulfil

Mark a reservation as fulfilled when the goods left on a document without a link to it. Does not move stock. An issue document that names the reservation fulfils it by itself.

Nástroj MCP: fulfil-stock-reservation

Parametry v cestě

idstringpovinné

Tělo požadavku

quantitynumbermax 1000000000

Odpověď · 200

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

quantitynumberpovinné

fulfilledintegerpovinné

remainingnumberpovinné

statusstringpovinné

orderIdnull | stringpovinné

orderLineIdnull | stringpovinné

orderNumbernull | stringpovinné

contactIdnull | stringpovinné

reservedUntilnull | stringpovinnédate

notestring | nullpovinné

itemNamestring

itemSkustring

unitnull | string

warehouseNamestring

POST/v1/stock-reservations/{id}/fulfil

curl -X POST https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fulfil \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "quantity": 1
}'

const response = await fetch('https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fulfil', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "quantity": 1
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/fulfil",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "quantity": 1
    },
)
data = response.json()

Release a reservation, returning its remaining quantity to available stock

POST/v1/stock-reservations/{id}/release

Release a reservation, returning its remaining quantity to available stock

Nástroj MCP: release-stock-reservation

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

itemIdstringpovinné

warehouseIdstringpovinné

quantitynumberpovinné

fulfilledintegerpovinné

remainingnumberpovinné

statusstringpovinné

orderIdnull | stringpovinné

orderLineIdnull | stringpovinné

orderNumbernull | stringpovinné

contactIdnull | stringpovinné

reservedUntilnull | stringpovinnédate

notestring | nullpovinné

itemNamestring

itemSkustring

unitnull | string

warehouseNamestring

POST/v1/stock-reservations/{id}/release

curl -X POST https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

const response = await fetch('https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stock-reservations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/release",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
)
data = response.json()

Check whether a quantity of an item is available, in total or in one warehouse

GET/v1/stock/availability

Check whether a quantity of an item is available, in total or in one warehouse. Available is on hand minus active reservations. `sufficient` compares it with the requested quantity.

Nástroj MCP: get-stock-availability

Parametry dotazu

itemIdstringpovinné

ID of the item. Find it with list-items.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

quantitynumber

Odpověď · 200

itemIdnull | stringpovinné

onHandintegerpovinné

reservedintegerpovinné

availableintegerpovinné

requestedinteger | nullpovinné

sufficientboolean | nullpovinné

shortinteger | nullpovinné

warehousesobject[]povinné

warehouseIdnull | stringpovinné

namenull | stringpovinné

onHandintegerpovinné

reservedintegerpovinné

availableintegerpovinné

GET/v1/stock/availability

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

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

Total stock value and how many items are below their minimum

GET/v1/stock/summary

Total stock value and how many items are below their minimum

Nástroj MCP: get-stock-summary

Odpověď · 200

valueHalerinteger | nullpovinné

itemCountintegerpovinné

lowStockCountintegerpovinné

GET/v1/stock/summary

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

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

Seznam: inventura

GET/v1/stocktakes

List stocktakes

Nástroj MCP: list-stocktakes

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"stocktake"povinné

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/stocktakes

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

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

Vytvoření: inventura

POST/v1/stocktakes

Start a stocktake: freezes the quantities of a warehouse, or of one item group in it, in total or shelf by shelf. While it runs, movements in the warehouse are refused unless blockMovements is false. One stocktake per warehouse at a time. byLocation freezes one line per item, lot, and shelf, plus what is on no shelf; locationId counts one shelf only. Goods found on another shelf of the warehouse become a shelf move, not a shortage and a surplus.

Nástroj MCP: create-stocktake

Tělo požadavku

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

datestringpovinnéYYYY-MM-DD

Date as YYYY-MM-DD.

groupIdstring | null

ID of the group.

byLocationboolean

locationIdstring | null

ID of the location.

blockMovementsboolean

notestring | null

Odpověď · 201

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

POST/v1/stocktakes

curl -X POST https://api.damedoklad.cz/v1/stocktakes \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "date": "2026-10-30"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stocktakes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "date": "2026-10-30"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stocktakes",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "date": "2026-10-30"
    },
)
data = response.json()

Detail: inventura

GET/v1/stocktakes/{id}

Get a stocktake with its frozen quantities, counts, and differences

Nástroj MCP: get-stocktake

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

GET/v1/stocktakes/{id}

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

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

Zrušení: inventura

POST/v1/stocktakes/{id}/cancel

Cancel a running stocktake and unblock the warehouse. Nothing is posted

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

Nástroj MCP: cancel-stocktake

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

POST/v1/stocktakes/{id}/cancel

curl -X POST https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/cancel \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Record counted quantities. An item not on the list is added at frozen zero

POST/v1/stocktakes/{id}/counts

Record counted quantities. An item not on the list is added at frozen zero

Nástroj MCP: record-stocktake-counts

Parametry v cestě

idstringpovinné

Tělo požadavku

countsobject[]povinné

lineIdstring

ID of the line.

itemIdstring

ID of the item. Find it with list-items.

lotCodestringmax 64 chars

locationIdstring | null

ID of the location.

quantitynumber | nullpovinné

unitCostHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

withinNormboolean

notestring | null

Odpověď · 200

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

POST/v1/stocktakes/{id}/counts

curl -X POST https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/counts \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "counts": [
    {
      "quantity": 1
    }
  ]
}'

const response = await fetch('https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/counts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "counts": [
      {
        "quantity": 1
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/counts",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "counts": [
            {
                "quantity": 1
            }
        ]
    },
)
data = response.json()

Record counts from CSV with a code column (SKU or EAN), a quantity column, and optionally lot and shelf columns

POST/v1/stocktakes/{id}/import

Record counts from CSV with a code column (SKU or EAN), a quantity column, and optionally lot and shelf columns. Semicolon and comma separated files both work, with a decimal comma or point. Rows with an error are skipped and returned.

Nástroj MCP: import-stocktake-counts

Parametry v cestě

idstringpovinné

Tělo požadavku

csvstringpovinnémax 5000000 chars

Odpověď · 200

importedintegerpovinné

errorsobject[]povinné

lineintegerpovinné

messagenull | stringpovinné

stocktakeobjectpovinné

object"stocktake"povinné

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

POST/v1/stocktakes/{id}/import

curl -X POST https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "csv": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "csv": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/import",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "csv": "string"
    },
)
data = response.json()

Zaúčtování: inventura

POST/v1/stocktakes/{id}/post

Post the differences: shortages and surpluses become stock movements and accounting entries. Refused while a line is uncounted, unless treatUncountedAsFrozen confirms those lines agree. Cannot be undone; a later stocktake corrects it.

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

Nástroj MCP: post-stocktake

Parametry v cestě

idstringpovinné

Tělo požadavku

datestringYYYY-MM-DD

Date as YYYY-MM-DD.

treatUncountedAsFrozenboolean

Odpověď · 200

idstringpovinné

warehouseIdstringpovinné

numbernull | stringpovinné

statusstringpovinné

datestringpovinnédate

postedDatenull | stringpovinnédate

blockMovementsbooleanpovinné

groupIdstring | nullpovinné

byLocationbooleanpovinné

locationIdnull | stringpovinné

shortageValueHalerintegerpovinné

surplusValueHalerintegerpovinné

notestring | nullpovinné

lineCountintegerpovinné

countedCountintegerpovinné

differenceCountintegerpovinné

linesobject[]

object"stocktake_line"povinné

idstringpovinné

itemIdstringpovinné

itemNamestringpovinné

itemSkustringpovinné

unitnull | stringpovinné

lotIdnull | stringpovinné

lotCodenull | stringpovinné

locationIdnull | stringpovinné

locationCodenull | stringpovinné

frozenintegerpovinné

frozenValueHalerintegerpovinné

countednull | numberpovinné

differencenull | numberpovinné

unitCostHalerinteger | nullpovinné

withinNormbooleanpovinné

postedValueHalerinteger | nullpovinné

notestring | nullpovinné

POST/v1/stocktakes/{id}/post

curl -X POST https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "date": "2026-10-30",
  "treatUncountedAsFrozen": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "date": "2026-10-30",
    "treatUncountedAsFrozen": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/stocktakes/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/post",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "date": "2026-10-30",
        "treatUncountedAsFrozen": False
    },
)
data = response.json()

List supplier price list rows, by item or supplier

GET/v1/supplier-prices

List supplier price list rows, by item or supplier

Nástroj MCP: list-supplier-prices

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.

itemIdstring

ID of the item. Find it with list-items.

supplierIdstring

ID of the supplier.

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/supplier-prices

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

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

Add a row to a supplier's price list: price per the item's own unit, minimum order, pack size, lead time

POST/v1/supplier-prices

Add a row to a supplier's price list: price per the item's own unit, minimum order, pack size, lead time

Nástroj MCP: create-supplier-price

Tělo požadavku

supplierIdstringpovinné

ID of the supplier.

itemIdstringpovinné

ID of the item. Find it with list-items.

supplierSkustring | null

priceHalerintegerpovinnémin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

minQuantitynumbermin 0

packQuantitynumber | null

leadDaysinteger | null

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

Odpověď · 201

idstringpovinné

supplierIdstringpovinné

itemIdstringpovinné

supplierSkustring | nullpovinné

priceHalerintegerpovinné

currencystringpovinné

minQuantityintegerpovinné

packQuantityintegerpovinné

leadDaysinteger | nullpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

POST/v1/supplier-prices

curl -X POST https://api.damedoklad.cz/v1/supplier-prices \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "priceHaler": 1210000
}'

const response = await fetch('https://api.damedoklad.cz/v1/supplier-prices', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "supplierId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "priceHaler": 1210000
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/supplier-prices",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "supplierId": "obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "itemId": "itm_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "priceHaler": 1210000
    },
)
data = response.json()

Change a supplier price list row

PATCH/v1/supplier-prices/{id}

Change a supplier price list row

Nástroj MCP: update-supplier-price

Parametry v cestě

idstringpovinné

Tělo požadavku

supplierSkustring | null

priceHalerintegermin 0max 9007199254740991

Integer amount in haléře: 100 = 1 Kč.

currencystring3 chars

ISO 4217 currency code, for example CZK or EUR.

minQuantitynumbermin 0

packQuantitynumber | null

leadDaysinteger | null

validFromstring | null

Date as YYYY-MM-DD.

validTostring | null

Date as YYYY-MM-DD.

Odpověď · 200

idstringpovinné

supplierIdstringpovinné

itemIdstringpovinné

supplierSkustring | nullpovinné

priceHalerintegerpovinné

currencystringpovinné

minQuantityintegerpovinné

packQuantityintegerpovinné

leadDaysinteger | nullpovinné

validFromstring | nullpovinné

validTostring | nullpovinné

PATCH/v1/supplier-prices/{id}

curl -X PATCH https://api.damedoklad.cz/v1/supplier-prices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "supplierSku": "string",
  "priceHaler": 1210000,
  "currency": "CZK"
}'

const response = await fetch('https://api.damedoklad.cz/v1/supplier-prices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "supplierSku": "string",
    "priceHaler": 1210000,
    "currency": "CZK"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/supplier-prices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "supplierSku": "string",
        "priceHaler": 1210000,
        "currency": "CZK"
    },
)
data = response.json()

Delete a supplier price list row

DELETE/v1/supplier-prices/{id}

Delete a supplier price list row

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

Nástroj MCP: delete-supplier-price

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/supplier-prices/{id}

curl -X DELETE https://api.damedoklad.cz/v1/supplier-prices/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

List warehouse locations (regály)

GET/v1/warehouse-locations

List warehouse locations (regály)

Nástroj MCP: list-warehouse-locations

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.

warehouseIdstring

ID of the warehouse. Find it with list-warehouses.

Odpověď · 200

dataany[]povinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/warehouse-locations

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

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

Add a location (regál) to a warehouse

POST/v1/warehouse-locations

Add a location (regál) to a warehouse

Nástroj MCP: create-warehouse-location

Tělo požadavku

warehouseIdstringpovinné

ID of the warehouse. Find it with list-warehouses.

codestringpovinnémax 32 chars

namestring | null

isActiveboolean

Odpověď · 201

idstringpovinné

warehouseIdstringpovinné

codestringpovinné

namenull | stringpovinné

isActivebooleanpovinné

POST/v1/warehouse-locations

curl -X POST https://api.damedoklad.cz/v1/warehouse-locations \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/warehouse-locations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/warehouse-locations",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "warehouseId": "whs_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
        "code": "string"
    },
)
data = response.json()

Rename or deactivate a warehouse location

PATCH/v1/warehouse-locations/{id}

Rename or deactivate a warehouse location

Nástroj MCP: update-warehouse-location

Parametry v cestě

idstringpovinné

Tělo požadavku

codestringmax 32 chars

namestring | null

isActiveboolean

Odpověď · 200

idstringpovinné

warehouseIdstringpovinné

codestringpovinné

namenull | stringpovinné

isActivebooleanpovinné

PATCH/v1/warehouse-locations/{id}

curl -X PATCH https://api.damedoklad.cz/v1/warehouse-locations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "string",
  "name": "Pekárna U Lípy s.r.o.",
  "isActive": false
}'

const response = await fetch('https://api.damedoklad.cz/v1/warehouse-locations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "string",
    "name": "Pekárna U Lípy s.r.o.",
    "isActive": false
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/warehouse-locations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "code": "string",
        "name": "Pekárna U Lípy s.r.o.",
        "isActive": False
    },
)
data = response.json()

Delete an empty warehouse location that was never used. Used ones can be deactivated

DELETE/v1/warehouse-locations/{id}

Delete an empty warehouse location that was never used. Used ones can be deactivated

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

Nástroj MCP: delete-warehouse-location

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/warehouse-locations/{id}

curl -X DELETE https://api.damedoklad.cz/v1/warehouse-locations/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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

Seznam: sklady

GET/v1/warehouses

List warehouses

Nástroj MCP: list-warehouses

Parametry dotazu

limitintegermin 1max 500

offsetintegermin 0max 9007199254740991

searchstringmax 200 chars

Odpověď · 200

dataobject[]povinné

object"warehouse"povinné

idstringpovinné

namestringpovinné

codestringpovinné

analyticSuffixnull | stringpovinné

addressstring | nullpovinné

notestring | nullpovinné

isActivebooleanpovinné

isDefaultbooleanpovinné

totalinteger

Rows that match, on all pages.

hasMorebooleanpovinné

More rows follow. Ask again with offset + the number of rows received.

GET/v1/warehouses

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

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

Vytvoření: sklad

POST/v1/warehouses

Create a warehouse. An analytic suffix splits its stock accounts, for example 132001

Nástroj MCP: create-warehouse

Tělo požadavku

namestringpovinnémax 120 chars

codestringpovinnémax 32 chars

analyticSuffixstring | null

addressstring | null

notestring | null

isActiveboolean

isDefaultboolean

Odpověď · 201

idstringpovinné

namestringpovinné

codestringpovinné

analyticSuffixnull | stringpovinné

addressstring | nullpovinné

notestring | nullpovinné

isActivebooleanpovinné

isDefaultbooleanpovinné

POST/v1/warehouses

curl -X POST https://api.damedoklad.cz/v1/warehouses \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string"
}'

const response = await fetch('https://api.damedoklad.cz/v1/warehouses', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/warehouses",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string"
    },
)
data = response.json()

Detail: sklad

GET/v1/warehouses/{id}

Get a warehouse

Nástroj MCP: get-warehouse

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

analyticSuffixnull | stringpovinné

addressstring | nullpovinné

notestring | nullpovinné

isActivebooleanpovinné

isDefaultbooleanpovinné

GET/v1/warehouses/{id}

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

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

Úprava: sklad

PATCH/v1/warehouses/{id}

Update a warehouse. The analytic suffix can only change while the warehouse has never had stock movements posted.

Nástroj MCP: update-warehouse

Parametry v cestě

idstringpovinné

Tělo požadavku

namestringmax 120 chars

codestringmax 32 chars

analyticSuffixstring | null

addressstring | null

notestring | null

isActiveboolean

isDefaultboolean

Odpověď · 200

idstringpovinné

namestringpovinné

codestringpovinné

analyticSuffixnull | stringpovinné

addressstring | nullpovinné

notestring | nullpovinné

isActivebooleanpovinné

isDefaultbooleanpovinné

PATCH/v1/warehouses/{id}

curl -X PATCH https://api.damedoklad.cz/v1/warehouses/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Pekárna U Lípy s.r.o.",
  "code": "string",
  "analyticSuffix": "A1"
}'

const response = await fetch('https://api.damedoklad.cz/v1/warehouses/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DAMEDOKLAD_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Pekárna U Lípy s.r.o.",
    "code": "string",
    "analyticSuffix": "A1"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.damedoklad.cz/v1/warehouses/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "name": "Pekárna U Lípy s.r.o.",
        "code": "string",
        "analyticSuffix": "A1"
    },
)
data = response.json()

Smazání: sklad

DELETE/v1/warehouses/{id}

Delete a warehouse that was never used. Used warehouses can only be deactivated

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

Nástroj MCP: delete-warehouse

Parametry v cestě

idstringpovinné

Odpověď · 200

idstringpovinné

deletedbooleanpovinné

DELETE/v1/warehouses/{id}

curl -X DELETE https://api.damedoklad.cz/v1/warehouses/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"

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

import os
import requests

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