Покрокове завантаження контактів, товарів, цін і залишків: зіставлення колонок, помилки, файл з помилками.

Що це і навіщо

Імпорт переносить дані з таблиці Excel чи CSV у систему одним файлом: сотні контактів, тисячі товарів, ціни для прайс-листа, початкові залишки на складі. Замість того щоб вручну створювати кожен запис, ви завантажуєте файл, показуєте системі, яка колонка що означає, і запускаєте. Імпорт працює у фоні: ви можете закрити сторінку й продовжити роботу, а про результат прийде сповіщення.

Імпорт лише створює нові записи (єдиний виняток становить імпорт цін у прайс-лист, він може оновлювати наявні ціни). Він не шукає збігів і не оновлює вже наявні контакти чи товари. Якщо завантажити той самий файл двічі, ви отримаєте дублікати.

Що можна імпортувати

Що	Звідки почати	Адреса
Контакти	Список «Контакти» → меню списку → «Імпорт»	`/import/contact`
Контрагенти	Список «Контрагенти» → меню → «Імпорт»	`/import/account`
Ліди	Список «Ліди» → меню → «Імпорт»	`/import/lead`
Товари і послуги	Список «Товари» або «Послуги» → меню → «Імпорт»	`/import/product`
Ціни в прайс-лист	Налаштування → Прайс-листи → посилання «Імпорт цін» у рядку потрібного прайс-листа	`/import/price_book?price_book_id=…`
Початкові залишки на складі	Список складів → кнопка «Імпорт залишків» у рядку потрібного складу	`/import/stock?stock_id=…`
Холодна база для обдзвону	«Черга обдзвону» → меню → «Імпорт» або «Потенційні клієнти» → «Імпорт бази»	`/import/prospect`

Меню списку відкривається іконкою праворуч над таблицею (див. Фільтри). Пункт «Імпорт» видно лише у списках, які його підтримують. Для холодної бази він видимий тим, хто може додавати записи в чергу обдзвону (Черга обдзвону).

Підготовка файлу

Формати: .xlsx, .xls, .csv. Максимальний розмір 20 МБ.
У першому рядку заголовки колонок, дані починаються з другого рядка. Порожні рядки пропускаються.
CSV: роздільник (кома, крапка з комою, табуляція чи «|») і кодування (UTF-8 та Windows-1251 з Excel) система визначає сама.
Найпростіше почати з готового зразка: на першому кроці є посилання «Завантажити приклад файлу» (для контактів, контрагентів, лідів, товарів, залишків і прайс-листа). Якщо назви колонок у вашому файлі збігаються з прикладом, зіставлення на другому кроці проставиться автоматично.
Числа. Пробіли й нерозривні пробіли всередині числа ігноруються. Один роздільник (кома чи крапка) вважається десятковим: «12,5» і «12.5» означають дванадцять з половиною. Якщо є і кома, і крапка, правіший з них вважається десятковим, а інший роздільником тисяч: «1.234,50» і «1,234.50» дають 1234,5.
Дати. Підходять формати «31.12.2026», «2026-12-31», «31-12-2026», «12/31/2026» (можна з часом), а також дата з Excel як число.
Так/Ні. Розуміються: так, ні, yes, no, y, n, true, false, 1, 0, «+», «-». Порожня клітинка означає «ні».
Теги. Кілька тегів в одній клітинці пишіть через кому або крапку з комою (Теги).

Крок 1: «Файл»

Вгорі стежок із трьох кроків: «Файл», «Відповідність полів», «Готово». На першому кроці показано пунктирну зону. Перетягніть файл або натисніть «Обрати файл». Кнопка «Закрити» повертає назад.

Крок 1 імпорту: завантаження файлу

Помилки на цьому кроці:

«Підтримуються лише файли .xlsx, .xls та .csv»: файл має інший формат.
«Файл перевищує ліміт 20 МБ».
«Файл порожній».

Крок 2: «Відповідність полів»

Система показує ім'я файлу, розмір і формат, а нижче таблицю з колонками «Поле» і «Колонка у файлі». Ліворуч поля системи (для контакту: «Тип контакта», «Ім'я», «Прізвище», «Телефон», «Email», «Відповідальний», «Контрагент», «Теги» тощо), праворуч спадний список колонок вашого файлу. За замовчуванням колонку не вибрано (у списку стоїть «не змаповано»).

Червона зірочка * біля поля означає, що його треба зіставити. Якщо біля кількох полів стоїть зірочка з підказкою «Потрібна хоча б одна колонка з позначених», достатньо будь-якої з них (наприклад, у ліда «Назва ліда» або «Ім'я»).
Ваші додаткові поля додаються в кінець таблиці автоматично. Для полів-списків підказка розповідає, як вписувати значення: «Назва, код або #id опції»; для мультисписків «Кілька через кому: назви, коди або #id опцій». Число в клітинці розглядається як назва опції, а не її номер; щоб вказати номер, напишіть «#42».
Внизу показано «Прев'ю перших N рядків» вашого файлу (до 20 рядків): перевірте, що дані ті.
Для деяких імпортів є додатковий блок: «Режим оновлення» (прайс-листи) чи «Відповідальний» (холодна база). Для інших видно рамку «Спільні дані» із застереженням, що вибір тегів і статусу з'явиться згодом; поки що вона нічого не робить.

Кнопка «Імпортувати» запускає імпорт (поки йде запуск, на кнопці написано «Запуск...»). Кнопка «Назад» повертає на вибір файлу.

Якщо не зіставлено обов'язкове поле, ви побачите «Обов'язкове поле "..." не змаповане» або «Змапте хоча б одну колонку: "..." або "..."».

Які поля у кожному імпорті

Імпорт	Обов'язкові поля	Важливо знати
Контакти	«Ім'я»	«Тип контакта» і «Відповідальний» шукаються за назвою чи іменем користувача; якщо не знайдено, рядок отримає помилку «Тип '...' не знайдено» або «Користувач '...' не знайдений». «Контрагент» шукається за назвою, і якщо такого немає, його буде створено. Також є адреса (тип, країна, область, район, місто, адреса, індекс), «Теги», «Дата народження».
Контрагенти	«Назва»	«Тип контрагента» шукається за назвою типу. Є «Галузь», «Сайт», «Знижка», адреса, теги.
Ліди	«Назва ліда» або «Ім'я» (достатньо одного)	«Воронка»: назва або id воронки; «Статус»: назва статусу (якщо вказали статус, а воронку ні, береться перша воронка лідів); «Валюта», «Тип потреби», «Джерело ліда», «Відповідальний» шукаються за назвою. Є «Бюджет», «Курс», UTM-мітки, адреса, теги.
Товари і послуги	«Категорія», «Назва»	«Тип»: `goods` або `service`. Якщо «Артикул (SKU)» порожній, система створить його сама. «Одиниця виміру», «Податок», «Валюта» шукаються за назвою. «Облік партій» і «Серійний облік» приймають так/ні, але не одночасно. Ціни («Базова», «Закупівельна») вписуйте звичайним числом, наприклад 1250,50.
Ціни в прайс-лист	«Ціна», плюс один ідентифікатор товару: «ID продукту», «Артикул (SKU)», «SKU виробника» або «Назва продукту»	Режим: «Додати і оновити» (якщо позиції немає в прайс-листі, її створять, а якщо є, оновлять) або «Тільки оновити» (якщо позиції немає, рядок піде у файл помилок).
Початкові залишки	Ідентифікатор товару (як вище), «Кількість», «Собівартість (за одиницю)»	Склад береться з посилання, з якого ви відкрили імпорт. Для партійних товарів обов'язковий «Номер партії»; для серійних ще й «Серійні номери» (через кому чи крапку з комою; їх кількість має дорівнювати кількості). Необов'язкові «Дата виробництва» і «Дата придатності».
Холодна база	«Телефон»	Рядок без цифр у телефоні або з номером із списку «не дзвонити» відхиляється. Якщо номер уже є серед контактів чи лідів, у чергу піде цей запис, а не новий. У кроці 2 можна вибрати «Відповідальний», тобто кому дістануться завдання на дзвінки (порожньо = вам).

Крок 3: «Готово», хід і результат

Після кліку «Імпортувати» система створює фонове завдання з номером («Номер завдання: #N») і показує «Імпорт виконується у фоні...». Пише «Опрацьовано X з N» і показує смужку прогресу. Можна натиснути «Закрити»: імпорт триває, а після завершення прийде сповіщення. Клік на нього відкриває сторінку результату /import/job/N.

Файл опрацьовується порціями по 50 рядків із короткими паузами, тому великий файл іде помітний час. Кожен рядок записується окремо: помилка в одному рядку не зупиняє решту.

Що побачите	Що це означає
Імпорт успішно завершено, «Створено записів: N»	Усі рядки додано.
Імпорт завершено з помилками, «Створено: X · з помилкою: Y»	Частину рядків додано, частину відхилено.
Не вдалось імпортувати жоден рядок	Усі рядки з помилками; перевірте зіставлення колонок.
Імпорт зупинено, «Занадто багато помилок у перших рядках»	Якщо в перших 100 рядках понад 30 помилок, система припиняє імпорт: найімовірніше, колонки зіставлено неправильно. Те, що встигло створитися, залишається.
Імпорт зупинено через помилку	Технічний збій під час обробки файлу.

Якщо є помилки, під заголовком з'являється блок «Що саме не заїхало»: перші 10 рядків з причиною (наприклад, «Тип 'VIP' не знайдено») і примітка, що решта у файлі помилок. Кнопка «Завантажити файл помилок» віддає таблицю .xlsx: ваші колонки, а в кінці нова колонка import_error з причиною. Виправте лише ці рядки й імпортуйте файл повторно. Файл помилок бачить лише той, хто запускав імпорт.

Що відбувається в обліку

Контакти, контрагенти, ліди, товари: створюються звичайні записи, ніби ви додали їх вручну, з вами як автором. Фінансових проводок і руху складу це не створює.
Ціни в прайс-листі: змінюються ціни позицій прайс-листа.
Початкові залишки означають приймання на склад: на вибраному складі збільшується залишок товару, створюється рух на складі з назвою «Імпорт залишків», обчислюється середня собівартість, для партійних і серійних товарів створюються партії та серійні номери. Собівартість береться у валюті за замовчуванням системи (зазвичай гривня). Імпортуйте залишки лише один раз, інакше залишок подвоїться.
Записи, створені імпортом, відразу з'являються у списках, а колеги бачать їх без перезавантаження сторінки.

Приклад: файл із 3 рядками залишків «Кабель 2 м; 100 шт.; 15,50» створить на складі 100 шт. цього товару з собівартістю 15,50 за штуку, тобто оцінка запасу зросте на 1 550.

Права доступу

Пункт «Імпорт» у меню списку показується тим, хто має доступ до самого списку. У налаштуваннях ролі є також перемикач «Імпорт» (група «Адміністрування»), проте окремої перевірки цього перемикача під час запуску імпорту ми не бачимо, тому не покладайтеся на нього як на захист. Записи створюються від імені користувача, який запустив імпорт; той самий користувач бачить завдання й файл помилок. Ролі й права: Ролі.

Типові помилки і питання

Ситуація	Що робити
Після імпорту дублікати	Імпорт не шукає збігів. Видаліть зайві записи або не завантажуйте файл двічі.
«Тип '...' не знайдено», «Користувач '...' не знайдений»	У файлі має бути точна назва довідника чи ім'я користувача. Регістр літер не важливий.
Імпорт зупинився на перших рядках	Перевірте зіставлення колонок і чи в першому рядку файлу справді заголовки.
«Кількість (5) не співпадає з кількістю серійних номерів (3)»	Для серійного товару вкажіть стільки номерів, скільки одиниць.
Для партійних товарів номер партії (batch_number) обов'язковий	Додайте колонку «Номер партії».
«Продукт не знайдено: задайте id, sku, manufacturer_sku або name»	Товар шукається за id, потім за артикулом, потім за SKU виробника, потім за назвою. Перевірте, що товар уже створений.
Незрозуміла помилка у списку-полі	Скористайтеся кодом опції або «#id» замість назви.
Сторінка «Фонові процеси» порожня	Усі результати імпорту дивіться за сповіщенням і на сторінці «Імпорт виконується...»: список у налаштуваннях наразі не завантажується.
Не працюють бізнес-правила під час імпорту	Імпорт контактів і контрагентів записує дані напряму й правил не перевіряє.

Імпорт з Excel і CSV