Heureka Marketplace je iná funkcia ako bežný produktový feed — zákazník nakupuje priamo na Heureke a objednávka natečie do vášho e-shopu. Tento plugin je oddelený od pluginu Heureka (feed a Overené zákazníkmi), dajú sa použiť aj spolu.
Kde to nájdete
Systém > Pluginy > Heureka Marketplace na /admin/plugins.
1. Povoľte IP adresy Heureky
Heureka autentifikuje svoje volania podľa zdrojovej IP adresy servera, nie tokenom. Do poľa Povolené IP adresy Heureky zadajte zoznam IP adries alebo rozsahov (CIDR) oddelených čiarkou — získate ich priamo od Heureky. Prázdne pole znamená, že sa zamietnu úplne všetky prichádzajúce volania.
2. Nastavte spätnú synchronizáciu
Vyplňte API URL a API token Heureka Marketplace — použijú sa na odosielanie zmien stavu objednávky späť na Heureku (napr. odoslaná, doručená, zrušená). Token sa po uložení zašifruje.
3. Priraďte predvolenú platbu a dopravu
Objednávka z Heureky nenesie vašu internú platobnú ani dopravnú metódu, preto nastavte:
| Pole | Povinné | Význam |
|---|---|---|
| Predvolená platobná metóda | odporúčané | Kód platobnej metódy priradený objednávkam z Heureky (napr. bank_transfer) |
| Predvolená doprava | nie | Kód dopravnej metódy priradený objednávkam z Heureky |
Čo sa deje na pozadí
Keď zákazník nakúpi na Heureke, Heureka pošle objednávku na endpoint chránený IP adresou. Produkty sa v objednávke párujú podľa SKU — kód produktu, ktorý ste namapovali na položku Heureky, musí sedieť. Objednávka sa v e-shope označí zdrojom heureka_marketplace. Zmena stavu objednávky (napr. na odoslanú) sa následne posiela späť na Heureku cez nastavené API URL a token; ak sa odoslanie nepodarí, chyba sa len zaloguje a stav u vás sa nemení — obchodník môže synchronizáciu zopakovať ručne.
Pozor: Presný formát spätných volaní na Heureku (napríklad kódy stavov) treba pred ostrým nasadením overiť priamo v obchodníckom API a sandboxe Heureky — plugin vychádza z tvaru oficiálneho pluginu, nie je to garantovane totožné pre každý účet.
Vzťah k produktovému feedu
Heureka Marketplace je nezávislý od pluginu Heureka (produktový feed a Overené zákazníkmi) — dajú sa použiť súčasne aj samostatne. Bežná kombinácia je mať zapnutý produktový feed pre zobrazenie v porovnaní cien a k tomu zapnúť Marketplace pre priamy predaj cez Heureku bez presmerovania zákazníka na váš vlastný e-shop. Pozri Heureka a porovnávače cien.
Tip: Pred ostrým spustením otestujte celý tok na malom počte položiek — od nahlásenia dostupnosti cez prijatie objednávky až po spätné oznámenie zmeny stavu. Chyba v mapovaní SKU sa inak prejaví až pri reálnej platenej objednávke zákazníka.
Časté problémy
- Objednávky z Heureky vôbec neprichádzajú → skontrolujte zoznam povolených IP adries; prázdny alebo nesprávny rozsah zamietne všetko.
- Objednávka prišla, ale bez správnych produktov → SKU v e-shope musí presne zodpovedať položke, akú ste nahlásili Heureke; nespárovaná položka sa neprevedie.
- Stav sa Heureke neposiela späť → over API URL a token; expirovaný alebo zle vložený token spôsobí tiché zlyhanie zapísané len do logu.
- Objednávka nemá platobnú ani dopravnú metódu → doplňte predvolenú platbu (a prípadne dopravu) v nastaveniach pluginu.