EET client (www.etrzby.cz)

dev-master 2017-03-04 13:20 UTC

This package is auto-updated.

Last update: 2024-10-27 04:18:11 UTC


README

#PHP klient pro EET

Základní klient umožňující odeslat účtenku na EET server a získat FIK. Podporuje i PHP 5.3, nevyžaduje konverzi certifikátů z PKCS12 do PEM formátu. Pro komunikaci s bránou umožňuje použít SOAP nebo curl.

Implementace vychází z dokumentace http://www.etrzby.cz/assets/cs/prilohy/EET_popis_rozhrani_v3.1.1.pdf. Přístupové údaje a certifikáty pro testovací prostředí jsou popsány v http://www.etrzby.cz/assets/cs/prilohy/EET_pristupove_provozni_informace_playground_3.1.pdf.

##Instalace

Composer

composer require zdenekgebauer/eet

Ruční instalace

Soubory ze složky src je třeba začlenit do aplikace pomocí autoloadu nebo pomocí require_once 'src/autoload.php'

##Použítí Příklady použití jsou ve složce example. Příklad připojení na produkční EET používá testovací certifikát, pro ostré nasazení je třeba nastavit certifikát vystavený obchodníkovi.

##Testy V adresáři tests/integration jsou testy používajíci testovací i produkční server. U těchto serverů není možné simulovat selhání spojení, proto se používá volání skriptů na lokálním serveru. Před jejich spuštěním je třeba v souborech tests/_data/*.wsdl patřičně nastavit soap:address location.

##Známé problémy Starší verze PHP 5.3 mohou mít kvůli starší verzi OpenSSL problém s voláním EET serveru. V takovém případě může pomoci vynucení použití curl pomocí Config::setUseCurl(true). Při tomto způsobu se může objevit problém
s ověřením certifikátu, jeho příčinou je zpravidla chybějící nebo zastaralý certifikát v nastavení curl.cainfo v php.ini. Certifikáty jsou ke stažení na https://curl.haxx.se/docs/caextract.html. Není-li možné opravit toto nastavení, je v krajním případě možné kontrolu certifikátu vyřadit pomocí Config::setCurlVerifySslPeer(false).

##Changelog

  • 0.0.1
    • první verze
  • 0.0.2
    • doplnění metody Connector:sign() pro podepsání účtenky bez odeslání
    • doplnění metody Receipt::getPkpString() pro získání PHP kódu v base64
    • drobné opravy překlepů, odstranění zbytečností.
  • 0.0.3
    • možnost použití curl místo SOAP
  • 0.0.4
    • možnost potlačit kontrolu SSL certifikátu při použití curl
    • oprava výjimek při použití curl
  • 0.0.5
    • vynechání prázdných údajů z datové zprávy