Faktúry a predfaktúry
Vytvorenie dokladu, vlastné dátumy, platobné symboly a položky s DPH.
Fakturačné REST API
Vaša aplikácia predáva. Dokly fakturuje.
Napojte e-shop, SaaS produkt alebo interný systém na jedno API pre doklady, PDF, e-maily, úhrady a odberateľov.
create-invoice.sh
curl -X POST https://api.dokly.sk/api/v1/documents \
-H "Authorization: Bearer dokly_..." \
-H "Content-Type: application/json" \
-d '{
"type": "invoice",
"external_id": "order-22531",
"number_series_code": "invoice",
"items": [{
"name": "Mesačné predplatné",
"quantity": "1",
"unit_price": "39.00",
"tax_rate": "23"
}]
}'201 Created · total: 47.97 EUR
Jedna integrácia
Celý životný cyklus dokladu.
Od prvého odberateľa po dobropis a úhradu. API používa predvídateľné JSON odpovede, ULID identifikátory a štandardné HTTP stavy.
Dobropisy a storno
Úplné aj čiastočné dobropisy s kontrolou maximálnej opravovanej sumy.
PDF a e-mail
Vygenerovanie PDF, stiahnutie a asynchrónne odoslanie klientovi.
Odberatelia
Voliteľný adresár s vyhľadávaním a historickou snímkou údajov na doklade.
Úhrady
Čiastočné a úplné platby s automatickým prepočtom zostatku.
Číselné rady
Samostatné série pre projekty s vlastným formátom a bezpečným prideľovaním čísla.
Bezpečné opakovanie
Objednávka vytvorí faktúru iba raz.
Pošlite identifikátor objednávky ako external_id. Ak váš systém požiadavku zopakuje, Dokly vráti pôvodný doklad bez duplicity a bez spotrebovania ďalšieho čísla.
- Bearer autentifikácia
- Kľúč patrí organizácii a môžete ho okamžite zrušiť.
- 120 požiadaviek/min
- Limit sa vyhodnocuje samostatne pre každý API kľúč.
- Izolácia organizácií
- Dotaz nikdy nevráti dáta inej firmy.
- Validačné chyby
- Konkrétne polia nájdete v štandardnej JSON odpovedi.
Časté otázky
Integrácia fakturačného API.
Ako sa API autentifikuje?+
Každá požiadavka používa Bearer API kľúč patriaci jednej organizácii. V databáze je uložený iba jeho bezpečný hash.
Ako Dokly zabráni duplicitnej faktúre?+
Pri vytvorení dokladu môžete poslať vlastné external_id. Opakovaná požiadavka s rovnakou hodnotou vráti existujúci doklad a nespotrebuje nové číslo.
Dá sa cez API odoslať aj PDF?+
Áno. API vie PDF vytvoriť, vrátiť na stiahnutie a zaradiť e-mail s dokladom klientovi.
Sú dáta jednotlivých firiem oddelené?+
Áno. API kľúč vždy sprístupní iba číselné rady, odberateľov, doklady a úhrady svojej organizácie.
Pozrite si endpointy a príklady.
Verejná dokumentácia obsahuje requesty, odpovede aj chybové stavy.