Súgó: telepítés, beállítás és kezelés
Ez az útmutató végigvezet a FeedSync telepítésén, az első import és a feed források beállításán, valamint az előfizetés és az alkalmazás kezelésén. Ha elakadsz, írj az [email protected] címre.
1. Telepítés
Mire van szükséged?
- Éles, fizetős Shoptet webáruházra. A Shoptet próbaidőszaka alatt külső alkalmazás nem telepíthető.
- Egy termékfájlra (CSV, XML, XLSX, JSON vagy tagolt TXT) vagy egy nyilvánosan elérhető feed URL-jére.
Telepítés lépésről lépésre
- Jelentkezz be a webáruházadba, és nyisd meg a FeedSync adatlapját a Shoptet Alkalmazások oldalán.
- Kattints az „Alkalmazás rendelése” gombra.
- Fogadd el a Shoptet által felsorolt hozzáférési jogokat, és véglegesítsd a rendelést.
Ezzel a telepítés kész. A FeedSync azonnal csatlakozik a boltodhoz, mást nem kell aktiválnod.
Mi történik a telepítés után?
- A 30 napos ingyenes próbaidőszak az első telepítéskor automatikusan elindul. Bankkártyát nem kell megadnod.
- Nem kapsz e-mailt belépési adatokkal, és külön FeedSync-fiókot sem kell létrehoznod. Elég, ha be tudsz lépni a Shoptet adminisztrációba.
- Ügyfélmenedzser sem keres meg. A beállítást egyedül is el tudod végezni, ez az útmutató végigvezet rajta.
- A FeedSync magától nem importál semmit. Az első importot te indítod el egy fájllal vagy egy feed forrással.
A FeedSync megnyitása
A Shoptet adminisztrációban nyisd meg az „Összekapcsolás” menü „Alkalmazáskezelő” pontját, és ott nyisd meg a FeedSync beállításait. A FeedSync a „Vezérlőpult” oldalon nyílik meg.
A FeedSyncet mindig a Shoptet adminisztrációból nyisd meg. A munkamenet 12 óra elteltével lejár, ilyenkor nyisd meg újra ugyanonnan.
2. Beállítás
Első import fájlból
- Az „Importok” oldalon húzd be a fájlt, majd kattints a „Feltöltés és előnézet” gombra. Ekkor még semmi nem kerül a boltodba.
- A „Párosítás áttekintése” oldalon ellenőrizd, melyik oszlop melyik Shoptet mezőhöz tartozik. A FeedSync az oszlopfejlécek alapján előre kitölti a párosítást, és megjegyzi, amit egyszer jóváhagytál.
- Új termék létrehozásához négy mező kötelező: kód, név, ár és kategória. Meglévő termék frissítéséhez elég a termékkód. Mindegyik mezőhöz választhatsz oszlopot, vagy megadhatsz fix értéket.
- Ha módosítasz valamit, kattints a „Módosítások alkalmazása” gombra. Az előnézet megmutatja, hány termék jön létre, hány frissül, és hány sor marad ki, soronkénti indoklással.
- Ha az előnézet rendben van, kattints a „Jóváhagyás és importálás” gombra. A FeedSync csak ekkor ír a boltodba, és ez egy szinkront felhasznál a napi keretedből.
- Az import oldalán látod az eredményt és a kihagyott sorokat a kihagyás okával együtt. A hibás sor kimarad, a többi ettől még bekerül.
Feed forrás és ütemezés
- A „Feed források” oldalon adj meg egy nevet és a feed nyilvános URL-jét. A feednek bejelentkezés nélkül kell megnyílnia. Ellenőrizd, hogy a „Formátum” megegyezik-e a feed formátumával (CSV, XML, XLSX vagy JSON; tagolt TXT-fájl esetén válaszd a CSV-t).
- Válassz ütemezést: naponta vagy hetente, a megadott órában. A Growth csomagtól felfelé a feed naponta többször is futhat.
- Kattints a „Feed forrás hozzáadása” gombra. Az első futás azonnal elindul, és „jóváhagyásra vár” állapotban megáll.
- A feed sorában kattints a „Párosítás ellenőrzése” gombra, nézd át a párosítást és az előnézetet, majd hagyd jóvá, akárcsak egy fájlnál.
- Az első jóváhagyott import után bekapcsolhatod az „Automatikus jóváhagyás” kapcsolót. Ettől kezdve az ütemezett futások kérdés nélkül írnak a boltodba. Enélkül minden futás a jóváhagyásodra vár.
A „Szinkron most” gombbal bármikor azonnal letöltheted a feedet. Ha a beszállító szervere nem jelez változást, a futás „változatlan” állapotot kap, és nem számít bele a napi keretedbe.
A feed forrás URL-je és ütemezése utólag nem szerkeszthető. Ha változtatnál rajta, töröld a feed forrást, és add hozzá újra.
Mit ír a FeedSync a boltodba?
- Új termék: a FeedSync a párosított mezőkkel hozza létre, az árral és a kategóriával együtt.
- Meglévő termék: a FeedSync termékkód alapján azonosítja, és frissíti a párosított adatait, például a nevét, a leírását, a láthatóságát, a készletét, a képeit és a paramétereit. Az alapár és a kategória frissítéskor nem változik: ezeket a FeedSync csak a termék létrehozásakor állítja be.
- Törlés: a FeedSync soha nem töröl terméket. Ami kikerül a beszállítói feedből, az a boltodban változatlanul megmarad.
További lehetőségek a párosításnál
- Szabályok (ha / akkor): feltételhez kötött módosítások. Például ha a készlet 5 vagy annál kevesebb, a termék rejtett lesz.
- Kategóriák párosítása: a beszállítói kategóriát a saját bolti kategóriádra húzhatod, és a párosítás minden importnál megmarad.
- Variánsok: az azonos párkódú sorokból egy termék lesz, több variánssal. Ezeknek a soroknak egymás alatt kell állniuk a fájlban.
- Képek, termékparaméterek és egyedi Shoptet mezők: párosíthatsz képlinkeket, paramétereket és további Shoptet mezőket is, például garanciát vagy mértékegységet.
- Készlet raktáranként: ha a boltodban több raktár van, mindegyikhez külön oszlopot párosíthatsz.
- B2B-árlista és duplikátumszűrés: mindkettő csak párkód nélküli importnál használható. A B2B-árlistának már léteznie kell a Shoptetben.
A részletes leírást az alkalmazás „Súgó” oldalán találod.
Nyelv és időzóna
A „Beállítások” oldalon kiválaszthatod a felület nyelvét (magyar vagy angol) és az ütemezett szinkronok időzónáját. Az alapértelmezett időzóna Budapest.
3. Kezelés
Csomagok és számlázás
A próbaidőszak 30 napig tart. Ha utána is szinkronizálnál, válassz csomagot a „Számlázás” oldalon. A csomagok árát az árlistában találod.
| Csomag | Termékek száma | Napi szinkronok | Feed források |
|---|---|---|---|
| Próbaidőszak | 500 | 1 | 1 |
| Starter | 1 000 | 1 | 1 |
| Growth | 10 000 | 3 | 3 |
| Pro | 20 000 | 6 | 10 |
| Enterprise | Egyedi megállapodás szerint | ||
- A termékkorlátba a fájl minden sora beleszámít, a variánsok sorai is.
- A napi keret budapesti idő szerint éjfélkor indul újra.
- Csomagot a „Számlázás” oldalon, a „Váltás erre” gombbal válthatsz. A különbözetet a FeedSync időarányosan terheli vagy jóváírja.
- Az előfizetést a „Számlázás kezelése” gombbal mondhatod le. A gomb az első előfizetés után jelenik meg, a lemondás pedig a kifizetett időszak végén lép életbe.
- Az előfizetést a FeedSync havonta, a Stripe-on keresztül számlázza.
Szüneteltetés és eltávolítás
Mindkettőt a Shoptet adminisztrációban, az „Összekapcsolás” menü „Alkalmazáskezelő” pontjában találod.
- Szüneteltetés: a szinkronok leállnak, az adataid megmaradnak, az előfizetés számlázása viszont tovább fut. Visszakapcsolás után minden folytatódik. Ha a számlázást is le szeretnéd állítani, távolítsd el az alkalmazást, vagy kapcsold vissza, és mondd le az előfizetést a „Számlázás” oldalon.
- Eltávolítás: a fizetős csomagod a kifizetett időszak végén megszűnik. Az importált termékek a boltodban maradnak, és ott semmit nem kell átállítanod.
- Adatok: a FeedSyncben tárolt adataid (feed források, párosítások, importelőzmények) az eltávolítás után még 30 napig megmaradnak, utána véglegesen törlődnek. Ha 30 napon belül újratelepíted az alkalmazást, a feed forrásaid, a párosításaid és az előzményeid megmaradnak.
Ha valami nem működik
- A FeedSync nem nyílik meg, vagy „unauthenticated” hibát látsz: a munkameneted hiányzik vagy lejárt. Nyisd meg újra a FeedSyncet a Shoptet adminisztrációból.
- Az ütemezett feed nem frissíti a boltot: nézd meg az „Importok” oldalon, van-e „jóváhagyásra vár” állapotú futás, és hagyd jóvá. Ha nem szeretnél minden futást kézzel jóváhagyni, kapcsold be az „Automatikus jóváhagyás” kapcsolót.
- A feed „változatlan” állapotú: a beszállító szervere nem jelzett változást, ezért a FeedSync nem töltötte le újra a feedet.
- Kimaradt néhány sor: az import oldalán minden kihagyott sor mellett ott az ok. Gyakori okok: hiányzó kategória vagy ár, ismétlődő termékkód, a boltodban nem engedélyezett pénznem.
- Az egész import megállt: a „Kategória” mezőhöz rossz oszlop van párosítva, az azonos párkódú sorok nem egymás alatt állnak, vagy a fájl túllépi a csomagod termékkorlátját.
- Lejárt a próbaidőszak: válassz csomagot a „Számlázás” oldalon.
- Elfogyott a napi keret: várd meg az éjféli újraindulást (budapesti idő szerint), vagy válts nagyobb csomagra.
- „A FeedSync szünetel ebben a boltban” üzenetet látsz: kapcsold vissza az alkalmazást a Shoptet „Alkalmazáskezelő” oldalán.
Kapcsolat
Írj az [email protected] címre, és add meg a „Beállítások” oldalon látható „E-shop azonosító” számot is. A FeedSync ügyfélszolgálata munkanapokon 24 órán belül válaszol.
Help: installation, setup and management
This guide walks you through installing FeedSync, setting up your first import and your feed sources, and managing your subscription and the add-on. If you get stuck, write to [email protected].
1. Installation
What you need
- A live, paid Shoptet e-shop. Shoptet trial e-shops cannot install external add-ons.
- A product file (CSV, XML, XLSX, JSON or delimited TXT) or a publicly reachable feed URL.
Installing step by step
- Sign in to your e-shop and open the FeedSync page in the Shoptet add-on catalogue.
- Click the order button („Alkalmazás rendelése”).
- Accept the access rights that Shoptet lists, and confirm the order.
That completes the installation. FeedSync connects to your shop right away, and nothing else needs activating.
What happens after the installation
- The 30-day free trial starts automatically when you first install FeedSync. You do not need a payment card.
- No e-mail with login details arrives, and you do not create a separate FeedSync account. Your Shoptet admin login is enough.
- No account manager contacts you. You can do the setup yourself, and this guide takes you through it.
- FeedSync imports nothing on its own. You start the first import with a file or a feed source.
Opening FeedSync
In the Shoptet admin, open „Összekapcsolás” (Connections), then „Alkalmazáskezelő” (the add-on manager), and open FeedSync's settings there. FeedSync starts on the Dashboard.
Always open FeedSync from the Shoptet admin. The session ends after 12 hours; when that happens, open it again the same way.
2. Setup
First import from a file
- On the Imports page, drop in your file and click "Upload & preview". Nothing is written to your shop yet.
- On the "Review mapping" page, check which column belongs to which Shoptet field. FeedSync pre-fills the mapping from your column headers and remembers what you have confirmed before.
- Four fields are required to create a product: code, name, price and category. To update an existing product, the product code is enough. For each field you can pick a column or set a fixed value.
- After a change, click "Apply changes". The preview shows how many products will be created, how many will be updated and how many rows will be skipped, each with a reason.
- When the preview looks right, click "Confirm & import". Only now does FeedSync write to your shop, and this counts as one of your daily syncs.
- The import page shows the result and the skipped rows with their reasons. A bad row is skipped, and the other rows still import.
Feed source and schedule
- On the Feed sources page, enter a name and the feed's public URL. The feed must open without a login. Check that Format matches the feed (CSV, XML, XLSX or JSON; for a delimited TXT file choose CSV).
- Choose a schedule: daily or weekly, at the hour you set. From the Growth plan up, a feed can also run several times a day.
- Click "Add feed source". The first run starts right away and stops at "pending review".
- In the feed's row, click "Review mapping", check the mapping and the preview, then confirm, just like with a file.
- After this first confirmed import, you can turn on "Auto-confirm". From then on, scheduled runs write to your shop without asking. Otherwise every run waits for your review.
Click "Sync now" to fetch the feed at any time. If the supplier's server reports no change, the run is marked "unchanged" and does not count toward your daily syncs.
A feed source's URL and schedule cannot be edited afterwards. To change them, delete the feed source and add it again.
What FeedSync writes to your shop
- New product: FeedSync creates it from the mapped fields, including its price and category.
- Existing product: FeedSync matches it by product code and updates its mapped data, such as the name, description, visibility, stock, images and parameters. An update does not change the base price or the category: FeedSync sets those only when it creates a product.
- Deleting: FeedSync never deletes products. A product that drops out of the supplier feed stays in your shop unchanged.
More mapping options
- Rules (if / then): conditional changes. For example, if stock is 5 or less, the product is hidden.
- Category pairing: drag a supplier category onto one of your shop categories, and the pairing is kept for every import.
- Variants: rows with the same pair code become one product with several variants. Those rows must sit next to each other in the file.
- Images, product parameters and custom Shoptet fields: you can also map image links, parameters and further Shoptet fields, such as warranty or unit.
- Stock per warehouse: if your shop has several warehouses, you can map a separate column to each.
- B2B price list and duplicate detection: both work only on imports without a pair code. The B2B price list must already exist in Shoptet.
The Help page inside the add-on describes each of these in detail.
Language and timezone
On the Settings page you choose the interface language (Hungarian or English) and the timezone for scheduled syncs. The default timezone is Budapest.
3. Management
Plans and billing
The trial lasts 30 days. To keep syncing after it, choose a plan on the Billing page. Plan prices are in the price list.
| Plan | Products | Syncs per day | Feed sources |
|---|---|---|---|
| Trial | 500 | 1 | 1 |
| Starter | 1,000 | 1 | 1 |
| Growth | 10,000 | 3 | 3 |
| Pro | 20,000 | 6 | 10 |
| Enterprise | By individual agreement | ||
- Every row in the file counts toward the product limit, including each variant row.
- The daily count resets at midnight, Budapest time.
- To change plans, click "Switch to this" on the Billing page. FeedSync charges or credits the difference pro rata.
- To cancel, click "Manage billing". The button appears once you have subscribed, and the cancellation takes effect at the end of the paid period.
- FeedSync bills the subscription monthly through Stripe.
Pausing and uninstalling
You find both in the Shoptet admin, under „Összekapcsolás” (Connections), in „Alkalmazáskezelő” (the add-on manager).
- Pausing: syncs stop and your data is kept, but billing for the subscription continues. Resuming picks everything up again. To stop billing as well, uninstall the add-on, or resume it and cancel on the Billing page.
- Uninstalling: a paid plan ends at the end of the paid period. Your imported products stay in your shop, and you do not need to change anything there.
- Data: the data stored in FeedSync (feed sources, mappings, import history) is kept for 30 days after you uninstall, then deleted for good. If you reinstall within 30 days, your feed sources, mappings and history are still there.
If something does not work
- FeedSync does not open, or you see an "unauthenticated" error: your session is missing or has expired. Open FeedSync again from the Shoptet admin.
- A scheduled feed does not update the shop: check the Imports page for a run that is "pending review", and confirm it. If you do not want to confirm every run by hand, turn on "Auto-confirm".
- The feed shows "unchanged": the supplier's server reported no change, so FeedSync did not download the feed again.
- Some rows were skipped: the import page gives the reason next to every skipped row. The most common reasons are a missing category or price, a repeated product code, and a currency that is not enabled in your shop.
- The whole import was stopped: the wrong column is mapped to Category, rows with the same pair code are not next to each other, or the file is over your plan's product limit.
- The trial has ended: choose a plan on the Billing page.
- The daily syncs are used up: wait for the reset at midnight, Budapest time, or switch to a higher plan.
- You see "FeedSync is paused for this shop": resume the add-on in the Shoptet add-on manager.
Contact
Write to [email protected] and include the E-shop ID shown on the Settings page. FeedSync support replies within 24 hours on working days.