EET certifikáty je možné do ABRA Flexi importovať aj cez REST API. Importovaný súbor musí obsahovať certifikát aj privátny kľúč.
🚨 Evidencia elektronických evidencií tržieb bola v Českej republike zrušená a v aktuálnych verziách ABRA Flexi je EET vypnuté. Služba preto vracia 500 s kódom eetDeactivated a hlásením EET nie je podporované. — a to bez ohľadu na zadané parametre. Popis nižšie sa vzťahuje na staršie verzie, v ktorých EET fungovalo.
Spôsob volania
Služba je dostupná na adrese /c/{firma}/certifikat-eet/import, kde {firma} je databázový identifikátor firmy. Volá sa metódou PUT alebo POST; iná metóda vracia 405 Method Not Allowed. Podporované výstupné formáty sú XML a JSON.
Príklad volania
Telom požiadavky je samotný súbor s certifikátom:
PUT https://demo.flexibee.eu/c/demo/certifikat-eet/import.json?heslo={heslo}&provozovna={provozovna}
Content-Type: application/x-pkcs12
Accept: application/json
<binární obsah souboru s certifikátem>
ℹ️ Ako takúto požiadavku poslať z príkazového riadku, popisuje článok import dát príkazovým riadkom.
Parametre
Oba parametre sú povinné:
Parameter | Význam |
| Heslo na odomknutie certifikátu. |
| Označenie EET prevádzky. |
Pri nesprávnom hesle a neplatnej či chýbajúcej prevádzke operácia skončí kódom 400.
Hlavička Content-Type
V hlavičke je nutné uviesť Content-Type zodpovedajúci formátu importovaného súboru:
MIME type | Formát súboru s certifikátom |
| X.509 certifikáty v textovom PEM formáte — obvyklé prípony |
| Certifikáty vo formáte PKCS #12 — obvyklé prípony |
📝 Staršie verzie tohto návodu uvádzali navyše application/x-x509-ca-cert pre prípony .crt a .der a application/pkix-cert pre príponu .cer. Vývojárska dokumentácia dnes textové X.509 certifikáty zhŕňa pod application/x-pem-file.
Chybové stavy
Stav | Kód chyby | Príčina |
|
| EET je v danej verzii vypnuté — služba nie je k dispozícii. |
| — | Nesprávne heslo k certifikátu alebo neplatná či chýbajúca prevádzka. |
| — | Použitá HTTP metóda nie je |
