zdenekgebauer/eet

EET client (www.etrzby.cz)

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

Requires

• php: >=5.3.0
• ext-curl: *
• ext-openssl: *
• ext-soap: *
• robrichards/wse-php: 2.0.*
• robrichards/xmlseclibs: ^2.0

WTFPL

• Zdenek Gebauer

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