# Импорт на продукти от CSV, XML и Google Sheets в CloudCart CSV импорт на продукти в CloudCart: какви колони трябват, как да качите файл от Excel, XML фийд от доставчик и как да обновявате цените без дубликати. Източник: https://cloudcart.com/blog/product-import-csv-xml · CloudCart · 2026-11-05 Накратко: 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](https://www.rfc-editor.org/rfc/rfc4180)). 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) е текстов формат, в който данните са в етикети, например 24.90 ([спецификацията на W3C](https://www.w3.org/TR/xml/)). Доставчиците публикуват каталога си като 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 само на цена и количество, за да не се презаписват вашите описания. Доставчикът държи склада, а магазинът показва неговите цени и наличности. > Миграция €0 за пренасяне при договор за 24 месеца, до 31.12.2026 Ако каталогът ви е в друга платформа, екипът на CloudCart пренася продуктите, клиентите, статиите и позициите в Google вместо вас, а старият магазин продава, докато новият се подготвя. Как става пренасянето → ## Какви колони трябват в 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](https://support.microsoft.com/en-us/office/import-or-export-text-txt-or-csv-files-5250ac4c-663c-47ce-937b-339e391393ba)). Кодировката UTF-8 пази кирилицата. Файл в Windows-1251 може да излезе с непонятни знаци. - Отворете импорта. В админа: Продукти → бутонът Import (иконата с облак) → Import with CSV file . Същият импорт е и в Приложения → CSV Import . - Стъпка 1, Upload file. Пуснете файла или го изберете от компютъра. Разделителят (запетая, точка и запетая, табулация) се разпознава сам по първите 10 KB на файла. - Стъпка 2, CSV file settings. Включете заглавния ред, ако първият ред на файла съдържа имената на колоните. По подразбиране превключвателят е изключен и първият ред ще стане продукт. Тук задавате и знака, който разделя категориите (например > ). - Разширени настройки. Изберете дали продуктите да се публикуват веднага, да са „препоръчани“ или „нови“, дали искат доставка, дали се следи наличността им и дали се продават при изчерпване. Настройките важат за всички редове във файла. - Стъпка 3, Mapping. До всяко поле на CloudCart изберете колоната от файла. Платформата показва стойността от първия ред, за да разпознаете колоните. Натиснете Submit . - Следете напредъка. Бутонът Track importing progress отваря списъка със задачите. Броят на внесените и неуспешните редове се обновява на всеки 5 секунди, а неуспешните редове са в отделна таблица с грешката. Важно: първо пуснете файл с 10 до 20 реда. CSV импортът няма бутон за връщане назад: Cancel import спира задачата, но вече създадените продукти остават. Ако съпоставянето е грешно, грешката засяга 20 продукта, които изтривате за минута. > €1 за 3 месеца Целият план за €1 на месец, докато пробвате импорта Новите магазини до 31.12.2026 плащат €1 на месец за първите 3 месеца на всеки план, така че можете да заредите целия си каталог и да продадете първите поръчки, преди да платите цената на плана. Създайте магазин за €1 → ## Как да импортирате продукти от XML фийд на доставчик XML фийд се импортира с приложението XML Import: задавате адреса на фийда, съпоставяте етикетите с полетата в CloudCart и платформата създава продуктите. Приложението приема само адрес (HTTP или HTTPS). За файл на компютъра ползвайте CSV импорта. - Инсталирайте приложението. Приложения → XML Import → Install, после + New task . - Стъпка 1: адрес и правила. Поставете адреса на фийда. Изберете вид на импорта: нови продукти, обновяване на съществуващи или и двете. Тук са и превключвателите за следене на наличността (Track inventory), продажба при изчерпване (Continue selling), скриване на продукти, които вече не са във фийда (Disable missings), и фиксирана категория за всички продукти. - Стъпка 2: етикетите. Посочете етикета, който обвива всеки продукт, и съпоставете етикетите с полетата: име, цена, SKU, описание, снимки, категория, количество. Изберете как фийдът описва вариантите. До всяко поле има отметка Update . - Стъпка 3: финал. Съпоставете категориите (липсващите се създават сами, нивата са с > ), данъка и марката по подразбиране и характеристиките. Със записа задачата тръгва. - Проверете статуса. В 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 и ми покажи кои кодове липсват“. Как агентът прави това с преглед и файл за връщане назад, е в статията за [масова промяна на цени и наличности с едно изречение](https://cloudcart.com/blog/bulk-catalog-changes-ai). ## Google Sheets: масова промяна на продуктите, които вече са в магазина Google Sheets е препоръчаният начин да промените цени, имена, описания, марки и категории на продукти, които вече са в CloudCart. Целият цикъл е два бутона: Upload изпраща каталога в таблица, а Download връща промените в магазина. - Свържете профила в Google. Приложения → Google Sheets → Settings → Sign in with Google . Платформата създава таблица сама при първото свързване. Не можете да посочите своя таблица. - Изберете продукти и колони. Филтър: всички продукти, категория, марка или конкретни продукти. Настройките предлагат и етикет и селекция, но при Upload тези два филтъра не стесняват избора и в таблицата влизат всички продукти. Отбележете колоните, които ще редактирате. Без поне една колона настройките не се записват. - Upload. В раздела Tasks натиснете бутона със стрелка нагоре. Всяко Upload изтрива съдържанието на листа и го пише наново. - Редактирайте в таблицата. Нов ред с празен Product ID става нов продукт. Нова категория се пише като път („Дрехи > Ризи“) и се създава сама, както и нова марка. - Download. Бутонът със стрелка надолу връща промените. Download се пуска само след поне едно успешно Upload. Важно: при Download таблицата е водеща. Ако между Upload и Download сте променили продукт в админа, стойността от таблицата ще я замени. Етикетите също се записват наново от таблицата. Правете Upload непосредствено преди да започнете да редактирате. Google Sheets работи само с продукти: поръчките и клиентите не минават през него. Ако приложението не се показва в списъка с приложения, планът ви не го включва. Как са устроени продуктите, вариантите, свойствата и марките, които пишете в колоните, е обяснено в ръководството за [продуктовия каталог в CloudCart](https://cloudcart.com/blog/product-catalog-management). ## Импорт и промени с 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 импортът няма. > Магазин с AI асистент Ценоразпис от Excel в магазина с едно изречение Агентът сам чете файла на доставчика, намира продуктите по код и показва какво ще смени, преди да запише, без шаблони и без ръчно съпоставяне. Как се свързва AI асистентът → Разликата е в броя на ръчните стъпки. При CSV импорт експортирате, чистите колоните, качвате и съпоставяте поле по поле. С агента давате файла и едно изречение, а агентът сам открива кой SKU на кой продукт отговаря и връща списък с несъвпаденията. Колко време спестява това всеки месец, освен за каталога и за отчети, имейли и реклами, е сметнато в статията [защо да управлявате магазина с AI агент](https://cloudcart.com/blog/ai-agent-online-store-why). Как се създава токенът и какви права (scopes) да му дадете, е описано в ръководството за [PAT токен в CloudCart](https://cloudcart.com/blog/ai-assistant-store-management). ## Как да изтеглите поръчките и продажбите от CloudCart като CSV файл Поръчките се изтеглят като CSV файл с бутона Export горе вдясно в Поръчки. Експортът взима точно поръчките, които виждате след филтрите (период, статус, плащане), а без филтър взима цялата история. Форматът е само CSV, с фиксиран набор от над 40 колони и по един ред за всеки продукт в поръчката. - До 50 поръчки. Файлът се тегли веднага в браузъра. - Над 50 поръчки. Експортът минава във фонов режим и CloudCart изпраща имейл с линк за изтегляне. Файлът се пази и във файловия мениджър на магазина. - Защита. Ако за профила е включена двуфакторна защита, преди експорта платформата иска код. Файлът с поръчките е суровина: оборот, средна поръчка или продажби по продукт се смятат после в Excel с обобщена таблица. AI агент с PAT токен с права само за четене (Read Only) прескача тази стъпка. Изречение като „покажи оборота, броя поръчки и средната поръчка за октомври спрямо септември и 5-те най-продавани продукта“ връща готовите числа направо от магазина, без файл и без формули. | Задача | С CSV експорт | С AI агент | | Оборот и средна поръчка за месеца | Експорт, филтър, обобщена таблица | Едно изречение | | Най-продаваните продукти | Сумиране по продукт в Excel | Едно изречение, с имената и SKU | | Сравнение с предходен период | Два експорта и ръчно сравнение | Едно изречение с двата периода | | Отчет всяка сутрин | Ръчно всеки ден | Агент по график | Кои 10 метрики да следите, как се смятат и какви изречения да дадете на агента, е в статията за [KPI на онлайн магазина, които AI агентът смята вместо вас](https://cloudcart.com/blog/ecommerce-kpi-metrics-ai-agent). Как агентът праща отчета за продажбите, склада и изоставените колички всяка сутрин, е описано в [отчет за продажбите в 8:00 с AI агент](https://cloudcart.com/blog/ai-agent-daily-store-report). ## Колко продукта можете да импортирате по план Лимитите на импорта следват плана на магазина. Таблицата е по [страницата с цените и плановете](https://cloudcart.com/pricing) към ноември 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% на всеки план](https://cloudcart.com/bg/offer/zero-commission-ecommerce), колкото и продукти да заредите. ## Обратната посока: 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](https://cloudcart.com/blog/pazaruvaj-product-feed) и за [Google Shopping и Merchant Center](https://cloudcart.com/blog/google-shopping-merchant-center-bulgaria). Фийдовете за Facebook каталог, TikTok и Google Merchant Center са основата на рекламите с продукти: Meta и TikTok могат да показват на всеки човек продуктите, които е разглеждал, с цената от фийда, а Google Ads ги показва в Shopping и Performance Max. Колкото по-пълни са колоните при импорта (SKU, баркод, марка, категория, снимки), толкова по-малко продукти отпадат при проверката в рекламните профили. Настройката на кампаниите е в ръководствата за [реклама в Meta](https://cloudcart.com/blog/meta-ads-online-store), [TikTok Ads](https://cloudcart.com/blog/tiktok-shop-tiktok-ads) и [Google Ads за онлайн магазин](https://cloudcart.com/blog/google-ads-online-store). > Канали за продажба Един каталог към Google, Facebook, TikTok, Pazaruvaj и eMAG Продуктите, които току-що импортирахте, отиват във всеки канал от готов фийд, без да поддържате отделна таблица за всеки сайт. Каналите за продажба на CloudCart → ## Добри практики при импорт на продукти - Тест с малък файл. 10 до 20 реда, после целият каталог. - Еднакъв ред на колоните. Съпоставянето не се запазва за следващ импорт. Ако файлът е с едни и същи колони всеки път, съпоставянето отнема секунди. - Продуктите като чернови. Оставете „Publish imported products“ изключено, прегледайте 10 продукта и тогава ги публикувайте от списъка. - Пълни SKU и баркодове. По тях после обновявате цени и наличности от доставчика, от ERP системата или с AI агента. - Категории по пътя. Един и същ разделител във всички редове. „Дрехи > Ризи“ и „Дрехи/Ризи“ правят две различни дървета. - Снимки на адрес, който работи. Проверете 3 адреса в браузъра, преди да пуснете импорта. - Склад в 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 в списъка с продукти показва всички продукти от една задача. Маркирайте ги и ги изтрийте наведнъж, после пуснете поправения файл. Всички начини за зареждане и редакция на каталога са събрани на страницата за [продуктовия каталог](https://cloudcart.com/catalog), а пълното пренасяне на магазин от друга платформа е на страницата за [миграция към CloudCart](https://cloudcart.com/migration). ## Често задавани въпроси **Как да кача продукти от Excel в онлайн магазина?** Запишете таблицата в Excel като CSV UTF-8 и я качете от Продукти → Import → Import with CSV file. Файлове .xls и .xlsx не се приемат. В третата стъпка съпоставяте колоните с полетата на CloudCart и натискате Submit. **Какви колони трябват за CSV импорт на продукти?** Задължителни са product.id (вашият код на продукта) и product.name (името). Редовете с варианти искат и variant.parent_id. Цена, SKU, количество, категория, снимки и описание са по избор. Примерен файл тегли бутонът CSV Template в първата стъпка на импорта. **Как да обновявам цените от XML на доставчика?** Създайте задача в XML Import или XML Sync и в стъпка 2 сложете отметка Update само на цената и количеството. При всяко следващо четене на фийда се сменят само тези полета. XML Sync е за фийдове, които се сменят всеки ден. **Може ли CSV импортът да обнови съществуващи продукти?** Не. CSV импортът в CloudCart винаги създава нови продукти и повторното качване прави дубликати. Съществуващите продукти се променят масово с Google Sheets, с XML Import с отметка Update или с AI агент, свързан с PAT токен. **Как да експортирам поръчките от магазина в CSV?** В Поръчки филтрирайте периода и натиснете Export горе вдясно. До 50 поръчки файлът се тегли веднага, а при повече CloudCart изпраща имейл с линк. Ако ви трябват готови числа като оборот и средна поръчка, AI агент с Read Only токен ги връща с едно изречение, без файл. **С каква програма се отваря CSV файл?** CSV файл се отваря с Excel, Google Sheets, LibreOffice Calc или текстов редактор, защото е чист текст. Ако в Excel кирилицата излиза с непонятни знаци, отворете файла през Data → From Text/CSV и изберете кодировка UTF-8. За импорт в CloudCart файлът се записва като CSV UTF-8. **Как да изтрия продуктите от грешен импорт?** Импортът няма бутон за отмяна. В списъка с продукти изберете филтъра Imported with и задачата, маркирайте всички продукти и ги изтрийте наведнъж. После поправете файла и го качете отново. **Колко продукта мога да импортирам в CloudCart?** Зависи от плана: магазинът побира 100 продукта на Baby Pack, 2 000 на Starter Pack, 7 500 на CC Pro и неограничено на CC Master. XML Import на CC Master внася до 25 000 продукта на задача. Лимитите са на страницата с цените към ноември 2026.