HTML dokladu
/api/v2/docs/{id}/htmlVrací samostatný HTML dokument se styly, logem a QR kódem uvnitř, bez odkazů na jiné adresy. Můžete ho vytisknout nebo převést do PDF ve vlastním systému. Je to stejné HTML jako html z vystavení dokladu s options.html: true.
Účtenka (cash) má šířku 58 nebo 80 mm podle tiskárny v tiskové sestavě skladu uživatele, kterému patří API token. Bez tiskárny je 80 mm. Šířka se v požadavku nenastavuje. Faktura (včetně periodické) je A4, případně ve vlastní tiskové šabloně firmy. Jiné typy dokladů HTML nemají.
Hlavička X-Content-SHA256 nese otisk SHA-256 vráceného HTML. Server HTML neukládá, každé volání ho vytvoří znovu podle aktuálních údajů dokladu a firmy, takže po změně loga nebo šablony vrátí jiné HTML. Neměnnou podobu z okamžiku vystavení najdete v archivu dokladu. Hotové PDF bez archivu vrací stažení dokladu v PDF.
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, např. documents[].id z vystavení dokladu. | 18234 |
Příklad požadavku
curl
curl -X GET 'https://www.elpokladny.cz/api/v2/docs/18234/html' \
-H 'Authorization: Bearer elp_live_example.example_secret'PHP
<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/docs/18234/html');
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/18234/html", {
"method": "GET",
"headers": {
"Authorization": "Bearer elp_live_example.example_secret"
}
});
const data = await response.json();Ukázkové odpovědi
HTML dokladu (HTTP 200)
text/html; charset=UTF-8
<!DOCTYPE html>
<html lang="cs">...</html>
Doklad nenalezen (HTTP 404)
application/json
{
"status": "error",
"code": "not-found"
}
Typ dokladu nemá HTML (HTTP 422)
application/json
{
"status": "error",
"code": "unsupported-type",
"message": "Typ dokladu „order“ nemá HTML šablonu."
}
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ě (code not-found). | |
| 422 | Typ dokladu HTML nepodporuje (code unsupported-type), nebo se HTML nepodařilo vytvořit (render-failed). | status-message |