# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/import-plateb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.