podpalcem GitHub
Pokladna propojená přes bránu s ověřením a serverem
OPEN SOURCE / MITbrána v0.2.0 · klienti v0.1.1

EET Gateway

EET 2.0 pro váš pokladní systém, bez ruční práce se SOAP a certifikáty.

Open source brána přijme tržbu přes jednoduché HTTP API a postará se o podpis, odeslání do EET, kontrolu odpovědi, opakování při výpadku a frontu.

Stáhnout z GitHubu Dokumentace

MIT licence · TypeScript · binárka nebo Docker · Releases a CHANGELOG

Zatím ověřeno jen na playgroundu.

S ostrým certifikátem v produkci zatím neověřeno. Nezávislý bezpečnostní audit zatím neproběhl. Neoficiální projekt, bez záruky. Certifikaci, registraci pokladny a soulad se zákonem si zajišťuje a za ně odpovídá každý provozovatel sám.

Kdy co platí.

  1. 17. 9. 2026

    Zákon podepsán

    Prezident podepsal zákon o evidenci tržeb, vyšel jako č. 180/2026 Sb.

  2. 1. 11. 2026

    Certifikáty a DIS+

    V daňové informační schránce DIS+ lze generovat pokladní certifikáty a připravit evidenci.

  3. 1. 12. 2026

    Aplikace MOJE EET

    Finanční správa spouští bezplatnou webovou aplikaci pro nejmenší podnikatele.

  4. 1. 1. 2027

    Povinnost evidovat

    Běžný provoz. Finanční správa avizuje leden jako pilotní měsíc s metodickou podporou, povinnost ale platí od prvního dne.

Podle harmonogramu Finanční správy a zákona č. 180/2026 Sb. Aktuální znění ověřte na eet.gov.cz.

Pro koho to je a co si odnést.

01

Vývojář pokladny

Nemusíte sami psát a udržovat komunikaci s EET. Váš systém mluví HTTP, brána řeší zbytek.

Quick start
02

Provozovatel s vlastní pokladnou

Bez cizího cloudu. Brána běží u vás, klíče a certifikáty zůstávají u vás.

Spustit přes Docker
pokladnaHTTP → EET Gateway podpis → EET

Co má brána pod palcem.

Jedno HTTP API

Pošlete tržbu a dostanete typovaný výsledek: přijato, ověřeno, zamítnuto, ve frontě, nejisté nebo neplatné. Popsáno v OpenAPI.

Idempotence

Každá tržba nese číslo účtenky. Opakované odeslání téže tržby nevytvoří duplicitu.

Fronta a opakování

Při výpadku EET se tržba uloží a odešle později podle daných pravidel. SQLite, žádná další služba.

Ověření odpovědi

Kontrola podpisu odpovědi a řetězu certifikátů. Ne jen kontrola, že přišlo HTTP 200.

Dávky a kontrola předem

Odeslání po dávkách v JSON, NDJSON, CSV nebo XML. Kontrola dat i bez odeslání do EET.

Přehled pokladen

Platnost certifikátů, stav fronty a zdravotní kontrola. Přepínač mezi playgroundem a produkcí.

První tržba za 5 minut.

nejdřív playground ↓
  1. 01 /

    Stáhněte bránu

    Binárka pro Linux, macOS nebo Windows, nebo veřejný Docker image. Návod na další způsoby spuštění je v repozitáři.

  2. 02 /

    Spusťte playground

    Nastavte API klíč a testovací certifikát podle dokumentace. Produkci zatím nemáme ověřenou.

  3. 03 /

    Pošlete první tržbu

    Jednoduchý POST na /v1/sales. Přesný požadavek a výsledky popisuje OpenAPI.

POST /v1/sales
curl -X POST http://localhost:8080/v1/sales \
  -H "Authorization: Bearer $EET_API_KEY" \
  -H "Idempotency-Key: R-1001" \
  -H "Content-Type: application/json" \
  -d '{"porad_cis":"R-1001","dat_trzby":"2026-10-30T12:00:00+01:00","celk_trzba":"123.50"}'
nebo přes Docker
docker run ghcr.io/hospodskej-cz/eet-2-0:0.2.0

odpověď — přijato (ilustrační ukázka)

200 · accepted
{
  "status": "accepted",
  "porad_cis": "R-1001",
  "pok": "3f9a1c…",
  "dat_odpovedi": "2026-10-30T12:00:01+01:00"
}

odpověď — neplatná data (ilustrační ukázka)

422 · invalid
{
  "status": "invalid",
  "issues": [
    { "field": "celk_trzba", "code": "invalid_format",
      "message": "očekáváno desetinné číslo s tečkou" }
  ]
}
Specifikace OpenAPI

Co když EET nejede.

Brána hlídá stav každé tržby místo „odešli a zapomeň“. Při výpadku se tržba zařadí do fronty a odešle, až EET ožije.

queued · ve frontěuncertain · nejistéaccepted · přijato

Idempotence: stejný klíč tržby = žádná dvojí evidence. Opakované odeslání téže účtenky vrátí původní výsledek, ne duplicitu.

Klienti pro váš jazyk.

Typovaní klienti v0.1.1 pro pět jazyků. Příkaz zkopírujete jedním klikem.

PHP

PHP 8.1+ · Composer

PHP
composer require hospodskej-cz/eet-gateway-client

Python

Python 3.9+ · PyPI

Python
pip install eet-gateway-client

C# / .NET

.NET 8 · NuGet

C# / .NET
dotnet add package EetGateway.Client

Java

Java 17+ · Maven Central, bez závislostí

Java
io.github.hospodskej-cz:eet-gateway-client:0.1.1

Node / Bun

npm · CLI i knihovny core, ingest, queue, server

Node / Bun
npm i @eet-gateway/cli

Docker

veřejný image v0.2.0

Docker
docker run ghcr.io/hospodskej-cz/eet-2-0:0.2.0
Klienti a instalační návodyReleases a CHANGELOG

Pro jiný jazyk lze klienta vygenerovat z OpenAPI.

Otevřený kód.
Dohledatelné vydání.

  • MIT licence, bez poplatků a bez vazby na cizí službu.
  • Binárky s kontrolními součty, SBOM a atestací původu. Podepsaný Docker image. Provenance npm balíčků platí od verze 0.2.1; první vydání 0.2.0 bylo publikované ručně.
  • Bezpečnostní přezkum a model hrozeb v repozitáři. Zranitelnosti hlaste soukromě přes GitHub.
  • Žádné soukromé klíče v repozitáři. Pouze veřejné certifikační autority a testovací certifikáty playgroundu.
Bezpečnost a hlášení zranitelností

Stav a omezení.
Říkáme to na rovinu.

Playground ≠ produkce
Ověřeno proti playgroundu EET 2.0. S ostrým certifikátem v produkci zatím neověřeno.
Bez nezávislého auditu
Externí bezpečnostní audit zatím neproběhl. Příprava je popsaná v docs/AUDIT.md.
Verze 0.x
API /v1 může ještě projít úpravami. Pravidla jsou v docs/STABILITY.md, plán v ROADMAP.md.
Závislost transportu
Komunikaci s EET zajišťuje @finitoapp/eet-client (MIT, jeden správce). Rozhodnutí a rizika popisuje ADR-004.
11 operací API4 jazykoví klientiověřeno proti playgroundu 25. 10. 2026CI na každém commitupodepsané binárky a image

Podrobnosti o živém ověření: docs/SPEC_NOTES.md

hledáme první piloty

Chcete to ověřit s námi v produkci?

Hledáme 2 až 3 provozovatele s produkčním certifikátem, kteří bránu s námi ověří na ostrém provozu. Ozvěte se — rádi se domluvíme.

Napsat na WhatsAppGitHub Discussions — téma Pilot Roadmap

Ještě něco?

Je to oficiální nástroj Ministerstva financí nebo Finanční správy?

Ne. Je to nezávislý open source projekt bez jakékoli záruky.

Zařídí to za mě certifikaci a registraci pokladny?

Ne. Certifikát, registraci pokladny a soulad se zákonem si zajišťuje a za ně odpovídá každý provozovatel.

Co když je EET nedostupné?

Tržba se uloží do fronty a brána ji odešle později podle daných pravidel. Mezitím ji uvidíte ve stavu ve frontě nebo nejistá, takže nic nezmizí a nic se nepošle dvakrát.

Jak se napojím z PHP, Javy, .NET nebo Pythonu?

Hotovými klienty — instalační příkazy jsou výše v sekci Klienti. Pro jiný jazyk lze klienta vygenerovat z OpenAPI.

Kdo to udržuje a co když projekt zanikne?

Spravuje ho tým Pod Palcem a přispěvatelé. Licence MIT znamená, že zdrojový kód je váš — můžete ho forkovat a udržovat sami. Pravidla správy popisuje GOVERNANCE.md.

Co když Finanční správa změní rozhraní?

API brány je verzované (/v1). Pravidla kompatibility a postup při změnách popisuje docs/STABILITY.md.

Je to náhrada za certifikaci pokladny?

Ne. Brána řeší jen komunikaci s EET. Certifikát, registraci a soulad se zákonem si zajišťuje provozovatel.

Musím používat Docker?

Ne. Stačí jedna binárka pro podporovaný systém. Docker image je k dispozici jako jedna z možností.

Kam posílat chyby a nápady?

Do Issues a Discussions na GitHubu. Bezpečnostní nálezy hlaste soukromě podle SECURITY.md.

Můžu to použít komerčně?

Ano, MIT licence to dovoluje. Poznámky k závislostem jsou v THIRD_PARTY_NOTICES.md.

volně k použití, otevřeně k vývoji

Vyzkoušejte to na playgroundu.

A řekněte nám, co vám chybí.

Stáhnout Zdrojový kódDiscussions