Разделы документации

Интеграция 1С и SAMSON

Страница продукта

Адаптер SAMSON загружает в 1С номенклатуру, цены, остатки, описания, изображения, характеристики, штрихкоды и сертификаты.

Поддерживаемые версии 1С

1С:Предприятие 8.5.1.1343 или новее

КонфигурацияМинимальная версия
Управление торговлей 1111.5.27.47
Комплексная автоматизация 22.5.27.47
ERP Управление предприятием 22.5.27.47
Управление нашей фирмой 3.03.0.13.342

Что понадобится

  • установленное ядро asu-plus;
  • лицензионный ключ из личного кабинета asu-plus;
  • токен API SAMSON — выдаёт техподдержка дистрибьютора;
  • доступ в интернет.

Подключение адаптера SAMSON к 1С

  1. Скачайте адаптер SAMSON в личном кабинете.
  2. В 1С откройте Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.
  3. Нажмите Добавить из файла и выберите скачанный файл .epf.
  4. Откройте адаптер и перейдите на вкладку Настройки.
  5. Заполните:
    • Токен API — токен доступа к API, полученный у SAMSON;
    • Контрагент — карточка SAMSON в 1С. У контрагента должно быть заполнено поле Партнер;
    • Ключ ASU-Plus — лицензионный ключ из личного кабинета.

Загрузка номенклатуры SAMSON в 1С

SAMSON отдаёт каталог целиком, поэтому сначала данные сохраняются в кэш 1С, а потом вы отбираете из них нужные товары.

  1. Откройте Номенклатура → Выбор категорий.
  2. Нажмите Получить категории товаров.
  3. Нажмите Загрузить данные из API (цены / остатки / изображения / характеристики / штрихкоды / сертификаты). Все данные приходят вместе, каталог большой — загрузка занимает время.
  4. Отметьте нужные категории. Флажок Только новинки ограничивает отбор новинками дистрибьютора.
  5. Нажмите Получить товары дистрибьютора → Отмеченные категории. Пункт Только загруженный ранее товар обновляет данные только по товарам, уже сопоставленным с 1С.
  6. Откройте вкладку Номенклатура.
  7. Разверните блок Настройки по умолчанию и заполните параметры — состав описан ниже.
  8. Отметьте нужные товары и нажмите Загрузить данные в 1С.

Шаги 4–8 работают с кэшем и не обращаются к серверу. Чтобы обновить данные дистрибьютора, повторите шаг 3.

Чтобы создать в 1С структуру каталогов по категориям дистрибьютора, на вкладке Выбор категорий укажите Корневой каталог и нажмите Загрузить категории в 1С.

Настройки по умолчанию

Блок свёрнут — разверните его перед первой загрузкой.

Куда загружать цены. Заполните только те типы цен, которые используете:

ПараметрКакая цена загружается
Тип цены (закуп., руб)закупочная
Тип цены (розн., руб)РРЦ
Тип цены поставщика (закуп., руб)закупочная как цена поставщика
Тип цены поставщика (РРЦ, руб)РРЦ как цена поставщика

SAMSON передаёт цены только в рублях.

Куда загружать остатки и как создавать товары:

  • Склад — виртуальный склад для хранения остатков поставщика;
  • Склад (РЦ) — виртуальный склад для остатков распределительного центра дистрибьютора;
  • Организация — участвует в работе с остатками. Только в Управлении нашей фирмой 3.0;
  • Вид номенклатуры — обязательное поле, подставляется, если вид не задан в таблице. В Управлении нашей фирмой 3.0 называется Категория номенклатуры;
  • Ставка НДС — по умолчанию для оформления документов. Только в Управлении торговлей 11, Комплексной автоматизации 2 и ERP Управление предприятием 2;
  • Ценовая группа — по умолчанию, если не задана в таблице;
  • Код товарагенерируется автоматически (рекомендуется) или = код дистрибьютора.

Чем управляют флажки:

  • Создавать новую номенклатуру — создавать в 1С карточки товаров, которых в ней ещё нет;
  • Обновить номенклатуру — обновлять данные товаров, уже сопоставленных с 1С;
  • Загружать штрихкоды, Загружать упаковки, Загружать описание, Загружать вес, Загружать объем — переносить эти данные в карточку товара. В Управлении торговлей 11, Комплексной автоматизации 2 и ERP Управление предприятием 2 добавляется Загружать ставку НДС, в Управлении нашей фирмой 3.0 — Загружать габариты и Загружать страну;
  • Загружать доп.хар-ки в доп.реквизит — переносить характеристики товара в дополнительные реквизиты номенклатуры.

Чтобы изменить цены сразу для всех отмеченных товаров, разверните Групповое изменение цены, выберите действие, укажите величину и нажмите Установить цены по умолчанию.

Загрузка изображений, сертификатов и характеристик

Эти данные загружаются в два шага: сначала получить на вкладке Номенклатура, затем загрузить в 1С на отдельной вкладке. Товар в строке должен быть сопоставлен с номенклатурой 1С.

ДанныеПолучитьЗагрузить в 1С
ИзображенияПолучить изображенияЗагрузка изображенийЗагрузить изображения в 1С
СертификатыПолучить сертификатыЗагрузка изображенийЗагрузить изображения в 1С
ХарактеристикиПолучить характеристикиЗагрузка характеристик (свойств)Загрузить характеристики (свойства) в 1С

Изображения и сертификаты используют одну таблицу, поэтому получайте и загружайте их по очереди.

Чтобы заменить данные, а не дополнить их, на вкладке загрузки включите Удалить текущие изображения в номенклатуре или Удалить текущие характеристики в номенклатуре.

Настройка обновления по расписанию

По расписанию обновляются цены и остатки уже сопоставленных товаров. Автоматическое обновление доступно на тарифе «Премиум».

1. Создайте настройку SAMSON

Откройте ASU-Plus: Настройки синхронизации с дистрибьюторами:

  • Управление торговлей 11, Комплексная автоматизация 2 и ERP Управление предприятием 2:
    Администрирование → Настройка интеграции;
  • Управление нашей фирмой 3.0:
    Настройки → Интеграции.

Создайте настройку и заполните:

  • Сервис — SAMSON;
  • Токен API — тот же токен, что на вкладке Настройки адаптера;
  • Ключ ASU-Plus;
  • Контрагент;
  • Склад, Склад (РЦ) и типы цен, которые нужно обновлять;
  • Включено.

Нажмите Сохранить, затем Проверить соединение.

2. Настройте расписание

Откройте карточку адаптера SAMSON в Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки и настройте расписание для команды Автоматическая загрузка остатков и цен дистрибьютора (SAMSON).