Fakturowanie, które dzieje się samo
Podłączcie sklep internetowy, system rezerwacyjny, CRM lub własną aplikację. Jedno wywołanie wystawi fakturę, wyśle ją klientowi i zwróci PDF oraz e-fakturę.
curl -X POST https://www.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
}'Bezpieczeństwo
Klucz Bearer dla każdej firmy, przechowywany wyłącznie jako hash. Klucz można unieważnić w dowolnym momencie.
Idempotencja
Pole external_id gwarantuje, że ponowne wywołanie nie utworzy zduplikowanej faktury.
VAT automatycznie
Reżim VAT (odwrotne obciążenie, UE, zwolnienie) zaproponujemy według odbiorcy albo prześlą go Państwo w polu vat_regime.
Limity
Do 600 żądań na minutę (Profi) lub 6 000 (Business). Status w nagłówku X-RateLimit-Remaining.
Endpointy
Base URL: https://www.dsdata.sk/api/v1 · odpowiedzi w JSON · błędy zwracają 4xx z polem error.
| POST | \/invoices | Wystawia dokument (invoice, proforma, quote, credit_note) |
| GET | \/invoices | Lista dokumentów z filtrami i stronicowaniem |
| GET | \/invoices\/{id} | Szczegóły wraz z pozycjami, płatnościami i tekstami VAT |
| GET | \/invoices\/external\/{id} | Wyszukanie dokumentu według Państwa ID |
| PUT | \/invoices\/{id} | Edycja dokumentu |
| POST | \/invoices\/{id}\/payments | Płatność – w przypadku zaliczki powstanie dokument podatkowy |
| POST | \/invoices\/{id}\/send | Wysłanie e-mailem (PDF + XML) |
| GET | \/invoices\/{id}\/pdf | PDF dokumentu |
| GET | \/invoices\/{id}\/ubl | E-faktura Peppol BIS 3.0 |
| GET · POST | \/customers | Katalog klientów |
Ú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).