Автоматическая загрузка прайс-листов из почты в 1С:УНФ

Задача

Поставщики присылают прайс-листы по email в виде Excel-файлов. Вручную переносить цены в 1С — долго и с риском ошибок. Нужно, чтобы 1С сама забирала актуальные цены из почты и создавала документ установки цен без участия менеджера.

Что делает расширение

Чтение почты. Регламентное задание подключается к ящику по IMAP, используя учётную запись, уже настроенную во встроенной почте УНФ. Перебираются письма за указанный период (константа, по умолчанию 14 дней). Письма, обработанные ранее, пропускаются — идентификатор каждого сообщения сохраняется в регистре сведений ЧАС_ОбработанныеПисьмаПрайсов.

Разбор Excel. Из письма берутся все вложения с расширениями xlsx, xlsm, ods. В файле автоматически ищется строка заголовка (среди первых 30 строк), содержащая одновременно три колонки: «Артикул», «Номенклатура» и «Цена для загрузки в 1С». Сравнение нечувствительно к регистру, пробелам, знакам препинания и визуально похожим латинским буквам (C/С, A/А и т.д.) — файл распознается корректно даже при минимальных отличиях в оформлении заголовков.

Поиск номенклатуры. Все артикулы из файла сопоставляются с базой одним запросом через временную таблицу — без цикличных обращений к справочнику. Если по артикулу найдено несколько позиций, используется та, что идёт первой по коду; в протокол записывается предупреждение.

Создание новой номенклатуры. Если артикул не найден, элемент создаётся с заполненными наименованием и артикулом в режиме ОбменДанными.Загрузка = Истина. Код устанавливается явно через УстановитьНовыйКод(). Номенклатура создаётся даже для строк с незаполненной ценой — чтобы позиция появилась в базе, даже если цену поставщик пока не прислал.

Строки с незаполненной или нечисловой ценой не попадают в документ установки цен, но фиксируются в протоколе. Поддерживается как числовое значение, так и текстовое (с запятой в качестве разделителя).

Документ установки цен создаётся один на каждый файл-вложение. Вид цены берётся из константы. Документ может быть записан или сразу проведён — настраивается константой.

Оповещение об отсутствии прайсов. Если с последнего успешного создания документа прошло больше N дней (константа, по умолчанию 7), пользователь получает три сигнала: тост при открытии обработки, запись в центр оповещений БСП (колокольчик в шапке) при входе в систему, запись уровня «Ошибка» в журнал регистрации при следующем срабатывании регламентного задания.

Состав расширения

Константы:

• ЧАС_ВидЦеныЗагрузкиПрайсов — вид цены для документа
• ЧАС_УчетнаяЗаписьПочтыДляПрайсов — учётная запись встроенной почты
• ЧАС_ПапкаПочтыДляПрайсов — папка IMAP (по умолчанию INBOX)
• ЧАС_ПериодАнализаПисемПрайсовДней — глубина просмотра ящика
• ЧАС_ГруппаНоменклатурыДляПрайсов — группа для создаваемой номенклатуры
• ЧАС_ПроводитьУстановкуЦенПриЗагрузке — проводить или только записывать
• ЧАС_ДатаПоследнейЗагрузкиПрайса — служебная, устанавливается автоматически
• ЧАС_ПериодАлертаОтсутствияПрайсовДней — порог для уведомлений

Регистр сведений ЧАС_ОбработанныеПисьмаПрайсов — дедупликация писем.

Общие модули: ЧАС_ЗагрузкаПрайсов (разбор файла, поиск и создание номенклатуры, формирование документа), ЧАС_ЗагрузкаПрайсовИзПочты (IMAP, перебор писем, регистрация, оповещения).

Обработка ЧАС_ЗагрузкаПрайсЛистов — ручной запуск: выбор файла с диска, кнопка «Проверить почту», поле протокола, тост-оповещение при открытии.

Регламентное задание ЧАС_ЗагрузкаПрайсовИзПочты.

Требования

• 1С:УНФ (конфигурация с документом «Установка цен номенклатуры»)
• Платформа 1С:Предприятие 8.5
• Доступ к серверу IMAP (для Яндекса требуется пароль приложения, не пароль от аккаунта)
• Формат файла: xlsx, xlsm, ods. Старый формат xls (BIFF) не поддерживается платформенным ТабличныйДокумент.Прочитать — такие вложения пропускаются с записью в протокол