/PHP-EET

PHP třída pro elektronickou evidenci tržeb

Primary LanguagePHPMIT LicenseMIT

PHP knihovna pro EET

Codacy Badge Dependency Status Build Status Latest Stable Version Total Downloads License SensioLabsInsight

⚠️ Je třeba si aktualizovat EET knihovnu na verzi v3.0.1, jelikož předchozí verze neumožňuje odesílat opakované platby. Aktualizace nemá vliv na kompatibilitu. Příručka jak opakovaně zasílat platby. ⚠️

Koukněte se na přispěvatelé, a příspějte taktéž na vývoj. Díky těmto lidem je knihovna dále udržována a šířena zdarma jako open source. Příspějte a buďte na seznamu přispěvatelů

V případě že podáváte issue a nenastavíte label - šítek, pro lepší přehlednost, tak je issue automaticky uzavřen bez řešení. Před podáním issue, prosím věnujte čas k pročtení příručky.

Instalace

Composer

Pro instalaci balíčku je nutné jej instalovat skrze composer.

composer require filipsedivy/php-eet

Instalace bez composeru

O tom jak nainstalovat závislosti bez composeru navštivte wiki - instace bez composeru

Dokumentace

Dokumentaci k použítí naleznete ve wiki systému

Než se zeptáte, zkuste se do něj podívat, zda-li již problém není zdokumentován

Nejvíce zasílaných otázek

Ukázka užití

Ukázky naleznete ve složce examples/.

Certifikát EET_CA1_Playground-CZ00000019.p12 byl vydán pro účel testování Daňovou správou. Tento certifikát nepoužívejte pro ostrou verzi. Svůj certifikát si vygenerujete skrze rozhraní Daňové správy.

<?php
require_once __DIR__.'/vendor/autoload.php';

use FilipSedivy\EET\Certificate;
use FilipSedivy\EET\Dispatcher;
use FilipSedivy\EET\Receipt;
use FilipSedivy\EET\Utils\UUID;

$certificate = new Certificate(__DIR__.'/EET_CA1_Playground-CZ00000019.p12', 'eet');
$dispatcher = new Dispatcher($certificate);
$dispatcher->setPlaygroundService();

$uuid = UUID::v4();

$r = new Receipt;
$r->uuid_zpravy = $uuid;
$r->id_provoz = '11';
$r->id_pokl = 'IP105';
$r->dic_popl = 'CZ1212121218';
$r->porad_cis = '1';
$r->dat_trzby = new \DateTime();
$r->celk_trzba = 500;

echo '<h2>---REQUEST---</h2>';
echo '<pre>';

try {
    // Odeslání tržby
    $dispatcher->send($r);

    // Tržba byla úspěšně odeslána
    echo sprintf('FIK: %s <br>', $dispatcher->getFik());
    echo sprintf('BKP: %s <br>', $dispatcher->getBkp());
}catch(\FilipSedivy\EET\Exceptions\EetException $ex){
    // Tržba nebyla odeslána
    echo sprintf('BKP: %s <br>', $dispatcher->getBkp());
    echo sprintf('PKP: %s <br>', $dispatcher->getPkp());
}catch(Exception $ex){
    // Obecná chyba
    var_dump($ex);
}

Pomoc a řešní chyb

V případě že potřebujete poradit, nebo při implementaci Vám třída zobrazuje chybu můžete využít následujících kontaktů. Základní pomoc je poskytována zcela zdarma. V ostatních případech se řídí dle aktuální ceny, kterou naleznete ve wiki.

Issues

Issues je systém veřejných hlášení chyb. V rámci veřejné podpory jsou k dispozici štítky otázka a potřebuji pomoc. Před tím než vytvoříte issue, zkuste se podívat zda není problém již řešen nebo již vyřešen někým jiným. Seznam problémů řešených i vyřešených.

Email

V případě že veřejné řešení problémů nepřipadá v úvahu, tak je možné mě kontaktovat na emailové adrese, kterou naleznete na mé osobní stránce https://filipsedivy.cz.

Příspěvek

V případě že se vám knihovna líbí a je vám užitečná, můžete mi zaslat příspěvěk. Jak zaslat příspěvek a co z toho budete mít můžete nalést ve wiki.

Přispěvatelé

Přispěvatel Částka
https://www.drento.cz 1 000 Kč
http://www.elektrahk.cz 1 000 Kč
http://www.nerosty.cz 500 Kč
https://www.manvel.cz 500 Kč
https://www.skoda-dily.cz 1 000 Kč

Screencasty

Odkazy

Licence

MIT - https://opensource.org/licenses/MIT