Nezávislá služba, není provozována Finanční správou.

EvidujZdarma
Chci zdarma

EET 2.0 ve vašem systému za jeden den

REST API pro hotelová PMS, rezervační systémy a fakturaci. Pošlete platbu jako JSON – podpis, komunikaci s Finanční správou, frontu při výpadku a vratky řešíme my. POK vrátíme hned, nebo webhookem.
Chci pilotní přístupDokumentace API

Co nemusíte programovat

Podpis a SOAP

XML podpis certifikátem klienta, WS-Security, ověření odpovědi Finanční správy a POK. U nás jedno volání JSON.

Výpadky a 48 hodin

Fronta s opakováním podle pravidel FS (nové UUID, prvni_zaslani=false) a upozornění, než vyprší 48 hodin.

Certifikáty klientů

Klient nahraje svůj pokladní certifikát u nás. Vy ho nikdy nevidíte a nemusíte ho bezpečně ukládat.

Vratky a uzávěrky

Částečné i úplné vratky s kontrolou proti originálu, denní přehled podle jednotky, způsobu platby a DPH.

Jak to funguje

  1. Krok 1

    Vyzkoušejte v Playgroundu

    Testovací token si vytvoříte sami v pokladně (Integrace). Tržby jdou do testovacího prostředí Finanční správy, POK končí na „ff“.

  2. Krok 2

    Připojte klienty jedním klikem

    Tlačítko „Připojit EvidujZdarma“ ve vašem systému: podnikatel se přihlásí, vybere provozovny a povolí přístup (OAuth 2.0 + PKCE).

  3. Krok 3

    Posílejte platby z místa

    Každou platbu na recepci nebo u pultu pošlete POST /v1/sales. Do ~2,5 s vrátíme POK, jinak stav „ve frontě“ a webhook.

  4. Krok 4

    Tiskněte údaje na doklad

    Odpověď obsahuje vše pro doklad: POK, čas, jednotku, pořadové číslo, rozpis DPH, případně odkaz na doklad.

curl -X POST https://evidujzdarma.cz/api/v1/sales \
  -H "Authorization: Bearer ezk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"sales":[{"id":"6f1c…","externalRef":"REZ-2027-0042","unitId":"…",
       "soldAt":"2027-01-02T08:10:00+01:00",
       "lines":[{"name":"Ubytování 2 noci","qty":1,"unitPrice":320000,"vatRate":12}],
       "payments":[{"method":"card","amount":320000}]}]}'

→ {"results":[{"status":"confirmed","pok":"…","evidencedAmount":320000,"receipt":{…}}]}

Co API umí

  • REST API /v1 s OpenAPI 3.1 a dokumentací v češtině
  • Idempotence podle vašeho ID platby a externalRef
  • Webhooky s podpisem HMAC: potvrzeno, odmítnuto, blíží se 48 h, končí certifikát
  • Vratky, denní přehledy, stav jednotek a certifikátů
  • Playground Finanční správy zdarma, testovací tokeny bez schvalování
  • Stejná evidence a fronta jako v naší pokladně – žádná zvláštní cesta

Pro hotelová PMS a penziony

Evidují se jen platby přijaté na místě. Pravidla podle našeho návodu EET u ubytování:

Platba v PMSEET 2.0
Záloha převodem, platební bránou, přes Booking nebo Airbnb onlineNeeviduje se – vzdálená platba
Záloha nebo doplatek zaplacený na recepci (hotovost, karta, QR)Eviduje se – každá platba zvlášť
Minibar, wellness, parkování placené na místěEviduje se
Vratná kauce – složení a vráceníNeeviduje se; jen ponechaná část kauce složené na místě
Storno nebo vrácení peněz na místěVratka přes API

Místní poplatek z pobytu Finanční správa zatím podrobně nevysvětlila – v API je to nastavení na straně ubytovatele.

Časté otázky

Kdo odpovídá Finanční správě za evidenci?

Podnikatel (poplatník). Tržba jde pod jeho EIČ, z jeho evidenční jednotky a s jeho pokladním certifikátem. EvidujZdarma je technický nástroj, který zprávu podepíše, odešle, opakuje a vrátí výsledek.

Uvidí náš systém certifikát klienta?

Ne. Klient nahraje pokladní certifikát přímo do EvidujZdarma. Váš systém dostane jen token s oprávněními, který klient může kdykoli odpojit.

Co když Finanční správa neodpoví?

Prodej se neblokuje. Tržba čeká ve frontě, odešle se znovu podle pravidel FS a výsledek dostanete webhookem. Pokud se blíží lhůta 48 hodin, pošleme událost sale.deadline_soon.

Kolik to stojí?

Testování v Playgroundu je zdarma. Ostrý provoz od 990 Kč měsíčně podle počtu aktivních evidenčních jednotek – přesnou nabídku pošleme e-mailem.

Odkdy jde ostrý provoz?

Produkční prostředí Finanční správy přijímá tržby v přechodném režimu od 1. 11. 2026, povinně od 1. 1. 2027. Ostrý přístup k API zapínáme partnerům po podpisu smlouvy v pilotním provozu.

Funguje to i pro rezervační systémy a fakturaci?

Ano. Evidují se jen platby přijaté při osobním kontaktu nebo v provozovně (hotovost, karta, QR na místě). Platby převodem na fakturu nebo přes platební bránu se neevidují – API je přijme jako neevidované, nebo je neposíláte vůbec.

Provozuje Swipe Scape s.r.o., IČO 22269134. Nezávislá služba, není provozována Finanční správou.

Předregistrovat se zdarma