API pro vývojáře
Úvod do REST API invo.space, základní adresa https://invo.space/api/v2, formát JSON, stránkování, chyby a přehled zdrojů.
invo.space má REST API, přes které napojíte e-shop, účetnictví nebo vlastní skripty. Základní adresa je https://invo.space/api/v2, data se posílají v JSON a přihlašujete se tokenem v hlavičce Authorization: Bearer.
Podrobnou referenci všech endpointů připravujeme. Bude vygenerovaná přímo z popisu API, aby vždy odpovídala skutečnosti. Do té doby tady najdete principy, autentizaci a přehled zdrojů.
Rychlý start
- V Nastavení > API a webhooky vytvořte token, viz Autentizace.
- Pošlete první požadavek:
curl https://invo.space/api/v2/invoices?year=2026 \
-H "Authorization: Bearer VAS_TOKEN"Formát
- Požadavky i odpovědi jsou v JSON (
Content-Type: application/json). Nahrání souborů používámultipart/form-data. - Úspěšná odpověď vrací data přímo, bez obálky. Vytvoření obvykle vrací
201, úpravy často204bez těla. - Data a časy jsou ve formátu ISO 8601 s časovou zónou, například
2026-11-03T00:00:00+01:00. - Peněžní částky mají tvar objektu s částkou v haléřích (nejmenší jednotce měny) jako řetězcem a kódem měny:
{ "amount": "1694000", "currency": "CZK" }Stránkování a řazení
Seznamy, které stránkování podporují, přijímají parametry limit a offset a vracejí objekt s daty a celkovým počtem:
{ "data": [], "total": 27 }Řazení nastavíte parametrem orderBy, například orderBy=id:desc,name:asc.
Seznamy faktur, výzev k platbě a nákladů se nestránkují. Filtrujete je podle období parametry year a month.
Chyby
Chyby vracíme ve formátu application/problem+json:
{
"type": "https://developers.invo.space/docs/errors/...",
"status": 403,
"code": 40302,
"title": "...",
"detail": "..."
}Pole code je strojově čitelný kód chyby. Nejčastější kódy:
| HTTP | Kód | Význam |
|---|---|---|
| 400 | 40001 | Neplatný JSON v těle požadavku |
| 400 | 40099 | Neplatné údaje |
| 400 | 40014 | Datum vystavení nesedí s rokem v čísle dokladu |
| 401 | 40101 až 40109 | Chybí, je neplatný, nebo byl zneplatněn token, viz Autentizace |
| 403 | 40301 | Na akci nemáte oprávnění, nebo je modul vypnutý |
| 403 | 40302 | Účet nemá aktivní předplatné, zápisy jsou zablokované |
| 404 | 40401 | Záznam nebyl nalezen |
| 404 | 40402 | Subjekt s daným IČ nebyl nalezen v rejstříku |
| 409 | 40013 | Záznam už existuje |
| 503 | 50302 | Externí služba (třeba ARES) je dočasně nedostupná |
Při údržbě systému vrací API stav 503.
Předplatné a moduly
- Bez aktivního předplatného jde API jen číst. Požadavky
POST,PUT,PATCHaDELETEvrátí403s kódem40302. - Endpointy modulů (pokladna, katalog, sklad, e-shop) fungují, jen když má účet modul zapnutý.
Přehled zdrojů
| Oblast | Cesty |
|---|---|
| Doklady | /invoices, /paid-invoices, /invoice-submissions, /orders, /paid-orders, /order-submissions, /expenses, /paid-expenses, /simple-expenses, /export |
| Kontakty | /contacts, /ares |
| Banka | /bank, /bank-accounts |
| Pokladna a EET 2.0 | /receipts, /eet, /eet-certificates, /eet-submissions |
| Katalog | /products, /categories, /skus, /parameters, /variant-axes |
| Sklad | /warehouses, /stock-items, /moves, /stock-transfers |
| E-shop | /delivery-methods, /pickup-points, /payment-methods, /storefront-tokens |
| Nastavení a účet | /settings, /document-sequences, /users, /currencies, /tax-rates, /subscriptions |
| Webhooky | /webhooks, viz Webhooky |
Všechny cesty jsou relativní k https://invo.space/api/v2. Pro web e-shopu je samostatné storefront API.