REST API v1
Fakturácia, ktorá sa deje sama
Napojte e-shop, rezervačný systém, CRM alebo vlastnú aplikáciu. Jedno volanie vystaví faktúru, pošle ju klientovi a vráti PDF aj e-faktúru.
cURL
curl -X POST https://faktury.dsdata.sk/api/v1/invoices \
-H "Authorization: Bearer uk_…" \
-H "Content-Type: application/json" \
-d '{
"type": "invoice",
"external_id": "objednavka-10045",
"customer": { "company_id": "36631124",
"name": "Slovenská pošta, a.s." },
"items": [{ "name": "Tonery", "quantity": 4,
"unit_price": 39.90, "vat_rate": 23 }],
"mark_paid": true, "send_email": true
}'Bezpečnosť
Bearer kľúč pre každú firmu, uložený len ako hash. Kľúč kedykoľvek zneplatníte.
Idempotencia
Pole external_id zaručí, že opakované volanie nevytvorí duplicitnú faktúru.
DPH automaticky
Režim DPH (prenesenie, EÚ, oslobodenie) navrhneme podľa odberateľa, alebo ho pošlete v poli vat_regime.
Limity
Do 600 požiadaviek za minútu (Profi) alebo 6 000 (Business). Stav v hlavičke X-RateLimit-Remaining.
Endpointy
Base URL: https://faktury.dsdata.sk/api/v1 · odpovede v JSON · chyby vracajú 4xx s poľom error.
| POST | /invoices | Vystaví doklad (invoice, proforma, quote, credit_note) |
| GET | /invoices | Zoznam dokladov s filtrami a stránkovaním |
| GET | /invoices/{id} | Detail vrátane položiek, platieb a textov DPH |
| GET | /invoices/external/{id} | Nájdenie dokladu podľa vášho ID |
| PUT | /invoices/{id} | Úprava dokladu |
| POST | /invoices/{id}/payments | Úhrada – pri zálohe vznikne daňový doklad |
| POST | /invoices/{id}/send | Odoslanie e-mailom (PDF + XML) |
| GET | /invoices/{id}/pdf | PDF dokladu |
| GET | /invoices/{id}/ubl | E-faktúra Peppol BIS 3.0 |
| GET · POST | /customers | Adresár klientov |
Úplnú dokumentáciu s príkladmi nájdete po prihlásení v časti Nastavenia → API. REST API je súčasťou balíka Business (30 dní zadarmo na vyskúšanie).