Настройка отображения паспортов безопасности товаров 1С-Битрикс

Настройка отображения паспортов безопасности товаров 1С-Битрикс

Паспорт безопасности (Safety Data Sheet, SDS / MSDS) — обязательный документ для химических веществ, лакокрасочных материалов, чистящих средств, промышленных газов и ряда других категорий товаров. При продаже через интернет-магазин на Битрикс требование простое: документ должен быть доступен покупателю до покупки. На практике это означает PDF в карточке товара с версионным контролем и возможностью скачать.

Хранение документов

Паспорта безопасности хранятся в файловом хранилище Битрикс (/upload/) через модуль main. Связь документа с товаром — через свойство-файл инфоблока:

Свойство SAFETY_DATA_SHEET (тип F — файл):

• Множественное: нет (один актуальный паспорт)
• Обязательное: нет (не у всех товаров)
• Описание подсказки: «PDF паспорта безопасности (ГОСТ 30333-2007)»

Для версионного контроля — дополнительное свойство SAFETY_DATA_SHEET_DATE (тип DateTime) — дата версии документа.

Загрузка при массовом обновлении

Паспорта часто приходят пачкой от поставщика в ZIP-архиве с именами файлов по артикулу. Скрипт массовой загрузки:

function importSdsDocuments(string $zipPath, int $iblockId): array
{
    $zip = new \ZipArchive();
    $zip->open($zipPath);
    $results = ['ok' => 0, 'not_found' => [], 'error' => []];

    for ($i = 0; $i < $zip->numFiles; $i++) {
        $filename = $zip->getNameIndex($i);
        if (!str_ends_with(strtolower($filename), '.pdf')) continue;

        // Извлекаем артикул из имени файла (напр. "ART-12345_msds.pdf")
        preg_match('/^([A-Z0-9\-]+)/i', $filename, $matches);
        $article = $matches[1] ?? '';

        $product = \CIBlockElement::GetList([], [
            'IBLOCK_ID' => $iblockId,
            'PROPERTY_ARTICLE' => $article,
        ], false, ['nPageSize' => 1], ['ID', 'NAME'])->GetNext();

        if (!$product) {
            $results['not_found'][] = $filename;
            continue;
        }

        // Сохраняем файл
        $tmpPath = sys_get_temp_dir() . '/' . $filename;
        file_put_contents($tmpPath, $zip->getFromIndex($i));

        $fileId = \CFile::SaveFile([
            'name'      => $filename,
            'tmp_name'  => $tmpPath,
            'type'      => 'application/pdf',
        ], 'sds_documents');

        if ($fileId) {
            \CIBlockElement::SetPropertyValuesEx($product['ID'], $iblockId, [
                'SAFETY_DATA_SHEET'      => $fileId,
                'SAFETY_DATA_SHEET_DATE' => date('d.m.Y'),
            ]);
            $results['ok']++;
        }
    }
    $zip->close();
    return $results;
}

Отображение в карточке товара

В шаблоне компонента bitrix:catalog.element добавляем блок паспорта безопасности:

<?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE'])): ?>
    <?php $sdsFile = \CFile::GetFileArray($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']); ?>
    <div class="product-sds">
        <h4>Документация по безопасности</h4>
        <a href="<?= \CFile::GetPath($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']) ?>"
           download="<?= htmlspecialchars($sdsFile['ORIGINAL_NAME']) ?>"
           class="sds-download-btn">
            <span class="pdf-icon"></span>
            Паспорт безопасности (PDF)
            <?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'])): ?>
                <small>версия от <?= $arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'] ?></small>
            <?php endif; ?>
        </a>
        <p class="sds-note">В соответствии с ГОСТ 30333-2007</p>
    </div>
<?php endif; ?>

Атрибут download обеспечивает скачивание вместо открытия в браузере.

Проверка наличия SDS при добавлении в каталог

Для категорий, где SDS обязателен (например, раздел «Химия», «Лакокрасочные материалы»), настраиваем валидацию через обработчик события OnBeforeIBlockElementAdd:

AddEventHandler('iblock', 'OnBeforeIBlockElementAdd', function(&$fields) {
    $requiredSdsSections = \Bitrix\Main\Config\Option::get('sds_module', 'required_sections', '');
    $requiredSectionIds = array_filter(explode(',', $requiredSdsSections));

    if (in_array($fields['IBLOCK_SECTION_ID'], $requiredSectionIds)) {
        if (empty($fields['PROPERTY_VALUES']['SAFETY_DATA_SHEET'])) {
            // Предупреждение (не блокировка — редактор может заполнить позже)
            $GLOBALS['APPLICATION']->ThrowException(
                'Внимание: для этого раздела рекомендуется прикрепить паспорт безопасности.',
                'SDS_MISSING'
            );
        }
    }
});

Отчёт по товарам без SDS

Административный отчёт GET /bitrix/admin/sds_report.php: список товаров из «химических» разделов без прикреплённого паспорта безопасности, с кнопкой быстрой загрузки файла прямо из таблицы.

SELECT ie.ID, ie.NAME, s.NAME as section_name
FROM b_iblock_element ie
JOIN b_iblock_section s ON s.ID = ie.IBLOCK_SECTION_ID
LEFT JOIN b_iblock_element_property iep
    ON iep.IBLOCK_ELEMENT_ID = ie.ID
    AND iep.IBLOCK_PROPERTY_ID = (
        SELECT ID FROM b_iblock_property
        WHERE IBLOCK_ID = ie.IBLOCK_ID AND CODE = 'SAFETY_DATA_SHEET'
    )
WHERE ie.IBLOCK_ID = ? AND ie.ACTIVE = 'Y'
  AND s.ID IN (/* разделы с обязательным SDS */)
  AND (iep.VALUE IS NULL OR iep.VALUE = '')
ORDER BY s.NAME, ie.NAME;

Сроки