slevomat/eet-client

This package is abandoned and no longer maintained. No replacement package was suggested.

Client for electronic records of sales (EET) in Czech republic

2.2.0 2021-01-19 19:27 UTC

This package is auto-updated.

Last update: 2022-11-25 13:45:37 UTC


README

Build status Code coverage Latest Stable Version Composer Downloads

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.