Реализация экспорта товаров из сайта в 1С (CommerceML)

При ручной передаче заказов из интернет-магазина в 1С бухгалтер тратит 2-3 часа ежедневно, а вероятность ошибки — каждая десятая строка. Автоматический экспорт товаров из сайта в 1С по CommerceML решает эту проблему: данные передаются мгновенно, без опечаток и потерь. Наша команда имеет 7+ лет опыта интеграции с 1С, включая работу с типовыми и нетиповыми конфигурациями. Мы гарантируем корректную передачу данных и полное логирование для отладки.

Один из наших проектов — интернет-магазин с 10 000 заказов в месяц. Раньше бухгалтер тратил 3 часа ежедневно на ручной ввод, что обходилось компании в 500 000 рублей зарплаты в год. После внедрения экспорта заказов по CommerceML2 время сократилось до 10 минут в день.

В этой статье разберём, какие данные можно экспортировать, как настроить генерацию sale.xml, обработать подтверждения и обновить статусы. Также рассмотрим типичные сложности и способы их избежать.

Почему экспорт заказов в 1С — нетривиальная задача?

Проблема не в генерации XML — это прямо. Сложности начинаются при сверке идентификаторов: если товар создан на сайте (без GUID из 1С), его нельзя просто передать — нужно либо создать позицию в 1С, либо сопоставить по артикулу. Вторая проблема — кодировка: некоторые версии 1С ожидают файлы в Windows-1251, а сайты обычно работают в UTF-8. Наконец, тестирование требует доступа к тестовой базе 1С, что не всегда есть на начальном этапе.

Какие данные передаются в 1С?

Наиболее распространённые сценарии экспорта:

Для каждого сценария настраивается своя логика: какие именно данные попадают в XML, как часто передаются и как обрабатываются ошибки.

Как мы генерируем sale.xml

Реализуем класс SaleXmlGenerator, который строит дерево КоммерческаяИнформация с документами-заказами:

class SaleXmlGenerator { public function generate(Collection $orders): string { $xml = new \DOMDocument('1.0', 'UTF-8'); $root = $xml->createElement('КоммерческаяИнформация'); $root->setAttribute('ВерсияСхемы', '2.10'); $xml->appendChild($root); foreach ($orders as $order) { $orderNode = $xml->createElement('Документ'); $this->addElement($xml, $orderNode, 'Ид', $order->uuid); $this->addElement($xml, $orderNode, 'Номер', $order->number); $this->addElement($xml, $orderNode, 'Дата', $order->created_at->format('Y-m-d')); $this->addElement($xml, $orderNode, 'Сумма', number_format($order->total, 2, '.', '')); $this->addElement($xml, $orderNode, 'Валюта', 'RUB'); // Контрагент $client = $xml->createElement('Контрагенты'); $agent = $xml->createElement('Контрагент'); $this->addElement($xml, $agent, 'Наименование', $order->customer_name); $this->addElement($xml, $agent, 'Роль', 'Покупатель'); $client->appendChild($agent); $orderNode->appendChild($client); // Товары $products = $xml->createElement('Товары'); foreach ($order->items as $item) { $product = $xml->createElement('Товар'); $this->addElement($xml, $product, 'Ид', $item->product->onec_guid); $this->addElement($xml, $product, 'Наименование', $item->product->name); $this->addElement($xml, $product, 'Количество', $item->quantity); $this->addElement($xml, $product, 'ЦенаЗаЕдиницу', number_format($item->price, 2, '.', '')); $this->addElement($xml, $product, 'Сумма', number_format($item->total, 2, '.', '')); $products->appendChild($product); } $orderNode->appendChild($products); $root->appendChild($orderNode); } return $xml->saveXML(); } } 

Пошаговая инструкция по запуску генерации

1. Создайте экземпляр SaleXmlGenerator.
2. Передайте коллекцию заказов (с загруженными товарами и контрагентами).
3. Вызовите метод generate() — получите строку XML.
4. Проверьте валидность XML через DOMDocument::validate.
5. Отдайте файл по запросу 1С через HTTP-эндпоинт.

Как происходит подтверждение получения?

После загрузки заказов 1С отправляет список GUID успешно обработанных документов. Сайт помечает их как sent_to_1c = true. Это защищает от повторной передачи и даёт прозрачную историю синхронизации:

public function markAsSent(Request $request): Response { $guids = explode("\n", $request->getContent()); Order::whereIn('uuid', array_filter($guids)) ->update(['sent_to_1c' => true, 'sent_to_1c_at' => now()]); return response('success'); } 

Как обновляются статусы из 1С?

1С может возвращать обновлённые статусы заказов (оплачен, отгружен, отменён). Сайт принимает их через POST-запрос и обновляет поля заказов:

public function processSaleResponse(string $xmlPath): void { $xml = simplexml_load_file($xmlPath); foreach ($xml->Документ as $doc) { $guid = (string) $doc->Ид; $status = (string) $doc->Статус; Order::where('uuid', $guid)->update([ 'status' => $this->mapOnecStatus($status), 'onec_status' => $status, 'status_updated_at' => now(), ]); } } private function mapOnecStatus(string $onecStatus): string { return match($onecStatus) { 'Оплачен' => 'paid', 'Передан на склад' => 'processing', 'Отгружен' => 'shipped', 'Отменён' => 'cancelled', default => 'unknown', }; } 

Что входит в реализацию экспорта?

Мы предоставляем:

• Разработку генератора XML под вашу структуру заказов
• Обработку подтверждений и обновление статусов
• Механизм сопоставления товаров по артикулу при отсутствии GUID
• Тестирование на тестовой базе 1С (доступ предоставляется клиентом)
• Документацию и обучение ваших специалистов
• Поддержку в течение 2 недель после сдачи

Стоимость рассчитывается индивидуально и зависит от сложности интеграции. Экономия времени на ручном вводе — до 500 000 рублей в год.

Типичные сложности

Частые проблемы: пустые GUID товаров (если товар создан на сайте), несоответствие кодировок (Windows-1251 vs UTF-8), сложности тестирования без тестовой базы 1С. Для решения используем сопоставление по артикулу, конвертацию кодировок и помощь в настройке тестовой среды.

Сравнение: CommerceML2 против ручного ввода

CommerceML2 экспорт в 5 раз быстрее ручного ввода и снижает количество ошибок на 90%. Закажите экспорт под ключ — получите консультацию инженера бесплатно.

Как проверить корректность экспорта?

Первый шаг — убедиться, что в sale.xml попали все заказы с корректными суммами и GUID. Для этого мы генерируем XML в тестовом режиме, загружаем его в 1С и сверяем количество документов. Второй шаг — проверить, что после подтверждения статус заказов на сайте изменился на "передан в 1С". Третий шаг — обновить статус из 1С и убедиться, что сайт его принял.

Сроки и стоимость

Разработка экспорта заказов с подтверждением и обновлением статусов занимает 8–14 рабочих дней. Оценка точного срока проводится после анализа вашей учётной системы.

Чтобы обсудить детали, оставьте заявку — мы свяжемся с вами в течение дня.