К содержимому
# Интеграции с 1С

Как протестировать обмен сайта с 1С перед запуском

Материал ITS6 мин чтения

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

Начните с карты потоков данных, подготовьте изолированное окружение, затем проверьте обычные операции и управляемые сбои. Результатом должен стать протокол приёмки: какие сценарии выполнены, где обнаружены расхождения и кто принимает решение о запуске. Ниже – основа такого протокола для заказчика и команды интеграции.

Зафиксируйте границы проверки и безопасное окружение

Сначала запишите конфигурацию и версию 1С, CMS, модуль обмена, направления передачи и источник каждого поля. Например, цена приходит из учётной системы, а комментарий покупателя создаётся на сайте. Укажите, какая сторона вправе менять статус заказа и как разрешается одновременное редактирование. Без этих правил невозможно отличить ошибку от предусмотренного поведения.

Тестирование проводите на отдельном сайте и тестовой базе 1С. До первого обмена проверьте адреса подключений, учётные записи, расписания фоновых заданий и обработчики событий. Письма, SMS, оплату, доставку и другие внешние действия отключите либо направьте в тестовые сервисы. Одна надпись «тест» в интерфейсе не защищает от отправки настоящего заказа или уведомления клиенту.

Используйте вымышленные или обезличенные данные. Подготовьте исходный снимок состояния, чтобы повторять сценарии с одинаковыми условиями. Зафиксируйте ответственного за сброс тестовых данных и запретите подключение этого окружения к рабочим получателям. Это рекомендуемые условия испытания; конкретный способ изоляции команда выбирает под архитектуру проекта.

Подготовьте контрольные данные и матрицу сценариев

Подберите товары и заказы, которые представляют разные правила бизнеса: обычный товар, вариант с характеристикой, позицию без остатка, дробное количество, нужные типы цен и склады. Не переносите все комбинации в один заказ: при ошибке будет трудно понять причину. У каждого примера должны быть постоянный идентификатор и заранее записанные ожидаемые значения.

Если подготовка структуры и объёма данных ещё не завершена, сначала используйте материал о проверках перед интеграцией большого товарного каталога. Здесь задача другая: воспроизвести события и подтвердить результат работающего обмена.

Сценарий Действие на тесте Что считать успешным результатом
Новый товар Передать контрольную позицию и её вариант Созданы нужные сущности; идентификаторы, единицы и связи совпали
Изменение данных Поменять цену и остаток выбранного товара Обновилась нужная позиция; согласованные значения видны на сайте
Новый заказ Оформить заказ с известными суммами и составом В 1С появился один документ с правильным покупателем и строками
Повторная доставка Повторно передать ту же операцию Нет второго заказа и повторного списания или резервирования
Прерывание обмена Оборвать тестовое соединение в выбранной точке Видно незавершённое состояние; повтор позволяет получить согласованный результат
Ошибочные данные Отправить пример с отсутствующим обязательным полем Ошибка объяснима; запись не считается успешно обработанной
Конфликт изменений Изменить согласованное поле с двух сторон Применилось заранее определённое правило; изменение не потерялось незаметно

Для каждой строки добавьте номер проверки, начальное состояние, фактический результат и ссылку на журнал. Ожидание «обмен работает» замените проверяемой формулировкой. Для денежных полей отдельно согласуйте округление, скидки, доставку и способ учёта налогов: одинаковый итог заказа ещё не доказывает правильность каждой строки.

Проверьте не только передачу, но и обработку

При штатном обмене по протоколу 1С проверка авторизации, передача файла и его обработка – разные этапы. Ответ success на запись файла не подтверждает завершение импорта. На этапе импорта progress означает необходимость повторить запрос, а success сообщает об окончании обработки файла. Поэтому успешное соединение или один ответ сервера не заменяют сверку данных.

В протоколе также предусмотрены согласование размера передаваемой части файла и обмен заказами. Проверяйте фактическую последовательность вашего модуля, включая завершение загрузки заказов. Если используется собственный API или очередь, опирайтесь на их контракт: названия режимов штатного протокола могут к ним не относиться.

Сопоставьте одну операцию по всей цепочке: исходная запись, отправленный пакет, результат обработки, запись получателя и отображение для пользователя. Сохраняйте время с часовым поясом, идентификаторы и диагностическое сообщение. Пароли, токены и лишние сведения о клиентах в отчёт не включайте.

Воспроизведите повторы, задержки и восстановление

Особенно полезна проверка момента, когда получатель уже сохранил заказ, но отправитель не получил подтверждение. Для отправителя результат неизвестен, поэтому возможна повторная передача. В руководстве RabbitMQ по надёжности такой риск описан прямо: при потере подтверждения сообщение может быть отправлено снова, а получатель должен учитывать дубликаты. Это относится к системам с RabbitMQ; наличие брокера не следует предполагать у любой интеграции с 1С.

Для вашего обмена сформулируйте требование: повтор той же операции не создаёт второе бизнес-действие. Затем проверьте его на данных, а не только по журналу запросов. Например, в условном испытании заказ TEST-104 передают дважды с тем же идентификатором. В 1С должен остаться один соответствующий заказ; предусмотренные резервирование и уведомление также не должны повториться. Способ реализации этого требования зависит от модуля обмена.

Отдельно проверьте недоступность получателя, задержанную доставку старого изменения после нового и остановку обработчика посреди пакета. Согласуйте, как выявляются необработанные записи и кто запускает повтор после исправления. Не требуйте общего отката всего пакета, если система обрабатывает записи по отдельности: важнее однозначно видеть, что принято, что отклонено и что осталось выполнить.

Примите результат и подготовьте запуск

После исправления ошибки повторите исходный сценарий и связанные с ним проверки. При согласованном ожидаемом объёме измерьте длительность обмена и задержку появления изменений. Объём и допустимое время задаёт проект; универсальная норма для любого магазина здесь не подходит.

Перед решением о запуске проверьте:

  • контрольные товары, цены, остатки и заказы сверены с ожидаемыми значениями;
  • повторы и прерывания не приводят к необъяснимой потере или дублированию операций;
  • ошибки видны, для каждой известны причина и следующий шаг;
  • зафиксированы версии компонентов и проверенные настройки;
  • назначены ответственные за переключение, контрольный обмен и решение об остановке;
  • описано, как восстановить согласованное состояние, если после запуска возникнет сбой.

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

Для обсуждения разработки сайта и интеграций с ITS подготовьте карту потоков, версии систем и несколько контрольных примеров. По ним проще определить состав проверки, границы доработок и критерии приёмки до подключения рабочего обмена.

ОТ ЧТЕНИЯ К ЗАДАЧЕ

Обсудим ваш процесс

Опишите задачу и системы, с которыми работает команда. Обсудим подход, ограничения и следующий шаг.

ITS GROUP
ITS GROUP
Мы на связи
Задайте вопрос – мы не заставим себя долго ждать
отвечаем