# Import plateb

Modul **Import plateb** zjednodušuje práci s úhradami objednávek tím, že:

* umožňuje **nahrát exportní soubor z banky (výpis)**,
* automaticky z něj načte všechny **bankovní transakce**,
* pokusí se je **spárovat s objednávkami** ve vašem e‑shopu.

Výsledkem je:

* méně ručního přepisování plateb,
* méně chyb (překlepy ve variabilním symbolu, částce apod.),
* lepší přehled o tom, které objednávky jsou skutečně zaplacené.

### K čemu slouží Import plateb

Bez modulu byste museli:

* otevřít výpis z banky,
* ručně hledat variabilní symboly / částky,
* u každé objednávky ručně měnit stav na „zaplacená“.

S modulem:

* jednou za čas (např. denně) **nahrajete výpis z banky**,
* systém si z výpisu přečte jednotlivé platby,
* automaticky je přiřadí k objednávkám podle **variabilního symbolu / dalších kritérií**,
* objednávky se mohou automaticky označit jako **zaplacené** a změnit stav.

### **Podporované banky**

Aktuálně modul podporuje import z CSV souboru z těchto bank:

* **Raiffeisenbank (RB)**
* **AirBank**
* **Komerční banka (KB)**t
* **Moneta Bank**

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

V administraci e‑shopu přejděte na:

* **Nastavení → Import plateb**

Zde:

* nastavíte, pro které banky je import povolen,
* určíte chování systému po spárování platby (stav objednávky, označení jako zaplacená),
* otevřete nástroj pro samotné nahrávání bankovních výpisů (tlačítko / toolbar v části Import plateb).

## Jak import funguje

{% stepper %}
{% step %}
V internetovém bankovnictví **stáhnete CSV soubor s transakcemi** (výpis z účtu) za zvolené období.
{% endstep %}

{% step %}
V administraci e‑shopu tento soubor **nahrajete** do modulu Import plateb.
{% endstep %}

{% step %}
Systém soubor zpracuje:

* načte jednotlivé řádky (transakce),
* rozpozná variabilní symbol, částku a další údaje.
  {% endstep %}

{% step %}
Podle nastavených pravidel se pokusí:

* najít odpovídající objednávku v e‑shopu,
* pokud se podaří spárování, provede akce po přijetí platby (označení jako zaplacená, změna stavu).
  {% endstep %}

{% step %}
Systém zobrazí informaci, kolik transakcí bylo úspěšně načteno a/nebo spárováno.
{% endstep %}
{% endstepper %}

## Nastavení modulu v administraci

V **Nastavení → Import plateb** najdete tyto možnosti:

* **Povolené banky pro import**
  * zaškrtněte banky, ze kterých budete importovat výpisy,
  * pouze vybrané banky se pak nabídnou v rozhraní pro import.
* **Automaticky párovat platby**
  * pokud je zaškrtnuto, systém se u každé importované transakce pokusí:
    * najít odpovídající objednávku,
    * provést nastavené akce (označit zaplaceno, změnit stav).
* **Automaticky párovat pouze u těchto plateb**
  * můžete omezit automatické párování jen na vybrané typy plateb (např. bankovní převody),
  * ruční zásahy budete mít pod kontrolou u jiných typů plateb (např. dobírka, hotově apod.).
* **Při přijetí platby**:
  * **Změnit stav objednávky** – z rozbalovacího seznamu vyberte stav (např. „Zaplaceno – čeká na expedici“).

Tato nastavení ovlivňují, co se bude dít s objednávkami po úspěšném spárování platby.

## Jak naimportovat výpis z banky

{% stepper %}
{% step %}

### Stáhněte CSV výpis z banky

* Přihlaste se do internetového bankovnictví (Raiffeisenbank, Air Bank, KB, Moneta).
* Zvolte účet, ze kterého přijímáte platby za objednávky.
* Stáhněte **CSV soubor** s transakcemi za požadované období.
  {% endstep %}

{% step %}

### Otevřete modul Import plateb v administraci

* Jděte do **Objednávky → Transakce**.
  {% endstep %}

{% step %}

### Vyberte banku a nahrajte soubor

* Zvolte záložku podle toho, ze které banky výpis pochází (např. Air Bank).
* Klikněte na **Importovat platby** a přetáhněte soubor do vyznačeného prostoru.
  {% endstep %}

{% step %}

### Spusťte import

* Potvrďte import (tlačítko **Importovat platby**).
* Počkejte na zpracování.
  {% endstep %}

{% step %}

### Zkontrolujte výsledek

Systém zobrazí, zda:

* soubor byl v pořádku načten,
* byly nalezeny transakce,
* případně že některé platby nebylo možné spárovat.
  {% endstep %}
  {% endstepper %}

## Automatické párování plateb s objednávkami

Pokud je v nastavení **zapnuto automatické párování**:

* modul u každé transakce z výpisu zkusí najít odpovídající objednávku v systému,
* typicky podle **variabilního symbolu** (číslo objednávky / specifický symbol),
* může také ověřovat **částku** a další údaje.

Pokud se párování povede:

* k objednávce se uloží informace o přijaté platbě,
* dle nastavení se:
  * objednávka označí jako zaplacená,
  * změní se její stav (např. na *Zaplaceno*).

Pokud se párování nepovede:

* platba zůstane ve stavu **nespárovaná** (záleží na konkrétní implementaci zobrazení),
* je možné ji ručně dohledat a přiřadit – typicky na základě variabilního symbolu nebo částky.

## Řešení chyb a nejčastější hlášky

Při importu se mohou objevit tyto zprávy:

* **„Vyberte soubor k nahrání.“ / „Nebyl nahrán žádný soubor.“**
  * nebyl zvolen žádný soubor – je potřeba znovu vybrat CSV export.
* **„Chyba při nahrávání souboru.“**
  * problém při přenosu souboru na server, zkuste akci opakovat nebo ověřte velikost souboru.
* **„Nepovolený typ souboru.“**
  * export není ve správném formátu (např. místo CSV byl stažen PDF nebo XLS),
  * stáhněte výpis z banky znovu ve formátu **CSV**.
* **„CSV soubor neobsahuje požadované sloupce.“**
  * struktura CSV neodpovídá očekávanému formátu (mohlo dojít ke změně formátu na straně banky),
  * v takovém případě kontaktujte podporu nebo implementátora.
* **„Datový soubor neobsahoval žádné transakce.“**
  * výpis je prázdný pro dané období,
  * nebo byly všechny transakce již dříve zpracovány podle času / filtru exportu.
* **„Transakce byly úspěšně načteny.“**
  * soubor byl v pořádku zpracován,
  * další detail o spárovaných / nespárovaných platbách můžete sledovat v přehledech plateb nebo objednávek (dle implementace).

***

## Často kladené otázky

<details>

<summary>Jak často mám importovat výpisy z banky?</summary>

Záleží na objemu objednávek:

* menší e‑shopy – obvykle 1× denně,
* větší – i vícekrát denně (např. ráno a odpoledne).

Import je manuální (nahrajete soubor), ale rychlý, takže si snadno nastavíte rutinu.

</details>

<details>

<summary>Co když se změnil formát CSV v internetovém bankovnictví?</summary>

Pokud po změně formátu začnou padat chyby typu „neobsahuje požadované sloupce“:

* ověřte v bance, zda existuje volba **„starší“ / „kompatibilní“ export**,
* případně kontaktujte implementátora pro úpravu parsování souboru.

</details>

<details>

<summary>Spárují se i platby v jiné měně?</summary>

Záleží na konkrétní implementaci. Obecně:

* pokud je variabilní symbol a částka jednoznačně dohledatelná, párování proběhne,
* při složitějších scénářích (kurzy, poplatky) může být potřeba kontrola člověkem.

</details>

<details>

<summary>Co když zákazník zadal špatný variabilní symbol?</summary>

Automatické párování v takovém případě selže:

* platba zůstane nespárovaná,
* obsluha může ručně dohledat odpovídající objednávku a označit ji jako zaplacenou,
* je dobré mít v obchodních podmínkách a v e‑mailech jasně uvedeno, jak variabilní symbol správně použít.

</details>