Настройка генерации прайс-листов 1С-Битрикс

Настройка генерации прайс-листов 1С-Битрикс

Прайс-лист — это не просто экспорт цен. Для B2B-клиента это документ с актуальными ценами его типа, с артикулами, остатками и скидками. Автоматическая генерация прайса из Битрикс исключает ошибки ручного обновления и даёт менеджеру всегда актуальные данные.

Форматы и инструменты

Прайс-листы генерируют в трёх форматах:

Excel (XLSX) — наиболее востребован. Используют библиотеку PhpSpreadsheet (phpoffice/phpspreadsheet). Поддерживает форматирование, формулы, несколько листов.

CSV — простой вариант для машинной обработки, без форматирования.

PDF — для отправки клиентам как представительский документ (см. статью по PDF-каталогам).

Генерация Excel через PhpSpreadsheet

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
use PhpOffice\PhpSpreadsheet\Style\NumberFormat;

class BitrixPriceListGenerator
{
    public function generate(int $priceTypeId, array $userGroups): string
    {
        $spreadsheet = new Spreadsheet();
        $sheet = $spreadsheet->getActiveSheet();
        $sheet->setTitle('Прайс-лист');

        // Заголовки
        $headers = ['Артикул', 'Наименование', 'Раздел', 'Цена', 'Валюта', 'Остаток'];
        foreach ($headers as $col => $header) {
            $sheet->setCellValueByColumnAndRow($col + 1, 1, $header);
        }

        // Стиль заголовка
        $sheet->getStyle('A1:F1')->getFont()->setBold(true);
        $sheet->getStyle('A1:F1')->getFill()
            ->setFillType(\PhpOffice\PhpSpreadsheet\Style\Fill::FILL_SOLID)
            ->getStartColor()->setARGB('FFE0E0E0');

        $row = 2;
        $res = $this->getProductsWithPrices($priceTypeId, $userGroups);

        foreach ($res as $product) {
            $sheet->setCellValueByColumnAndRow(1, $row, $product['ARTICLE']);
            $sheet->setCellValueByColumnAndRow(2, $row, $product['NAME']);
            $sheet->setCellValueByColumnAndRow(3, $row, $product['SECTION']);
            $sheet->setCellValueByColumnAndRow(4, $row, $product['PRICE']);
            $sheet->setCellValueByColumnAndRow(5, $row, $product['CURRENCY']);
            $sheet->setCellValueByColumnAndRow(6, $row, $product['QUANTITY']);

            // Форматирование числа цены
            $sheet->getStyleByColumnAndRow(4, $row)
                ->getNumberFormat()
                ->setFormatCode(NumberFormat::FORMAT_NUMBER_COMMA_SEPARATED2);
            $row++;
        }

        // Автоширина колонок
        foreach (range('A', 'F') as $col) {
            $sheet->getColumnDimension($col)->setAutoSize(true);
        }

        // Добавляем дату генерации
        $sheet->setCellValue('A' . ($row + 1), 'Дата формирования: ' . date('d.m.Y H:i'));

        $writer = new Xlsx($spreadsheet);
        $tempFile = tempnam(sys_get_temp_dir(), 'pricelist_');
        $writer->save($tempFile);

        return $tempFile;
    }

    private function getProductsWithPrices(int $priceTypeId, array $userGroups): array
    {
        $result = [];
        $dbRes = \CIBlockElement::GetList(
            ['SECTION_ID' => 'ASC', 'SORT' => 'ASC'],
            ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'],
            false,
            false,
            ['ID', 'NAME', 'IBLOCK_SECTION_ID', 'PROPERTY_ARTICLE']
        );

        $sectionCache = [];

        while ($el = $dbRes->GetNextElement()) {
            $fields = $el->GetFields();
            $productId = $fields['ID'];

            // Получаем цену для типа
            $priceRes = \CCatalogProduct::GetOptimalPrice($productId, 1, $userGroups);
            $price = $priceRes['PRICE']['PRICE'] ?? 0;

            // Кэшируем названия разделов
            $sectionId = $fields['IBLOCK_SECTION_ID'];
            if (!isset($sectionCache[$sectionId])) {
                $sectionCache[$sectionId] = \CIBlockSection::GetByID($sectionId)->GetNext()['NAME'] ?? '';
            }

            // Остатки
            $storeData = \CCatalogStoreProduct::GetList(
                [], ['PRODUCT_ID' => $productId]
            )->Fetch();
            $quantity = $storeData['AMOUNT'] ?? 0;

            $result[] = [
                'ARTICLE' => $fields['PROPERTY_ARTICLE_VALUE'],
                'NAME'    => $fields['NAME'],
                'SECTION' => $sectionCache[$sectionId],
                'PRICE'   => $price,
                'CURRENCY' => $priceRes['PRICE']['CURRENCY'] ?? 'RUB',
                'QUANTITY' => $quantity,
            ];
        }

        return $result;
    }
}

Доступ и разграничение прайсов

Разные типы клиентов получают разные прайсы. Контроль доступа — через группы пользователей и типы цен:

// Определяем тип прайса для текущего пользователя
$userId = \Bitrix\Main\Context::getCurrent()->getUser()->getId();
$userGroups = \CUser::GetUserGroup($userId);

$priceTypeId = 1; // базовый
if (in_array(WHOLESALE_GROUP_ID, $userGroups)) {
    $priceTypeId = 2; // оптовый
} elseif (in_array(VIP_GROUP_ID, $userGroups)) {
    $priceTypeId = 3; // VIP
}

Автогенерация по расписанию

Для крупных каталогов (10 000+ позиций) генерацию выносят в агент Битрикс, запускаемый ночью, с сохранением файла в /upload/pricelists/:

// Агент, добавляется через AddEventHandler или вручную в b_agent
function GeneratePriceLists(): string
{
    $generator = new BitrixPriceListGenerator();
    foreach (getPriceTypes() as $type) {
        $file = $generator->generate($type['ID'], $type['USER_GROUPS']);
        $targetPath = '/upload/pricelists/pricelist_' . $type['CODE'] . '.xlsx';
        rename($file, $_SERVER['DOCUMENT_ROOT'] . $targetPath);
    }
    return __FUNCTION__ . '();'; // Агент возвращает себя для повторного запуска
}

Сроки