Technická dokumentácia

Čo je Pricing Fox a ako funguje

Aplikácia na automatickú cenotvorbu produktov. Pricing Fox funguje ako aplikácia do Mergada. Nahráte si vstupné dáta, tie následne spracuje Pricing Fox a spočíta novú cenu. Nová cena je potom potrebné dostať späť do eshopu. Aplikácia berie informácie o konkurentoch z Heureky, je preto potrebné, aby eshop na Heureke fungoval a mal k dispozícii XML report z merania konverzií.

Čo je Mergado

Mergado slúži na spracovanie a úpravu XML alebo CSV feedov predtým, než dáta eshop pošle napríklad do Heureky,… V Mergade sa nastaví formát vstupného súboru (napríklad Mergado Product XML), na jednotlivé produkty sa následne aplikujú rôzne pravidlá (prepísanie hodnoty elementu, … a jedno z týchto pravidiel je práve Pricing Fox) a nakoniec sa nastaví formát výstupného feedu (napríklad Heureka XML). Mergado následne v pravidelných intervaloch sťahuje vstupný feed, aplikuje nastavenie pravidla a vygeneruje výstupný feed.

Vstupné dáta

Ako vstupné dáta je možné použiť takmer ľubovoľné XML alebo CSV, ktoré takmer každý shopsystém nejakým spôsobom vie generovať. Súbor sa len musí generovať na nejakú fixnú URL adresu. V súbore by mali byť uvedené minimálne nasledujúce informácie:

názov produktu
cena produktu
hodnota elementu ITEM_ID, ktorý sa posiela do Heureky — na základe neho sa následne párujú dáta z Heureky
voliteľne potom aj obstarávacia cena produktu (nákupná cena) — pokiaľ však uvedená nebude (napríklad eshop informácia nemá zadané v systéme), na základnú funkčnosť aplikácie to nemá vplyv (len nepôjde nastaviť obmedzenie práve podľa obstarávacej ceny)

Tieto požiadavky spĺňa napríklad XML, ktoré posiela eshop do Heureky, ale to neobsahuje obstarávaciu cenu. Ako alternatívu odporúčame použiť formát Mergado Product XML, ktorý je všeobecný (a obsahuje práve aj obstarávaciu cenu) av Mergade ho ide potom jednoducho previesť na ľubovoľný iný formát. Obmedzenie na tieto dva formáty nie je nijako striktné a Mergado zvládne spracovať prakticky ľubovoľné XML alebo CSV. Požiadavky na vstupné dáta sa môžu ďalej líšiť podľa zvoleného spracovania výstupov, viď ďalej.

Výstupné dáta

Akonáhle Pricing Fox spočíta novú cenu produktov, treba nové ceny dostať späť do eshopu. Možnosti sú:

API

Toto je odporúčaný variant, ak shopsystém má nejaké vlastné API. Užívateľ v Pricing Foxe zadá prístupové údaje do API a aplikácia bude už sama niekoľkokrát za deň cez toto API aktualizovať ceny produktov v eshope. Pokiaľ API pracuje s iným identifikátorom produktu ako je ITEM_ID, je potrebné tento identifikátor doplniť do vstupných dát. Podpora napojenia cez API je do Pricing Foxu potrebné najskôr doprogramovať.

Podporované systémy cez API:

Woocommerce,
UPgates,
Prestashop,
Webareal,
JZshop,
ExitShop.

XML / CSV súbor

Cenu je možné generovať aj do súboru XML alebo CSV Toto ide riešiť buď cez Mergado alebo priamo z aplikácie (popísané ďalej). tak aj tu platí, že pokiaľ sa pri importe feedu do eshopu dáta aktualizujú na základe iného identifikátora ako je ITEM_ID, je potrebné tento identifikátor doplniť do vstupných dát.

XML / CSV súbor – Mergado

Aplikácia novo spočítanú cenu zapíše do nejakého elementu v Mergade a táto novo spočítaná cena sa následne objaví vo výstupnom feede z Mergada. Formát tohto výstupného feedu sa nastavuje v Mergade.

XML / CSV súbor – Pricing Fox

Pricing Fox môže výstupné dáta generovať do súboru priamo sama, bez ohľadu na nastavenie Mergada. Táto varianta je preferovaná pre prípady, keď používateľ už Mergado používa napríklad pre Heureku. Vďaka tomu si môže urobiť v Pricing Foxe “odbočku” a výstupný feed z Mergada naďalej posielať Heureke. V základe vie aplikácia generovať CSV súbor s definovateľnými stĺpčekmi, možno ale doprogramovať ľubovoľný iný formát súboru. Po dokončení generovania súboru môže Pricing Fox navyše poslať “notifikáciu” (napríklad nejakým HTTP requestom) o dokončení generovania exportu a shopsystém tak môže spustiť import dát skôr, ako by to urobil nejakým cronom.

Podporované systémy cez XML / CSV:

Shoptet,
Shopion,
jakýkoliv e‑shopový systém, který pracuje se zmíněnými formáty.

Manuálna

Užívateľ môže nové ceny aj prepisovať ručne do svojho systému, na základe dát/informácií, ktoré mu Pricing Fox prehľadne zobrazuje ku každému produktu.Tento variant je ale silne neodporúčaný, pretože bude jednak náchylný na chyby a tiež užívateľovi neušetrí veľa času.