Poplatky za mýtné univerzální CSV — Uživatelská dokumentace

Obsah

Úvod
Konfigurace mapování sloupců
Konfigurace parametrů importu
Konfigurace číselníku států
Spuštění importu
Kontrola a párování importovaných dat
Nejčastější otázky a řešení problémů

1. Úvod

Ovladač Poplatky za mýtné univerzální CSV umožňuje importovat záznamy o mýtných transakcích z libovolného CSV souboru do aplikace Doprava 4K. Na rozdíl od ostatních mýtných ovladačů (DKV BOX, TollCollect, PREMID, CzechToll atd.), které mají pevně daný formát souboru, tento ovladač umožňuje uživatelsky definovat mapování sloupců — tzn. přiřadit, který sloupec v CSV odpovídá které informaci (SPZ, datum, cena, stát atd.).

Import vytváří ostatní doklady (XX) v agendě dopravy, které se párují s jízdními příkazy.

Poznámka: Pro práci s ovladačem potřebujete příslušná oprávnění k importu mýtného a přístup k modulu importů.

2. Konfigurace mapování sloupců

Před prvním importem je nutné definovat alespoň jednu šablonu mapování sloupců, která popisuje strukturu vašeho CSV souboru.

2.1 Otevření nastavení

Otevřete import mýtného: Poplatky za mýtné univerzální CSV
Klikněte na Možnosti driveru
Přejděte na záložku Mapování sloupců

2.2 Popis záložky Mapování sloupců

V horní části záložky je žlutý informační panel s textem:

Definujte mapování sloupců CSV souborů pro univerzální import.
Dostupné sloupce: SPZ, CISLO_KARTY, DATUM, CAS, DATUM_CAS, CENA, CENA_S_DPH, DPH, MENA, STAT, EXT_CISLO, USEK_ZAC, USEK_KON, USEK_PRUB, SKIP (SKIP2, SKIP3.. pro více)

Pod informačním panelem je editační oblast s těmito poli:

Pole	Popis	Příklad
Název	Pojmenování šablony (pro snadnou identifikaci)	`DKV Total Cost Report`
Hlavička	Definice sloupců oddělená středníky — přiřazuje každý sloupec CSV k odpovídajícímu poli	`CISLO_KARTY;SPZ;SKIP;SKIP;DATUM_CAS;...`
Oddělovač	Znak oddělující sloupce v CSV souboru	`;` nebo `,`
Des. oddělovač	Desetinný oddělovač v číselných hodnotách	`.` nebo `,`
Formát data	Formát data v CSV souboru	`dd.mm.yyyy`
Formát času	Formát času v CSV souboru	`hh:nn`
Má hlavičku	Zaškrtněte, pokud první řádek CSV obsahuje názvy sloupců	☑
Datum+čas spojen	Zaškrtněte, pokud datum a čas jsou v jednom sloupci	☑
Cena obsahuje měnu	Zaškrtněte, pokud cena je ve formátu „60.18 EUR“ (hodnota + mezera + měna)	☑
Aktivní	Zaškrtněte, aby šablona byla k dispozici při importu	☑

Ve spodní části je tabulka se seznamem existujících šablon (sloupce Název a Hlavička) a tlačítka Přidat, Opravit, Smazat.

2.3 Vytvoření nové šablony

Na záložce Mapování sloupců klikněte na Přidat
Editační pole se zpřístupní (zbělejí)
Do pole Název zadejte srozumitelný název šablony
Do pole Hlavička zadejte mapování sloupců:
- Otevřete svůj CSV soubor v textovém editoru a podívejte se na první řádek (hlavičku)
- Pro každý sloupec CSV zapište odpovídající název pole, oddělte středníkem
- Sloupce, které nepotřebujete, zapište jako SKIP
Vyplňte oddělovač, desetinný oddělovač, formáty data/času
Zaškrtněte příslušné přepínače
Klikněte na OK pro uložení

Tip: Počet polí v hlavičce musí přesně odpovídat počtu sloupců v CSV souboru. Pokud se neshoduje, import soubor nerozpozná.

2.4 Dostupné názvy sloupců

Název	Popis
`SPZ`	Registrační značka vozidla
`CISLO_KARTY`	Číslo karty nebo OBU
`DATUM`	Datum transakce (samostatný sloupec)
`CAS`	Čas transakce (samostatný sloupec)
`DATUM_CAS`	Datum a čas v jednom sloupci (nutno zaškrtnout Datum+čas spojen)
`CENA`	Cena bez DPH
`CENA_S_DPH`	Cena s DPH
`DPH`	Částka DPH
`MENA`	Měna (pokud cena NEobsahuje měnu)
`STAT`	Kód státu (ISO zkratka, např. AT, DE, CZ)
`EXT_CISLO`	Externí číslo dokladu (číslo faktury)
`USEK_ZAC`	Mýtný úsek — začátek
`USEK_KON`	Mýtný úsek — konec
`USEK_PRUB`	Mýtný úsek — průběh/trasa
`SKIP`	Přeskočit sloupec (pro více sloupců: `SKIP`, `SKIP2`, `SKIP3`…)

Upozornění: Pokud je zaškrtnuto Cena obsahuje měnu, měna se automaticky extrahuje z cenových polí (text za mezerou, např. „60.18 EUR“ → cena = 60.18, měna = EUR). V tom případě pole MENA v hlavičce není potřeba.

2.5 Příklad: DKV Total Cost Report

CSV soubor má 31 sloupců oddělených středníkem. První řádek:

Číslo karty/krabice;RZ motorového vozidla;Zákaznické číslo;Název společnosti;
Doba transakce;Stav faktury;Datum vyúčtování;Číslo faktury;...

Mapování:

CISLO_KARTY;SPZ;SKIP;SKIP2;DATUM_CAS;SKIP3;SKIP4;EXT_CISLO;SKIP5;SKIP6;SKIP7;SKIP8;
SKIP9;SKIP10;SKIP11;CENA;CENA_S_DPH;SKIP12;DPH;SKIP13;SKIP14;STAT;SKIP15;SKIP16;SKIP17;SKIP18;
SKIP19;SKIP20;SKIP21;SKIP22;SKIP23

Nastavení: Oddělovač ;, Des. oddělovač ., Má hlavičku ☑, Datum+čas spojen ☑, Formát data dd.mm.yyyy, Cena obsahuje měnu ☑.

2.6 Úprava a smazání šablony

Úprava: V tabulce vyberte šablonu, klikněte na Opravit, upravte pole, klikněte OK
Smazání: V tabulce vyberte šablonu, klikněte na Smazat, potvrďte dialog

3. Konfigurace parametrů importu

Na záložce Parametry nastavte obecné parametry importu (společné pro všechny mýtné ovladače):

3.1 Dodavatel na dokladech

V sekci Dodavatel na dokladech klikněte na tlačítko […] vedle pole Kód firmy a vyberte dodavatele, který bude uveden na importovaných dokladech.

3.2 Záznamy o mýtném

V sekci Záznamy o mýtném klikněte na […] vedle pole Kontace mýtného a vyberte odpovídající položku z účetní osnovy.

3.3 Ostatní doklady (XX)

Nastavení	Popis
Automaticky párovat s jízdním příkazem	Při importu se automaticky hledá odpovídající jízdní příkaz dle SPZ a data
Importovat pouze záznamy spárované s jízdním příkazem	Záznamy bez vazby na jízdní příkaz se neimportují
Povolit import do zkontrolovaných jízdních příkazů	Automaticky zruší kontrolu JP při importu
Kontace mýtného dle státu	Kontace se přiřazuje individuálně dle státu (viz záložka Číselník států). Specifické pro univerzální CSV.
U výdajů v zahraničí započítávat do nákladů částku včetně DPH	U zahraničních mýtných transakcí se do nákladů započítá brutto částka

3.4 Rozdělení položek do dokladů

Volba	Popis
Pro každý úsek samostatný doklad	Každý řádek CSV = jeden doklad s jednou položkou
Za každý den samostatný doklad	Řádky ze stejného dne a vozidla se sloučí do jednoho dokladu
Ukládat mýtné úseky v souhrnu	Řádky se sečtou do jedné souhrnné položky za den

4. Konfigurace číselníku států

Na záložce Číselník států přiřaďte kódy států z CSV souboru odpovídajícím státům v systému.

Klikněte na Přidat
Do pole Kód státu zadejte kód tak, jak se vyskytuje v CSV (např. AT)
V rozbalovacím seznamu Přiřazení vyberte odpovídající stát
Pokud máte zapnutou Kontaci mýtného dle státu, vyberte v rozbalovacím seznamu Kontace mýtného příslušnou položku účetní osnovy
Volitelně vyplňte Sazba DPH
Klikněte na OK

Poznámka: Pokud import narazí na neznámý kód státu, nabídne automatické přidání do číselníku.

5. Spuštění importu

5.1 Příprava

Ujistěte se, že máte vytvořenou alespoň jednu šablonu mapování (viz kapitola 2)
Uložte CSV soubor do složky pro import (výchozí: C:\IMPORTY\MYTNE_CSV\)

5.2 Postup importu

Spusťte import Poplatky za mýtné univerzální CSV
V dialogu výběru souboru vyberte CSV soubor(y) k importu
Aplikace automaticky rozpozná formát CSV dle definovaných šablon:
- Pokud je nalezena odpovídající šablona → import pokračuje automaticky
- Pokud formát není rozpoznán → zobrazí se dialog Výběr formátu importu s náhledem prvních řádků souboru a seznamem dostupných šablon. Vyberte správnou šablonu a klikněte OK.
Probíhá načítání a zpracování souboru (zobrazí se čekací dialog)
Po zpracování se zobrazí formulář Kontrola záznamů k importu (viz kapitola 6)

6. Kontrola a párování importovaných dat

6.1 Formulář kontroly záznamů

Po zpracování CSV souboru se zobrazí okno Kontrola záznamů k importu se dvěma záložkami:

Záložka „Záznamy k importu“

Tabulka zobrazuje všechny úspěšně zpracované záznamy. Barevné odlišení:

Barva	Význam
Černá	Nový záznam s vazbou na jízdní příkaz, nebo mimo jízdní příkaz
Červená	Nový záznam bez vazby na jízdní příkaz
Zelená	Již naimportovaný záznam s vazbou na jízdní příkaz
Hnědá	Již naimportovaný záznam bez vazby na jízdní příkaz

Dostupná tlačítka:

Pokračovat — spustí vlastní import vybraných záznamů do databáze
Storno — zruší import
Výběr jízdního příkazu — ruční spárování záznamu s jízdním příkazem
Vyřadit — vyřazení záznamu z importu
Zařadit k importu — opětovné zařazení vyřazeného záznamu
Zobrazit — přepnutí zobrazení (všechny / pouze nové / pouze opakované)

Záložka „Vyřazené záznamy“

Zobrazuje záznamy, které nebylo možné zpracovat. Důvody vyřazení:

Vozidlo (SPZ) nebylo nalezeno v číselníku vozidel
Neznámý kód státu
Neplatné datum nebo čas
Nulová cena

6.2 Dokončení importu

Zkontrolujte záznamy k importu
Případně ručně spárujte záznamy s jízdními příkazy
Klikněte na Pokračovat
Po dokončení se zobrazí souhrn počtu naimportovaných dokladů

7. Nejčastější otázky a řešení problémů

1. Import nenasel žádnou odpovídající šablonu a zobrazil dialog výběru formátu. Co dělat?

Počet sloupců ve vašem CSV neodpovídá žádné šabloně. Vyberte nejbližší šablonu, nebo se vraťte do Možností driveru → Mapování sloupců a vytvořte novou šablonu s přesným počtem polí odpovídajícím vašemu CSV.

2. Při otevření Možností driveru se zobrazí chyba „Údaj ID_DRUH musí být vyplněn“.

V databázi chybí záznam pro typ UNIVERSAL v tabulce IMP_TOLL_DRUHY. Kontaktujte správce a nechte spustit inicializační DB skript.

3. Import hlásí „Nejsou definované žádné mapovací šablony pro univerzální CSV“.

Nemáte vytvořenou žádnou aktivní šablonu mapování. Přejděte do Možností driveru → záložka Mapování sloupců a vytvořte šablonu (viz kapitola 2.3).

4. Záznamy se po importu objevují v záložce „Vyřazené záznamy“.

Nejčastější příčiny: SPZ z CSV souboru neodpovídá žádnému vozidlu v číselníku, nebo kód státu není v číselníku. Zkontrolujte, že vozidla a státy jsou správně evidovány.

5. Ceny se importují jako nulové.

Zkontrolujte nastavení šablony: pokud jsou ceny ve formátu „60.18 EUR“, musí být zaškrtnuto Cena obsahuje měnu. Dále zkontrolujte, že Des. oddělovač odpovídá formátu čísla v CSV (tečka vs čárka).

6. Datum transakce se nezpracuje správně.

Zkontrolujte Formát data v šabloně — musí odpovídat formátu v CSV. Pokud jsou datum a čas v jednom sloupci (např. „03.01.2026 – 00:00″), musí být zaškrtnuto Datum+čas spojen. Ovladač podporuje oddělovač „ – “ (mezera pomlčka mezera) i prostou mezeru.

7. Jak přidat nový formát CSV od jiného poskytovatele mýtného?

Jednoduše vytvořte novou šablonu v Možnostech driveru → Mapování sloupců. Otevřete CSV v textovém editoru, spočítejte sloupce a pro každý napište odpovídající název pole nebo SKIP. Není potřeba žádný zásah do programu.

8. Jaký je rozdíl oproti specifickému ovladači (např. DKV BOX)?

Specifické ovladače mají pevně naprogramované mapování sloupců a mohou využívat speciální funkce daného poskytovatele. Univerzální ovladač je flexibilnější, ale nemusí podporovat všechny detaily specifického formátu. Pokud pro vašeho poskytovatele existuje dedikovaný ovladač, je lepší použít ten.

9. Jak zjistím, kolik sloupců má můj CSV soubor?

Otevřete CSV v textovém editoru (např. Notepad++), najděte první řádek (hlavičku) a spočítejte oddělovače (středníky, čárky). Počet sloupců = počet oddělovačů + 1. Stejný počet polí musí být v mapování.

10. Import hlásí „Údaj POPIS musí být vyplněn“.

Tato chyba se může objevit u starší verze ovladače, pokud CSV neobsahuje pole USEK_PRUB. V aktuální verzi se automaticky doplní výchozí hodnota. Aktualizujte DLL na nejnovější verzi.

Import mýtného – univerzální CSV formát (DKV Cockpit)