slevomat/eet-client

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

Client for EET - Elektronická evidence tržeb

, _(*1)

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), _(*2)

• EET website

Instalace

Nejlepší způsob jak slevomat/eet-client nainstalovat je pomocí Composeru:, _(*3)

> 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., _(*4)

$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., _(*5)

V příkazové řádce proveďte tyto příkazy:, _(*6)

$ openssl pkcs12 -in cesta/k/souboru.p12 -out public.pub -clcerts -nokeys, _(*7)

$ openssl pkcs12 -in cesta/k/souboru.p12 -out private.key -nocerts, _(*8)

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, _(*9)

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., _(*10)

Parametry účtenky

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., _(*11)

Součástí knihovny je implentace rozhraní s pomocí guzzlehttp/guzzle. Výchozí timeout této implementace je 2.5 sekundy, nastavitelný parametrem konstruktoru., _(*12)