← Základy / Sady SDK
Import bankovních výpisů (camt.053)
Stáhněte si z banky výpis ve formátu ISO 20022 camt.053, nastavte šablonu importu a nechte systém Nordlet zakládat partnery, párovat faktury a účtovat platby.
Tato příručka popisuje souborový import bankovních výpisů ve formátu ISO 20022 camt.053 prostřednictvím importní šablony: co stáhnout, jak šablonu nastavit a co import vytvoří. Podrobnosti o rozhraní API najdete v části Importy bank a plateb. Pokud preferujete živé připojení k bance namísto souborů, podívejte se na Bankovní připojení.
1. Stažení výpisu z banky
Ve svém internetovém bankovnictví otevřete export výpisů a zvolte formát ISO 20022 camt.053 (XML). Litvinské banky jej uvádějí jako „ISO 20022 XML“ nebo „camt.053“, přičemž většina evropských bank jej nabízí v rámci firemního bankovnictví. Vyberte časové období a stáhněte soubor. Jeden soubor může obsahovat několik výpisů (například jeden pro každý měnový účet); výpisy, jejichž IBAN se neshoduje se zvoleným bankovním účtem, budou přeskočeny.
Importují se pouze zaúčtované položky (Ntry/Sts = BOOK). Nezaúčtované (čekající) položky se ignorují.
2. Vytvoření bankovního účtu
Každý import směřuje na určitý bankovní účet. Vytvořte ho v sekci Banka a zadejte IBAN a měnu účtu. Jakmile je IBAN nastaven, import zkontroluje, zda výpis patří k tomuto účtu, a soubor s odlišným IBANem odmítne.
3. Vytvoření importní šablony
V sekci Banka → Šablony importu klikněte na Nová šablona importu, vyberte typ ISO 20022 camt.053 a zadejte její název.
Položky. Každý element výpisu, který importer čte, představuje jeden řádek. Zaškrtávací políčko Vyžadováno v souboru určuje, že prvek musí být v nahrátém souboru přítomen; soubor, kterému chybí požadovaný prvek, je odmítnut a chybějící názvy se zobrazí. Prvky, které obsahuje každý výpis (Stmt/Id, Stmt/Acct/Id/IBAN, zůstatky, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt), jsou zaškrtnuty automaticky. Volitelné položky - název banky, kód transakce, jména a IBANy dlužníka a věřitele, text zprávy pro příjemce a variabilní symboly - zaškrtnuté nejsou, protože je neposkytuje každá banka; zaškrtněte ty, které vaše banka dodává.
Účet hlavni knihy (Ledger account). Řádky obsahující peněžní částky lze přiřadit k účtu hlavní knihy, a to buď k existujícímu, nebo k novému vytvořenému z daného řádku. Každý pohyb vygenerovaný z přiřazeného řádku se zaúčtuje v okamžiku importu: příchozí platba mávne účet hlavní knihy bankovního účtu na má dáti a dal přiřadí přiřazenému účtu, odchozí platba funguje opačně a bankovní transakce je označena jako spárovaná s tímto účetním zápisem. Kromě řádku se samotnou částkou Ntry/Amt existují řádky pravidel, které vybírají položky podle jejich bankovního kódu transakce nebo směru:
| Řádek | Vybírá | Typický účet |
|---|---|---|
| Bankovní poplatky (BkTxCd CHRG) | položky, jejichž rodina kódů transakcí je CHRG |
náklady na bankovní poplatky (v účtové osnově 568) |
| Úroky (BkTxCd INTR) | položky, jejichž rodina je INTR |
úrokové výnosy nebo náklady |
| Daně (BkTxCd TAXE) | položky, jejichž rodina je TAXE |
daňové platby |
| Ostatní odchozí platby | jakákoli jiná položka na vrub (debet) | ponechte „Nezaúčtováno“, aby se platby spárovaly s přijatými fakturami |
| Ostatní příchozí platby | jakákoli jiná položka ve prospěch (kredit) | ponechte „Nezaúčtováno“, aby se platby spárovaly s vydanými fakturami |
Ntry/Amt |
každá položka, kterou nezachytilo žádné pravidlo | obvykle „Nezaúčtováno“ |
Položka se zaúčtuje na účet prvního řádku, kterému vyhovuje: nejprve se zohlední rodina kódu transakce, poté směr a nakonec řádek se samotnou částkou. Řádky pravidel se v souboru nekontrolují. Kód transakce pochází z pole Ntry/BkTxCd/Domn/Fmly/Cd; pokud jej banka nezasílá, zůstanou řádky kódů bez shody.
Vytvářet chybějící zákazníky / dodavatele. Zaškrtněte možnost Vytvářet chybějící zákazníky u řádku se jménem dlužníka (…/RltdPties/Dbtr/Nm), čímž se vytvoří zákazník pro každého neznámého plátce příchozí platby, a možnost Vytvářet chybějící dodavatele u řádku se jménem věřitele (…/RltdPties/Cdtr/Nm) pro každého neznámého příjemce odchozí platby. Partneři jsou rozpoznáváni nejprve podle IBANu (IBAN se ukládá k bankovním účtům partnera) a následně podle přesného názvu; partner nalezený podle názvu získá doplněný IBAN, takže ho další import rozpozná už podle IBANu. Nový partner je označen jako firma, pokud jeho název obsahuje právní formu (s.r.o., a.s., z.ú., v.o.s., k.s., UAB, MB, SIA, OÜ, GmbH, Ltd, …), v opačném případě jde o fyzickou osobu.
Vytvořit partnera pro banku. Zaškrtněte u řádku pravidla Bankovní poplatky. Import vytvoří dodavatele pojmenovaného podle banky (Stmt/Acct/Svcr/FinInstnId/Nm, případně podle názvu bankovního účtu, pokud výpis název banky neobsahuje) a každý poplatek zaeviduje v deníku s tímto partnerem.
Propojit faktury pomocí tohoto pole. Zaškrtněte u řádku zprávy pro příjemce (…/RmtInf/Ustrd), řádku strukturovaného symbolu (…/RmtInf/Strd/CdtrRefInf/Ref) nebo řádku end-to-end identifikátoru (…/Refs/EndToEndId). Tuto možnost může obsahovat pouze jeden řádek; import však přečte všechny tři texty bez ohledu na to, který řádek je zaškrtnut. Zobrazí se dvě další volby:
- Vytvářet zálohové faktury pro nespárované příchozí platby - příchozí platba, která neodpovídá žádné faktuře a pochází od známého partnera, vygeneruje vydanou zálohovou fakturu (číselná řada VF) na danou částku s datem platby a platba se k ní spáruje. Partner musí být známý, proto zaškrtněte také možnost Vytvářet chybějící zákazníky.
- Sazba DPH a Položka katalogu pro tyto zálohové faktury. Pokud je položka vybrána, použije se její účet a v případě prázdné sazby také její sazba DPH.
Šablonu uložte.
4. Import souboru
V sekci Banka vyberte bankovní účet, šablonu a soubor a klikněte na tlačítko Importovat. Výsledek informuje o tom, kolik transakcí bylo importováno, kolik jich již existovalo, kolik pohybů bylo zaúčtováno, kolik partnerů bylo vytvořeno a kolik faktur bylo propojeno či vytvořeno. Varování vypisují platby, které se nepodařilo spárovat, a udávají důvod.
Opakovaný import téhož souboru je bezpečný: položky jsou rozpoznávány podle referenčního čísla bankovní položky (NtryRef, AcctSvcrRef nebo ID transakce TxId), případně - pokud chybí - pomocí heše (hash) data zaúčtování, částky, měny, IBANu protistrany a textu, přičemž se počítá s tím, že totožné položky kdekoli v jednom souboru zůstanou oddělené. Partneři jsou rozpoznáváni podle IBANu a názvu. Zaúčtované položky s nulovou částkou jsou přeskočeny s varováním.
5. Co dělá funkce „Propojit faktury pomocí tohoto pole“
Každá nová bankovní položka se porovnává s otevřenými dokumenty:
- příchozí platby proti vydaným prodejním fakturám, které nejsou zcela zaplaceny, podle čísla faktury (například
VF-123) nalezeného v textu pro příjemce, ve strukturovaném symbolu nebo v end-to-end identifikátoru; - odchozí platby proti zaevidovaným přijatým fakturám, které nejsou zcela zaplaceny, podle čísla dokladu dodavatele.
Shoda zaznamená platbu k faktuře a zaúčtuje příjem nebo platbu; položka se v sekci Banka → Transakce zobrazí jako spárovaná s odkazem na fakturu. Položky bez rozpoznatelného čísla zůstanou nespárované a lze je spárovat ručně ze seznamu transakcí, případně je - u příchozích plateb od známého zákazníka - při zapnuté příslušné volbě převést na zálohovou fakturu.
6. Kde hledat výsledky
- Banka → Transakce - všechny importované položky; spárované položky obsahují odkaz na fakturu nebo účetní zápis.
- Faktury - zálohové faktury vytvořené pro nespárované příchozí platby.
- Partneři - vytvoření zákazníci a dodavatelé, každý s IBANem uloženým u bankovních účtů.
- Hlavní kniha → Účetní deník - zaúčtování poplatků (s bankou jako partnerem), úroků, daní a plateb.
Fakturace
Podporovány jsou soubory do velikosti 10 MB a s maximálně 50 000 položkami. Každých 10 importovaných položek se počítá jako jeden požadavek API.