PHPackages slevomat/eet-client - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. slevomat/eet-client AbandonedArchivedLibrary[Utility & Helpers](/categories/utility) slevomat/eet-client =================== Client for electronic records of sales (EET) in Czech republic 2.2.0(5y ago)93288.7k↓35.6%19MITPHPPHP ^7.2 || ^8.0 Since Nov 9Pushed 4y ago7 watchersCompare [ Source](https://github.com/slevomat/eet-client)[ Packagist](https://packagist.org/packages/slevomat/eet-client)[ RSS](/packages/slevomat-eet-client/feed)WikiDiscussions master Synced 1w ago READMEChangelog (10)Dependencies (12)Versions (12)Used By (0) Client for EET - Elektronická evidence tržeb ============================================ [](#client-for-eet---elektronická-evidence-tržeb) [![Build status](https://github.com/slevomat/eet-client/workflows/Build/badge.svg?branch=master)](https://github.com/slevomat/eet-client/actions?query=workflow%3ABuild+branch%3Amaster)[![Code coverage](https://camo.githubusercontent.com/1c33e9fcd74be8437822dce11ced979e958de70cfcd0ae09b647dedddcda804f/68747470733a2f2f636f6465636f762e696f2f67682f736c65766f6d61742f6565742d636c69656e742f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/slevomat/eet-client)[![Latest Stable Version](https://camo.githubusercontent.com/0db169688f807dc533876a59a9b71f1f5463b5566845b0814247d1968dfe885c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736c65766f6d61742f6565742d636c69656e742e737667)](https://packagist.org/packages/slevomat/eet-client)[![Composer Downloads](https://camo.githubusercontent.com/891b5cb2d7a79f8eb8d77686d81f5f73904ea3437179f783a8eb3361a95d632a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736c65766f6d61742f6565742d636c69656e742e737667)](https://packagist.org/packages/slevomat/eet-client) This repository provides a client library for electronic record of sales (EET) required by czech law. Tento repozitář obsahuje klientskou knihovnu pro elektronickou evidenci tržeb (EET) - [EET website](http://www.etrzby.cz) Instalace --------- [](#instalace) Nejlepší způsob jak slevomat/eet-client nainstalovat je pomocí [Composeru](http://getcomposer.org/): ``` > composer require slevomat/eet-client ``` Použití ------- [](#použití) **POZOR**: Všechny částky jsou uváděny v setinách měny. Tedy pokud chcete odeslat tržbu 55.5 Kč, vložíte do třídy `Receipt` hodnotu jako integer 5550. ``` $crypto = new CryptographyService('cesta k privátnímu klíči', 'cesta k veřejnému klíči', 'heslo privátního klíče (nebo prázdný string pokud bez hesla)'); $configuration = new Configuration( 'DIČ poplatníka', 'Identifikace provozovny ', 'Identifikace pokladního zařízení', EvidenceEnvironment::get(EvidenceEnvironment::PLAYGROUND), // nebo EvidenceEnvironment::get(EvidenceEnvironment::PRODUCTION) pro komunikaci s produkčním systémem false // zda zasílat účtenky v ověřovacím módu ); $client = new Client($crypto, $configuration, new GuzzleSoapClientDriver(new \GuzzleHttp\Client())); $receipt = new Receipt( true, 'CZ683555118', '0/6460/ZQ42', new \DateTimeImmutable('2016-11-01 00:30:12'), 3411300 ); try { $response = $client->send($receipt); echo $response->getFik(); } catch (\SlevomatEET\FailedRequestException $e) { echo $e->getRequest()->getPkpCode(); // if request fails you need to print the PKP and BKP codes to receipt } catch (\SlevomatEET\InvalidResponseReceivedException $e) { echo $e->getResponse()->getRequest()->getPkpCode(); // on invalid response you need to print the PKP and BKP too } ``` ### Generování klíčů [](#generování-klíčů) Klíče obdržené z portálu Finanční správy jsou ve formátu .p12 a je třeba převést do formátu PEM. V příkazové řádce proveďte tyto příkazy: `$ openssl pkcs12 -in cesta/k/souboru.p12 -out public.pub -clcerts -nokeys` `$ openssl pkcs12 -in cesta/k/souboru.p12 -out private.key -nocerts` Cestu k výsledným `public.pub` a `private.key` pak nastavíte jako veřejný, resp. privátní klíč při vytváření `CryptographyService` Pro testovací prostředí (playground) je třeba využít speciální testovací certifikáty. Tyto playground certifikáty jsou distribuovány s knihovnou v adresáři `cert`. Detailnější popis naleznete v dokumentaci [k testovacímu prostředí EET](http://www.etrzby.cz/cs/oznameni-k-testovacimu-prostredi-playground). ### Parametry účtenky [](#parametry-účtenky) XML jméno (dokumentace EET)PopisUmístění v klientuPoznámkauuid\_zpravyUUID zprávy`Receipt::$uuid`automaticky generovánodat\_odeslDatum odeslání tržby`$response->getRequest()->getSendTime()`automaticky generovánoprvni\_zaslaniPříznak první zaslání`Receipt::$firstSend`overeniPříznak ověřovacího módu`Configuration::$verificationMode`výchozí falsedic\_poplDIČ poplatníka`Configuration::$vatId`dic\_poverujicihoDIČ pověřujícího poplatníka`Receipt::$delegatedVatId`id\_provozID provozovny`Configuration::$premiseId`id\_poklID pokladny`Configuration::$cashRegisterId`porad\_cisČíslo účtenky`Receipt::$receiptNumber`dat\_trzbyDatum uskutečnění tržby`Receipt::$receiptTime`celk\_trzbaCelková částka`Receipt::$totalPrice`zakl\_nepodl\_dphCelková částka plnění osvobozených od DPH, ostatních plnění`Receipt::$priceZeroVat`zakl\_dan1Základ daně se základní sazbou DPH`Receipt::$priceStandardVat`dan1DPH se základní sazbou`Receipt::$vatStandard`zakl\_dan2Základ daně s první zníženou sazbou`Receipt::$priceFirstReducedVat`dan2DPH s první sníženou saznou`Receipt::$vatFirstReduced`zakl\_dan3Základ daně s druhou sníženou sazbou`Receipt::$priceSecondReducedVat`dan3DPH s druhou sníženou sazbou`Receipt::$vatSecondReduced`cest\_sluzCelková částka v režimu DPH pro cestovní službu`Receipt::$priceTravelService`pouzit\_zboz1Celková částka v režimu DPH pro prodej použitého zboží se základní sazbou`Receipt::$priceUsedGoodsStandardVat`pouzit\_zboz2Celková částka v režimu DPH pro prodej použitého zboží s první sníženou sazbou`Receipt::$priceUsedGoodsFirstReducedVat`pouzit\_zboz3Celková částka v režimu DPH pro prodej použitého zboží s druhou sníženou sazbou`Receipt::$priceUsedGoodsSecondReducedVat`urceno\_cerp\_zuctČástka plateb určená k následnému čerpání nebo zúčtování`Receipt::$priceSubsequentSettlement`cerp\_zuctČástka plateb které jsou následným čerpáním nebo zúčtováním`Receipt::$priceUsedSubsequentSettlement`rezimRežim tržby`Configuration::$evidenceMode`výchozí bežnýpkpPodpisový kód poplatníka`$response->getRequest()->getPkpCode()`bkpBezpečnostní kód poplatníka`$response->getRequest()->getBkpCode()`### Client driver [](#client-driver) Odeslání požadavku na servery EET neprobíhá přímo přes SoapClient integrovaný v PHP, ale pomocí rozhraní `SoapClientDriver`. Hlavním důvodem je nemožnost nastavení timeoutu požadavků integrovaného SoapClienta. Součástí knihovny je implentace rozhraní s pomocí [guzzlehttp/guzzle](https://packagist.org/packages/guzzlehttp/guzzle). Výchozí timeout této implementace je 2.5 sekundy, nastavitelný parametrem konstruktoru. ### Health Score 46 — FairBetter than 92% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity49 Moderate usage in the ecosystem Community23 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 68.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~153 days Recently: every ~187 days Total 11 Last Release 1967d ago Major Versions 0.2.1 → 1.0.02017-02-10 1.1.0 → 2.0.02020-02-17 PHP version history (3 changes)0.1PHP ^7.0 1.1.0PHP ^7.2 2.1.0PHP ^7.2 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/acc323747135bdd72731aafc0052a920b5e67c6cb8ffac74bf4b9eb44e9c0c90?d=identicon)[slevomat](/maintainers/slevomat) --- Top Contributors [![janlanger](https://avatars.githubusercontent.com/u/415695?v=4)](https://github.com/janlanger "janlanger (46 commits)")[![kukulich](https://avatars.githubusercontent.com/u/260445?v=4)](https://github.com/kukulich "kukulich (8 commits)")[![pepakriz](https://avatars.githubusercontent.com/u/383294?v=4)](https://github.com/pepakriz "pepakriz (5 commits)")[![fra-iesus](https://avatars.githubusercontent.com/u/12542064?v=4)](https://github.com/fra-iesus "fra-iesus (2 commits)")[![PavelJurasek](https://avatars.githubusercontent.com/u/1270132?v=4)](https://github.com/PavelJurasek "PavelJurasek (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![VasekPurchart](https://avatars.githubusercontent.com/u/406821?v=4)](https://github.com/VasekPurchart "VasekPurchart (1 commits)")[![hrach](https://avatars.githubusercontent.com/u/284263?v=4)](https://github.com/hrach "hrach (1 commits)")[![jaygridley](https://avatars.githubusercontent.com/u/424868?v=4)](https://github.com/jaygridley "jaygridley (1 commits)")[![ondrejmirtes](https://avatars.githubusercontent.com/u/104888?v=4)](https://github.com/ondrejmirtes "ondrejmirtes (1 commits)") --- Tags czech-republiceeteet-clientEETelectronic records of sales ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/slevomat-eet-client/health.svg) ``` [![Health](https://phpackages.com/badges/slevomat-eet-client/health.svg)](https://phpackages.com/packages/slevomat-eet-client) ``` ### Alternatives [pocketmine/pocketmine-mp A server software for Minecraft: Bedrock Edition written in PHP 3.5k77.4k88](/packages/pocketmine-pocketmine-mp)[firefly-iii/data-importer Firefly III Data Import Tool. 7905.8k](/packages/firefly-iii-data-importer)[mynaparrot/plugnmeet-sdk plugNmeet PHP SDK 102.5k](/packages/mynaparrot-plugnmeet-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)