Description

Suite of tools to match payments and invoices in Abra Flexi using the php-abraflexi library. Can be scheduled via cron or MultiFlexi for automated daily processing.

Included tools:

abraflexi-matcher — Matches both received and issued invoices against bank payments.
abraflexi-matcher-in — Matches received (incoming) invoices in AbraFlexi.
abraflexi-matcher-out — Matches issued (outgoing) invoices in AbraFlexi.
abraflexi-matcher-init — Initialises matcher configuration and environment.
abraflexi-matcher-new2old — Matches newer invoices against older outstanding entries.
abraflexi-match-bank — Matches received bank payments to invoices.
abraflexi-match-cash — Matches received cash (till) payments to invoices.
abraflexi-match-received-payment — Matches a specific received payment by its ID.
abraflexi-match-specsym — Matches received payments by specific symbol.
abraflexi-match-varsym — Matches received payments by variable symbol.
abraflexi-pull-bank — Pulls bank statements from AbraFlexi.
abraflexi-transaction-report — Generates a bank transaction report in JSON format.

Package Logo

Párovač faktur pro FlexiBee

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 - páruje faktury po jednotlivých dnech zpět až 3mesíce. ParujVydaneFaktury.php - pokusí se zpárovat všechny nespárované vydané doklady ParujPrijateFaktury.php - pokusí se zpárovat všechny nespárované přijaté doklady

Algoritmus je následující:

stažení výpisů z banky do flexibee
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 flexibee 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 flexibee 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 flexibee

Debian/Ubuntu

Pro Linux jsou k dispozici .deb balíčky. Prosím použijte repo:

wget -O - http://v.s.cz/info@vitexsoftware.cz.gpg.key|sudo apt-key add -
echo deb http://v.s.cz/ stable main > /etc/apt/sources.list.d/ease.list
apt update
apt install php-flexibee-matcher

Po instalaci balíku jsou v systému k dispozici tyto nové příkazy:

flexibee-matcher - páruje všechny toho schopné faktury
flexibee-matcher-in - páruje všechny toho schopné přijaté faktury
flexibee-matcher-out - páruje všechny toho schopné vydané faktury
flexibee-automatcher - páruje pomocí automatického párování
flexibee-matcher-new2old - páruje příchozí platby den po dni od nejnovějších ke starším
flexibee-pull-bank - pouze stahne bankovní výpisy

Závislosti

Tento nástroj ke svojí funkci využívá následující knihovny:

EasePHP Framework - pomocné funkce např. logování
FlexiPeeHP - komunikace s FlexiBee
FlexiPeeHP 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 Prepare

Test sestavení balíčku + test instalace balíčku + test funkce balíčku obstarává Vagrant

Konfigurace

/etc/flexibee/client.json - společná konfigurace připojení k FlexiBee serveru
/etc/flexibee/matcher.json - nastavení párovače:

    "EASE_APPNAME": "InvoiceMatcher",             - název aplikace 
    "EASE_MAILTO": "info@yourdomain.net",         - 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
    "LABEL_PREPLATEK": "PREPLATEK",               - štítek pro označení vetší než kolik vyžaduje uhrazovaná faktura 
    "LABEL_CHYBIFAKTURA": "CHYBIFAKTURA",         - štítek pro označení platby ke které nebyla dohledána faktura
    "LABEL_NEIDENTIFIKOVANO": "NEIDENTIFIKOVANO"  -

Další software pro FlexiBee

Poděkování

Tento software by nevznikl pez podpory:

Package database temporarily unavailable.

abraflexi-matcher

Install