Číselné rady

Read-only prehľad číselných radov pre dokumenty.

Číselné rady definujú formát čísel dokumentov (FA260042, PO/2026/0007, atď.) a kedy sa resetujú (yearly / monthly / never). Endpoint je read-only – série vytvoríš a upravíš v UI v Nastaveniach. API ich poskytuje hlavne pre preview ďalšieho čísla. Zoznam vracia rovný zoznam (one flat array) radov naprieč typmi dokumentov, nie zoskupené podľa typu – ak potrebuješ iba jeden typ, filtruj si ich na strane klienta cez pole type.

Endpointy

GET/api/v1/seriesseries:read

Rovný zoznam (one flat array) všetkých číselných radov organizácie naprieč typmi dokumentov.

Request

curl "https://monivio.sk/api/v1/series" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": [
    {
      "id": "ser_2hf8pq3rxn4mlkzyt9abwvve",
      "version": 1,
      "name": "Faktúry 2026",
      "type": "invoice",
      "prefix": "FA",
      "format_pattern": "{prefix}{YY}{NNNN}",
      "next_number": "FA260042",
      "is_default": true,
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "total_pages": 1
  }
}

GET/api/v1/series/{seriesId}series:read

Detail jedného radu vrátane preview ďalšieho čísla.

Request

curl "https://monivio.sk/api/v1/series/{seriesId}" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": {
    "id": "ser_2hf8pq3rxn4mlkzyt9abwvve",
    "version": 1,
    "name": "Faktúry 2026",
    "type": "invoice",
    "prefix": "FA",
    "format_pattern": "{prefix}{YY}{NNNN}",
    "next_number": "FA260042",
    "is_default": true,
    "created_at": "2026-01-01T00:00:00.000Z"
  }
}

Objekt Series

idreadonly

string

Stabilný CUID2 identifikátor radu s prefixom ser_.

Príklad: ser_2hf8pq3rxn4mlkzyt9abwvve

versionreadonly

number

Číslo aktuálnej verzie. Pri každej zmene radu (cez UI) sa zvýši o 1.

Príklad: 1

name

string

Názov radu zobrazovaný v UI.

Príklad: Faktúry 2026

type

string

Typ dokumentu (invoice, quote, proforma, ...). Jeden rad = jeden typ dokumentu.

Príklad: invoice

prefix

string

Prefix čísla dokumentu (napr. FA, PO, FAK).

Príklad: FA

format_pattern

string

Vzor s placeholdermi {prefix}, {YY}, {YYYY}, {MM}, {NNNN}, {NNN}, {NNNNNN}.

Príklad: {prefix}{YY}{NNNN}

next_numberreadonly

string

Vygenerované ďalšie číslo na základe pattern-u + counter-u. Slúži na náhľad – skutočné číslo sa pridelí až pri vytvorení dokumentu.

Príklad: FA260042

is_default

boolean

Default rad pre daný typ dokumentu. Použije sa ak pri vytváraní dokumentu nešpecifikuješ rad explicitne.

created_atreadonly

string (ISO 8601)

Kedy bol rad vytvorený.