Pro nastavení služby Ověřeno zákazníky je třeba použít tajný klíč pro váš e-shop. Pokud vlastníte více e-shopů, je nutné použít vždy unikátní klíč pro každý z nich.
Unikátní klíč naleznete v administraci e-shopu na Heureka.cz pod záložkou Ověřeno zákazníky, kde si také zvolíte, pro který e-shop chcete službu zavést.
Jsou dvě možnosti:
Řada shopystémů podporuje službu Ověřeno zákazníky a pak tedy stačí pouze zkopírovat 32 znakový řetězec (který je unikátní pouze pro váš e-shop) a vložit jej do předpřipraveného pole v administraci vašeho řešení e-shopu. Zda váš poskytovatel podporuje tuto funkci, si můžete ověřit v Přehledu shopsystémů nebo přímo u daného shopsystému.
Pokud vaše řešení e-shopu tuto funkci nepodporuje, pak do posledního kroku objednávky ve vašem zdrojovém kódu obchodu váš webmaster umístí aplikační skript, pomocí kterého dojde k odeslání e-mailové adresy zákazníka.
Uložení informace o provedené objednávce se provádí zavoláním následující adresy:
https://www.heureka.cz/direct/dotaznik/objednavka.php?id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&[email protected]&itemId[]=206210&orderid=123456
id = unikátní klíč vašeho obchodu ověřující pravost volání. Naleznete jej v administraci pod záložkou Ověřeno zákazníky
email = e-mailová adresa zákazníka
itemId[] = unikátní označení produktu v rámci e-shopu. Kombinace maximálně 36 znaků [0-9a-zA-Z_\-]. TENTO TAG MUSÍ BÝT OBSAŽEN V ZÁKLADNÍM XML SOUBORU! Pokud není možné tag ITEM_ID přidat do XML souboru pak je možné nakoupené zboží předat skrz jeho název (produkt[]=název objednaného produktu. Název produktu musí být stejný, jako nám zasíláte v XML souboru). Využívá se pro recenze produktů, které si může obchod umístit na svůj web a pro nastavení pozdějšího odeslání dotazníků spokojenosti. Více zde.
orderid = vaše číslo objednávky, kterým bude označen vyplněný dotazník (celé kladné číslo)
Ukázka implementace v PHP
Zdrojové kódy i s příkladem použití (včetně třídy HeurekaOvereno) jsou ke stažení na adrese https://github.com/heureka/overeno-zakazniky/
Technický popis API pro vývojáře klientských knihoven pro jiné programovací jazyky
https://github.com/heureka/overeno-zakazniky/blob/master/docs/api-documentation-cs.md
Ve chvíli, kdy v e-shopu přijmete objednávku na zboží, tak v ten samý čas k nám je objednávka reportována. V administraci pod záložkou Ověřeno zákazníky zaznamenáváme datum a čas poslední objednávky, kterou jsme skrz skript Ověřeno zákazníky od vašeho e-shopu obdrželi a také počet reportovaných objednávek za posledních 30 dní. Pokud se objednávka nezaznamenala, pak není služba správně zavedena a je nutné kontaktovat svého webmastera či daný shopsystém.
Skript se zaktivuje až první přijatou objednávkou po implementaci, dříve tedy nemáme možnost poznat, zda máte službu zavedenou správně. Než proběhne první objednávka, uvidíte v administraci hlášku "Obchod XXX nemá tuto službu zavedenou.".
Pokud máte službu správně implementovanou, pak jediné, co brání spuštění této funkce, je AKTIVACE služby. Zaregistrujte se tedy k užívání této služby přes formulář v administraci, kde pouze zkontrolujete předvyplněné údaje pro smlouvu ke službě Ověřeno zákazníky a doplníte funkční e-mailovou adresu, na kterou chcete zasílat vyplněné dotazníky. Pokud je uvedeno "Aktivováno", tak jste formulář v minulosti již vyplnili a není třeba ho vyplňovat znovu.
Návod na vyplnění:
Registrace k využívání této služby se řídí Obchodními podmínkami služby Ověřeno zákazníky. Odeslání registrace včetně přistoupení na znění podmínek je považováno za návrh na uzavření smlouvy. Smlouva je uzavřena přijetím potvrzujícího e-mailu na vaši e-mailovou adresu.
V případě, že máte podezření na únik unikátního klíče a hrozí tak jeho zneužití, pak si v administraci vygenerujete nový klíč. Tím starý okamžitě přestane fungovat a musíte již tedy všechny nové objednávky volat s novým klíčem!
Vygenerování nového klíče se provádí odkazem "Vygenerovat nový". Tento 32 znakový řetězec budete nyní používat při odesílání informací o objednávkách.
V tomto případě je nutné kontaktovat svého webmastera či shopsystém, který vám službu zřídil.