readme.md

Client for EET - Elektronická evidence tržeb

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

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.