Import produse din CSV, XML și Google Sheets în magazinul online

Pe scurt: CSV este un fișier text cu un tabel, în care valorile sunt separate prin virgulă sau punct și virgulă. În CloudCart îl încarci din Produse → Import → Import with CSV file. Feedul XML al furnizorului îl aduci cu XML Import sau XML Sync, iar modificările în masă le faci în Google Sheets. Importul CSV creează mereu produse noi, așa că prețurile le actualizezi prin XML sau Google Sheets.

Ce este un fișier CSV, cu ce se deschide și ce este un feed XML

CSV (Comma-Separated Values) este un fișier text cu un tabel: fiecare rând este o înregistrare, iar valorile din rând sunt separate prin virgulă sau prin alt caracter (RFC 4180).

Un fișier CSV se deschide cu Excel, Google Sheets, LibreOffice Calc sau un editor de text, pentru că este text simplu. Se creează din aceleași programe: în Excel cu Salvare ca → CSV UTF-8, în Google Sheets cu Fișier → Descărcați → Valori separate prin virgulă (.csv).

XML (Extensible Markup Language) este un format text în care datele stau în etichete (tag-uri), de exemplu <price>89.90</price> (specificația W3C). Mulți distribuitori și importatori din România își publică catalogul ca feed XML la o adresă fixă (URL). Feedul se actualizează la ei, iar magazinul îl citește după un program.

În CloudCart fiecare format are aplicația lui. Tabelul arată ce face fiecare și unde se oprește.

Instrument	Sursa	Creează produse noi	Actualizează produse existente	Potrivit pentru
CSV Import	Fișier .csv sau .txt încărcat de tine	Da	Nu, un import repetat face dubluri	Prima încărcare a catalogului, migrare
XML Import	Adresa (URL) unui feed XML	Da	Da, doar câmpurile bifate cu „Update”	Catalogul unui furnizor, o linie nouă de produse
XML Sync	Adresa (URL) unui feed XML, după program	Da	Da, câmpurile bifate cu „Update”, la fiecare rulare	Dropshipping, prețuri și stocuri zilnice
Google Sheets	Un tabel creat de CloudCart în contul tău Google	Da, un rând cu Product ID gol	Da, tabelul are prioritate la Download	Modificări manuale de prețuri, nume, texte
Agent AI cu cheie PAT	O propoziție și un fișier pe care i le dai agentului	Da	Da, după SKU sau după o regulă	Modificări care se spun într-o propoziție

Ce metodă de import să alegi

Alegerea depinde de unde vin datele și cât de des se schimbă. O dată: CSV. De la un furnizor: XML. Produse deja în magazin: Google Sheets sau un agent AI.

• Magazin nou cu catalogul în Excel. Salvează tabelul ca CSV UTF-8 și încarcă-l prin importul CSV. Este drumul cel mai scurt de la fișier la produse.
• Migrare de pe WooCommerce, Shopify, OpenCart sau Magento. Exportă produsele din platforma veche în CSV sau XML și importă-le. Cum păstrezi adresele și pozițiile din Google este explicat în ghidul de migrare de pe WooCommerce fără pierderi SEO.
• Furnizor cu feed XML. XML Import încarcă o dată catalogul și apoi recitește implicit feedul la fiecare 12 ore. XML Sync este pentru furnizorii la care prețurile și stocurile se schimbă zilnic. Cum începi cu un astfel de furnizor afli în ghidul despre dropshipping în România.

Ce coloane trebuie în fișierul CSV pentru import

Pentru importul de produse din CSV în CloudCart sunt obligatorii două coloane: product.id și product.name. Dacă produsul are variante, fiecare rând de variantă cere și variant.parent_id. Toate celelalte coloane sunt opționale și le asociezi manual în ultimul pas al importului.

Câmp în CloudCart	Obligatoriu	Ce scrii în coloană
product.id	Da	Codul tău de produs din fișier. Rândurile cu același cod devin un singur produs.
product.name	Da	Numele produsului.
variant.parent_id	Da, pentru variante	Codul produsului principal căruia îi aparține varianta.
variant.v1 / variant.v1_value	Nu	Prima opțiune și valoarea ei, de exemplu „Mărime” și „M”. Mai există v2 și v3: până la 3 opțiuni pe variantă.
Preț, SKU, cod de bare, greutate	Nu	La nivel de produs sau de variantă (variant.price, variant.sku, variant.quantity).
Categorie	Nu	O cale cu separator, de exemplu „Haine > Cămăși”. Caracterul se alege în setările importului.
product_images.src	Nu	Adresele pozelor, separate prin virgulă într-o singură celulă.
Descriere, marcă, etichete, caracteristici	Nu	Text. Mai multe coloane pot intra în același câmp.

Pozele nu rămân pe serverul altcuiva. CloudCart descarcă o dată fiecare poză de la adresa ei și o păstrează în biblioteca sa media, așa că site-ul vechi poate fi oprit după import. Butonul CSV Template din primul pas al importului descarcă un fișier model.

Exemplu pentru un magazin de haine: un tricou în 3 mărimi înseamnă 3 rânduri în fișier. Toate trei au variant.parent_id „TRC-01”, iar coloanele v1 și v1_value sunt „Mărime” și, pe rând, S, M, L. După import, în magazin există 1 produs cu 3 variante.

Cum încarci produse din Excel, pas cu pas

Produsele din Excel se încarcă în CloudCart ca fișier CSV, pentru că importul nu primește fișiere .xls și .xlsx. În Excel alege Salvare ca → CSV UTF-8. Codificarea UTF-8 păstrează diacriticele ș, ț, ă, î, â. Un fișier salvat în altă codificare, de exemplu Windows-1250, poate afișa literele românești greșit în magazin.

Excel salvează CSV-ul cu separatorul de listă din setările regionale ale calculatorului, așa că un fișier din România iese des cu punct și virgulă în loc de virgulă (Microsoft Support explică separatorul). Pentru CloudCart nu contează: separatorul se recunoaște singur.

1. Deschide importul. În panoul de administrare: Produse → butonul Import (iconița cu nor) → Import with CSV file. Același import este și în Aplicații → CSV Import.
2. Pasul 1, Upload file. Trage fișierul în fereastră sau alege-l din calculator. Separatorul (virgulă, punct și virgulă, tab) este recunoscut automat din primii 10 KB ai fișierului.
3. Pasul 2, CSV file settings. Activează rândul de antet dacă primul rând din fișier conține numele coloanelor. Implicit comutatorul este oprit, iar primul rând ar deveni produs. Tot aici alegi caracterul care separă categoriile (de exemplu >).
4. Setări avansate. Alege dacă produsele se publică imediat, dacă sunt „recomandate” sau „noi”, dacă necesită livrare, dacă li se urmărește stocul și dacă se vând și fără stoc.
5. Pasul 3, Mapping. Lângă fiecare câmp CloudCart alege coloana din fișier. Apasă Submit.
6. Urmărește progresul. Butonul Track importing progress deschide lista sarcinilor. Rândurile eșuate apar într-un tabel separat, cu eroarea.

Important: pornește întâi un fișier cu 10-20 de rânduri și verifică pe produse că prețurile, diacriticele și categoriile au ieșit corect. Importul CSV nu are buton de anulare: Cancel import oprește sarcina, dar produsele deja create rămân. Dacă asocierea coloanelor este greșită, eroarea atinge 20 de produse, pe care le ștergi într-un minut.

Cum imporți produse din feedul XML al unui furnizor

Un feed XML se importă cu aplicația XML Import: dai adresa feedului, asociezi tag-urile cu câmpurile din CloudCart, iar platforma creează produsele. Aplicația primește doar o adresă (HTTP sau HTTPS). Pentru un fișier de pe calculator folosește importul CSV.

1. Instalează aplicația. Aplicații → XML Import → Install, apoi + New task.
2. Pasul 1: adresa și regulile. Lipește adresa feedului primită de la furnizor. Alege tipul importului: produse noi, actualizarea celor existente sau ambele. Tot aici activezi Track inventory, Continue selling și Disable missings (ascunde produsele care nu mai sunt în feed).
3. Pasul 2: tag-urile. Arată tag-ul care cuprinde fiecare produs și asociază tag-urile cu câmpurile: nume, preț, SKU, descriere, poze, categorie, cantitate. Alege cum descrie feedul variantele. Lângă fiecare câmp există bifa Update.
4. Pasul 3: final. Asociază categoriile (cele lipsă se creează singure), taxa, marca și caracteristicile. La salvare, sarcina pornește.
5. Verifică statusul. În Status vezi progresul fiecărei sarcini. La un feed mare, importul continuă în fundal și poți închide pagina.

Feedul se recitește implicit la fiecare 12 ore. După 3 încercări eșuate la rând, sarcina se oprește singură, ca să nu scrie date vechi.

Exemplu pentru un magazin de electrocasnice: distribuitorul trimite un link de forma https://distribuitor.ro/feed/produse.xml, cu un tag <produs> pentru fiecare articol și prețul de vânzare recomandat în lei. Asociezi <denumire> cu numele, <cod> cu SKU-ul, <pret> cu prețul și <stoc> cu cantitatea. Înainte de prima sarcină, cere-i furnizorului în scris cât de des se actualizează feedul și dacă prețul din el include TVA.

Cum actualizezi prețurile din XML-ul furnizorului

Prețurile din feedul XML al furnizorului se actualizează cu bifa Update din pasul 2 al XML Import sau XML Sync. Bifează doar prețul și cantitatea. Câmpurile fără bifă, de exemplu descrierile tale și textele SEO, rămân neschimbate la fiecare nouă citire a feedului.

Platforma găsește produsul existent după sarcina care l-a creat și după codul rândului din feed, așa că actualizarea nu face dubluri. La XML Sync alegi încă din pasul 1 după ce se potrivesc produsele (Compare by): SKU, cod de bare sau ID.

• Prețuri și stocuri în fiecare zi. XML Sync. Compară feedul cu catalogul la fiecare rulare și actualizează, creează sau ascunde produse.
• Produse oprite de furnizor. Activează Disable missings. Produsele se ascund și nu se șterg. La XML Sync activează și Enable exists products: un produs ascuns reapare singur când revine în feed cu stoc.
• Pozele. După ce pozele s-au încărcat, scoate bifa Update de pe ele. Dacă furnizorul schimbă adresa unei poze cu una greșită, cu bifa activă poza veche se șterge întâi și produsul poate rămâne fără poză.

Google Sheets: modificări în masă pentru produsele care sunt deja în magazin

Google Sheets este metoda recomandată pentru a schimba prețuri, nume, descrieri, mărci și categorii la produsele care sunt deja în CloudCart. Upload trimite catalogul într-un tabel, iar Download aduce modificările înapoi.

1. Conectează contul Google. Aplicații → Google Sheets → Settings → Sign in with Google. Platforma creează singură tabelul la prima conectare. Nu poți alege un tabel al tău.
2. Alege produsele și coloanele. Filtru: toate produsele, o categorie, o marcă sau anumite produse. Bifează coloanele pe care le vei modifica. Fără cel puțin o coloană, setările nu se salvează.
3. Upload. În secțiunea Tasks apasă butonul cu săgeata în sus. Fiecare Upload golește foaia și o scrie din nou.
4. Modifică în tabel. Un rând nou cu Product ID gol devine produs nou. O categorie nouă se scrie ca o cale („Haine > Cămăși”) și se creează singură, la fel ca o marcă nouă.
5. Download. Butonul cu săgeata în jos aduce modificările înapoi. Download pornește doar după cel puțin un Upload reușit.

Important: la Download tabelul are prioritate. Dacă între Upload și Download ai modificat un produs în panoul de administrare, valoarea din tabel o înlocuiește. Fă Upload chiar înainte să începi editarea.

Google Sheets lucrează doar cu produse: comenzile și clienții nu trec prin el. Dacă aplicația nu apare în lista de aplicații, planul tău nu o include.

Import și modificări cu un agent AI, fără coloane și asocieri

Un agent AI conectat la magazin printr-o cheie PAT încarcă și modifică produse dintr-o propoziție, fără să asociezi coloane. Agentul este un program precum Claude Code, ChatGPT Codex, Gemini CLI sau Cursor, care lucrează prin Admin GraphQL API-ul CloudCart cu drepturile cheii pe care i-ai dat-o.

Un exemplu de propoziție: „Uite lista de prețuri a furnizorului în preturi-11.xlsx. Actualizează prețurile după SKU, nu atinge produsele care nu sunt în fișier și arată-mi primele 5 înainte să salvezi.” Cu abilitățile (skills) CloudCart pentru agentul AI, la 100 de rânduri sau mai multe agentul salvează întâi valorile actuale într-un fișier CSV și face o rulare „de probă”, fără să schimbe nimic. Fișierul este drumul înapoi pe care importul CSV nu îl are.

Cum descarci comenzile și vânzările din CloudCart ca fișier CSV

Comenzile se descarcă ca fișier CSV cu butonul Export din dreapta sus, în Comenzi. Exportul ia exact comenzile pe care le vezi după filtre (perioadă, status, plată), iar fără filtru ia tot istoricul. Formatul este doar CSV, cu un set fix de peste 40 de coloane și câte un rând pentru fiecare produs din comandă.

Până la 50 de comenzi fișierul se descarcă imediat. La mai multe, exportul rulează în fundal, iar CloudCart trimite un e-mail cu linkul de descărcare.

Din fișier, vânzările și coșul mediu le calculezi în Excel cu un tabel pivot. Un agent AI cu o cheie PAT doar pentru citire (Read Only) dă aceleași cifre direct din magazin, dintr-o propoziție, fără fișier.

Câte produse poți importa, în funcție de plan

Limitele importului urmează planul magazinului. Tabelul este după pagina de prețuri și planuri din noiembrie 2026, la plata anuală și fără TVA.

Limită	Baby Pack (14 €)	Starter Pack (33 €)	CC Pro (83 €)	CC Master (249 €)
Produse în magazin	100	2.000	7.500	Nelimitat
Import CSV	100	2.000	7.500	10.000
XML Import: produse pe sarcină	100	2.000	7.500	25.000
XML Import: sarcini active	1	1	1	2
XML Import: limita totală de produse importate	100	2.000	7.500	100.000
Sincronizare XML: produse	100	2.000	7.500	25.000

Dacă importul CSV atinge limita de produse la jumătate, sarcina se oprește cu un mesaj despre câte rânduri au intrat din câte. La XML Import, produsele peste limită nu se procesează și primești o notificare și un e-mail. Limitele cresc cu un plan mai mare sau cu un pachet suplimentar de produse. Abonamentul planului este fix, iar comisionul din vânzări este 0% pe orice plan, oricâte produse ai încărca.

Direcția inversă: feed XML din magazin către eMAG, Google și ShopMania

După import, același catalog pleacă spre comparatoarele de prețuri și marketplace-uri ca feed XML pe care CloudCart îl generează singur. Aplicația XML Feed (Aplicații → XML Feed) are formate gata făcute pentru Google Merchant Center, catalogul Facebook, TikTok, eMAG, ShopMania, Glami și Criteo, plus un feed CSV pentru rețeaua de afiliere Profitshare. Activezi formatul de care ai nevoie, iar platforma publică feedul la o adresă fixă, pe care o dai canalului.

Un preț schimbat de XML Sync de la furnizor sau de agentul AI ajunge la Google în cel mult 2 ore și la eMAG sau ShopMania în cel mult 4 ore, la următoarea generare a feedului, fără un al doilea fișier. Pentru eMAG Marketplace feedul este într-o singură direcție: produsele, prețurile și stocurile pleacă spre eMAG, iar comenzile rămân în eMAG, unde le gestionezi. Conectarea la eMAG o faci împreună cu echipa de suport CloudCart.

Cu cât sunt mai complete coloanele la import (SKU, cod de bare, marcă, categorie, poze), cu atât mai puține produse sunt respinse în Google Shopping și în reclamele cu produse. Google cere pentru fiecare produs cel puțin un ID, un titlu, prețul și linkul pozei, iar GTIN-ul și marca acolo unde există, conform specificațiilor Google Merchant Center.

Bune practici la importul de produse

1. Test cu un fișier mic. 10-20 de rânduri, apoi tot catalogul.
2. Produsele ca ciorne. Lasă „Publish imported products” oprit, verifică 10 produse și abia apoi publică-le din listă.
3. SKU-uri și coduri de bare complete. După ele actualizezi apoi prețurile și stocurile de la furnizor, din softul de gestiune (ERP) sau cu agentul AI.
4. Categoriile ca o cale. Același separator pe toate rândurile. „Haine > Cămăși” și „Haine/Cămăși” fac doi arbori diferiți.
5. Stocul în soft de gestiune. Dacă stocurile se țin într-un ERP, e mai bine să vină direct din el printr-o integrare.

Greșeli la import pe care să le eviți

• Un nou import CSV ca să schimbi prețurile. Importul CSV creează produse noi. Un fișier modificat, încărcat a doua oară, face dubluri. Pentru modificări folosește Google Sheets, XML Import cu bifa Update sau agentul AI.
• Fișier care nu e în UTF-8. Diacriticele ies cu semne de neînțeles. Salvează fișierul ca CSV UTF-8.
• Două importuri deodată. Magazinul rulează un singur import CSV o dată, indiferent de plan.

Dacă un import a ieșit greșit, filtrul Imported with din lista de produse arată toate produsele dintr-o sarcină. Selectează-le, șterge-le dintr-odată și pornește fișierul corectat. Toate metodele de încărcare și editare a catalogului sunt adunate pe pagina despre catalogul de produse, iar mutarea completă a unui magazin de pe altă platformă este pe pagina despre migrarea în CloudCart. Pașii pentru fiecare platformă veche sunt în ghidul despre importul magazinului din altă platformă.

Întrebări frecvente

Ai o întrebare despre fișierul tău sau despre feedul furnizorului? Scrie-ne la support@cloudcart.com.