# Číselné řady · API DameDokladu

> Operace ve skupině Číselné řady.

Source: https://damedoklad.cz/docs/api-reference/series/

# Číselné řady

Operace ve skupině Číselné řady.

## Seznam: číselné řady

GET `/v1/series`

List number series. Every issued document takes its number from one, per accounting period

Nástroj MCP: `list-series`

### Parametry dotazu

`periodId` string

Only series of this accounting period.

`documentType` string

For example invoice, proforma, credit\_note, delivery\_note, received\_invoice.

`limit` integer min 1 max 500

`offset` integer min 0 max 9007199254740991

`search` string max 200 chars

### Odpověď · 200

`data` object\[\] povinné

`object` "series" povinné

`id` string povinné

`name` string povinné

`documentType` string povinné

`prefix` string povinné

`includeYear` string povinné

`pad` integer povinné

`nextNumber` integer povinné

`periodId` string povinné

`periodName` string povinné

`isDefault` boolean povinné

`isSystem` boolean povinné

`isActive` boolean povinné

`preview` string povinné

`total` integer

Rows that match, on all pages.

`hasMore` boolean povinné

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

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

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

```python
import os
import requests

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

## Vytvoření: číselná řada

POST `/v1/series`

Create a number series for a document type and accounting period

Nástroj MCP: `create-series`

### Tělo požadavku

`name` string max 80 chars

`documentType` "issued\_invoice" | "credit\_note" | "proforma" | "delivery\_note" | "received\_invoice" | "set\_off" | "service\_job" povinné

`prefix` string povinné max 8 chars

`includeYear` "yyyy" | "yy" | "none"

`pad` integer min 3 max 6

`nextNumber` integer min 1 max 999999

`periodId` string

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

`isDefault` boolean

`isActive` boolean

### Odpověď · 201

`id` string povinné

`name` string povinné

`documentType` string povinné

`prefix` string povinné

`includeYear` string povinné

`pad` integer povinné

`nextNumber` integer povinné

`periodId` string povinné

`periodName` string povinné

`isDefault` boolean povinné

`isSystem` boolean povinné

`isActive` boolean povinné

`preview` string povinné

```bash
curl -X POST https://api.damedoklad.cz/v1/series \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentType": "issued_invoice",
  "prefix": "string"
}'
```

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

```python
import os
import requests

response = requests.post(
    "https://api.damedoklad.cz/v1/series",
    headers={"Authorization": f"Bearer {os.environ['DAMEDOKLAD_API_KEY']}"},
    json={
        "documentType": "issued_invoice",
        "prefix": "string"
    },
)
data = response.json()
```

## Detail: číselná řada

GET `/v1/series/{id}`

Get a number series, with a preview of the next number

Nástroj MCP: `get-series`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`name` string povinné

`documentType` string povinné

`prefix` string povinné

`includeYear` string povinné

`pad` integer povinné

`nextNumber` integer povinné

`periodId` string povinné

`periodName` string povinné

`isDefault` boolean povinné

`isSystem` boolean povinné

`isActive` boolean povinné

`preview` string povinné

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

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

```python
import os
import requests

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

## Úprava: číselná řada

PATCH `/v1/series/{id}`

Update a number series. Numbers already issued do not change

Nástroj MCP: `update-series`

### Parametry v cestě

`id` string povinné

### Tělo požadavku

`name` string max 80 chars

`prefix` string max 8 chars

`includeYear` "yyyy" | "yy" | "none"

`pad` integer min 3 max 6

`nextNumber` integer min 1 max 999999

`isDefault` boolean

`isActive` boolean

### Odpověď · 200

`id` string povinné

`name` string povinné

`documentType` string povinné

`prefix` string povinné

`includeYear` string povinné

`pad` integer povinné

`nextNumber` integer povinné

`periodId` string povinné

`periodName` string povinné

`isDefault` boolean povinné

`isSystem` boolean povinné

`isActive` boolean povinné

`preview` string povinné

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

```javascript
const response = await fetch('https://api.damedoklad.cz/v1/series/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.",
    "prefix": "string",
    "includeYear": "yyyy"
  }),
});
const data = await response.json();
```

```python
import os
import requests

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

## Smazání: číselná řada

DELETE `/v1/series/{id}`

Delete a number series that has not issued any number

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

Nástroj MCP: `delete-series`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`deleted` boolean povinné

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

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

```python
import os
import requests

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

## Detail: mezery, číselná řada

GET `/v1/series/{id}/gaps`

Find gaps in the numbers a series has issued. Tax documents should run without gaps

Nástroj MCP: `get-series-gaps`

### Parametry v cestě

`id` string povinné

### Odpověď · 200

`id` string povinné

`from` integer povinné

`to` integer povinné

`missing` integer\[\] povinné

`used` integer\[\] povinné

```bash
curl https://api.damedoklad.cz/v1/series/obj_2n9F4kT7wQ1xYz0aBcDeFgHiJkL/gaps \
  -H "Authorization: Bearer $DAMEDOKLAD_API_KEY"
```

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

```python
import os
import requests

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