Přeskočit na hlavní obsah

Import EET certifikátů

Jak importovat EET certifikát přes REST API?

Autor: Petr Pech

EET certifikáty lze do ABRA Flexi importovat i přes REST API. Importovaný soubor musí obsahovat certifikát i privátní klíč.

🚨 Evidence elektronických evidencí tržeb byla v České republice zrušena a v aktuálních verzích ABRA Flexi je EET vypnutá. Služba proto vrací 500 s kódem eetDeactivated a hlášením EET není podporováno. — a to bez ohledu na zadané parametry. Popis níže se vztahuje ke starším verzím, ve kterých EET fungovala.


Způsob volání

Služba je dostupná na adrese /c/{firma}/certifikat-eet/import, kde {firma} je databázový identifikátor firmy. Volá se metodou PUT nebo POST; jiná metoda vrací 405 Method Not Allowed. Podporované výstupní formáty jsou XML a JSON.

Příklad volání

Tělem požadavku je samotný soubor s certifikátem:

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>

ℹ️ Jak takový požadavek poslat z příkazové řádky, popisuje článek import dat příkazovou řádkou.


Parametry

Oba parametry jsou povinné:

Parametr

Význam

heslo

Heslo k odemčení certifikátu.

provozovna

Označení EET provozovny.

Při špatném hesle a neplatné či chybějící provozovně operace skončí kódem 400.

Hlavička Content-Type

V hlavičce je nutné uvést Content-Type odpovídající formátu importovaného souboru:

MIME type

Formát souboru s certifikátem

application/x-pem-file

X.509 certifikáty v textovém PEM formátu — obvyklé přípony .pem, .cer, .cert, .crt.

application/x-pkcs12

Certifikáty ve formátu PKCS #12 — obvyklé přípony .p12, .pfx.

📝 Starší verze tohoto návodu uváděly navíc application/x-x509-ca-cert pro přípony .crt a .der a application/pkix-cert pro příponu .cer. Vývojářská dokumentace dnes textové X.509 certifikáty shrnuje pod application/x-pem-file.


Chybové stavy

Stav

Kód chyby

Příčina

500

eetDeactivated

EET je v dané verzi vypnutá — služba není k dispozici.

400

Špatné heslo k certifikátu nebo neplatná či chybějící provozovna.

405

Použitá HTTP metoda není PUT ani POST.


Související

Dostali jste odpověď na svou otázku?