Download the PHP package ninedigit/ekasa-clientphp without Composer
On this page you can find all versions of the php package ninedigit/ekasa-clientphp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package ekasa-clientphp
e-Kasa Client PHP
HTTP klient v jazyku PHP pre e-Kasa API riešenie spoločnosti Nine Digit, s.r.o..
Inštalácia
Knižnica je kompatibilná s PHP vo verzii 7.4, 8.1 a vyššej.
Inštalácia cez Packagist
Knižnica je dostupná na https://packagist.org/packages/ninedigit/ekasa-clientphp.
Najnovšiu verziu balíka nainštalujete príkazom:
Inštaláciu špecifickej verzie nainštalujete príkazom:
Inštalácia cez GitHub repozitár
-
Upravte súbor
composer.jsona do kolekcierepositoriespridajte nový repozitár: - Nainštalujte balík
Najnovšiu verziu balíka nainštalujete príkazom:
Inštaláciu špecifickej verzie nainštalujete príkazom:
Viac informácii o inštalácii privátnych repozitárov nájdete v Composer dokumentácii.
Použitie
Knižnica aktuálne pokrýva iba funkcionalitu registrácie dokladu. Ak máte záujem o rozšírenie, zadajte prosím dopyt na [email protected].
Knižnicu je možné používať v dvoch režimoch:
Cez lokálnu sieť
Služba je po inštalácií štandardne dostupná na porte 3010 (http://localhost:3010).
Klientskú triedu inštanciujte nasledovne:
TIP: Ak ste integrátor a potrebujete testovaciu eKasa API inštanciu, postupujte podľa tohto návodu.
Cez internet so službou Expose
Ak je vaša PHP aplikácia používajúca túto knižnicu nasadená na inom počítači (na serveri resp. v cloude), je potrebné zabezpečiť sieťové spojenie s lokálne nainštalovanou eKasa API.
Riešením je práve služba Expose, ktorá priradí k vašej lokálne nainštalovanej eKasa API URL adresu s použitím zabezpečeného HTTPS protokolu.
- Nie je potrebné žiadne nastavenie smerovača (routra) či obstarávanie statickej IP adresy u internetového poskytovateľa.
- Nadviazané spojenie je šifrované
- Prístup k eKasa API službe je chránený nastaveným prístupovým kľúčom, ktorý je možné kedykoľvek aktualizovať.
Pre aktiváciu služby a získanie prihlasovacích údajov nás kontaktujte na e-mailovej adrese [email protected].
Pri použití Expose služby inštanciujete klientskú triedu nasledovne:
Príklady
Príklady sú dostupné v adresári examples.
Príklad tvorby pokladničného dokladu
Zaokrúhľovanie
V prípade, ak do premenných vkladáte výsledky matematických operácii, pred priradením je vhodné premenné zaokrúhliť.
- Jednotkové ceny sú zaokrúhľované na 6 desatinných miest.
- Ceny sú zaokrúhľované na 2 desatinné miesta.
- Množstvá sú zaokrúhľované na 4 desatinné miesta.
Vývoj
Inštalácia Composer-a
Inštalácia závislostí knižnice:
Po vytvorení nových tried (v separátnych súboroch) je nutné vyvolať
Testovanie
Pre vykonanie integračných testov je nutné vytvoriť súbor settings.json v tests\integration vo formáte JSON so štruktúrou zhodnou s triedou ApiClientOptions.
Napríklad:
Testy je možné spustiť príkazom:
Pre spustenie konkrétneho testu je nutné uviesť prepínač --filter s názvom testovaciej metódy.
Napríklad:
Overenie kompatibility PHP
Lokálne testovanie CI
Prerekvizity:
- spustený Docker Desktop
- aktuálny pracovný adresár je nastavený na
ekasa-clientphpkoreňový adresár
All versions of ekasa-clientphp with dependencies
doctrine/annotations Version ^1.13 || ^2.0
php Version ^7.4 || ^8.1
guzzlehttp/guzzle Version ^7.0
symfony/serializer Version ^5.4 || ^6.4 || ^7.0
symfony/property-access Version ^5.4 || ^6.4 || ^7.0
squizlabs/php_codesniffer Version 3.*
phpdocumentor/reflection-docblock Version ^5.3
ext-json Version *