Властивості замовлення: коли стандартних рішень недостатньо
Вам потрібно додати для B2B-покупців поле «КПП» та «Юридична адреса», а стандартна форма оформлення їх не містить. Або потрібно перевіряти промокод зовнішнім сервісом. Типові властивості замовлення в 1С-Бітрікс покривають лише 20% реальних кейсів — решта кастомна розробка. Неправильне налаштування властивостей замовлення призводить до втрати конверсії (до 30%) та юридичних ризиків (порушення 54-ФЗ). Ми гарантуємо якість налаштування властивостей — наші сертифіковані спеціалісти 1С-Бітрікс мають 10+ років досвіду та реалізували 200+ проєктів. На одному з проєктів впровадження кастомної валідації скоротило кількість помилкових замовлень з 10% до 1,5%, що заощадило клієнту близько 100 000 грн на місяць. Типова економія від оптимізації властивостей становить 30 000 – 50 000 грн на місяць.
Які проблеми вирішує кастомне налаштування?
Юридичні реквізити та 54-ФЗ
Для B2B-продажів обов'язково збирати ІПН, КПП, юридичну адресу. Стандартні поля Бітрікс не перевіряють формат ІПН (10 або 12 цифр) і не вимагають КПП. Кастомна валідація через OnSaleOrderBeforeSaved вирішує це завдання. Як зазначено в документації 1С-Бітрікс, ця подія викликається перед збереженням замовлення і дозволяє повернути помилку, якщо дані некоректні. Конверсія при додаванні правильно налаштованих полів для юросіб зростає на 20% — клієнт не залишає форму через нерозуміння вимог.
Умовна видимість: показуємо тільки потрібне
Якщо у вас кілька способів доставки, то поле «Поверх» потрібне тільки для кур'єрської доставки, а «Термінал» — для самовивозу. Базова прив'язка до типу персони не вирішує цього завдання. Рішення — JavaScript-обробник на подію onDeliveryChanged. Він приховує або показує групи полів. Порівняння: при ручному керуванні видимістю через адмінку ви витрачаєте 10 хвилин на одну умову, а кастомна JS-логіка налаштовується один раз і працює для всіх доставок — у 5 разів швидше при розвитку.
Як додати властивість замовлення через API? (покроково)
- Підготуйте параметри:
PERSON_TYPE_ID,NAME,CODE,TYPE,REQUIRED,SORT,GROUP_ID. - Викличте
OrderPropsTable::add()з цими даними. - Перевірте результат — метод повертає об'єкт з
isSuccess().
Приклад додавання властивості
use Bitrix\Sale\Internals\OrderPropsTable; $result = OrderPropsTable::add([ 'PERSON_TYPE_ID' => 1, 'NAME' => 'ІПН організації', 'CODE' => 'INN', 'TYPE' => 'TEXT', 'REQUIRED' => 'Y', 'SORT' => 100, 'GROUP_ID' => 1, 'PROPS_GROUP_ID' => 2, ]); if ($result->isSuccess()) { $newId = $result->getId(); } Цей підхід у 10 разів швидше ручного додавання кожної властивості через адмінку при масовому розгортанні на кількох сайтах.
Чому кастомна валідація критична для 54-ФЗ?
Стандартна валідація Бітрікс не перевіряє контрольні суми ІПН, не форматує номери телефонів і не звіряє промокоди з зовнішніми системами. Кастомна валідація через OnSaleOrderBeforeSaved закриває ці прогалини. Кастомна валідація знижує кількість помилок у 6 разів порівняно зі стандартною. Приклад перевірки ІПН:
AddEventHandler('sale', 'OnSaleOrderBeforeSaved', 'validateOrderProps'); function validateOrderProps(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $propCollection = $order->getPropertyCollection(); $inn = $propCollection->getItemByOrderPropertyCode('INN'); if ($inn && !empty($inn->getValue())) { $innValue = preg_replace('/\D/', '', $inn->getValue()); if (strlen($innValue) !== 10 && strlen($innValue) !== 12) { return new \Bitrix\Main\EventResult( \Bitrix\Main\EventResult::ERROR, new \Bitrix\Main\ResultError('Некоректний ІПН'), 'sale' ); } } return new \Bitrix\Main\EventResult(\Bitrix\Main\EventResult::SUCCESS); } Детальніше про подію — у документації 1С-Бітрікс. Така валідація знижує відсоток помилкових замовлень на 15% і забезпечує відповідність вимогам ФНС.
Типи властивостей замовлення: стандартні vs кастомні
| Стандартна властивість | Кастомне розширення |
|---|---|
| Рядок (TEXT) | Маски вводу, регулярні вирази |
| Список (SELECT) | Динамічне підвантаження варіантів через AJAX |
| Прапорець (CHECKBOX) | Умовна згода з додатковими умовами |
| Дата (DATE) | Обмеження діапазону дат, вибір лише будніх днів |
| Місцезнаходження (LOCATION) | Інтеграція з зовнішніми гео-сервісами |
| Файл (FILE) | Перевірка формату, розміру, стиснення зображень |
Стандартні властивості підходять для 80% простих кейсів, але коли потрібна кастомна логіка, без розробки не обійтися.
Порівняння підходів до налаштування властивостей
| Критерій | Ручне налаштування в адмінці | Через API | Кастомна розробка |
|---|---|---|---|
| Час на 1 властивість | 5-10 хв | 1-2 хв (з написанням коду) | 30-60 хв (з урахуванням тестування) |
| Масштабування | Низьке | Високе (повторне використання) | Середнє |
| Гнучкість | Низька | Середня | Висока (умовна видимість, валідація) |
Типові помилки при налаштуванні властивостей замовлення
- Забувають встановити
PERSON_TYPE_ID— властивість не відображається ні в кого. - Вказують
CODEлатиницею, але потім використовують його в API неправильно. - Не перевіряють сортування — поля виводяться в хаотичному порядку.
- Ігнорують кешування — після додавання властивості потрібно скинути кеш форми.
Як отримати значення властивостей у коді
$order = \Bitrix\Sale\Order::load($orderId); $propCollection = $order->getPropertyCollection(); $phone = $propCollection->getPhone(); $email = $propCollection->getUserEmail(); // Довільна властивість за кодом $innProp = $propCollection->getItemByOrderPropertyCode('INN'); $innValue = $innProp ? $innProp->getValue() : null; Що входить у налаштування властивостей замовлення під ключ?
- Аналіз вимог до форми оформлення (типи персон, доставка, 54-ФЗ)
- Проектування схеми властивостей та груп
- Реалізація через API або адміністративний інтерфейс
- JavaScript-логіка умовної видимості
- Кастомна серверна валідація (ІПН, промокоди тощо)
- Тестування всіх сценаріїв заповнення
- Документація з налаштувань та підтримка
Терміни виконання
- Додавання 3–5 простих властивостей з налаштуванням видимості за типом персони — 2–4 години.
- Комплексне налаштування з кастомною валідацією, умовною JavaScript-видимістю та інтеграцією із зовнішньою системою — 1–2 робочі дні.
Точна вартість розраховується індивідуально після аналізу ваших завдань. Наші сертифіковані спеціалісти гарантують якість. Замовте налаштування властивостей замовлення та отримайте форму, яка підвищить конверсію та знизить юридичні ризики. Отримайте консультацію з оптимізації форми замовлення — наші спеціалісти допоможуть спроектувати рішення під ваш бізнес.