Invoicing that happens by itself
Connect your e-shop, booking system, CRM or custom application. A single call issues an invoice, sends it to the client and returns both the PDF and the e-invoice.
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
}'Security
Bearer key for each company, stored only as a hash. You can invalidate the key at any time.
Idempotency
The external_id field ensures that a repeated call does not create a duplicate invoice.
VAT automatically
We will suggest the VAT regime (reverse charge, EU, exemption) based on the customer, or you can send it in the vat_regime field.
Limits
Up to 600 requests per minute (Profi) or 6 000 (Business). Status in the X-RateLimit-Remaining header.
Endpoints
Base URL: https://faktury.dsdata.sk/api/v1 · odpovede v JSON · chyby vracajú 4xx s poľom error.
| POST | /invoices | Issues a document (invoice, proforma, quote, credit_note) |
| GET | /invoices | List of documents with filters and pagination |
| GET | \/invoices\/{id} | Detail including items, payments and VAT texts |
| GET | \/invoices\/external\/{id} | Find a document by your ID |
| PUT | \/invoices\/{id} | Edit document |
| POST | \/invoices\/{id}\/payments | Payment – for an advance payment, a tax document is generated |
| POST | \/invoices\/{id}\/send | Send by email (PDF + XML) |
| GET | \/invoices\/{id}\/pdf | Document PDF |
| GET | \/invoices\/{id}\/ubl | Peppol BIS 3.0 e-invoice |
| GET · POST | \/customers | Customer directory |
Ú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).