Импорт и экспорт справочников

Для кого: ВладелецАдминистратор

Для чего

Вкладка «Импорт / экспорт» позволяет загрузить сразу много записей справочника или выгрузить весь справочник в файл. Подходит для первичного наполнения и для переноса данных. Это техническая функция: данные передаются в формате JSON, поэтому ею обычно пользуются администратор или сотрудник, который ведёт справочники.

Открывается через Справочники → Данные → Справочные данные, вкладка «Импорт / экспорт».

Заявки на лиды загружаются из Excel в CRM (Импорт лидов из Excel), а договоры, накладные и организации приходят из 1С. Эта вкладка их не загружает.

Вкладка «Импорт / экспорт»: выбор справочника, поле для JSON, кнопки «Импортировать» и «Экспортировать»

Как сделать

Как выгрузить справочник

1. Откройте вкладку «Импорт / экспорт».
2. В списке выберите справочник: «Клиент», «Поставщик», «Товар», «Валюта» или «Ед. измерения».
3. Нажмите «Экспортировать». Браузер скачает файл <справочник>-export.json, например customers-export.json.

Выгрузка записывается в журнал аудита.

Как загрузить записи

1. Подготовьте JSON-массив строк. Каждая строка — объект с полями справочника. Обязательные поля:

   Справочник	Обязательные поля
   Клиент	code, name, kind (B2B или B2C), businessUnitId
   Поставщик	code, name, businessUnitId
   Товар	code, name, type, baseUnitOfMeasureId, businessUnitId
   Валюта	isoCode, name
   Ед. измерения	code, name

   Пример для клиента: [{"code":"C-1","name":"Клиент","kind":"B2B","businessUnitId":"..."}].

2. Выберите справочник в списке.

3. Вставьте массив в поле и нажмите «Импортировать».

4. Под полем появится итог, например «Завершено: 2/3 строк импортировано». Если часть строк не прошла, итог начинается со слов «Завершено с ошибками».

Для товара type — одно из значений: GREEN_COFFEE_LOT, FINISHED_SKU, EQUIPMENT, SPARE_PART, CONSUMABLE, OTHER.

Поля businessUnitId и baseUnitOfMeasureId — это внутренние идентификаторы (UUID), в интерфейсе они не показываются. Проще всего взять их из выгрузки: экспортируйте уже существующую запись и посмотрите значения.

Особенности

• Каждая строка проверяется отдельно. Одна неверная строка не блокирует остальные: корректные загружаются, ошибочные отклоняются.
• Только создание. Импорт создаёт новые записи; существующие он не обновляет. Повтор кода, который уже есть, даст ошибку по этой строке.
• Права. Для загрузки нужно право создавать справочники, для выгрузки — право экспорта. По умолчанию они есть у владельца и администратора.
• Что не загружается здесь. Лиды (только мастер импорта из Excel), договоры, накладные, взаиморасчёты, история цен и организации (только обмен с 1С).
• Обязательное поле пустое — строка отклоняется с сообщением, какого поля не хватает; сообщения по строкам в этом окне не показываются, только итоговое число.
• Выгрузка не заменяет отчёты. Это сырой список записей справочника.

Частые вопросы

Нажал «Импортировать», но ничего не появилось. Проверьте итог под полем. Если «Завершено: 0/N», все строки отклонены: чаще всего не хватает обязательного поля или код уже занят.

Ошибка при нажатии. Если текст не является корректным JSON (лишняя запятая, одинарные кавычки), над формой появится сообщение об ошибке.

Можно ли загрузить Excel? Нет, только JSON. Для лидов есть отдельный импорт из Excel в CRM.

Связанные статьи

• Справочные данные
• Импорт лидов из Excel
• Клиенты в справочниках