Import akčních produktů z CSV/FTPS

Import akcí z CSV/FTPS umožňuje automatický import akčních produktů do systému Quant ze serveru FTPS. Prostřednictvím tohoto importu lze v Quantu při plánovaném zlevnění zboží na toto zboží vytvářet akce. Tuto možnost využijete například v případě, že používáte tisk cenovek z Quantu. Pobočky si tak mohou změněné cenovky vytisknout ještě před zahájením prodeje akčních produktů. Import akcí lze použít i u automatických objednávek, u kterých při plánované akci předpokládáme zvýšení poptávky po zlevněných produktech.

1. Příprava souboru pro import

Nejprve je třeba vytvořit Excel soubor s informacemi o jednotlivých akčních produktech. Soubor musí obsahovat primární ID produktu, název akce, typ akce, začátek akce, konec akce a pobočku/y, na kterých daná akce probíhá. Každý řádek představuje jeden akční produkt na konkrétní pobočce/pobočkách a každý sloupec konkrétní vlastnost dané akce. Jakmile je soubor připraven, je třeba jej exportovat a uložit jako soubor CSV. 

Excelový soubor s daty o akcích

2. Příklad nastavení automatické úlohy

V následujícím vysvětlení jsou použity názvy atributů ze souboru, který je na obrázku výše.

Povinné atributy:
  • ID Produktu: primární ID produktu, kterého se akce týká.
  • Název akce: zde vyplňte název konkrétní akce (např. Leták 9/2023).
  • Typ akce: druh akce, která se může znovu opakovat. Pokud daný typ akce v Quantu, ještě není založený, je potřeba ho vytvořit manuálně před spuštěním importu.
  • Pobočka: jedno nebo více ID poboček, kterých se akce týká. V případě více poboček, je potřeba jednotlivé ID poboček oddělit oddělovačem seznamu.
  • Datum zahájení / Datum ukončení: období plánované akce. 
Volitelné atributy:
  • Datum publikace cenovek: datum, kdy se má na pobočce zobrazit nová cenovka v sekci Připravené cenovky

V případě, že má více produktů uvedený stejný název akce, typ akce, stejné pobočky, datum zahájení a ukončení, vytvoří  se pro ně v Quantu jedna společná akce. Pokud se však liší např. počtem poboček nebo datem zahájení, vytvoří se dvě samostatné akce se stejným názvem, ale s jiným počtem poboček či datem zahájení.

Příklad nastavení

3. Nahrání souboru na FTPS

Nahrajete soubor, který chcete importovat, do příslušné složky např. akce na FTPS.

4. Nastavení automatické úlohy

V sekci Automatické úlohy vytvořte novou automatickou úlohu Import akčních produktů z CSV.

Import akčních cen produktů z CSV

Před spuštěním importu je třeba upravit následující atributy v záložce Nastavení:

  • Zaškrtněte atribut Zapnuto pro povolení úlohy.
  • Vyplňte Přípony souborů.
  • Nastavte správně Formát souboru CSV, tak aby odpovídal Vašemu importovanému souboru, především znakovou sadu a oddělovače.
  • V řádku Mapování atributů akčních produktů v CSV přiřaďte všem sloupcům, které chcete importovat, příslušný atribut z Quantu.
  • Vyplňte v řádku Adresa (Primární server): "ftp.extech.eu" a Vaše Uživatelské jméno (Primární server) a Heslo (Primární server) na FTPS server.
  • Vyplňte v řádku Cesta k adresáři (Primární server) název složky, ve které máte na FTP uložen importovaný soubor.
  • Dále doporučujeme vyplnit Emaily k notifikacím, kde zadáte jednu či více e-mailových adres, na které budou zasílány e-maily s chybovými stavy.

Nastavení automatické úlohy

Atributy

Níže je přehled dalších atributů, které si můžete v rámci automatické úlohy nastavit:

 Atribut 
 Popis
 Typ 
Zapnuto
Určuje, zda je daná automatické úloha aktivní a mohou přes ní být posílána data.
ano/ne
Nadpis
Vlastní název automatické úlohy.
text
Popis 
Vlastní popis funkce automatické úlohy.
formátovaný text
Frekvence
    Určuje, kdy se mají soubory z FTPS importovat.    čas
Poznámky
Poznámky.
text
E-maily k notifikacím

Jedna nebo více e-mailových adres, na které budou zasílány e-maily s chybovými stavy.

seznam řetězců
Přípony souborů
Napište všechny možné přípony, které může importovaný soubor obsahovat.
seznam řetězců
Formát názvu souboru
Podle zadaného výrazu se vyfiltrují soubory k importu ze všech souborů v cílovém adresáři. Pokud v zadaném cílovém adresáři je pouze jeden soubor, není nutné formát názvu souboru vyplňovat.
text
Rozbalit zipy
Označte, pokud jste nahráli zazipovaný soubor.
ano/ne
Varovat, pokud se nic neimportovalo od
Pokud od zadaného termínu nedojde k žádnému importu dat, bude Vám zaslána notifikace.
výběr datumu
Prázdné řetězce hodnot
Zadejte zde hodnoty z importovaného souboru, které mají být ignorované neboli považované za prázdné řetězce.
seznam řetězců
Oddělování sloupců
Vyberte, který oddělovač sloupců se má použít pro importovaný soubor.
výběr
Escapovat
Označte, pokud v souboru používáte escapování.
ano/ne
Escapovací znak
Vyberte, jaký používáte escapovací znak.
znak
Ignorovat escapovací znak
Označte, pokud se má escapovací znak ignorovat.
ano/ne
Mapování atributů akčních produktů CSV
Přiřaďte všem sloupcům, které chcete importovat, příslušný atribut Quantu.
seznam atributů
Znaková sada
Vyberte znakovou sadu importovaného souboru.
výběr
Počet řádků hlavičky
Napište, kolik řádků obsahuje hlavička.
číslo
Oddělovač desetinných míst
Vyberte znaménko pro desetinnou čárku.
výběr
Zápis hodnoty "Ano"
Napište, jaká hodnota v souboru reprezentuje "Ano" (např. 1).
text
Jednotka rozměru
Vyberte, jakou jednotku používáte v souboru např. cm nebo mm.
výběr
Oddělovač položek seznamu
Vyberte oddělovač položek seznamu.
výběr
Formát dat
Formát, ve kterém je zadané datum např. 31.12.23
výběr
Adresa (Primární server)
Standardně "ftp.extech.eu", pokud ovšem nepoužíváte vlastní server.
text
Port (Primární server)
Standardně 21.
text
Uživatelské jméno (Primární server)
Vaše uživatelské jméno na serveru FTPS.
text
Heslo (Primární server)
Vaše heslo na serveru FTPS. 
text
Typ FTP klienta (Primární server)
Vyberte si typ FTP klienta.
výběr
Implicitní SSL (Primární server)
Označte, pokud požadujete použít implicitní SSL. Pokud políčko neoznačíte bude použit explicitní SSL pro FTPS.
ano/ne
Plain FTP (Primární server)
Označte, pokud požadujete používat nezabezpečený FTP protokol.
ano/ne
Nemazat původní soubory (Primární server)
Označte, pokud požadujete, aby po importu zůstal soubor na FTPS.
ano/ne
Cesta k adresáři  (Primární server)
Napište název složky, ve které je soubor s cenami umístěn např. akce.
text
Všechny pobočky pro prázdný seznam poboček
Označte, pokud požadujete, aby se v případě nevyplnění žádné pobočky, akce nastavila na všechny pobočky.
ano/ne

5. Spuštění automatické úlohy

Po nastavení všech potřebných atributů můžete přes tlačítko Spustit importovat ceny okamžitě nebo můžete počkat, až se akční produkty naimportují automaticky na základě nastavené Frekvence. V případě dokončení automatické úlohy se v pravém horním rohu zobrazí zpráva o úspěšném importu. V sekci Akce si můžete zkontrolovat, zda byly akční produkty správně naimportovány.

Spuštění automatické úlohy

Akce na jednotlivých pobočkách
Akce na všech pobočkách 

 Pokud se import nezdařil, najdete v záložce Záznamu průběhu další podrobnosti o tom, proč se import neprovedl.

6. Záznam průběhu

V záložce Záznam průběhu si můžete prohlédnout přehled každého spuštění automatické úlohy, včetně statistik, chyb a varování.

Vyberete-li konkrétní řádek záznamu, můžete si zobrazit jeho detail prostřednictvím tlačítka Zobrazit položky.

Záznam o průběhu

Skončí-li úloha chybou nebo varováním, můžete si přes příslušná tlačítka Zobrazit chyby a Zobrazit varování přečíst konkrétní zprávu chyby či varování.

Zobrazit chyby a varování