Nápověda (ke staré verzi aplikace)

Konfigurace Export / Import
Jiný typ e-shopu

Cenový automat umožňuje komunikovat s ostatními typy e-shop systémů pomocí univerzálních metod (Univerzální PHP skript, XML/CSV feed), které lze do e-shopů jednoduše integrovat.

Univerzální PHP skript

Univerzální řešení, které lze použít pro libovolný e-shop založený na programovacím jazyku PHP.

Pro integraci použijte námi připravený PHP skript, který implementuje do vašeho e-shopu jednoduché API, pomocí kterého s ním bude Cenový automat on-line komunikovat. PHP skript je nutno doplnit o další části kódu specifické pro váš e-shop, jako je aktualizace prodejní ceny produktu a získání nákupní ceny produktu.

Vyberte volbu Jiný v nabídce E-shop systém.
Vyberte volbu Univerzální PHP skript pro Export prodejních cen do e-shopu a Import nákupních cen z e-shopu.
Stáhněte si Univerzální PHP skript z konfiguračního okna API pomocí tlačítka Stáhnout Univerzální PHP skript
Rozbalte stažený zip soubor a dále postupujte podle nápovědy obsažené v rozbaleném PHP souboru cenovy-automat-api.php.
V případě jakýchkoliv dotazů ohledně implementace se neváhejte na nás kdykoliv obrátit.

XML/CSV feed

Univerzální řešení, které lze použít pro libovolný e-shop.
Nejedná se však o on-line komunikaci mezi oběma systémy, ale o dávkovou výměnu s pomocí XML/CSV souborů s definovanou strukturou. Rychlost aktualizace prodejních cen závisí na četnosti provádění importu XML/CSV dat na straně e-shopu.

Jelikož schopnost importovat a exportovat data v XML/CSV formátu je často součástí e-shop systémů, necháváme plně ve vaší kompetenci implementaci tohoto řešení do vašeho e-shopu. Požadovaná struktura XML/CSV souborů je popsaná níže.

V konfigurace je třeba nastavit API klíč a případně šifrovací klíč, budete-li používat šifrování nákupních cen v importním XML/CSV feedu.
Exportní XML feed má url adresu přednastavenou.
Pro importní XML/CSV feed zadejte url adresu, ze které si bude moci Cenový automat feed načítat (XML/CSV soubor nebo skript).

Specifikace exportního XML feedu

SHOP - Kořenový element, v souboru je obsažen pouze jednou.
SHOPITEM - Element obsahuje informace o konkrétním produktu, v souboru je obsažen tolikrát, kolik máte produktů.
ITEM_ID - Unikátní označení produktu v rámci e-shopu.
PRICE_VAT - Prodejní cena produktu s DPH.

Příklad exportního XML feedu


        <?xml version="1.0" encoding="utf-8"?>

        <SHOP>

          <SHOPITEM>

            <ITEM_ID>1</ITEM_ID>

            <PRICE_VAT>758</PRICE_VAT>

          </SHOPITEM>

          <SHOPITEM>

            <ITEM_ID>12</ITEM_ID>

            <PRICE_VAT>623</PRICE_VAT>

          </SHOPITEM>

        </SHOP>

Specifikace importního XML feedu

Příklad importního XML feedu


        <?xml version="1.0" encoding="utf-8"?>

        <SHOP>

          <SHOPITEM>

            <ITEM_ID>1</ITEM_ID>

            <WHOLESALE_PRICE_VAT>654</WHOLESALE_PRICE_VAT>

          </SHOPITEM>

          <SHOPITEM>

            <ITEM_ID>12</ITEM_ID>

            <WHOLESALE_PRICE_VAT>515.121212</WHOLESALE_PRICE_VAT>

          </SHOPITEM>

        </SHOP>

Použití šifrování

Pro zajištění maximální bezpečnosti dat je možno v importním feedu šifrovat nákupní ceny produktů, aby tak nemohlo dojít k nežádoucímu úniku těchto citlivých informací.

Použití šifrování se signalizuje atributem encryption="1" v kořenovém elementu SHOP.

Pro šifrování je třeba použít příkaz openssl_encrypt se šifrovací metodou aes-128-cbc, šifrovacím klíčem zadaným v konfiguraci API a náhodně generovaným inicializačním vektorem (iv), který je poté uvedený jako atribut kořenového elementu SHOP.

Příklad importního XML feedu s šifrováním nákupnách cen


        <?xml version="1.0" encoding="utf-8"?>

        <SHOP encryption="1" iv="1234567890123456">

          <SHOPITEM>

            <ITEM_ID>1</ITEM_ID>

            <WHOLESALE_PRICE_VAT>qIGYBlxEdDqEj5kskOX80g==</WHOLESALE_PRICE_VAT>

          </SHOPITEM>

          <SHOPITEM>

            <ITEM_ID>12</ITEM_ID>

            <WHOLESALE_PRICE_VAT>hKkI0hrBmhOJx67NCtFIMw==</WHOLESALE_PRICE_VAT>

          </SHOPITEM>

        </SHOP>

Účty