https://github.com/vitexsoftware/abraflexi-matcher
Externí párovač faktur pro FlexiBee
https://github.com/vitexsoftware/abraflexi-matcher
abraflexi accounting czk easephp eur flexibee
Last synced: 4 months ago
JSON representation
Externí párovač faktur pro FlexiBee
- Host: GitHub
- URL: https://github.com/vitexsoftware/abraflexi-matcher
- Owner: VitexSoftware
- License: apache-2.0
- Created: 2018-04-22T23:42:21.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-02-07T15:03:48.000Z (4 months ago)
- Last Synced: 2025-02-07T15:23:49.701Z (4 months ago)
- Topics: abraflexi, accounting, czk, easephp, eur, flexibee
- Language: PHP
- Homepage:
- Size: 909 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.cs.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Párovač faktur pro AbraFlexi
============================
Instalace balíčku po spuštění (vytvoří potřebné štítky NEIDENTIFIKOVANO a CHYBIFAKTURA)
K dispozici jsou tři skripty na párování faktur:
[ParujFakturyNew2Old.php](src/ParujFakturyNew2Old.php) - páruje faktury po jednotlivých dnech zpět až 3mesíce.
[ParujVydaneFaktury.php](src/ParujVydaneFaktury.php) - pokusí se spárovat všechny nespárované vydané doklady
[ParujPrijateFaktury.php](src/ParujPrijateFaktury.php) - pokusí se spárovat všechny nespárované přijaté doklady
[ParujPrijatouBanku.php](src/ParujPrijatouBanku.php) - pokusí se spárovat vhodné faktury k dané příchozí platbě.
Algoritmus je následující:
* stažení výpisů z banky do abraflexi
* projdou se všechny nespárované příjmy v bance ( /c/firma_s_r_o_/banka/(sparovano eq false AND typPohybuK eq 'typPohybu.prijem' AND storno eq false AND datVyst eq '2018-03-07' )?limit=0&order=datVyst@A&detail=custom:id,kod,varSym,specSym,sumCelkem,datVyst )
* Platby se pak v cyklu po jedné zpracovávají
* Ke každé příchozí platbě se program pokusí nalézt vhodný (neuhrazený a nestornovaný) doklad ke spárování. Nejprve podle variabilního symbolu. Nakonec dle prostého specifického symbolu.
* Výsledky jsou sjednoceny dle čísla bankovního pohybu ve abraflexi aby nedocházelo k duplicitám když faktura vyhoví více ruzným hledáním.
* Platby které nemají dohledaný protějšek dle žádné z podmínek jsou označeny štítkem NEIDENTIFIKOVANO
* Pokud k platbě není dohledána faktura, dostane platba štítek CHYBIFAKTURA
Dohledané doklady se pak párují takto:
* **FAKTURA** - platba se spáruje s fakturou + uhrazená faktura je odeslána z abraflexi na email klienta
* **ZALOHA** - zálohová faktura je spárována s platbou + je vytvořen daňový doklad se stejným variabilním symbolem od kterého je tato záloha odečtena.
* **DOBR** - je proveden odpočet dobropisu
* Ostatní - je zapsáno varování do protokolu s polu s linkem do webového abraflexi
Debian/Ubuntu
-------------
Pro Linux jsou k dispozici .deb balíčky. Prosím použijte repo:
wget -qO- https://repo.vitexsoftware.com/keyring.gpg | sudo tee /etc/apt/trusted.gpg.d/vitexsoftware.gpg
echo "deb [signed-by=/etc/apt/trusted.gpg.d/vitexsoftware.gpg] https://repo.vitexsoftware.com $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update
sudo apt install abraflexi-matcher
Po instalaci balíku jsou v systému k dispozici tyto nové příkazy:
* **abraflexi-matcher** - páruje všechny toho schopné faktury
* **abraflexi-matcher-in** - páruje všechny toho schopné přijaté faktury
* **abraflexi-matcher-out** - páruje všechny toho schopné vydané faktury
* **abraflexi-matcher-new2old** - páruje příchozí platby den po dni od nejnovějších ke starším
* **abraflexi-pull-bank** - pouze stahne bankovní výpisy
* **abraflexi-match-bank** - párovač příchozí platby
Závislosti
----------
Tento nástroj ke svojí funkci využívá následující knihovny:
* [**EasePHP Framework**](https://github.com/VitexSoftware/php-ease-core) - pomocné funkce např. logování
* [**AbraFlexi**](https://github.com/Spoje-NET/AbraFlexi) - komunikace s [AbraFlexi](https://abraflexi.eu/)
* [**AbraFlexi Bricks**](https://github.com/VitexSoftware/AbraFlexi-Bricks) - používají se třídy Zákazníka, Upomínky a Upomínače
Testování:
----------
K dispozici je základní test funkcionality spustitelný příkazem **make test** ve zdrojové složce projektu
Pouze testovací faktury a platby se vytvoří příkazem **make pretest**
Test sestavení balíčku + test instalace balíčku + test funkce balíčku obstarává [Vagrant](https://www.vagrantup.com/)
Konfigurace
-----------
* [/etc/abraflexi/client.json](client.json) - společná konfigurace připojení k AbraFlexi serveru
* [/etc/abraflexi/matcher.json](matcher.json) - nastavení párovače:
```
"APP_NAME": "InvoiceMatcher", - název aplikace
"EASE_MAILTO": "[email protected]", - kam odesílat reporty
"EASE_LOGGER": "syslog|mail|console", - jak logovat
"PULL_BANK": "false", - stahnout banku před párováním
"DAYS_BACK": "7" - až kolik dní zpět párovat
"MATCHER_LABEL_PREPLATEK": "PREPLATEK", - štítek pro označení vetší než kolik vyžaduje uhrazovaná faktura
"MATCHER_LABEL_CHYBIFAKTURA": "CHYBIFAKTURA", - štítek pro označení platby ke které nebyla dohledána faktura
"MATCHER_LABEL_NEIDENTIFIKOVANO": "NEIDENTIFIKOVANO" -
```
Další software pro AbraFlexi
---------------------------
* [Pravidelné reporty z AbraFlexi](https://github.com/VitexSoftware/AbraFlexi-Digest)
* [Odesílač upomínek](https://github.com/VitexSoftware/php-abraflexi-reminder)
* [Klientská Zóna pro AbraFlexi](https://github.com/VitexSoftware/AbraFlexi-ClientZone)
* [Nástroje pro testování a správu AbraFlexi](https://github.com/VitexSoftware/AbraFlexi-TestingTools)
* [Monitoring funkce AbraFlexi serveru](https://github.com/VitexSoftware/monitoring-plugins-abraflexi)
* [AbraFlexi server bez grafických závislostí](https://github.com/VitexSoftware/abraflexi-server-deb)
Poděkování
----------
Tento software by nevznikl pez podpory:
[  ](https://spoje.net/)
[  ](http://purehtml.cz/)
[  ](https://ictmorava.cz)
MultiFlexi
----------
AbraFlexi Matcher is ready for run as [MultiFlexi](https://multiflexi.eu) application.
See the full list of ready-to-run applications within the MultiFlexi platform on the [application list page](https://www.multiflexi.eu/apps.php).
[](https://www.multiflexi.eu/apps.php)