Preskoči na glavno vsebino

Import EET certifikátov

Ako importovať EET certifikát cez REST API?

Avtor: Petr Pech

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

Heslo na odomknutie certifikátu.

provozovna

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

application/x-pem-file

X.509 certifikáty v textovom PEM formáte — obvyklé prípony .pem, .cer, .cert, .crt.

application/x-pkcs12

Certifikáty vo formáte PKCS #12 — obvyklé prípony .p12, .pfx.

📝 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

500

eetDeactivated

EET je v danej verzii vypnuté — služba nie je k dispozícii.

400

—

Nesprávne heslo k certifikátu alebo neplatná či chýbajúca prevádzka.

405

—

Použitá HTTP metóda nie je PUT ani POST.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?