Импорт на продукти от CSV, XML и Google Sheets в CloudCart

Накратко: CSV е текстов файл с таблица, в който стойностите са разделени със запетая. В CloudCart го качвате от Продукти → Import → Import with CSV file. XML фийд от доставчик зареждате с XML Import, а масовите редакции правите с Google Sheets. CSV импортът винаги създава нови продукти, затова цените обновявайте с XML Import или XML Sync.

Какво е CSV файл, с какво се отваря и какво е XML фийд

CSV (Comma-Separated Values) е текстов файл с таблица, в който всеки ред е запис, а стойностите в реда са разделени със запетая или друг знак (RFC 4180). Excel, Google Sheets и почти всяка платформа за онлайн магазини записват и четат CSV, затова той е най-честият формат за пренасяне на каталог.

CSV файл се отваря с Excel, Google Sheets, LibreOffice Calc или обикновен текстов редактор, защото съдържанието е чист текст. Създава се от същите програми: в Excel с Save As → CSV UTF-8, в Google Sheets с File → Download → Comma-separated values (.csv). Ред „TSH-01,Тениска Basic,24.90“ в CSV е една клетка с код, една с име и една с цена.

XML (Extensible Markup Language) е текстов формат, в който данните са в етикети, например <price>24.90</price> (спецификацията на W3C). Доставчиците публикуват каталога си като XML фийд на постоянен адрес (URL). Фийдът се обновява при тях, а магазинът го чете по график.

В CloudCart, българската платформа за онлайн магазини, всеки формат има свое приложение. Таблицата показва кое какво прави и къде е границата му.

Инструмент	Източник	Създава нови	Обновява съществуващи	Най-добър за
CSV Import	Файл .csv или .txt, качен от вас	Да	Не, повторният импорт прави дубликати	Първо зареждане на каталог, миграция
XML Import	Адрес (URL) на XML фийд	Да	Да, само полетата с отметка „Update“	Каталог на доставчик, нова продуктова линия
XML Sync	Адрес (URL) на XML фийд, по график	Да	Да, полетата с отметка „Update“, при всяко изпълнение	Дропшипинг, ежедневни цени и наличности
Google Sheets	Таблица, която CloudCart създава в профила ви в Google	Да, ред с празен Product ID	Да, таблицата е водеща при Download	Ръчни промени на цени, имена, текстове
AI агент с PAT токен	Изречение и файл, който давате на агента	Да	Да, по SKU или по правило	Промени, които се казват с едно изречение

Кой начин за импорт да изберете

Изборът зависи от това откъде идват данните и колко често се сменят. Ако каталогът идва веднъж, ползвайте CSV. Ако идва от доставчик, ползвайте XML. Ако вече е в магазина, ползвайте Google Sheets или AI агент.

• Нов магазин с каталог в Excel. Запишете таблицата като CSV и я качете с CSV импорта. Това е най-краткият път от файла до продуктите.
• Миграция от WooCommerce, Shopify, OpenCart или Magento. Експортирайте продуктите от старата платформа в CSV или XML и ги импортирайте. Как се пазят адресите и позициите в Google, е описано в ръководството за миграция от WooCommerce без загуба на SEO.
• Доставчик с XML фийд. XML Import зарежда каталога веднъж и после по подразбиране чете фийда отново на всеки 12 часа. XML Sync е за доставчици, чиито цени и наличности се сменят всеки ден. Как се започва с такъв доставчик е в статията какво е дропшипинг.
• Нов ценоразпис за продукти, които вече продавате. Google Sheets, ако пишете цените на ръка, или AI агент, ако промяната е правило („+8% на марка X“).
• Дропшипинг. XML Sync с отметка Update само на цена и количество, за да не се презаписват вашите описания. Доставчикът държи склада, а магазинът показва неговите цени и наличности.

Какви колони трябват в CSV файла за импорт

За CSV импорт на продукти в CloudCart са задължителни две колони: product.id и product.name. Ако продуктът има варианти, всеки ред с вариант иска и variant.parent_id. Всички останали колони са по избор и се съпоставят ръчно в последната стъпка на импорта.

Поле в CloudCart	Задължително	Какво пишете в колоната
product.id	Да	Ваш код на продукта във файла. Редовете с един и същ код стават един продукт.
product.name	Да	Името на продукта.
variant.parent_id	Да, за варианти	Кодът на основния продукт, към който принадлежи вариантът.
variant.v1 / variant.v1_value	Не	Първа опция и стойност, например „Размер“ и „M“. Има още v2 и v3: до 3 опции на вариант.
Цена, SKU, баркод, тегло	Не	На ниво продукт или на ниво вариант (variant.price, variant.sku, variant.quantity).
Категория	Не	Път с разделител, например „Дрехи > Ризи“. Знакът се задава в настройките на импорта.
product_images.src	Не	Адреси на снимките, разделени със запетая в една клетка.
Описание, марка, етикети, характеристики	Не	Текст. Няколко колони могат да влязат в едно поле.

Снимките не остават на чуждия сървър. CloudCart изтегля всяка снимка по адреса ѝ веднъж и я пази в своята медийна библиотека, затова старият сайт може да спре след импорта. Шаблон с правилните колони има в прозореца за импорт: бутонът CSV Template в първата стъпка тегли примерен файл.

Пример за магазин за дрехи: тениска в 3 размера е 3 реда във файла. И трите реда имат variant.parent_id „TSH-01“, а колоните v1 и v1_value са „Размер“ и съответно S, M, L. След импорта в магазина има 1 продукт с 3 варианта. Затова броят на продуктите може да е по-малък от броя на редовете в CSV файла.

Как да кача продукти от Excel: стъпка по стъпка

Продукти от Excel се качват в CloudCart като CSV файл, защото импортът не приема .xls и .xlsx. В Excel изберете Save As → CSV UTF-8 (Microsoft Support). Кодировката UTF-8 пази кирилицата. Файл в Windows-1251 може да излезе с непонятни знаци.

1. Отворете импорта. В админа: Продукти → бутонът Import (иконата с облак) → Import with CSV file. Същият импорт е и в Приложения → CSV Import.
2. Стъпка 1, Upload file. Пуснете файла или го изберете от компютъра. Разделителят (запетая, точка и запетая, табулация) се разпознава сам по първите 10 KB на файла.
3. Стъпка 2, CSV file settings. Включете заглавния ред, ако първият ред на файла съдържа имената на колоните. По подразбиране превключвателят е изключен и първият ред ще стане продукт. Тук задавате и знака, който разделя категориите (например >).
4. Разширени настройки. Изберете дали продуктите да се публикуват веднага, да са „препоръчани“ или „нови“, дали искат доставка, дали се следи наличността им и дали се продават при изчерпване. Настройките важат за всички редове във файла.
5. Стъпка 3, Mapping. До всяко поле на CloudCart изберете колоната от файла. Платформата показва стойността от първия ред, за да разпознаете колоните. Натиснете Submit.
6. Следете напредъка. Бутонът Track importing progress отваря списъка със задачите. Броят на внесените и неуспешните редове се обновява на всеки 5 секунди, а неуспешните редове са в отделна таблица с грешката.

Важно: първо пуснете файл с 10 до 20 реда. CSV импортът няма бутон за връщане назад: Cancel import спира задачата, но вече създадените продукти остават. Ако съпоставянето е грешно, грешката засяга 20 продукта, които изтривате за минута.

Как да импортирате продукти от XML фийд на доставчик

XML фийд се импортира с приложението XML Import: задавате адреса на фийда, съпоставяте етикетите с полетата в CloudCart и платформата създава продуктите. Приложението приема само адрес (HTTP или HTTPS). За файл на компютъра ползвайте CSV импорта.

1. Инсталирайте приложението. Приложения → XML Import → Install, после + New task.
2. Стъпка 1: адрес и правила. Поставете адреса на фийда. Изберете вид на импорта: нови продукти, обновяване на съществуващи или и двете. Тук са и превключвателите за следене на наличността (Track inventory), продажба при изчерпване (Continue selling), скриване на продукти, които вече не са във фийда (Disable missings), и фиксирана категория за всички продукти.
3. Стъпка 2: етикетите. Посочете етикета, който обвива всеки продукт, и съпоставете етикетите с полетата: име, цена, SKU, описание, снимки, категория, количество. Изберете как фийдът описва вариантите. До всяко поле има отметка Update.
4. Стъпка 3: финал. Съпоставете категориите (липсващите се създават сами, нивата са с >), данъка и марката по подразбиране и характеристиките. Със записа задачата тръгва.
5. Проверете статуса. В Status виждате напредъка на всяка задача. При голям фийд импортът продължава във фонов режим и можете да затворите страницата.

Фийдът се чете отново по подразбиране на всеки 12 часа. Платформата чака отговор от сървъра на доставчика до 120 секунди. След 3 поредни неуспешни опита задачата се изключва сама, за да не пише стари данни. Пуснете я отново, когато доставчикът оправи фийда.

Как да обновявам цените от XML на доставчика

Цените от XML фийда на доставчика се обновяват с отметката Update в стъпка 2 на XML Import или XML Sync. Сложете отметка само на цената и количеството. Полетата без отметка, например вашите описания и SEO текстове, остават непроменени при всяко следващо четене на фийда.

Платформата намира съществуващия продукт по задачата, която го е създала, и по кода на реда във фийда. Затова обновяването не прави дубликати. При XML Sync изберете още в стъпка 1 по какво да се съпоставят продуктите (Compare by): SKU, баркод или ID.

• Цени и наличности всеки ден. XML Sync. Той сравнява фийда с каталога при всяко изпълнение и обновява, създава или скрива продукти.
• Продукти, които доставчикът е спрял. Включете Disable missings. Продуктите се скриват, без да се изтриват. При XML Sync включете и Enable exists products: тогава скрит продукт се показва отново сам, когато се върне във фийда с наличност.
• Снимките. След като снимките са заредени, махнете отметката Update от тях. Ако доставчикът смени адреса на снимка с грешен, при включена отметка старата снимка се изтрива първо и продуктът може да остане без снимка.

Ако цените на доставчика идват като Excel ценоразпис, а не като фийд, по-бързо е да дадете файла на AI агента с изречение „обнови цените по SKU и ми покажи кои кодове липсват“. Как агентът прави това с преглед и файл за връщане назад, е в статията за масова промяна на цени и наличности с едно изречение.

Google Sheets: масова промяна на продуктите, които вече са в магазина

Google Sheets е препоръчаният начин да промените цени, имена, описания, марки и категории на продукти, които вече са в CloudCart. Целият цикъл е два бутона: Upload изпраща каталога в таблица, а Download връща промените в магазина.

1. Свържете профила в Google. Приложения → Google Sheets → Settings → Sign in with Google. Платформата създава таблица сама при първото свързване. Не можете да посочите своя таблица.
2. Изберете продукти и колони. Филтър: всички продукти, категория, марка или конкретни продукти. Настройките предлагат и етикет и селекция, но при Upload тези два филтъра не стесняват избора и в таблицата влизат всички продукти. Отбележете колоните, които ще редактирате. Без поне една колона настройките не се записват.
3. Upload. В раздела Tasks натиснете бутона със стрелка нагоре. Всяко Upload изтрива съдържанието на листа и го пише наново.
4. Редактирайте в таблицата. Нов ред с празен Product ID става нов продукт. Нова категория се пише като път („Дрехи > Ризи“) и се създава сама, както и нова марка.
5. Download. Бутонът със стрелка надолу връща промените. Download се пуска само след поне едно успешно Upload.

Важно: при Download таблицата е водеща. Ако между Upload и Download сте променили продукт в админа, стойността от таблицата ще я замени. Етикетите също се записват наново от таблицата. Правете Upload непосредствено преди да започнете да редактирате.

Google Sheets работи само с продукти: поръчките и клиентите не минават през него. Ако приложението не се показва в списъка с приложения, планът ви не го включва. Как са устроени продуктите, вариантите, свойствата и марките, които пишете в колоните, е обяснено в ръководството за продуктовия каталог в CloudCart.

Импорт и промени с AI агент вместо колони и съпоставяне

AI агент, свързан с магазина през PAT токен, зарежда и променя продукти по изречение, без да съпоставяте колони. Агентът е програма като Claude Code, ChatGPT Codex, Gemini CLI или Cursor, която работи през Admin GraphQL API на CloudCart с правата на токена, който сте ѝ дали.

Примерно изречение: „Ето ценоразписа на доставчика в цени-11.xlsx. Обнови цените по SKU, продуктите, които ги няма във файла, не пипай, и ми покажи първите 5 преди да запишеш.“ С уменията на CloudCart за AI агента при 100 и повече реда агентът първо записва текущите стойности в CSV файл и минава „на сухо“, без да променя нищо. При над 1 000 реда този файл е задължителен, дори да кажете да го пропусне. Агент без тези умения помолете първо да покаже плана. Файлът е пътят назад, който CSV импортът няма.

Разликата е в броя на ръчните стъпки. При CSV импорт експортирате, чистите колоните, качвате и съпоставяте поле по поле. С агента давате файла и едно изречение, а агентът сам открива кой SKU на кой продукт отговаря и връща списък с несъвпаденията. Колко време спестява това всеки месец, освен за каталога и за отчети, имейли и реклами, е сметнато в статията защо да управлявате магазина с AI агент. Как се създава токенът и какви права (scopes) да му дадете, е описано в ръководството за PAT токен в CloudCart.

Как да изтеглите поръчките и продажбите от CloudCart като CSV файл

Поръчките се изтеглят като CSV файл с бутона Export горе вдясно в Поръчки. Експортът взима точно поръчките, които виждате след филтрите (период, статус, плащане), а без филтър взима цялата история. Форматът е само CSV, с фиксиран набор от над 40 колони и по един ред за всеки продукт в поръчката.

• До 50 поръчки. Файлът се тегли веднага в браузъра.
• Над 50 поръчки. Експортът минава във фонов режим и CloudCart изпраща имейл с линк за изтегляне. Файлът се пази и във файловия мениджър на магазина.
• Защита. Ако за профила е включена двуфакторна защита, преди експорта платформата иска код.

Файлът с поръчките е суровина: оборот, средна поръчка или продажби по продукт се смятат после в Excel с обобщена таблица. AI агент с PAT токен с права само за четене (Read Only) прескача тази стъпка. Изречение като „покажи оборота, броя поръчки и средната поръчка за октомври спрямо септември и 5-те най-продавани продукта“ връща готовите числа направо от магазина, без файл и без формули.

Задача	С CSV експорт	С AI агент
Оборот и средна поръчка за месеца	Експорт, филтър, обобщена таблица	Едно изречение
Най-продаваните продукти	Сумиране по продукт в Excel	Едно изречение, с имената и SKU
Сравнение с предходен период	Два експорта и ръчно сравнение	Едно изречение с двата периода
Отчет всяка сутрин	Ръчно всеки ден	Агент по график

Кои 10 метрики да следите, как се смятат и какви изречения да дадете на агента, е в статията за KPI на онлайн магазина, които AI агентът смята вместо вас. Как агентът праща отчета за продажбите, склада и изоставените колички всяка сутрин, е описано в отчет за продажбите в 8:00 с AI агент.

Колко продукта можете да импортирате по план

Лимитите на импорта следват плана на магазина. Таблицата е по страницата с цените и плановете към ноември 2026, при годишно плащане и без ДДС.

Лимит	Baby Pack (€14)	Starter Pack (€33)	CC Pro (€83)	CC Master (€249)
Продукти в магазина	100	2 000	7 500	Неограничено
CSV импортиране	100	2 000	7 500	10 000
XML Import: продукти за задача	100	2 000	7 500	25 000
XML Import: активни задачи	1	1	1	2
XML Import: общ лимит на импортирани продукти	100	2 000	7 500	100 000
XML синхронизация: продукти	100	2 000	7 500	25 000

Ако CSV импортът стигне лимита на продуктите по средата, задачата спира със съобщение колко реда са внесени от общо колко. При XML Import продуктите над лимита не се обработват и получавате известие и имейл. Общият лимит на XML Import брои всички продукти, внесени някога с приложението: изтриването на задачата не го нулира, само изтриването на продуктите. Лимитите се вдигат с по-висок план или с допълнителен пакет продукти. Таксата на плана е фиксирана, а комисионната от продажбите е 0% на всеки план, колкото и продукти да заредите.

Обратната посока: XML фийд от магазина към Pazaruvaj, eMAG и Google

След импорта същият каталог излиза към сайтовете за сравнение на цени и маркетплейсите като XML фийд, който CloudCart генерира сам. Приложението XML Feed (Приложения → XML Feed) има готови формати за Google Merchant Center, Facebook каталог, TikTok, Pazaruvaj, eMAG, Glami, Skroutz и Criteo. Включвате нужния формат и платформата публикува фийда на постоянен адрес, който давате на канала.

Така каталогът се поддържа на едно място. Цена, сменена с XML Sync от доставчика или с AI агента, стига до Pazaruvaj и Google Shopping със следващото четене на фийда, без втори файл. Стъпките за отделните канали са в ръководствата за продуктов фийд за Pazaruvaj и за Google Shopping и Merchant Center.

Фийдовете за Facebook каталог, TikTok и Google Merchant Center са основата на рекламите с продукти: Meta и TikTok могат да показват на всеки човек продуктите, които е разглеждал, с цената от фийда, а Google Ads ги показва в Shopping и Performance Max. Колкото по-пълни са колоните при импорта (SKU, баркод, марка, категория, снимки), толкова по-малко продукти отпадат при проверката в рекламните профили. Настройката на кампаниите е в ръководствата за реклама в Meta, TikTok Ads и Google Ads за онлайн магазин.

Добри практики при импорт на продукти

1. Тест с малък файл. 10 до 20 реда, после целият каталог.
2. Еднакъв ред на колоните. Съпоставянето не се запазва за следващ импорт. Ако файлът е с едни и същи колони всеки път, съпоставянето отнема секунди.
3. Продуктите като чернови. Оставете „Publish imported products“ изключено, прегледайте 10 продукта и тогава ги публикувайте от списъка.
4. Пълни SKU и баркодове. По тях после обновявате цени и наличности от доставчика, от ERP системата или с AI агента.
5. Категории по пътя. Един и същ разделител във всички редове. „Дрехи > Ризи“ и „Дрехи/Ризи“ правят две различни дървета.
6. Снимки на адрес, който работи. Проверете 3 адреса в браузъра, преди да пуснете импорта.
7. Склад в ERP. Ако наличностите се водят в склад като Микроинвест, по-добре да идват директно от него чрез интеграция. Връзките са в статията за склад, POS и ERP в CloudCart.

Грешки при импорт, които да избягвате

• Повторен CSV импорт за промяна на цени. CSV импортът създава нови продукти. Редактиран файл, качен втори път, прави дубликати. За промени ползвайте Google Sheets, XML Import с отметка Update или AI агент.
• ID от админа в колоната product.id. Номерът от адреса на продукта в админа (например 583) не обновява продукт 583. Колоната е кодът във вашия файл и импортът пак създава нов продукт.
• Изключен заглавен ред. Ако файлът има заглавия, а превключвателят е изключен, първият ред става продукт с име „Име“.
• Файл в Windows-1251. Кирилицата излиза с непонятни знаци. Запишете файла като CSV UTF-8.
• Повторен импорт, защото продуктите не се виждат. След импорта продуктите се появяват в магазина един по един, докато търсенето се обнови. В админа ги има веднага, затова проверете там, преди да качите файла пак.
• Два импорта наведнъж. Магазинът пуска един CSV импорт в даден момент, независимо от плана. Изчакайте първия да свърши.

Ако импортът е грешен, филтърът Imported with в списъка с продукти показва всички продукти от една задача. Маркирайте ги и ги изтрийте наведнъж, после пуснете поправения файл. Всички начини за зареждане и редакция на каталога са събрани на страницата за продуктовия каталог, а пълното пренасяне на магазин от друга платформа е на страницата за миграция към CloudCart.

Често задавани въпроси