Modul E-shop konektor
Money S3 - E-shop konektor
1
Obsah I. Verze Money S3 pro E-shop konektor ....................................................................................................................................... 2 Licencovaná verze .............................................................................................................................................................. 2 START verze ...................................................................................................................................................................... 2 II. Co je to E-shop konektor? ..................................................................................................................................................... 3 Export ........................................................................................................................................................................ 4 Import ......................................................................................................................................................................... 4 III. Nastavení E-shop konektoru a zásob pro elektronické obchodování ............................................................................................. 4 Nastavení E-shop konektoru ................................................................................................................................................. 4 Zásoby ............................................................................................................................................................................. 5 Záložka Aktuální sklad .................................................................................................................................................... 5 Záložka Zásoby pro elektronické obchodování ...................................................................................................................... 5 Karta zásoby ................................................................................................................................................................. 5 Adresář ............................................................................................................................................................................ 5 Karta adresy ................................................................................................................................................................. 6 Objenávky přijaté ............................................................................................................................................................... 6 Karta přijaté objednávky ................................................................................................................................................. 6 IV. Komunikace s E-shop konektorem.......................................................................................................................................... 7 Odeslání (export) .......................................................................................................................................................... 7 Stažení (import) ............................................................................................................................................................ 8 V. Technické podrobnosti ......................................................................................................................................................... 8 Exporty XML ...................................................................................................................................................................... 8 Importy XML ..................................................................................................................................................................... 9 Publikované a nepublikované zásoby...................................................................................................................................... 9 Konfigurace XML přenosů ..................................................................................................................................................... 9
© 2010 CÍGLER SOFTWARE, a.s.
Money S3 - E-shop konektor
2
I. Verze Money S3 pro E-shop konektor Licencovaná verze Pokud budete zkoušet Money S3 E-shop konektor (dále jen E-shop konektor) v „ostré“ instalaci Money S3, potřebujete licenci obsahující i placený modul pro podporu Money S3 E-shop konektoru. Bez této licence se Vám možnost používat E-shop konektor nebude vůbec nabízet. Money S3 E-shop konektor je samostatný modul, s jeho zakoupením je programu přiděleno nové licenční číslo. Modul je funkční pouze ve verzi programu 11.060 a vyšší a jen v případě, kdy program používá softwarový klíč. POZNÁMKA: Druh klíče ve vaší instalaci poznáte snadno podle licenčního čísla. V případě softwarového klíče je licenční číslo programu 16místné, u hardwarového klíče pouze 9místné.
Po zakoupení modulu Money S3 E-shop konektor mohou tedy nastat následující možnosti:
Máte verzi programu 11.060 a vyšší a používáte softwarový klíč – jedná se o nejčastější případ. V Money S3 stačí pouze v menu Nápověda / Registrace spustit funkci Změna licence. V průvodci na straně 1/7 zvolíte Změnu licence a stisknete tlačítko Změnit. Poté zadáte do formuláře nové licenční číslo a průvodce dokončíte.
Máte starší verzi programu a používáte softwarový klíč – v tomto případě je potřeba z přiloženého DVD nainstalovat novou verzi programu. Jestliže si během instalace průvodce vyžádá zadání licenčního čísla, zapište nové číslo, které jste dostali s modulem Money S3 E-shop konektor. Pokud jej program při instalaci nepožadoval, spusťte Money S3 a dále postupujte podle předchozího bodu.
Doposud jste používali hardwarový klíč – je nutné jej nahradit dodaným softwarovým klíčem (dle níže uvedeného postupu) a znovu provést instalaci Money S3 z přiloženého DVD, a to i v případě, kdy máte verzi 11.060 a vyšší již nainstalovánu. Při instalaci Money S3 postupujte dle těchto bodů:
1) Vytvořte zálohu dat. 2) Vyjměte fyzicky z počítače hardwarový klíč. Hardwarový klíč zašlete zpět na adresu CÍGLER SOFTWARE, a.s., Drobného 49, 602 00 Brno. 3) Pokud používáte síťovou licenci (v případě lokálního hardwarového klíče tento bod přeskočte), je nutné napřed přeinstalovat Správce síťových licencí. Nejprve je třeba otevřít stávajícího Správce síťových licencí (dvojklikem na velké červené „S“ v pravém dolním rohu pracovní plochy Windows v sekci Oznamovací oblast na Vašem počítači nebo serveru, respektive na počítači, kde byl hardwarový klíč), toho pomocí tlačítka Zastavit a poté jej Zavřít. Zastaveného Správce síťových licencí je pak potřeba pomocí pravého tlačítka myši z pop-up menu volbou Konec aplikaci vypnout. Následně musíte v seznamu Ovládacích panelů Windows vybrat funkci Přidat nebo odebrat programy a přes tuto volbu aplikaci odebrat – zobrazuje se pod názvem Správa síťových klíčů pro Money S3. Následně počítač restartujte. Poté už lze standardně nainstalovat nového Správce síťových licencí z přiloženého DVD v sekci Ostatní pod položkou Doplňky k Money S3 (Instalace správce síťových licencí). Po instalaci správce je nutné opět restartovat počítač. Instalace Money S3 vyžaduje vypnutého Správce síťových licencí. Protože se správce standardně spouští automaticky po startu operačního systému, je třeba ho tedy napřed zastavit a následně znovu spustit až po spuštění instalace Money S3 (bod 4). 4) Spusťte instalaci samotného Money S3. V okně průvodce klikněte na tlačítko Změnit typ licence..
© 2010 CÍGLER SOFTWARE, a.s.
3
Money S3 - E-shop konektor
Následně zadejte licenční číslo (pouze pro lokální instalaci) a pokračujte jako při standardní instalaci. Při síťové instalaci klikněte znovu na tlačítko Změnit typ licence a vyberte požadovaný způsob typu licence a dále již postupujte jako při standardní instalaci. V případě potíží kontaktujte naši technickou podporu na telefonním čísle 841 121 121.
START verze Ve verzi Money S3 START můžete používat E-shop konektor libovolně, dokud nepřekročíte ve zvolené agendě povolené limity verze START. Po jejich překročení nebudete moci tuto volbu požívat. Poznámka: Pokud verzi START zaregistrujete, zvětší se Vám povolené limity počtu záznamů. Nezaregistrovaná verze START používá i časový limit, po jehož překročení se považují limity za překročené. K testovacím účelům můžete požít běžně dodávané DEMO agendy, které je možné volitelně instalovat.
Poznámka: Verzi Money S3 START si můžete stáhnout na webu na adrese http://www.money.cz/kestazeni/start. Při spuštění verze START musíte použít volbu „Komplety“ a zde zvolit použití modulu „E-shop konektor “. V opačném případě nebude volba E-shop konektor přístupná.
II. Co je to Money S3 - E-shop konektor ? Money S3 podporuje několik „standardních“ obchodních domů na internetu (eShopů) konkrétních výrobců, jako jsou např. InShop, Vltava, InShop 2000, ... atd. Komunikace s těmito eShopy se dá označit jako on-line, protože Money S3 předává (export) nebo přebírá (import) data eShopu od on-line klienta, který komunikuje přímo s daty konkrétního eShopu a kterého dodává vždy konkrétní výrobce. Podpora pro tyto standardní eShopy je součástí Money S3 a není samostatným placeným modulem. Money S3 E-shop konektor(E-shop konektor) není konkrétním obchodním domem od určitého výrobce, jako jsou všechny ostatní, ale je obecným XML rozhraním pro libovolný elektronický obchod. Na rozdíl od jiných obchodních domů, pro Money S3 E-shop konektor je tato komunikace „off-line“, tzn. že z / do Money S3 se exportují / importují pouze XML soubory, které si musí zpracovat samostatná off-line aplikace výrobce obecného elektronického domu. Tento E-shop konektor je placeným modulem Mone yS3. Při exportu Money S3 exportuje data (XML soubory) nejdříve do tzv. systémových adresářů a teprve odtud do tzv. uživatelských adresářů, které definuje uživatel (viz dále). Uživatelské adresáře může uživatel definovat jako lokální (resp. síťové) nebo jako adresáře na vzdáleném FTP serveru. Při importu naopak Money S3 očekává data v uživatelském adresáři a odtud je přenáší do systémových adresářů, odkud je importuje do dat Money S3. © 2010 CÍGLER SOFTWARE, a.s.
Money S3 - E-shop konektor
4
V systémových adresářích jsou automaticky exportovaná a importovaná data zálohována v komprimované podobě (ZIP). Komprimace XML souborů v uživatelských adresářích je uživatelsky volitelná. Naprogramování off-line klienta, který portuje data z uživatelských adresářů na eShop (export), resp. z eShopu do uživatelského adresáře (import) je záležitostí výrobce eShopu. Money S3 podporuje možnost volání této aplikace po exportu resp. před importem. Standardní komunikace s eShopy sestává z:
Export
exportují se zásoby určené pro el. obchodování, včetně volitelné možnosti exportu obrázků. Součástí exportu zásob je i export Kategorií, tj. hierarchických skupin, do kterých jsou zásoby na eShopu řazeny. E-shop konektor podporuje u zásob také export Parametrů, Alternativ a Příslušenství.
exportují se Adresy, určené pro el. obchodování
exportují se změněné Objednávky přijaté, které byly importovány z eShopu
Import
importují se nové Adresy, vzniklé na eShopu, případně Adresy zde změněné.
importují se nové a změněné Objednávky přijaté od zákazníků (Adres) eShopu.
III. Nastavení E-shop konektoru a zásob pro elektronické obchodování V této kapitole popisujeme základní postupy pro konfiguraci E-shop konektoru a nastavení dat Money S3 pro E-shop konektor. Upozornění: Podrobnosti naleznete vždy v kontextové Nápovědě programu Money S3.
Nastavení E-shop konektoru Menu: Nástroje/Nastavení/Obchodování na internetu Nastavte Typ obchodního domu E-shop konektor. V jednotlivých záložkách konfigurujete vlastnosti komunikace s E-shop konektorem. Upozornění: Nastavení záložky Soubory, kde zadáváte uživatelské adresáře (složky nebo FTP server) je povinné.
© 2010 CÍGLER SOFTWARE, a.s.
5
Money S3 - E-shop konektor
Zásoby Menu: Sklady/Zásoby na skladě Pokud máte nastaven E-shop konektor, uvidíte Seznam zásob rozčleněný na dvě podzáložky Aktuální sklad a Zásoby pro elektronické obchodování:
Záložka Aktuální sklad Na této záložce určujete, které zásoby budou určeny pro elektronické obchodování. Nastavit zásoby pro e-Shop můžete po kliknutí pravým tlačítkem myši na konkrétní zásobu výběrem možnosti Elektronické obchodování nebo přes Hromadné operace / Hromadné změny konfiguračních údajů zásoby.
Záložka Zásoby pro elektronické obchodování V této záložce se zobrazují pouze zásoby, které jsou vybrány pro elektronické obchodování. Seznam je rozdělen na dvě části - Kategorie (obdoba skladových skupin) a Zásoby. V této záložce zařazujete běžné zásoby do Kategorií eShopu a určujete jejich publikovatelnost a spravujete hierarchický seznam kategorií.
Karta zásoby Doplňující informace, určené pro zásoby, které jsou určeny pro el. obchodování naleznete na Kartě zásoby v záložce „Obchod na internetu“. Tato záložka se zobrazí pouze tehdy, když je nastaveno propojení s eShopem. Při volbě E-shop konektoru jsou zde navíc k dispozici možnosti definování Parametrů (jejichž počet není omezen), Alternativ (alternativní zásoby k dané zásobě) a Příslušenství (zásoby, které se prodávají jako příslušenství s danou zásobou). Upozornění: Zásoby, definované jako alternativy nebo příslušenství se exportují na eShop pouze tehdy, jsou-li samotné určeny k el. obchodování.
Adresář Menu: Adresář Do Adresáře můžete přijímat nové zákazníky z internetu, případně z něj odesílat informace o svých stávajících zákaznících zpět – oceníte zvláště v případě uzavřeného obchodního systému, kdy budete kompletně evidovat svou síť zákazníků a úmyslně neumožníte přihlašování nových zákazníků na internetu.
© 2010 CÍGLER SOFTWARE, a.s.
6
Money S3 - E-shop konektor
V seznamu Adres můžete pomocí pravého tlačítka myši, kdy v pop-up menu vyberete položku Elektronické obchodování označit ikonou vybrané adresy a určit tak, zda vstupují do el.obchodování.
Karta adresy Doplňující informace, určené pro Adresy, které jsou určeny pro el. obchodování naleznete na Kartě adresy v záložce „Obchod na internetu“. Tato záložka se zobrazí pouze tehdy, když je nastaveno propojení s eShopem.
Objenávky přijaté Menu: Objednávky / Objednávky přijaté V tomto seznamu jsou objednávky přijaté, které byly importovány z eShopu, označeny podobně jako adresy nebo zásoby ikonou
.
Karta přijaté objednávky Doplňující informace, určené pro Objednávky přijaté, které jsou určeny pro el. obchodování naleznete na Kartě objednávky v záložce „Elekt. obchod“. Tato záložka se zobrazí pouze tehdy, pokud se jedná o objednávku importovanou z eShopu. V této záložce můžete nastavovat stavy objednávky, případně potvrzovat storno objednávky požadované zákazníkem prostřednictvím eShopu či editovat Poznámku určenou zákazníkovi na eShopu.
© 2010 CÍGLER SOFTWARE, a.s.
7
Money S3 - E-shop konektor
IV. Komunikace s E-shop konektorem Menu: Agenda / Obchod na internetu Upozornění: Tato volba není přístupná v programu Money S3 START, pokud jsou překročeny povolené limity START verze. Pomocí této funkčnosti provádíte vlastní export a import XML souborů určených pro E-shop konektor.
Odeslání (export) Na elektronický obchod můžete odeslat zásoby, objednávky a adresy. Volby pro jednotlivé entity:
Neodeslat na WWW - export pro entitu neproběhne.
Odeslat vše - exportují se všechny entity pro elektronické obchodování.
Odeslat pouze změny - exportují se pouze entity změněné od posledního exportu.
V případě Money S3 E-shop konektoru se při volbě „Odeslat vše“ u zásob exportují pouze zásoby určené k publikování. Které zásoby jsou určeny k publikování, je popsáno v Nápovědě programu, případně dále v tomto dokumentu. Při volbě „Odeslat pouze změny“ se u zásob exportují pouze změněné zásoby od posledního exportu, kdy za změnu se považuje i změna zařazení zásob do kategorií, případně i odstranění zásoby z vlastního el. obchodování. POZNÁMKA: Pokud potřebuje aplikace E-shop konektoru registrovat pouze změny zařazení zásob do kategorií, příp. přímo určení zásob k el.obchodování, je nutné použít po prvotním exportu „všech“ zásob nastavit tento „změnový“ režim.
© 2010 CÍGLER SOFTWARE, a.s.
Money S3 - E-shop konektor
8
Stažení (import) Z elektronického obchodu se stahují objednávky přijaté a adresy. Volby pro jednotlivé entity:
Nestahovat z WWW - import neproběhne.
Stáhnout z WWW - importují se importní XML soubory
V případě E-shop konektoru jsou volby při importu omezené pouze na Nestahovat/Stahovat z WWW, protože rozsah změn je určen obsahem konkrétních importních XML souborů. Proces komunikace ovládáte v průvodci standardními tlačítky. Tlačítkem Info zobrazíte informace o předchozím exportu/importu, tato informace je vám rovněž zobrazena po dokončení aktuálního exportu/importu. Po provedení importu máte navíc možnost Zobrazit výstupní zprávu, která zobrazí detailní zprávu o XML importu.
V. Technické podrobnosti Exporty XML Exportní soubory (pro každou entitu mají jiný název) se ukládají nejdříve do systémových adresářů, které se automaticky vytvářejí pro každou agendu ve standardním adresáři Data/eShops/název agendy/Documents/Export. Po každém exportu se přesunou všechny soubory z tohoto adresáře do jeho podadresáře /Backup. V tomto adresáři jsou tedy archivovány všechny exportní soubory. Případná následná správa tohoto adresáře je ponechána na uživateli. Při volbě Odeslat vše se soubory exportují bez čísla dávky (tudíž se při opakovaném použití této volby přepisují), při volbě Odeslat pouze změny se soubory číslují číslem dávky. Archivní soubory jsou automaticky komprimovány metodou ZIP. Do podadresáře /Pictures se případně exportují obrázky zásob, pro každou zásobu jako soubor, jehož jméno je tvořeno GUIDem kmenové karty zásoby (jednoznačný systémový identifikátor kmenové karty) a rozlišením malý (_M) či velký (_V) obrázek. Tento adresář má rovněž zálohovací podadresář /Backup se stejnou funkčností jako u zásob. Teprve z těchto systémových adresářů se aktuální exportní soubory zkopírují do uživatelských adresářů nastavených na kartě nastavení Obchodování na internetu. Součástí každého exportu zásob je i export Seznamu parametrů a Seznamu kategorií jako samostatných entit. Případné alternativy a příslušenství zásoby jsou součástí XML dat každé zásoby. Komponenty alternativ a příslušenství se exportují pouze v případě, že jsou samotné určeny k el. obchodování.
© 2010 CÍGLER SOFTWARE, a.s.
9
Money S3 - E-shop konektor
POZNÁMKA: Seznam kategorií je hierarchický a exportuje se vcelku zejména pro potřeby výrobců eshopů. Seznam parametrů obsahuje u výčtových parametrů i seznam výčtových hodnot. Každá exportovaná zásoba má pak informaci o kategorii do které patří a které parametry obsahuje včetně konkrétních hodnot.
Importy XML To, které entity se importují, je určeno obsahem importovaných XML souborů. Importovaný soubor(y) se nejdříve přesunou z uživatelského adresáře nastaveného na kartě Obchodování na internetu. do systémového adresáře Data/eShops/název agendy/Documents/Import, odkud proběhne vlastní import souboru. Před vlastním importem se všechny soubory z tohoto adresáře přesunou do jeho podadresáře /Backup podobně jako u exportu. Archivní soubory jsou automaticky komprimovány metodou ZIP. Vlastní případné číslování importních souborů je věcí výrobce eShopu, je ale implicitně očekáváno. POZNÁMKA: V případě použití vzdálených uživatelských adresářů na FTP serveru dojde k jeho smazání na tomto serveru teprve tehdy, pokud se zdaří jeho kompletní kopie z FTP serveru do lokální systémové složky.
POZNÁMKA: Jakékoliv chyby při stahování (download), resp. odesílání (upload) dat z, resp. na FTP server jsou hlášeny chybovými zprávami. POZNÁMKA: Schémata XSD exportovaných a importovaných entit naleznete v každé instalaci Money na standardním místě v podadresáří Data/ XMLDE/Schemas.
Publikované a nepublikované zásoby Zásoba se považuje za publikovanou, pokud je určena k elektronickému obchodování a je přiřazena některé publikované kategorii a tato zásoba v této kategorii je rovněž určena k publikování. Zásoba se považuje za nepublikovanou v opačném případě, tj. tehdy, kdy je přiřazena kategorii „Nepublikované“, nebo všechny kategorie, do kterých je přiřazena, mají příznak „Nepublikovat“, nebo tento příznak má libovolná jim nadřazená kategorie (tj. tento příznak „dědí“ všechny podkategorie) nebo příznak „Nepublikovat“ mají všechna samotná přiřazení zásoby do kategorií.
Konfigurace XML přenosů XML přenosy, pomocí kterých se provádějí exporty a importy E-shop konektoru jsou systémové, stejně tak jsou i systémové jejich konfigurace. Tyto konfigurace jsou uživatelsky nepřístupné. POZNÁMKA: Konfigurace jsou uloženy v systémových adresářích, podobně jako ostatní systémové adresáře pro data, atd. , a jejich případná změna může vést k úplné nefunkčnosti XML přenosů pro E-shop konektor. Z těchto důvodů je striktně nedoporučováno tyto konfigurace jakýmkoliv způsobem měnit.
© 2010 CÍGLER SOFTWARE, a.s.
www.money.cz