Stažení dokladu v PDF
GET
/api/v2/docs/{id}/pdfVrací binární soubor PDF s hlavičkami Content-Type: application/pdf a Content-Disposition: attachment. Název souboru odpovídá číslu dokladu, např. FV2026-1.pdf.
Faktura (včetně periodické faktury) se vytvoří ve formátu A4, případně ve vlastní tiskové šabloně firmy. Hotovostní doklad (cash) se vytvoří ve formátu účtenky. Jiné typy dokladů PDF nepodporují.
Úspěšná odpověď je PDF, chybové odpovědi (401, 403, 404) jsou JSON. Odpověď uložte přímo do souboru, např. u curl parametrem -o doklad.pdf, v JavaScriptu jako blob.
Autentizace a oprávnění
Vyžaduje API token: Bearer v hlavičce nebo URL token.
Parametry
Parametry cesty
| Název | Typ | Povinný | Popis | Příklad |
|---|---|---|---|---|
id | integer | ano | ID dokladu vaší firmy. | 1 |
Příklad požadavku
curl
curl -X GET 'https://www.elpokladny.cz/api/v2/docs/1/pdf' \
-H 'Authorization: Bearer elp_live_example.example_secret'PHP
<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/docs/1/pdf');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array (
0 => 'Authorization: Bearer elp_live_example.example_secret',
),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;javascript
const response = await fetch("https://www.elpokladny.cz/api/v2/docs/1/pdf", {
"method": "GET",
"headers": {
"Authorization": "Bearer elp_live_example.example_secret"
}
});
const data = await response.blob();Ukázkové odpovědi
PDF dokladu (HTTP 200)
application/pdf
Binární tělo PDF se nezobrazuje; uložte jej do souboru.
Chybí platný API token (HTTP 401)
application/json
{
"status": "error",
"message": "Unauthorized"
}
Možné chyby
| HTTP | Kdy | Podoba |
|---|---|---|
| 401 | Chybí nebo je neplatný API token. | status-message |
| 403 | API token se použil z IP adresy, která není u přístupu povolená, nebo je přístup odepřen. | status-message |
| 404 | Doklad s tímto ID neexistuje, je smazaný, nebo patří jiné firmě. | status-message |
| 500 | PDF se pro tento doklad nepodařilo vytvořit, například u typu dokladu, který PDF nepodporuje. |