FIO - automatické párování plateb
Už nikdy žádné ruční kontrolování účtu, jestli Vám platba dorazila. Pokud máte FIO banku, můžete bez problému napojit API na Váš e-shop a můžete kontrolovat přijaté platby klidně několikrát za hodinu. Automaticky se změní stav objednávky na "Platba přijata" a můžete expedovat bez nutnosti ruční kontroly bankovního účtu.
- Podpora + aktualizace zdarma 12 měsíců (poté 50% sleva)
- Pokud chcete modul expresně, žašleme ho oproti potvrzení o platbě
- 1 licence = 1 doména, viz licenční podmínky
- Máte s modulem problém? Prosíme, napište e-mail
- Ceny jsou konečné, nejsme plátci DPH
- Dominik Shaim Ulrich je oficiálním členem týmu PrestaShop Committers.
Popis
Už nikdy nebudete muset ručně kontrolovat svůj účet, zda vám platba dorazila. Pokud jste klientem FIO banky, můžete snadno napojit API na váš e-shop a kontrolovat přijaté platby několikrát za hodinu. Stav objednávky se automaticky změní na "Platba přijata", což vám umožní expedovat zboží bez nutnosti ruční kontroly bankovního účtu.
Funkce modulu
Modul slouží k párování plateb mezi e-shopem a FIO bankou. Párování může probíhat podle:
- ID objednávky
- Kódu objednávky
- Čísla faktury
V závislosti na tom, jaké variabilní symboly (VS) poskytujete svým zákazníkům, můžete nastavení upravit. Jakmile modul nalezne platbu s odpovídajícím VS, automaticky označí objednávku jako zaplacenou. Vyhledávání probíhá primárně v poli "Variabilní symbol", a pokud není nalezen, modul prohledává také poznámky (typické pro platby ze zahraničí, kde je VS často uvedeno v poznámce).
Přesnost a nastavení stavu objednávek
Modul je schopen rozpoznat, zda byla platba provedena správně (tj. jestli zákazník zaplatil více nebo méně, než měl). Pro tento účel je nastavena tolerance 1 Kč, aby se předešlo problémům se zaokrouhlením. Můžete také nastavit stavy objednávek, u kterých se mají stavy měnit, abyste zabránili nežádoucím změnám stavu.
Automatizace procesů
Samozřejmostí je nastavení cronu (plánovače úloh) pro automatické spouštění v předem stanovených intervalech. Standardně je nastaven na jednou za hodinu, ale je možné jej přizpůsobit častěji podle potřeby.
Technické požadavky, podpora měn a podpora verzí FIO
Modul využívá REST API. Pro jeho funkčnost potřebujete pouze TOKEN, který si generujete ve svém internetovém bankovnictví. Po přihlášení do účtu klikněte na záložku "Informace o účtu" a najdete sekci "Nastavení API", kde token vygenerujete.
Umožňuje používat CZK, EUR, USD a všechny ostatní měny, co FIO podporuje. V nastavení modulu lze nastavit token pro každou měnu/účet zvlášť.
Funguje jak s FIO CZ, tak s FIO SK.
Historie objednávek
Modul je funkční pro všechny objednávky uskutečněné od data instalace modulu.
Nastavení stavů
Modul nastavuje čtyři stavy:
- Přeplatek (pokud zákazník zaplatí příliš)
- Nedoplatek (pokud zákazník zaplatí málo)
- Platba přijata (pokud dorazí platba na váš bankovní účet)
- Dobírka přijata (pokud dopravce zašle dobírku na váš bankovní účet - je možné zadat více čísel účtů pro různé dopravce)
Modul umí rozeznat dobírky od různých dopravců, jako jsou ČP, PPL, Geis, GLS a DPD. Pokud máte jiného dopravce nebo vám dopravce zasílá dobírky z jiného čísla účtu, stačí toto číslo dopsat do nastavení modulu. Pokud nechcete měnit stav u plateb za dobírky, můžete stav nastavit na variantu "neměnit".
Možnost úprav a specifikace
Tyto stavy lze také přizpůsobit (napárovat akci na jiný stav). Modul se řídí oficiální specifikací od FIO banky, kterou najdete zde.
- Aktuální funkce modulu jsou viditelné na demo verzi níže, kde je vždy aktuální verze modulu.
- Moduly se vylepšují průběžně. Drobné úpravy v kódu apod. nemusí být v changelogu uváděny.
- Z důvodu nových funkcí, oprav, stability a bezpečnosti je vždy vhodné mít poslední verzi modulu.
- V případě, že byste měli jakékoliv dotazy napište e-mail.
Technické informace a kompatibilita
| PrestaShop 9.x | |
| PrestaShop 8.x | |
| PrestaShop 1.7 | |
| PrestaShop 1.6 | |
| Multistore | |
| Cron (plánovač úloh) | |
| PHP | 7.0 - 8.5 |
| Jazyk modulu | CZ + SK + EN + GB |
| Vytváří si neaktivní admin účet? | ano (kvůli "podepisování" stavů objednávek) |
| Datum vystavení | 19. 6. 2015 |
| Poslední aktualizace popisu | 4. 3. 2026 |
| Verze modulu | 2.6.1 (4. 3. 2026) |
| Název modulu na FTP | shaim_fio_pair |
| Kód produktu | FIO_PAROVANI_PLATEB |
| Autor | Dominik Shaim Ulrich |
| DEMO verze | ano (viz níže) |
Související moduly
Demo modulu
PS verze 9.x
PS verze 8.x
PS verze 1.7
PS verze 1.6
Video (detailní ukázka fungování)
Video bylo natočeno při vydání modulu, nemusí být tedy již plně aktuální, jelikož mohlo dojít ke změnám / aktualizacím v modulu apod.Changelog
- funkce "Odstranit nuly ze začátku VS při párování plateb" odstraňovala VS jen z regulérního políčka pro VS, ale už nezohledňovala, když někdo napsal VS do poznámky, nyní funkce odstraňuje nuly i z poznámky platby, pokud se tam VS podaří detekovat
- pouze technické přečíslování modulu pro nový rok 2026, kvůli přehlednosti pro naši podporu (update není třeba provádět)
- kompatibilita s PHP 8.5
- update datatables závislostí (2.3.4 -> 2.3.5)
- oprava řazení záznamů, aby byly od nejnovějšího a nemuselo se zbytečně scrollovat
- v prostředí multistore s více e-shopy se nyní zobrazují nespárované platby pouze v případě, že nebyly dříve spárovány v jiném e-shopu
- zobrazení datumu přijetí platby nastaveno na formát "Y-m-d", předtím byl použit i čas ("Y-m-d H:i:s"), ale FIO tento údaj neuvádí, takže odstraňujeme, aby to nevypadalo jako "chyba"
- návaznost na minulé úpravy hlášené ze strany FIO API, modul je nutno aktualizovat, jinak může dojít k nefunkčnosti párování plateb
- doplněna podpora IBAN formátů čísel pro volbu "Čísla účtu pro dobírky"
- technické přečíslování modulu pro nový rok 2025, kvůli přehlednosti pro naši podporu
- otestována funkčnost s PS 9
- vylepšen výkon modulu, optimalizovaný kód, odstranění starého již nepoužívaného kódu
- více menších úprav a oprav
- změna API od listopadu 2024 v souvislosti s emailem od FIO s předmětem "Měníme adresu Fio API Bankovnictví"
- další drobné úpravy
- doplněny mailové šablony pro další jazyky. Kromě CZ je nyní k dispozici SK, EN a GB
- další drobné úpravy
- pouze technické přečíslování modulu pro nový rok 2024, kvůli přehlednosti pro naši podporu (update není třeba provádět)
- přípravy modulu na PS 9.x
- upravena situace, kdy nemuselo být vygrabováno VS, které je z poznámky a je kratší jak 4 znaky
- upravena situace, kdy nebyly v nespárovaných platbách ty platby, kde nebyl VS uvedený vůbec, ani v položce VS, ani v poznámce
- přidána částka do nespárovaných plateb, jak do BO, tak do případného notifikačního e-mailu
- další drobné úpravy
- doplněna možnost zadat token v libovolné měně, kterou FIO podporuje. Tzn:
- CZK, USD, EUR, PLN, HUF, GBP, AUD, CAD, DKK, CHF, JPY, NOK, RUB, SEK
- dalších více drobných úprav
- oprava chyby, kdy nemuselo dojít ke spárování objednávky a byla označena jako "nespárovaná"
- ukládání informací potřebných pro fungování modulu bylo přesunuto do samostatné tabulky jako příprava na PrestaShop 9.0
- drobné úpravy
- upraveno zaokrouhlování, kdy mohla být zahraniční platba detekována jako přeplatek
- drobné úpravy
- doplněna podpora pro PrestaShop 8.0+ a PHP 8.0/8.1/8.2
- technické přečíslování pro nový rok 2023, kvůli přehlednosti
- moduly prověřeny utilitou PHPStan až do levelu 5, odstraněny nekompatibility a opravy datových typů. Tato utilitka je mezi programátory velmi známá a používá se zejména pro optimalizaci kódu, odstranění nepoužívaných částí kódu, apod)
- kompletní revize modulu (odstranění starého nepotřebného kódu, výměna za novější řešení, optimalizace rychlosti modulu, doplněny překladové stringy a mnoho dalšího -> generální každoroční údržba :))
- upraven výpis nespárovaných plateb, aby tam bylo jen opravdu to, co Vás zajímá, tzn, to co se nespárovalo u aktuálních plateb
- upravena detekce přijatých plateb, aby nehrály roli částky v řádu haléřů a došlo i tak k úspěšnému spárování platby
- drobné úpravy technického rázu
- nová možnost "odstranit nuly z VS", která zajišťuje spárování i když zadá někdo VS např. jako 000012345, apod
- oprava párování speciálních znaků, háčků, čárek v IMAPu, kdy mohlo dojít k nespárování
- drobné opravy/úpravy
- opravena sporadická chyba, kdy docházelo k párování sledovacího čísla přes číslo faktury = 0
- drobné úpravy a opravy
- kromě CZK, EUR a USD byla přidána možnost párovat PLN
- ladění výkonu
- doprogramována volba "Bezpečnostní token pro cron" -> Token slouží k zabezpečení cron úlohy, aby ji nemohl spustit každý. Pokud zadáte nějaký Váš libovolný text tokenu, změní se po uložení nastavení i URL adresa pro cron!
- optimalizace kódu
- doplněna podpora (přehled) nespárovaných plateb, zobrazí se v tabulce v modulu a máte možnost i nechat si upozornění a nespárované platbě zaslat na e-mail, abyste vždy byli plně informováni o platbách, které se nepodaří napárovat a abyste mohli napárování provést případně ručně
- opravy drobných bugů, optimalizace výkonu
- možnost nastavit si novou volbu "Po změně stavu vrátit zpět na původní stav objednávky"
Množstevní slevy
| Počet | Sleva |
|---|---|
| 2 ks a více | 15% |
| 5 ks a více | 30% |
Proč nakupovat na PSModuly.cz
- Letité zkušenosti s PS již od roku 2012.
- Vždy plně aktuální moduly dle poslední specifikace.
- Obrovský výběr modulů, možnost mít většinu modulů od jednoho vývojáře.
- Plná podpora samotného vývojáře, který své moduly zná a sám je psal.
- Nárok na podporu a aktualizace zdarma je 12 měsíců od data zakoupení.
- Samotná licence modulů není časově omezena.
- Sleva na aktualizace modulů 50%.
- Dominik Shaim Ulrich je oficiálním členem týmu PrestaShop Committers.
Více než 170
PS modulů
Na trhu
od 2012
Aktualizace
12 měsíců
Podpora
vývojáře
Hodnocení od zákazníků (10)
Komentáře mohou udělovat pouze registrování zákazníci, kteří produkt reálně koupili a to v sekci "Můj účet".
Komentáře prochází schvalovacím procesem, který provádí administrátor e-shopu.
Funguje spolehlivě.
doporucuji vse ok
Doporučuji. Funguje super.
Všetko bez problémov, modul je spoľahlivý. Máme nastavený cron a platby sa pekne párujú danom intervale.
Funguje bez problémů.
Již léta osvědčený modul, který funguje jak má. :-)
Propojení s banko, funguje bez problému, Děkuji
Modul funguje jak má. Bez problému. Super
Funguje podle představ :)
Jsem spokojen, vše funguje jak má.