Розробка модуля друкованих форм для 1С-Бітрікс із гарантією 3 місяці

Розробка модуля друкованих форм 1С-Бітрікс

Коли рахунок, акт або УПД доводиться формувати вручну, бухгалтерія витрачає години на однотипні операції?

У 1С-Бітрікс немає вбудованого механізму генерації документів — лише шаблони листів. Ми розробляємо модулі друкованих форм, які автоматизують цей процес: менеджер натискає кнопку в замовленні та отримує готовий PDF з реквізитами та підписами. При цьому кожен документ потребує ручного заповнення реквізитів, перевірки сум та друку — автоматизація скорочує час до 2 секунд. Наш досвід — понад 7 років у розробці на Бітрікс, реалізовано понад 200 проєктів. Використовуємо сучасні рішення: mPDF для HTML->PDF, PhpSpreadsheet для Excel-шаблонів. Модуль коректно працює з 54-ФЗ та фіскальними документами, підтримує формати ТОРГ-12, УПД, рахунок-фактуру. Середній час генерації документа — менше 2 секунд. Впровадження скорочує час на оформлення замовлень до 80% та знижує операційні витрати. За нашими оцінками, модуль окупається за 2–3 місяці, економлячи бухгалтеру від 15 000 гривень на місяць.

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

Типовий набір для інтернет-магазину:

• Рахунок на оплату — реквізити продавця та покупця, таблиця товарів, підсумкова сума прописом.
• Товарна накладна ТОРГ-12 — уніфікована форма із заповненими полями.
• Акт виконаних робіт — для послуг.
• УПД — універсальний передавальний документ.
• Договір — з підстановкою даних покупця та параметрів замовлення.

Набір документів та їх шаблони визначаються під конкретний проєкт. У середньому потрібно 3–5 документів.

Як обрати підхід до генерації PDF?

Підхід 1: HTML → PDF через mPDF або TCPDF. Шаблон документа пишеться як HTML/CSS, потім конвертується в PDF через бібліотеку. Простіше в редагуванні шаблонів — дизайнер працює зі звичайним HTML. Мінус: складні табличні форми з точним позиціонуванням відтворюються гірше. mPDF вдвічі швидший для простих документів. mPDF підтримує CSS2.1 та UTF-8. PDF — універсальний формат для документів (Wikipedia).

Підхід 2: PhpSpreadsheet → XLSX/PDF. Шаблон документа — Excel-файл з комірками та формулами. Дані підставляються в іменовані комірки, документ зберігається в XLSX або конвертується в PDF. Ідеальний для форм із точною табличною структурою (ТОРГ-12, УПД). PhpSpreadsheet втричі точніший при великих таблицях, ніж mPDF. PhpSpreadsheet — сучасна альтернатива PHPExcel.

На практиці ми комбінуємо: рахунок формуємо через mPDF, накладну — через PhpSpreadsheet. Це забезпечує оптимальну якість та швидкість.

Архітектура модуля

local/modules/vendor.printforms/ ├── lib/ │ ├── DocumentFactory.php # Фабрика документів │ ├── Template/ │ │ ├── BaseTemplate.php │ │ ├── InvoiceTemplate.php # Рахунок на оплату │ │ └── Torg12Template.php # ТОРГ-12 │ ├── Renderer/ │ │ ├── MpdfRenderer.php │ │ └── XlsxRenderer.php │ └── AmountInWords.php # Сума прописом ├── templates/ # HTML-шаблони документів └── admin/ # Сторінки в адміністративній частині 

Як дані збираються для документа?

Дані для документа збираються з кількох джерел:

class InvoiceTemplate extends BaseTemplate { public function getData(int $orderId): array { $order = \Bitrix\Sale\Order::load($orderId); $basket = $order->getBasket(); $propertyCollection = $order->getPropertyCollection(); $buyer = [ 'name' => $propertyCollection->getPayerName()->getValue(), 'inn' => $propertyCollection->getItemByCode('INN')?->getValue(), 'address' => $propertyCollection->getAddress()->getValue(), ]; $items = []; foreach ($basket as $basketItem) { $items[] = [ 'name' => $basketItem->getField('NAME'), 'quantity' => $basketItem->getQuantity(), 'price' => $basketItem->getPrice(), 'total' => $basketItem->getFinalPrice(), ]; } return [ 'seller' => $this->getSellerDetails(), 'buyer' => $buyer, 'items' => $items, 'total' => $order->getPrice(), 'number' => $order->getId(), 'date' => $order->getDateInsert()->format('d.m.Y'), ]; } } 

Реквізити продавця беруться з налаштувань модуля, що зберігаються в b_option. Ми обробляємо всі обов'язкові поля: ІПН, КПП, ОГРН, банківські реквізити.

Сума прописом

Клас AmountInWords конвертує числову суму в текст з урахуванням відмін: «П'ятнадцять тисяч двісті рублів 00 копійок». Реалізується вручну або через бібліотеку num2words — наявні PHP-реалізації часто мають помилки у відмінках, тому зазвичай пишемо власну під вимоги проєкту. У 95% випадків наша реалізація проходить перевірку податкової.

Кнопка в адміністративному замовленні та зберігання документів

Кнопка «Друкувати» додається в інтерфейс замовлення через обробник події OnSaleAdminOrderView або через глобальний адміністративний меню-файл local/admin/vendor_printforms.php.

При натисканні відкривається випадний список доступних документів. Вибраний документ генерується на льоту і віддається браузеру із заголовком Content-Type: application/pdf та Content-Disposition: attachment.

Згенеровані PDF можна зберігати у файлову систему (upload/printforms/{orderId}/) та прикріплювати до замовлення. Це дозволяє:

• Повторно завантажити раніше згенерований документ без перестворення.
• Автоматично додавати рахунок до листа про оплату замовлення.
• Зберігати історію версій документа (якщо реквізити змінювались).

Шлях до файлу записується в таблицю b_printform_document:

Що входить у розробку модуля?

До складу робіт входить:

• Аналіз вимог: список документів, джерела даних, макети.
• Створення шаблонів: верстка HTML або Excel-макетів з урахуванням фірмового стилю.
• Розробка модуля: фабрика документів, рендерери, інтеграція із замовленнями.
• Інтеграція з 1С через CommerceML (при необхідності).
• Тестування: юніт-тести та ручна перевірка всіх документів.
• Документація та навчання бухгалтера.
• Гарантійна підтримка 3 місяці після запуску.

Отримайте консультацію — розрахуємо вартість під ваш проєкт.

Процес роботи: покроково

1. Аналіз вимог — визначаємо список документів, джерела даних, макети.
2. Створення шаблонів — верстаємо HTML або Excel-макети з урахуванням фірмового стилю.
3. Розробка модуля — реалізуємо фабрику документів, рендерери, інтеграцію із замовленнями.
4. Інтеграція з 1С — налаштовуємо обмін через CommerceML при необхідності.
5. Тестування — юніт-тести та ручна перевірка всіх документів.
6. Деплой та документація — передача вихідників, інструкція для бухгалтера.
7. Гарантійна підтримка — 3 місяці після запуску.

Згідно з документацією 1С-Бітрікс, для роботи із замовленнями рекомендується використовувати Bitrix\Sale\Order.

Строки розробки

Вартість розраховується індивідуально. Оцінимо проєкт за 1 день. Замовте консультацію — отримайте розрахунок під вашу задачу.