Számlázás, ami magától történik
Kapcsolja össze webáruházát, foglalási rendszerét, CRM-jét vagy saját alkalmazását. Egyetlen hívás kiállítja a számlát, elküldi az ügyfélnek, és visszaadja a PDF-et és az e-számlát is.
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
}'Biztonság
Bearer-kulcs minden céghez, csak hashként tárolva. A kulcsot bármikor érvénytelenítheti.
Idempotencia
Az external_id mező garantálja, hogy az ismételt hívás ne hozzon létre duplikált számlát.
HÉA automatikusan
A HÉA-rendszert (fordított adózás, EU, mentesség) a vevő alapján javasoljuk, vagy elküldheti a vat_regime mezőben.
Korlátok
Legfeljebb 600 kérés percenként (Profi) vagy 6 000 (Business). Az állapot az X-RateLimit-Remaining fejlécben.
Végpontok
Base URL: https://www.dsdata.sk/api/v1 · válaszok JSON-ban · a hibák 4xx értéket adnak vissza error mezővel.
| POST | /invoices | Bizonylatot állít ki (invoice, proforma, quote, credit_note) |
| GET | /invoices | Bizonylatok listája szűrőkkel és lapozással |
| GET | \/invoices\/{id} | Részletek a tételekkel, fizetésekkel és áfaszövegekkel együtt |
| GET | \/invoices\/external\/{id} | Bizonylat keresése az Ön azonosítója alapján |
| PUT | \/invoices\/{id} | Bizonylat módosítása |
| POST | \/invoices\/{id}\/payments | Befizetés – előleg esetén adóügyi bizonylat jön létre |
| POST | \/invoices\/{id}\/send | Küldés e-mailben (PDF + XML) |
| GET | \/invoices\/{id}\/pdf | A bizonylat PDF-je |
| GET | \/invoices\/{id}\/ubl | Peppol BIS 3.0 e-számla |
| GET · POST | \/customers | Ügyféljegyzék |
Ú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).