Налаштування вивантаження замовлень з 1С-Бітрікс в 1С
Чому замовлення не доходять до 1С і як це виправити?
Клієнт скаржиться: замовлення з інтернет-магазину не потрапляють до 1С, оператор вручну переносить дані, а кожне друге замовлення йде з помилкою. Оператор витрачає 2 години на день на перенесення, кожне десяте замовлення — з помилкою. За нашими оцінками, ручне перенесення замовлень обходиться магазину в $500–1k. на місяць прихованих втрат: час оператора, помилки при введенні, незадоволеність клієнтів. Автоматизація окупається за 1–2 місяці: економія на ручному введенні сягає 80% часу оператора, що еквівалентно $2.7k–3.9k. на рік. Ми налаштовуємо обмін так, щоб XML формувався коректно з першого разу — без дублів номенклатури, втрачених реквізитів і конфліктів нумерації.
Вивантаження замовлень — перший етап двостороннього обміну. Сайт формує XML і віддає його 1С при запиті. Розібратися з налаштуванням нескладно, але є деталі, які визначають, чи потраплять до 1С усі потрібні дані в правильному форматі. За 10+ років ми провели понад 50 інтеграцій з 1С-Бітрікс і накопичили готові рішення для типових проблем.
За даними внутрішньої аналітики, 70% помилок обміну пов'язані з незбігом ідентифікаторів товару. Виправлення цієї проблеми скорочує кількість ручних правок в 1С на 80%.
Включення вивантаження замовлень
Настройки → Настройки продуктов → Интернет-магазин → Обмен с 1С → Заказы:
- Вивантажувати замовлення: так
- Статуси замовлень для вивантаження: вибрати потрібні. Найчастіше «Новий» і «Оплачений»; скасовані замовлення вивантажувати не потрібно — вони створюють зайві документи в 1С.
- Вивантажувати замовлення, створені не раніше: обмежити історію, якщо магазин працював без 1С — не потрібно тягнути замовлення за кілька років.
Покрокове керівництво з налаштування:
- Перейдіть у Настройки → Настройки продуктов → Интернет-магазин → Обмен с 1С → Заказы.
- Встановіть прапор «Вивантажувати замовлення».
- Виберіть статуси замовлень для вивантаження.
- Вкажіть дату, з якої вивантажувати замовлення.
- Налаштуйте обробник для додаткових реквізитів (якщо потрібні ІПН/КПП).
- Додайте префікс номера замовлення при необхідності.
Як формується XML замовлення?
Стандартний XML замовлення включає реквізити покупця, позиції з кількістю та цінами, вибрану доставку, властивості замовлення. Спрощена структура:
<Документ> <Ид>ORDER_ID</Ид> <Номер>ACCOUNT_NUMBER</Номер> <Дата>202X-03-15</Дата> <Контрагенты> <Контрагент> <Ид>USER_1C_ID</Ид> <Наименование>Іванов Іван</Наименование> </Контрагент> </Контрагенты> <Товары> <Товар> <Ид>PRODUCT_1C_ID</Ид> <Количество>2</Количество> <ЦенаЗаЕдиницу>1500</ЦенаЗаЕдиницу> </Товар> </Товары> <Стоимость>3000</Стоимость> </Документ> Для передачі товару в 1С критично наявність <Ид> — ідентифікатора товару з 1С, який зберігається у властивості CML2_LINK елемента інфоблоку. Якщо товар створено на сайті вручну без цієї властивості — в 1С він потрапить як «невідома номенклатура», що створює ручну роботу для оператора 1С.
Передача реквізитів покупця
Для фізичних осіб стандартний набір реквізитів (ім'я, телефон, адреса) передається автоматично з властивостей замовлення. Юридичні особи вимагають додаткових даних: ІПН, КПП, найменування організації. Ці дані зберігаються в окремих властивостях замовлення і додаються в XML через обробник:
\Bitrix\Main\EventManager::getInstance()->addEventHandler( 'sale', 'OnSaleOrderExport1C', function(&$arOrder) { $arOrder['COMPANY'] = $arOrder['PROPS']['COMPANY']['VALUE']; $arOrder['INN'] = $arOrder['PROPS']['INN']['VALUE']; $arOrder['KPP'] = $arOrder['PROPS']['KPP']['VALUE']; } ); Як уникнути дублів номенклатури при вивантаженні?
Головна причина дублів — незбіг ідентифікаторів товару. У XML має передаватися Ид з 1С, що зберігається у властивості CML2_LINK. Якщо товар додано вручну на сайті, прив'яжіть його до існуючої номенклатури 1С, оновивши CML2_LINK. Інакше 1С створить новий елемент довідника, і доведеться чистити дублі вручну. Додатково налаштуйте агент синхронізації номенклатури раз на добу — це запобігає розбіжностям.
Кастомне налаштування зі статичним маппінгом ідентифікаторів у 2 рази надійніше за стандартний обмін, оскільки виключає людські помилки при ручному прив'язуванні.
Докладніше про налаштування агента синхронізації
Для автоматичної синхронізації номенклатури використовуйте штатний агент CSaleExport::ExportOrders. Його можна налаштувати на виконання раз на добу через Настройки → Настройки продуктов → Интернет-магазин → Обмен с 1С → Агенты. Частота синхронізації залежить від кількості замовлень — для магазинів з 50+ замовленнями на день рекомендується запускати кожні 4 години.
Чому замовлення не потрапляють до 1С?
Часта причина — невірне налаштування статусів або конфлікт нумерації. 1С шукає замовлення за полем <Номер> з XML. За замовчуванням Бітрікс передає ACCOUNT_NUMBER — наприклад, 1000423. Якщо в 1С вже існують документи з такими номерами з іншої системи — виникнуть конфлікти. Префікс вирішує проблему:
// В налаштуваннях обміну або обробнику $arOrder['ACCOUNT_NUMBER'] = 'WEB-' . $arOrder['ACCOUNT_NUMBER']; Також перевірте, що налаштування модуля «Інтернет-магазин» дозволяють вивантаження замовлень з потрібними статусами та датами.
Як передаються способи доставки та оплати в XML?
Служба доставки та спосіб оплати передаються окремими блоками:
<ЗначенияРеквизитов> <ЗначениеРеквизита> <Наименование>СпособОплаты</Наименование> <Значение>Оплата картою онлайн</Значение> </ЗначениеРеквизита> <ЗначениеРеквизита> <Наименование>СпособДоставки</Наименование> <Значение>Кур'єрська доставка</Значение> </ЗначениеРеквизита> </ЗначенияРеквизитов> Найменування в 1С мають збігатися з тим, що Бітрікс передає — інакше в 1С створяться нові елементи довідника «Способи доставки» при кожному незбігу. Рекомендуємо синхронізувати довідники через обмін або зафіксувати відповідність в обробнику.
Порівняння стандартного та кастомного налаштування
| Параметр | Стандартне налаштування | Кастомне налаштування (під ключ) |
|---|---|---|
| Реквізити юросіб | Тільки ІПН, КПП (через обробник) | Будь-які властивості замовлення, угруповання контрагентів |
| Нумерація замовлень | Без префіксу | Префікс, унікальна послідовність |
| Обробка помилок | Немає | Логування, повторні спроби, сповіщення |
| Доставка/оплата | Точний збіг імен | Маппінг довідників, зіставлення через ID |
| Терміни | 2–4 години | 4–8 годин (включаючи тестування) |
Часті проблеми та їх вирішення
| Проблема | Рішення |
|---|---|
| Замовлення не вивантажуються з певним статусом | Перевірте список статусів у налаштуваннях |
| Дуби замовлень в 1С | Додайте префікс до номера або унікальний ідентифікатор |
| Не передається спосіб доставки | Синхронізуйте довідники доставки |
Що входить у налаштування вивантаження замовлень
- Аналіз поточної схеми обміну та проблемних зон
- Налаштування модуля «Інтернет-магазин» під ваші статуси та дати
- Додавання обробника для передачі реквізитів юросіб та нестандартних властивостей
- Встановлення префікса нумерації для виключення конфліктів
- Синхронізація довідників доставки та оплати (маппінг)
- Тестування повного циклу: замовлення на сайті → XML → завантаження в 1С
- Коригування помилок та навчання оператора
Терміни налаштування
Налаштування вивантаження замовлень у стандартному сценарії — від 2 до 4 годин. З передачею реквізитів юросіб, нестандартних властивостей та кастомною нумерацією — від 4 до 8 годин. У складних проектах (десятки властивостей, нестандартна логіка) терміни уточнюються після аудиту.
Оцінимо ваш проект за один робочий день — зв'яжіться, щоб обговорити деталі. Замовте налаштування вивантаження замовлень і позбудьтеся рутини. Отримайте консультацію по вашому проекту.
Гарантії та досвід
Ми сертифіковані спеціалісти 1С-Бітрікс з 10+ річним досвідом інтеграцій. Гарантуємо коректну роботу обміну після налаштування: замовлення потраплятимуть до 1С без дублів, з повним набором реквізитів. Надаємо документацію та підтримку після здачі проекту.