Termékfeltöltés CSV-ből, XML-ből és Google Sheetsből a CloudCartba

Röviden: a termékfeltöltés a CloudCartban négyféleképpen megy. CSV-fájlt a Termékek → Import → Import with CSV file menüben tölt fel, a beszállító XML feedjét az XML Import vagy az XML Sync alkalmazás olvassa be, a meglévő termékeket pedig Google Sheetsben vagy AI asszisztenssel szerkeszti tömegesen. A CSV import mindig új termékeket hoz létre, ezért az árakat XML-lel vagy Google Sheetsszel frissítse.

Mi az a CSV-fájl, mivel nyitható meg, és mi az XML feed?

A CSV (Comma-Separated Values) egy szöveges táblázatfájl: minden sora egy rekord, a sor értékeit pedig vessző vagy más karakter választja el (RFC 4180). Szinte minden webáruház rendszer tud CSV-t írni és olvasni.

A CSV-fájl megnyitható Excellel, Google Sheetsszel, LibreOffice Calckal vagy egy egyszerű szövegszerkesztővel, mert a tartalma tiszta szöveg. A „POLO-01,Basic póló,4990” sor egy cikkszám, egy terméknév és egy ár. A magyar nyelvű Excel a CSV-ben gyakran pontosvesszőt tesz elválasztónak, mert a tizedesjel nálunk a vessző. Ez a CloudCartban nem okoz gondot: az import az elválasztót maga ismeri fel.

Az XML (Extensible Markup Language) olyan szöveges formátum, amelyben az adatok címkék között állnak, például <price>4990</price> (a W3C specifikációja). A nagykereskedők és beszállítók a katalógusukat XML feedként teszik közzé egy állandó címen (URL).

A CloudCartban, a szófiai e-kereskedelmi platformon, minden formátumnak saját eszköze van:

Eszköz	Forrás	Új termékeket hoz létre	Meglévőket frissít	Mire a legjobb
CSV import	Ön által feltöltött .csv vagy .txt fájl	Igen	Nem, az ismételt import duplikátumot hoz létre	A katalógus első feltöltése, költöztetés
XML Import	XML feed címe (URL)	Igen	Igen, csak az „Update” jelölésű mezőket	Beszállítói katalógus, új termékcsalád
XML Sync	XML feed címe (URL), ütemezetten	Igen	Igen, az „Update” jelölésű mezőket minden futáskor	Dropshipping, napi árak és készlet
Google Sheets	Táblázat, amelyet a CloudCart hoz létre az Ön Google-fiókjában	Igen, üres Product ID-jú sorból	Igen, a Download a táblázatot veszi irányadónak	Árak, nevek, leírások kézi módosítása
AI asszisztens PAT tokennel	Egy mondat és egy fájl, amelyet az asszisztensnek ad	Igen	Igen, cikkszám (SKU) vagy szabály szerint	Egy mondatban leírható módosítások

Melyik termékfeltöltési módot válassza?

Ha a katalógus egyszer érkezik, CSV-t használjon. Ha beszállítótól jön, XML-t. Ha már a webshopban van, Google Sheetset vagy AI asszisztenst.

• Új webshop, a katalógus Excelben van. Mentse a táblázatot CSV-be, és töltse fel a CSV importtal.
• Költöztetés WooCommerce-ből, Shopifyból, OpenCartból vagy Magentóból. Exportálja a termékeket a régi rendszerből CSV-be vagy XML-be, és importálja őket. Szabványos exporthoz külön importáló alkalmazások is vannak, ezeket a Shopify- és WooCommerce-termékimport útmutatója mutatja be. A címek és a Google-helyezések megtartását a WooCommerce költöztetési útmutató írja le.
• Beszállító XML feeddel. Az XML Import egyszer betölti a katalógust, utána alapértelmezésben 12 óránként újraolvassa a feedet. Az XML Sync azoknak a beszállítóknak való, akiknél az ár és a készlet naponta változik. Hogy egy ilyen beszállítóval hogyan indul, azt a dropshipping útmutató írja le.
• Új árlista a már árult termékekhez. Google Sheets, ha kézzel írja az árakat, vagy AI asszisztens, ha a módosítás egy szabály („+8% az X márkára”).

Milyen oszlopok kellenek a CSV-fájlba?

A CloudCart CSV termékimportjához két oszlop kötelező: a product.id és a product.name. Ha a terméknek változatai vannak, minden változatsorhoz kell a variant.parent_id is. Minden más oszlop választható, és az import utolsó lépésében kézzel párosítja őket.

CloudCart-mező	Kötelező	Mit ír az oszlopba
product.id	Igen	A termék saját kódja a fájlban. Az azonos kódú sorokból egy termék lesz.
product.name	Igen	A termék neve.
variant.parent_id	Igen, változatoknál	Annak a fő terméknek a kódja, amelyhez a változat tartozik.
variant.v1 / variant.v1_value	Nem	Az első opció és értéke, például „Méret” és „M”. Van v2 és v3 is: változatonként legfeljebb 3 opció.
Ár, cikkszám (SKU), vonalkód, súly	Nem	Termék vagy változat szintjén (variant.price, variant.sku, variant.quantity).
Kategória	Nem	Elérési út elválasztóval, például „Ruházat > Ingek”.
product_images.src	Nem	A képek címei, egy cellán belül vesszővel elválasztva.
Leírás, márka, címkék, tulajdonságok	Nem	Szöveg. Több oszlop is kerülhet egy mezőbe.

A képek nem maradnak az idegen szerveren. A CloudCart minden képet egyszer letölt a címéről, és a saját médiatárában tárolja, ezért a régi oldal az import után leállhat. A helyes oszlopokkal készült minta az import ablakában van: az első lépés CSV Template gombja egy mintafájlt tölt le.

Példa egy ruhawebshopból: egy póló 3 méretben 3 sor a fájlban. Mindhárom sor variant.parent_id értéke „POLO-01”, a v1 és v1_value oszlop pedig „Méret”, illetve S, M és L. Az import után a webshopban 1 termék van 3 változattal.

Hogyan töltsön fel termékeket Excelből, lépésről lépésre?

Az Excel-táblázat CSV-fájlként kerül a CloudCartba, mert az import nem fogad .xls és .xlsx fájlt. Az Excelben válassza a Fájl → Mentés másként menüt, és fájltípusnak a CSV UTF-8 formátumot (a Microsoft súgója). Google Sheetsből a Fájl → Letöltés → Vesszővel elválasztott értékek (.csv) ad ilyen fájlt. Az UTF-8 kódolás megőrzi az ékezeteket. Az import nem ismeri fel a kódolást magától, ezért egy Windows-1250 kódolású régi fájlban az ő és az ű hibás karakterként jelenhet meg.

1. Nyissa meg az importot. Az admin felületen: Termékek → az Import gomb (felhő ikon) → Import with CSV file. Ugyanez az import az Alkalmazások → CSV Import menüben is megvan.
2. 1. lépés, Upload file. Húzza be a fájlt, vagy válassza ki a számítógépéről. Az elválasztót (vessző, pontosvessző, tabulátor) a rendszer a fájl első 10 KB-ja alapján maga ismeri fel.
3. 2. lépés, CSV file settings. Kapcsolja be a fejlécsort, ha a fájl első sora az oszlopok nevét tartalmazza. Alapértelmezésben a kapcsoló ki van kapcsolva, és az első sorból termék lesz. Itt adja meg a kategóriákat elválasztó karaktert is (például >).
4. Speciális beállítások. Döntse el, hogy a termékek azonnal megjelenjenek-e, kiemeltek vagy újak legyenek-e, kell-e hozzájuk szállítás, figyeli-e a rendszer a készletüket, és eladhatók-e elfogyás után.
5. 3. lépés, Mapping. Minden CloudCart-mező mellett válassza ki a fájl oszlopát. Kattintson a Submit gombra.
6. Kövesse a haladást. A Track importing progress gomb megnyitja a feladatok listáját. A beimportált és a sikertelen sorok száma 5 másodpercenként frissül, a sikertelen sorok a hibával együtt külön táblázatban vannak.

Az árat a biztonság kedvéért írja puszta számként, szóköz és „Ft” nélkül („4990”, nem „4 990 Ft”), és az első tesztfájl után nézze meg néhány termék árát az admin felületen.

Fontos: először egy 10-20 soros fájlt töltsön fel. A CSV importnak nincs visszavonás gombja: a Cancel import leállítja a feladatot, de a már létrehozott termékek megmaradnak.

Hogyan importáljon termékeket a beszállító XML feedjéből?

Az XML feedet az XML Import alkalmazás tölti be: megadja a feed címét, párosítja a címkéket a CloudCart mezőivel, és a rendszer létrehozza a termékeket. Az alkalmazás csak címet fogad (HTTP vagy HTTPS). A számítógépén lévő fájlhoz a CSV importot használja.

1. Telepítse az alkalmazást. Alkalmazások → XML Import → Install, majd + New task.
2. 1. lépés: cím és szabályok. Illessze be a feed címét. Válassza ki az import típusát: új termékek, a meglévők frissítése vagy mindkettő. Itt kapcsolja be a készletfigyelést (Track inventory) és a feedből hiányzó termékek elrejtését (Disable missings).
3. 2. lépés: a címkék. Adja meg azt a címkét, amely egy-egy terméket közrefog, és párosítsa a címkéket a mezőkkel: név, ár, cikkszám, leírás, képek, kategória, mennyiség. Válassza ki, hogyan írja le a feed a változatokat. Minden mező mellett van egy Update jelölőnégyzet.
4. 3. lépés: befejezés. Párosítsa a kategóriákat (a hiányzók maguktól létrejönnek, a szinteket > választja el), az alapértelmezett adót és márkát, valamint a tulajdonságokat. Mentéskor a feladat elindul.

A rendszer a feedet alapértelmezésben 12 óránként olvassa újra, és legfeljebb 120 másodpercig várja a beszállító szerverének válaszát. 3 egymást követő sikertelen próbálkozás után a feladat kikapcsol, a javított feed után indítsa újra.

Hogyan frissítse az árakat a beszállító XML-jéből?

A beszállító XML feedjéből az árak az XML Import vagy az XML Sync 2. lépésének Update jelölésével frissülnek. Csak az árat és a mennyiséget jelölje be. A jelölés nélküli mezők, például a saját leírásai, változatlanok maradnak.

A rendszer a meglévő terméket az azt létrehozó feladat és a feedsor kódja alapján találja meg, ezért a frissítés nem hoz létre duplikátumot. XML Syncnél az 1. lépésben azt is kiválasztja, mi alapján párosítsa a termékeket (Compare by): cikkszám, vonalkód vagy azonosító.

• Napi árak és készlet. XML Sync.
• A beszállító által megszüntetett termékek. Kapcsolja be a Disable missings beállítást. A termékek elrejtődnek, törlés nélkül. XML Syncnél kapcsolja be az Enable exists products beállítást is: így az elrejtett termék magától újra megjelenik, ha készlettel visszakerül a feedbe.
• A képek. Amikor a képek betöltődtek, vegye ki róluk az Update jelölést. Ha a beszállító egy kép címét hibásra cseréli, bekapcsolt jelölésnél előbb a régi kép törlődik, és a termék kép nélkül maradhat.

Ha a beszállító árai Excel-árlistában érkeznek, feed helyett, gyorsabb az AI asszisztensnek adni a fájlt ezzel a mondattal: „frissítsd az árakat cikkszám szerint, és mutasd meg, melyik kód hiányzik”.

Google Sheets: a webshopban lévő termékek tömeges módosítása

A Google Sheets az ajánlott módja annak, hogy a CloudCartban már meglévő termékek árát, nevét, leírását, márkáját és kategóriáját módosítsa. Az Upload táblázatba küldi a katalógust, a Download visszaviszi a változásokat.

1. Kösse össze a Google-fiókot. Alkalmazások → Google Sheets → Settings → Sign in with Google. Az első összekötéskor a rendszer maga hozza létre a táblázatot.
2. Válassza ki a termékeket és az oszlopokat. Szűrő: az összes termék, kategória, márka vagy konkrét termékek. Jelölje be a szerkeszteni kívánt oszlopokat. Legalább egy oszlop nélkül a beállítás nem menthető.
3. Upload. A Tasks fülön kattintson a felfelé mutató nyíl gombra. Minden Upload törli a munkalap tartalmát, és újraírja.
4. Szerkesszen a táblázatban. Az üres Product ID-jú új sorból új termék lesz. Az új kategóriát elérési útként írja („Ruházat > Ingek”), és az magától létrejön, ahogy az új márka is.
5. Download. A lefelé mutató nyíl gomb visszahozza a változásokat. A Download csak legalább egy sikeres Upload után indítható.

Fontos: Downloadnál a táblázat az irányadó. Ha az Upload és a Download között az admin felületen módosított egy terméket, a táblázat értéke felülírja. A címkék is újra a táblázatból íródnak be. Az Uploadot közvetlenül a szerkesztés előtt indítsa.

A Google Sheets csak termékekkel dolgozik, a rendelések és a vásárlók nem mennek át rajta.

Termékfeltöltés és módosítás AI asszisztenssel, oszloppárosítás nélkül

A webshophoz PAT tokennel kötött AI asszisztens egy mondat alapján tölt fel és módosít termékeket, oszloppárosítás nélkül. Az asszisztens egy olyan program, mint a Claude Code, a ChatGPT Codex, a Gemini CLI vagy a Cursor, amely a CloudCart Admin GraphQL API-ján keresztül dolgozik, a kapott token jogosultságaival.

Egy példamondat: „Itt a beszállító árlistája az arak-11.xlsx fájlban. Frissítsd az árakat cikkszám szerint, a fájlban nem szereplő termékekhez ne nyúlj, és mentés előtt mutasd meg az első 5-öt.” A CloudCart AI asszisztensnek szóló készségeivel 100 vagy több sornál az asszisztens előbb CSV-fájlba menti a jelenlegi értékeket, és „szárazon” fut le, semmit nem módosítva. 1 000 sor felett ez a fájl kötelező, akkor is, ha azt kéri, hogy hagyja ki. Ez a fájl az a visszaút, amely a CSV importból hiányzik.

Hogyan töltse le a rendeléseket CSV-fájlként?

A rendeléseket a Rendelések oldal jobb felső sarkában lévő Export gombbal tölti le CSV-fájlként. Az export pontosan azokat a rendeléseket veszi, amelyeket a szűrők (időszak, állapot, fizetés) után lát, szűrő nélkül pedig a teljes előzményt. A rendelés minden terméke külön sor.

• Legfeljebb 50 rendelés. A fájl azonnal letöltődik a böngészőben.
• 50 rendelés felett. Az export a háttérben fut, és a CloudCart e-mailben küld letöltési linket. A fájl a webshop fájlkezelőjében is megmarad.

A számlák nem ebből a fájlból készülnek: Magyarországon a Számlázz.hu alkalmazás állítja ki őket a rendelésből, és jelenti a NAV Online Számla rendszerébe, saját, fizetős Számlázz.hu-előfizetéssel (részletek a számlázás oldalon).

Hány terméket importálhat csomagonként?

Az import korlátai a webshop csomagját követik. A táblázat a csomagok és árak oldala szerint készült, éves fizetéssel és ÁFA nélkül.

Korlát	Baby Pack (14 € / hó)	Starter Pack (33 € / hó)	CC Pro (83 € / hó)	CC Master (249 € / hó)
Termékek a webshopban	100	2 000	7 500	Korlátlan
CSV termékimport	100	2 000	7 500	10 000
XML Import: termékek feladatonként	100	2 000	7 500	25 000
XML Import: aktív feladatok	1	1	1	2
XML Import: importált termékek teljes korlátja	100	2 000	7 500	100 000
XML szinkronizálás: termékek	100	2 000	7 500	25 000

Ha a CSV import menet közben eléri a termékkorlátot, a feladat leáll, és üzenetben jelzi, hány sor került be az összesből. XML Importnál a korlát feletti termékek nem dolgozódnak fel, erről értesítést és e-mailt kap. Az XML Import teljes korlátját a feladat törlése nem nullázza, csak a termékek törlése. A korlátok magasabb csomaggal vagy kiegészítő termékcsomaggal emelhetők.

A másik irány: XML feed a webshopból az Árukeresőre, a Compari oldalára és a Google-ba

Az import után ugyanaz a katalógus XML feedként megy az árösszehasonlító oldalakra és a hirdetési felületekre, a feedet a CloudCart maga állítja elő. Az XML Feed alkalmazásban (Alkalmazások → XML Feed) kész formátumok vannak a Google Merchant Centerhez, a Facebook-katalógushoz, a TikTokhoz, az Árukeresőhöz, a Compari oldalához, a Glamihoz és a Criteóhoz. Bekapcsolja a kívánt formátumot, a rendszer pedig állandó címen közzéteszi a feedet, amelyet megad a csatornának.

Az Árukereső XML vagy CSV terméklistát fogad, a webshop saját címén, és megadja a kötelező mezőket (az Árukereső terméklista-követelményei). A CloudCart Árukereső-feedje tartalmazza a termék címét, az árat (akciós ár esetén azt), a kategória útvonalát, a képeket, a nevet, a gyártót, a leírást, a szállítási díjat és időt, a vonalkódot és a cikkszámot. A Web Api Key megadásával vásárlás után az Árukereső értékelési meghívója (Trusted Shop) is kimegy a vásárlónak.

Az XML Synccel a beszállítótól vagy az AI asszisztenssel módosított ár a feed következő olvasásával eljut az Árukeresőre és a Google Shoppingba, második fájl nélkül. A Google-csatorna lépéseit a Google Shopping és Merchant Center útmutatója írja le.

Bevált gyakorlatok termékfeltöltéshez

1. Teszt kis fájllal. 10-20 sor, utána a teljes katalógus.
2. Mindig azonos oszlopsorrend. A párosítás nem mentődik a következő importra. Ha a fájl oszlopai mindig ugyanazok, a párosítás másodpercekig tart.
3. A termékek piszkozatként. Hagyja kikapcsolva a „Publish imported products” beállítást, nézzen át 10 terméket, és utána tegye közzé őket a listából.
4. Teljes cikkszámok és vonalkódok. Ezek alapján frissíti később az árakat és a készletet a beszállítótól, a vállalatirányítási rendszerből vagy az AI asszisztenssel.
5. Kategóriák elérési úttal. Minden sorban ugyanaz az elválasztó. A „Ruházat > Ingek” és a „Ruházat/Ingek” két külön fát hoz létre.
6. Működő képcímek. Import előtt nyisson meg 3 képcímet a böngészőben.

Kerülendő hibák termékimportnál

• Ismételt CSV import az árak módosítására. A CSV import új termékeket hoz létre. A szerkesztett fájl második feltöltése duplikátumokat ad. Módosításra a Google Sheetset, az Update jelölésű XML Importot vagy az AI asszisztenst használja.
• Az admin azonosítója a product.id oszlopban. A termék admin címében szereplő szám (például 583) nem frissíti az 583-as terméket. Az oszlop a saját fájlbeli kódja, és az import ilyenkor is új terméket hoz létre.
• Kikapcsolt fejlécsor. Ha a fájlnak van fejléce, de a kapcsoló ki van kapcsolva, az első sorból „Név” nevű termék lesz.
• Nem UTF-8 kódolású fájl. Az ékezetes betűk hibásan jelennek meg. Mentse a fájlt CSV UTF-8 formátumban.
• Két import egyszerre. A webshop egyszerre egy CSV importot futtat, csomagtól függetlenül. Várja meg, amíg az első befejeződik.

Ha az import hibás lett, a terméklista Imported with szűrője egy feladat összes termékét megmutatja. Jelölje ki és törölje őket egyszerre, majd töltse fel a javított fájlt. A katalógus feltöltésének és szerkesztésének minden módja a termékkatalógus oldalán van, a teljes webshop átvitele másik rendszerből pedig a webáruház költöztetés oldalán. Ha elakad, írjon a support@cloudcart.com címre.

Gyakori kérdések