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;
        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;
}

The script is 5 times faster than manual upload: processes 100 files in 20 minutes instead of 2 hours.

Setup in 4 steps:

1. Create properties SAFETY_DATA_SHEET and SAFETY_DATA_SHEET_DATE in the product info block.
2. Place the importSdsDocuments script in the administrative section.
3. Add a link to the SDS in the product card template.
4. Set up the report and validation handler.

Checking SDS Presence: Importance and Implementation

Display in the Product Card

In the bitrix:catalog.element template, add this block:

<?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE'])): ?>
    <?php $sdsFile = \CFile::GetFileArray($arResult['PROPERTIES']['SAFETY_DATA_SHEET']['VALUE']); ?>
    <div class="product-sds">
        <h4>Safety Documentation</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> Safety Data Sheet (PDF)
            <?php if (!empty($arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'])): ?>
                <small>version from <?= $arResult['PROPERTIES']['SAFETY_DATA_SHEET_DATE']['VALUE'] ?></small>
            <?php endif; ?>
        </a>
        <p class="sds-note">In accordance with <cite>GOST 30333-2007</cite></p>
    </div>
<?php endif; ?>

The download attribute ensures direct download.

Validation When Adding a Product

For sections where SDS is required (e.g., "Chemicals", "Paints"), use the OnBeforeIBlockElementAdd handler:

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(
                'Attention: for this section it is recommended to attach a safety data sheet.',
                'SDS_MISSING'
            );
        }
    }
});

Report for Products Without SDS

An administrative report (GET /bitrix/admin/sds_report.php) shows a list of products from "chemical" sections without an attached SDS, with a quick upload button.

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 (/* sections with mandatory SDS */) AND (iep.VALUE IS NULL OR iep.VALUE = '')
ORDER BY s.NAME, ie.NAME;

The report allows identifying all products without SDS in a few clicks.

Work Process

What's Included

• Info block properties (SAFETY_DATA_SHEET, SAFETY_DATA_SHEET_DATE)
• Mass upload script from ZIP with error handling
• Display template in product card
• Report for products without SDS
• Documentation and training (1 hour)
• 1 month support

Typical Errors and Checklist

Errors:

• Incorrect filename (article mismatch) — script marks as not_found.
• File exceeds limit (>20 MB) — configure limitations.
• Version date not set — automatically takes current date.
• Forgot to attach SDS manually — validation warns.

Pre-launch checklist:

• [ ] All article names in filenames match products
• [ ] Properties SAFETY_DATA_SHEET and SAFETY_DATA_SHEET_DATE created
• [ ] Sections with mandatory SDS set in options
• [ ] Product card template displays download link
• [ ] Report works and shows correct products

Timeline

Order turnkey configuration of safety data sheets — get a ready solution in 4 days. Contact us for a consultation and assessment of your project. We guarantee quality and support after launch.