Уявіть: інтернет-магазин з 200 замовленнями на день. Кожне відвантаження вимагає формування накладної, акта, рахунку-фактури. Менеджери витрачають на ручне введення даних від 10 до 20 хвилин на замовлення. Помноживши на кількість замовлень, отримуємо до 67 годин на місяць — майже два робочі тижні одного співробітника. Автоматичне формування відвантажувальних документів у 1С-Бітрікс скорочує цей час до секунд, виключаючи помилки введення. Економія на одному магазині становить від 100 000 до 500 000 гривень на рік — це в 10 разів швидше ручного процесу. Ми — команда з досвідом розробки на 1С-Бітрікс (CMS та Бітрікс24) понад 8 років. За цей час реалізували понад 120 проєктів, включаючи інтеграції з 1С, CRM та платіжними шлюзами. Налаштування автоматичного формування відвантажувальних документів — одне з частих завдань, яке ми вирішуємо за 3-5 днів. Отримайте консультацію по вашому проєкту — зв'яжіться з нами, автоматизація окупається за 2-3 тижні.
Згідно з документацією Бітрікс, подія OnSaleStatusOrderChange викликається при кожній зміні статусу замовлення.
Навіщо автоматизувати формування відвантажувальних документів?
Ручне створення документів при відвантаженні — джерело помилок і втрат часу. Менеджер вводить дані із замовлення в Excel або 1С, помиляється в артикулах або цінах, перероблює. Система Бітрікс дозволяє виключити людський фактор: документи генеруються за заданими правилами в момент зміни статусу. Це особливо важливо для магазинів з великим потоком замовлень — від 50 на день і вище. Помилки в документах призводять до повернень і невдоволення клієнтів.
Налаштування автоматичного формування відвантажувальних документів
Точка входу — подія OnSaleStatusOrderChange модуля sale. Вона викликається при кожній зміні статусу. Параметри: ORDER_ID, STATUS_ID (новий статус), OLD_STATUS_ID. Обробник реєструється в /bitrix/php_interface/init.php або в модулі:
AddEventHandler('sale', 'OnSaleStatusOrderChange', 'generateShipmentDoc');
function generateShipmentDoc($orderId, $newStatus, $oldStatus) {
if ($newStatus !== 'S') return;
$order = \Bitrix\Sale\Order::load($orderId);
if (!$order) return;
generateInvoiceForOrder($order);
}
У новому API Бітрікса (D7) подія називається OnSaleOrderSaved і передає об'єкт замовлення — рекомендується використовувати його замість застарілого. Вона спрацьовує при будь-якому збереженні замовлення, тому потрібно додатково перевіряти зміну статусу.
Важливість перевірки DEDUCTED
Не всі відвантаження зі статусом «Відвантажено» мають фактичне списання. Критично перевіряти прапор DEDUCTED='Y', інакше документ може бути згенерований для відвантаження, яке ще не оброблене складом. Це часта помилка — ми її виправляємо на етапі аудиту.
Структура відвантаження в модулі sale
Відвантаження в Бітріксі — об'єкт \Bitrix\Sale\Shipment. Кожне замовлення може мати кілька відвантажень. Таблиця b_sale_shipment зберігає відвантаження з полями: ORDER_ID, DELIVERY_ID, STATUS_ID, PRICE_DELIVERY, CURRENCY, DEDUCTED (Y — товари списані зі складу). Рядки відвантаження — b_sale_shipment_item: SHIPMENT_ID, BASKET_ID, QUANTITY, RESERVED_QUANTITY. При формуванні відвантажувального документа потрібно читати саме з b_sale_shipment_item, а не з b_sale_basket — при частковому відвантаженні кількості можуть розрізнятися.
| Поле | Призначення |
|---|---|
ORDER_ID |
Ідентифікатор замовлення |
DELIVERY_ID |
Служба доставки |
STATUS_ID |
Статус відвантаження |
DEDUCTED |
Прапор списання товарів |
Генерація PDF-накладної
Для генерації PDF використовується зовнішня бібліотека mpdf. У Бітріксі немає вбудованого PDF-генератора для документів, але є механізм друкованих форм через компонент bitrix:sale.order.invoice. Програмне створення PDF через mpdf:
function generateInvoiceForOrder(\Bitrix\Sale\Order $order) {
$shipmentCollection = $order->getShipmentCollection();
$items = [];
foreach ($shipmentCollection as $shipment) {
if ($shipment->isSystem()) continue;
foreach ($shipment->getShipmentItemCollection() as $shipmentItem) {
$basketItem = $shipmentItem->getBasketItem();
$items[] = [
'name' => $basketItem->getField('NAME'),
'quantity' => $shipmentItem->getQuantity(),
'price' => $basketItem->getPrice(),
'sum' => $basketItem->getPrice() * $shipmentItem->getQuantity(),
];
}
}
ob_start();
include __DIR__ . '/templates/invoice.php';
$html = ob_get_clean();
$mpdf = new \Mpdf\Mpdf(['utf-8', 'A4']);
$mpdf->WriteHTML($html);
$pdfContent = $mpdf->Output('', 'S');
$fileId = \CFile::SaveFile([
'name' => 'invoice_' . $order->getId() . '.pdf',
'type' => 'application/pdf',
'content' => $pdfContent,
], 'sale/invoices');
saveInvoiceFile($order->getId(), $fileId);
}
Як зберігати згенеровані PDF?
Бітрікс не має стандартного місця для зберігання файлів замовлення. Порівняємо варіанти:
| Спосіб зберігання | Переваги | Недоліки |
|---|---|---|
| Властивість замовлення типу «Файл» | Просте налаштування | Може загубитися при оновленні |
Кастомна таблиця sale_order_documents |
Незалежність від ядра, розширюваність | Вимагає SQL-міграції |
| Інфоблок CRM-угоди | Інтеграція з CRM | Залежність від модуля crm |
Ми рекомендуємо кастомну таблицю — вона не втрачає дані при оновленнях і не вимагає додаткових модулів.
Відправка документа менеджеру
Після генерації документ відправляється на email менеджера або в CRM. Через подію OnSaleOrderSaved доступний ORDER_ID — по ньому береться відповідальний менеджер із b_sale_order (поле RESPONSIBLE_ID) і надсилається лист через \Bitrix\Main\Mail\Event::send() з шаблоном типу SALE_NEW_ORDER або кастомним. Альтернатива — інтеграція з модулем tasks: при зміні статусу створюється задача менеджеру з посиланням на документ. Задача висить до виконання, а лист може загубитися.
Що входить у роботу з налаштування
- Аудит поточних статусів замовлень і схем відвантажень
- Розробка обробника під вашу логіку (статуси, часткове відвантаження)
- Шаблон PDF-документа з макетом (назва, ціни, артикули, підписи)
- Вибір і налаштування місця зберігання файлів (властивість, таблиця, CRM)
- Налаштування сповіщень (email, задачі) для менеджерів
- Документування рішення та навчання співробітників
- Технічна підтримка після запуску — гарантія 1 місяць
Етапи впровадження
- Аналітика — вивчаємо ланцюжок замовлення-відвантаження, визначаємо точки входу (статуси, користувацькі поля)
- Проєктування — вибираємо подію, таблицю зберігання, спосіб генерації PDF
- Реалізація — пишемо код, тестуємо на тестовому замовленні
- Тестування — прогоняємо часткові, повні та поворотні відвантаження
- Деплой — викатуємо на бой, налаштовуємо логування помилок
- Приймання — показуємо результат, отримуємо зворотний зв'язок
Строки орієнтовно
Типовий проєкт на один-два статуси відвантаження — від 3 до 5 робочих днів. Складні схеми з кількома відвантаженнями, інтеграцією з 1С і кастомними шаблонами — до 2 тижнів. Вартість розраховується індивідуально після аудиту поточної системи. Зв'яжіться з нами — оцінимо проєкт безкоштовно і запропонуємо оптимізацію без прихованих доплат.
Типові помилки та як їх уникнути
Найчастіша помилка — відсутність перевірки прапора DEDUCTED. У результаті документ генерується для відвантажень без фактичного списання. Ми завжди перевіряємо цей прапор перед генерацією. Інша поширена проблема — читання даних із b_sale_basket замість b_sale_shipment_item при частковому відвантаженні. Кількість товарів у кошику може не збігатися з відвантажуваною кількістю, тому використовуйте таблицю b_sale_shipment_item. Також важливо прив'язувати шаблон документа до типу відвантаження, інакше різні служби доставки отримають однаковий формат. Логування всіх помилок — обов'язкова вимога для швидкої діагностики. При високому навантаженні необхідне блокування за ID замовлення, щоб уникнути повторної генерації.
Ми використовуємо ці практики у всіх проєктах — понад 120 впроваджень підтверджують їх ефективність. Замовте налаштування автоматичного формування відвантажувальних документів — отримайте готове рішення з документацією та підтримкою.