zdenekgebauer/eet

EET client (www.etrzby.cz)

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

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

Instalace

Composer

composer require zdenekgebauer/eet, _(*3)

Ruční instalace

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

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

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

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

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