slevomat / eet-client
Client for electronic records of sales (EET) in Czech republic
Installs: 246 874
Dependents: 0
Suggesters: 0
Security: 0
Stars: 96
Watchers: 20
Forks: 20
Open Issues: 0
Requires
- php: ^7.2 || ^8.0
- ext-dom: *
- ext-openssl: *
- ext-soap: *
- ramsey/uuid: ^3.5 || ^4.0
- robrichards/wse-php: ^2.0
- slevomat/consistence: ^2.1.0
Requires (Dev)
- composer/ca-bundle: ^1.0
- guzzlehttp/guzzle: ^6.3.3 || ^7.0.1
- phing/phing: ^2.16.3
- php-parallel-lint/php-parallel-lint: ^1.2
- phpstan/phpstan: ^0.12.37
- phpstan/phpstan-phpunit: ^0.12.16
- phpunit/phpunit: ^8.5.14 || ^9.3.7
- slevomat/coding-standard: ^6.3.10
- squizlabs/php_codesniffer: ^3.5.6
Suggests
- guzzlehttp/guzzle: For usage of bundled GuzzleSoapClientDriver
README
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)
Instalace
Nejlepší způsob jak slevomat/eet-client nainstalovat je pomocí Composeru:
> composer require slevomat/eet-client
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íčů
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.
Parametry účtenky
XML jméno (dokumentace EET) | Popis | Umístění v klientu | Poznámka |
---|---|---|---|
uuid_zpravy | UUID zprávy | Receipt::$uuid |
automaticky generováno |
dat_odesl | Datum odeslání tržby | $response->getRequest()->getSendTime() |
automaticky generováno |
prvni_zaslani | Příznak první zaslání | Receipt::$firstSend |
|
overeni | Příznak ověřovacího módu | Configuration::$verificationMode |
výchozí false |
dic_popl | DIČ poplatníka | Configuration::$vatId |
|
dic_poverujiciho | DIČ pověřujícího poplatníka | Receipt::$delegatedVatId |
|
id_provoz | ID provozovny | Configuration::$premiseId |
|
id_pokl | ID pokladny | Configuration::$cashRegisterId |
|
porad_cis | Číslo účtenky | Receipt::$receiptNumber |
|
dat_trzby | Datum uskutečnění tržby | Receipt::$receiptTime |
|
celk_trzba | Celková částka | Receipt::$totalPrice |
|
zakl_nepodl_dph | Celková částka plnění osvobozených od DPH, ostatních plnění | Receipt::$priceZeroVat |
|
zakl_dan1 | Základ daně se základní sazbou DPH | Receipt::$priceStandardVat |
|
dan1 | DPH se základní sazbou | Receipt::$vatStandard |
|
zakl_dan2 | Základ daně s první zníženou sazbou | Receipt::$priceFirstReducedVat |
|
dan2 | DPH s první sníženou saznou | Receipt::$vatFirstReduced |
|
zakl_dan3 | Základ daně s druhou sníženou sazbou | Receipt::$priceSecondReducedVat |
|
dan3 | DPH s druhou sníženou sazbou | Receipt::$vatSecondReduced |
|
cest_sluz | Celková částka v režimu DPH pro cestovní službu | Receipt::$priceTravelService |
|
pouzit_zboz1 | Celková částka v režimu DPH pro prodej použitého zboží se základní sazbou | Receipt::$priceUsedGoodsStandardVat |
|
pouzit_zboz2 | Celková částka v režimu DPH pro prodej použitého zboží s první sníženou sazbou | Receipt::$priceUsedGoodsFirstReducedVat |
|
pouzit_zboz3 | Celková čá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 |
|
rezim | Režim tržby | Configuration::$evidenceMode |
výchozí bežný |
pkp | Podpisový kód poplatníka | $response->getRequest()->getPkpCode() |
|
bkp | Bezpečnostní kód poplatníka | $response->getRequest()->getBkpCode() |
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. Výchozí timeout této implementace je 2.5 sekundy, nastavitelný parametrem konstruktoru.