Home » » Odkazy nápověd » Importy » Import čerpání Unicode Systems Euroshop

Import čerpání Unicode Systems Euroshop

Uživatelský návod — Import čerpání UNICODE SYSTEMS Euroshop

1. Úvod

Ovladač Čerpání UNICODE SYSTEMS Euroshop slouží k importu záznamů o čerpání pohonných hmot a dalšího sortimentu (nemrznoucí kapaliny, autokosmetika, mytí apod.) z kartového systému UNICODE SYSTEMS Euroshop do vašeho informačního systému.

Import zpracovává soubor ve formátu CSV, který obdržíte z kartového systému Euroshop. Na základě tohoto souboru se automaticky vytvoří interní doklady (typ XX). Typ dokladu nelze změnit — systém vždy generuje pouze interní doklady XX.

Co budete potřebovat

  • CSV soubor exportovaný ze systému UNICODE SYSTEMS Euroshop
  • Správně nastavený číselník vozidel (přiřazení karet k vozidlům)
  • Správně nastavený číselník produktů (přiřazení produktů k účetní osnově)
  • Oprávnění k modulu importu čerpání (modul 384)

2. Příprava vstupního souboru

2.1 Kam soubor umístit

Výchozí umístění, kde systém hledá soubory pro import, je:

C:\IMPORTY\EUROSHOP\*.csv

Uložte CSV soubor exportovaný z Euroshop do složky C:\IMPORTY\EUROSHOP\. Soubor musí mít příponu .csv. Při spuštění importu můžete cestu změnit nebo vybrat jiný soubor.

2.2 Požadovaný formát souboru

Vstupní soubor musí splňovat následující podmínky:

Vlastnost Požadavek
Formát CSV (textový soubor s oddělenými hodnotami)
Oddělovač sloupců Středník ; (doporučeno), čárka , nebo tabulátor
Hlavička Soubor nesmí obsahovat hlavičku — systém ji přidává automaticky
Počet sloupců Přesně 11 sloupců v každém řádku
Desetinný oddělovač Tečka . (např. 55.44, nikoli 55,44)
Formát data a času yyyy.mm.dd hh:nn:ss (např. 2020.03.31 12:34:28)

⚠️ Důležité upozornění: Euroshop používá tečku jako desetinný oddělovač i jako oddělovač v datu. Tento formát se liší od běžného českého zápisu. Neupravujte soubor ručně — mohl byste narušit formát dat.

2.3 Struktura sloupců CSV souboru

Každý řádek CSV souboru představuje jeden záznam o čerpání a musí obsahovat přesně 11 hodnot v tomto pořadí:

Pořadí Obsah Příklad Popis
1 Datum a čas 2020.03.31 12:34:28 Datum a čas čerpání ve formátu rok.měsíc.den hodina:minuta:sekunda
2 ID karty 562001397 Identifikační číslo karty přiřazené k vozidlu
3 SPZ 7B9 2881 Státní poznávací značka vozidla
4 Kód produktu 4 Číselný kód čerpaného produktu
5 Název produktu Natural Textový název produktu
6 Množství 55.44 Čerpané množství (v litrech, s tečkou)
7 Pistole 1 Číslo výdejní pistole (systém tuto hodnotu nevyužívá)
8 Měna CZK Kód měny
9 Cena bez DPH 1232.53 Celková cena bez DPH (s tečkou)
10 Cena s DPH 1491.36 Celková cena včetně DPH (s tečkou)
11 Sazba DPH 21 Sazba DPH v procentech

2.4 Ukázka správného CSV souboru

2020.03.31 12:34:28;562001397;7B9 2881;4;Natural;55.44;1;CZK;1232.53;1491.36;21
2020.03.31 14:15:00;562001306;7B5 1775;1;Nafta;42.30;2;CZK;950.10;1149.62;21

💡 Tip: Soubor nesmí obsahovat žádný řádek s hlavičkou (nadpisy sloupců). Pokud váš export hlavičku obsahuje, odstraňte ji před importem.

3. Nastavení ovladače (před prvním importem)

Před prvním importem je nutné správně nastavit ovladač. Nastavení se otevírá přes funkci Možnosti driveru (tlačítko nastavení u ovladače Euroshop).

3.1 Číselník vozidel

Záložka Číselník vozidel je klíčovou částí nastavení. Slouží k přiřazení karet Euroshop k vozidlům evidovaným ve vašem systému.

Proč je to důležité:
Systém Euroshop identifikuje vozidla pomocí ID karty (např. 562001397). Aby se čerpání správně přiřadilo k vozidlu v informačním systému, musí být karta propojena s interním vozidlem.

⚠️ Kritické upozornění: Pokud karta není přiřazena k žádnému internímu vozidlu, záznam o čerpání bude při importu vyřazen (označen TAG = V) a nebude naimportován. Ve výchozím stavu může být většina karet nepřiřazena!

Jak přiřadit vozidlo:

  1. Otevřete Možnosti driveru → záložka Číselník vozidel.
  2. V tabulce uvidíte seznam karet s jejich kódy (ID karty).
  3. Ve sloupci Poznámka je pro orientaci uvedena SPZ vozidla.
  4. U každého záznamu nastavte přiřazení k příslušnému internímu vozidlu (sloupec KMCIS).
  5. Uložte změny.

Poznámky k formátu kódů karet:

  • Většina karet má číselný kód začínající 562001... (např. 562001397)
  • Některé karty mohou mít kratší kódy (000060, 60008)
  • Některé karty mohou mít alfanumerické kódy (AF763, 52C0E, F03AB)
  • Kód zadávejte přesně tak, jak přichází v CSV souboru

3.2 Číselník produktů

Záložka Číselník produktů slouží k přiřazení produktů z Euroshop k účetní osnově.

Standardní produkty:

Kód Název produktu Doporučený účet Popis
1 Nafta TA-N Pohonné hmoty – Nafta
4 Natural TA-B Pohonné hmoty – Benzín
10 Nemrznoucí kapaliny SM Spotřební materiál
47 Aditivum TA-O Pohonné hmoty – Ostatní
14 Mytí (nutno přiřadit) Nepřiřazeno ve výchozím stavu
11 Autokosmetika (nutno přiřadit) Nepřiřazeno ve výchozím stavu

Jak přiřadit produkt:

  1. Otevřete Možnosti driveru → záložka Číselník produktů.
  2. U každého produktu zkontrolujte, zda má přiřazený účet osnovy.
  3. Pokud chcete importovat položky Mytí nebo Autokosmetika, přiřaďte jim příslušný účet.
  4. Pokud tyto položky importovat nechcete, ponechte je bez přiřazení — záznamy s těmito produkty budou automaticky vyřazeny z importu (TAG = P).

💡 Tip: Pokud se v CSV souboru objeví nový kód produktu, který v číselníku není, bude při importu vyřazen. V takovém případě jej přidejte do číselníku a přiřaďte účet.

3.3 Obecná nastavení

V nastavení ovladače najdete následující společné volby:

Nastavení Výchozí hodnota Popis
Typ dokladu XX (interní doklad) Nelze změnit — vždy se generují interní doklady XX
Párovat se stázkami ✅ Zapnuto Automaticky páruje záznamy s jízdními příkazy (stázkami)
Importovat pouze spárované ❌ Vypnuto Importují se i záznamy, které se nepodařilo spárovat se stázkou
Vymazat příznaky ✅ Zapnuto Povoluje import do již zkontrolovaných jízdních příkazů
Nulový čas ✅ Zapnuto Záznamy s časem 0:00 se párují bez ohledu na čas

💡 Tip: Pokud nechcete automatické párování se stázkami, vypněte volbu Párovat se stázkami. Pokud chcete importovat pouze záznamy, které mají vazbu na jízdní příkaz, zapněte Importovat pouze spárované.

3.4 Nastavení souborů

Ovladač umožňuje nastavit:

  • Cestu k importnímu souboru — výchozí je C:\IMPORTY\EUROSHOP\*.csv
  • Cestu k log souboru — protokol průběhu importu (pro diagnostiku)
  • Smazat soubor po importu — pokud je zapnuto, CSV soubor se po úspěšném importu automaticky smaže

4. Spuštění importu

4.1 Krok za krokem

  1. Připravte CSV soubor — uložte jej do složky C:\IMPORTY\EUROSHOP\ (nebo na jiné dohodnuté místo).

  2. Spusťte import — v systému zvolte funkci importu čerpání Euroshop.

  3. Vyberte soubor — systém zobrazí dialog pro výběr souboru. Výchozí maska je C:\IMPORTY\EUROSHOP\*.csv. Vyberte požadovaný CSV soubor a potvrďte.

  4. Zpracování souboru — systém automaticky:

    • Načte CSV soubor
    • Přidá interní hlavičku (neviditelné pro uživatele)
    • Rozpozná oddělovač sloupců (středník, čárka nebo tabulátor)
    • Zpracuje každý řádek souboru

  5. Zobrazení náhledu — systém zobrazí náhled importovaných záznamů ve formuláři se dvěma sekcemi:

    • Importované záznamy — záznamy připravené k importu
    • Vyřazené záznamy — záznamy, které nelze importovat (chybějící přiřazení vozidla/produktu, duplicity apod.)

4.2 Informace zobrazené v náhledu

V náhledu importu uvidíte tyto sloupce (mimo jiné):

  • Kód vozidla — ID karty z CSV
  • SPZ — státní poznávací značka
  • Datum a čas — datum a čas čerpání
  • Produkt — název čerpaného produktu
  • Množství — čerpané množství
  • Cena — cenové údaje
  • Sazba DPH — sazba DPH z výpisu (viditelný sloupec)
  • Jednotková cena — dopočítaná systémem (viditelný sloupec)

ℹ️ Poznámka: Sloupec Řidič se v náhledu nezobrazuje — ovladač Euroshop informace o řidičích neimportuje.

5. Barevné kódování záznamů v náhledu

Záznamy v náhledu jsou barevně odlišeny pro snadnou orientaci:

Barva textu Pozadí Význam
Černá Bílé ✅ Záznam je v pořádku — nový, s vazbou na jízdní příkaz nebo označený „Mimo JP“
Červená Bílé ⚠️ Nový záznam, ale nemá vazbu na žádný jízdní příkaz
Hnědá Bílé ℹ️ Záznam byl již dříve naimportován a nemá vazbu na jízdní příkaz
Zelená Bílé ℹ️ Záznam byl již dříve naimportován a má vazbu na jízdní příkaz
Libovolná Šedé ❌ Záznam je vyřazen z importu (nenalezeno vozidlo, nepřiřazený produkt apod.)

Co dělat podle barvy:

  • Černé záznamy — vše je v pořádku, lze importovat.
  • Červené záznamy — záznam bude naimportován, ale nemá vazbu na jízdní příkaz. Vazbu můžete doplnit později, případně zkontrolujte nastavení párování.
  • Hnědé/zelené záznamy — jedná se o duplicity (již naimportované). Nebudou znovu importovány.
  • Šedé pozadí — záznam je vyřazen. Zkontrolujte, proč (viz sloupec s důvodem vyřazení — TAG).

6. Potvrzení a dokončení importu

  1. Zkontrolujte záznamy v náhledu — ověřte, že důležité záznamy jsou v sekci importovaných (nikoli vyřazených).

  2. Zkontrolujte vyřazené záznamy — pokud jsou záznamy vyřazeny neočekávaně, zjistěte důvod:

    • TAG = V — vozidlo (karta) není přiřazeno v číselníku vozidel
    • TAG = P — produkt není přiřazen k účetní osnově

  3. Potvrďte import — po kontrole potvrďte import tlačítkem pro spuštění. Systém vygeneruje interní doklady XX pro všechny schválené záznamy.

  4. Výsledek — po dokončení importu:

    • Byly vytvořeny interní doklady XX
    • Záznamy byly přiřazeny ke správným vozidlům a účtům
    • Pokud bylo nastaveno, CSV soubor byl smazán
    • V logovacím souboru je zaznamenán průběh importu

7. Řešení nejčastějších problémů

7.1 Soubor se nepodařilo zpracovat

Příznaky: Import skončí chybou hned po výběru souboru.

Řešení:

  • Ověřte, že soubor má příponu .csv.
  • Zkontrolujte, že soubor obsahuje přesně 11 hodnot na každém řádku, oddělených středníkem.
  • Ověřte, že soubor nemá hlavičku (řádek s nadpisy sloupců) — ovladač ji přidává automaticky. Pokud hlavička v souboru je, odstraňte první řádek.
  • Zkontrolujte, že číselné hodnoty používají tečku jako desetinný oddělovač (55.44, nikoli 55,44).
  • Ověřte, že datum je ve formátu yyyy.mm.dd (rok.měsíc.den s tečkami, např. 2020.03.31).

7.2 Většina záznamů je vyřazena (TAG = V — nenalezeno vozidlo)

Příznaky: V náhledu je většina záznamů v sekci vyřazených se šedým pozadím a označením TAG = V.

Příčina: Karty Euroshop nejsou přiřazeny k interním vozidlům v číselníku.

Řešení:

  1. Otevřete Možnosti driveru → záložka Číselník vozidel.
  2. Pro každou kartu (ID karty) nastavte přiřazení k odpovídajícímu vozidlu ve vašem systému.
  3. Využijte pole Poznámka, kde je pro referenci uvedena SPZ vozidla.
  4. Po přiřazení spusťte import znovu.

7.3 Záznamy produktů Mytí nebo Autokosmetika jsou vyřazeny (TAG = P)

Příznaky: Záznamy s produkty Mytí (kód 14) nebo Autokosmetika (kód 11) jsou vyřazeny.

Příčina: Tyto produkty nemají přiřazený účet v účetní osnově.

Řešení:

  • Pokud chcete tyto položky importovat: Možnosti driveru → Číselník produktů → přiřaďte účet osnovy.
  • Pokud je importovat nechcete: Ponechte bez přiřazení — budou automaticky vyřazeny, což je v pořádku.

7.4 Datum nebo čas se nezobrazuje správně

Příznaky: Ve sloupci datum/čas jsou nesmyslné hodnoty nebo chyby.

Příčina: CSV soubor obsahuje datum v jiném formátu, než ovladač očekává.

Řešení:

  • Ovladač očekává formát: yyyy.mm.dd hh:nn:ss (např. 2020.03.31 12:34:28).
  • Otevřete CSV soubor v textovém editoru (Poznámkový blok, Notepad++) a zkontrolujte formát data v prvních řádcích.
  • Pokud systém Euroshop exportuje data v jiném formátu, kontaktujte správce systému Euroshop nebo technickou podporu.

7.5 Nesprávné částky (ceny)

Příznaky: Importované ceny jsou nesprávné — příliš vysoké, nulové nebo nesmyslné.

Příčina: Soubor může obsahovat čárky místo teček v číslech.

Řešení:

  • Ovladač očekává tečku jako desetinný oddělovač: 1232.53 (nikoli 1232,53).
  • Otevřete CSV v textovém editoru a ověřte formát čísel.
  • Neupravujte soubor v Excelu — Excel může automaticky změnit formát čísel.

7.6 Nový produkt se v importu nezobrazuje nebo je vyřazen

Příčina: Kód produktu z CSV neodpovídá žádnému záznamu v číselníku produktů.

Řešení:

  1. Otevřete CSV soubor a zjistěte přesný kód nového produktu (4. sloupec).
  2. Přidejte tento kód do Možnosti driveru → Číselník produktů.
  3. Přiřaďte mu účet osnovy.
  4. Kódy jsou číselné řetězce bez vedoucích nul (např. 4, nikoli 04).

7.7 Záznamy se importují duplicitně nebo se hlásí jako duplicitní

Vysvětlení: Systém kontroluje duplicity pomocí unikátního kódu (IMP_KOD), který se skládá z:

  • Identifikátoru ovladače EUROSHOP
  • ID karty
  • Data a času včetně sekund
  • Kódu produktu

Příklad: EUROSHOP_562001397_20200331123428_4

Pokud se záznam hlásí jako duplicitní, znamená to, že stejný záznam (stejná karta, stejný čas, stejný produkt) byl již dříve naimportován. Je zobrazen hnědou nebo zelenou barvou.

ℹ️ Poznámka: Dvě čerpání stejnou kartou, ve stejnou sekundu a se stejným produktem by systém považoval za duplicitu. V praxi je tento scénář extrémně nepravděpodobný.

7.8 Záznamy bez SPZ

Ovladač Euroshop je nastaven tak, že importuje i záznamy bez vyplněné SPZ. Pokud CSV soubor obsahuje řádek s prázdným polem SPZ, záznam bude zpracován normálně — vozidlo se identifikuje přes ID karty.

8. Přehled důležitých informací

Výchozí nastavení importu

Parametr Hodnota Význam
Typ dokladu XX (pevně dáno) Vždy se generují interní doklady
Výchozí cesta C:\IMPORTY\EUROSHOP\*.csv Složka s importními soubory
Párování se stázkami Zapnuto Automatické párování s jízdními příkazy
Import bez SPZ Povolen Záznamy bez SPZ se importují
Identifikace vozidla ID karty Vozidla se identifikují číslem karty
Identifikace řidiče Neprovádí se Ovladač řidiče neimportuje
Měna Z CSV souboru Obvykle CZK, ale může být i jiná
Sazba DPH Z CSV souboru Čte se přímo z každého záznamu

Podporované produkty (výchozí číselník)

Kód Produkt Typ
1 Nafta Pohonná hmota
4 Natural Pohonná hmota
47 Aditivum Pohonná hmota – ostatní
10 Nemrznoucí kapaliny Spotřební materiál
14 Mytí Služba (nutno přiřadit)
11 Autokosmetika Zboží (nutno přiřadit)

9. Doporučený postup pro nové uživatele

Při prvním použití ovladače doporučujeme postupovat v tomto pořadí:

  1. Nastavte číselník vozidel — přiřaďte všechny karty Euroshop k interním vozidlům. Toto je nejdůležitější krok — bez něj se záznamy neimportují.

  2. Zkontrolujte číselník produktů — ověřte, že všechny produkty mají přiřazený účet osnovy (případně rozhodněte, které produkty nechcete importovat).

  3. Zkontrolujte obecná nastavení — ověřte nastavení párování se stázkami a dalších voleb dle potřeb vaší organizace.

  4. Proveďte zkušební import — importujte první soubor a důkladně zkontrolujte náhled. Ověřte, že:

    • Vozidla jsou správně rozpoznána
    • Produkty jsou přiřazeny ke správným účtům
    • Ceny a množství odpovídají údajům v CSV souboru
    • Data a časy jsou správně načteny

  5. Potvrďte import — pokud je vše v pořádku, potvrďte generování dokladů.

  6. Zkontrolujte vytvořené doklady — ověřte v systému, že interní doklady XX byly vytvořeny správně.

10. Kontakt na podporu

Pokud narazíte na problém, který se vám nepodaří vyřešit pomocí tohoto návodu, obraťte se na technickou podporu vašeho informačního systému. Při hlášení problému uveďte:

  • Přesný popis chyby nebo neočekávaného chování
  • Ukázku řádku z CSV souboru (bez citlivých údajů)
  • Informaci o tom, které záznamy jsou vyřazeny a s jakým TAG kódem (V, P apod.)
  • Obsah logovacího souboru (pokud je nastaven)