Соединение установлено, товары появились на сайте, пробный заказ дошёл до 1С. Этого недостаточно, чтобы принимать интеграцию: сбой может проявиться при повторной отправке, изменении цены или недоступности одной из систем. Перед запуском нужен небольшой, воспроизводимый набор проверок с ожидаемым результатом и доказательствами в обеих системах.
Начните с карты потоков данных, подготовьте изолированное окружение, затем проверьте обычные операции и управляемые сбои. Результатом должен стать протокол приёмки: какие сценарии выполнены, где обнаружены расхождения и кто принимает решение о запуске. Ниже – основа такого протокола для заказчика и команды интеграции.
Зафиксируйте границы проверки и безопасное окружение
Сначала запишите конфигурацию и версию 1С, CMS, модуль обмена, направления передачи и источник каждого поля. Например, цена приходит из учётной системы, а комментарий покупателя создаётся на сайте. Укажите, какая сторона вправе менять статус заказа и как разрешается одновременное редактирование. Без этих правил невозможно отличить ошибку от предусмотренного поведения.
Тестирование проводите на отдельном сайте и тестовой базе 1С. До первого обмена проверьте адреса подключений, учётные записи, расписания фоновых заданий и обработчики событий. Письма, SMS, оплату, доставку и другие внешние действия отключите либо направьте в тестовые сервисы. Одна надпись «тест» в интерфейсе не защищает от отправки настоящего заказа или уведомления клиенту.
Используйте вымышленные или обезличенные данные. Подготовьте исходный снимок состояния, чтобы повторять сценарии с одинаковыми условиями. Зафиксируйте ответственного за сброс тестовых данных и запретите подключение этого окружения к рабочим получателям. Это рекомендуемые условия испытания; конкретный способ изоляции команда выбирает под архитектуру проекта.
Подготовьте контрольные данные и матрицу сценариев
Подберите товары и заказы, которые представляют разные правила бизнеса: обычный товар, вариант с характеристикой, позицию без остатка, дробное количество, нужные типы цен и склады. Не переносите все комбинации в один заказ: при ошибке будет трудно понять причину. У каждого примера должны быть постоянный идентификатор и заранее записанные ожидаемые значения.
Если подготовка структуры и объёма данных ещё не завершена, сначала используйте материал о проверках перед интеграцией большого товарного каталога. Здесь задача другая: воспроизвести события и подтвердить результат работающего обмена.
| Сценарий | Действие на тесте | Что считать успешным результатом |
|---|---|---|
| Новый товар | Передать контрольную позицию и её вариант | Созданы нужные сущности; идентификаторы, единицы и связи совпали |
| Изменение данных | Поменять цену и остаток выбранного товара | Обновилась нужная позиция; согласованные значения видны на сайте |
| Новый заказ | Оформить заказ с известными суммами и составом | В 1С появился один документ с правильным покупателем и строками |
| Повторная доставка | Повторно передать ту же операцию | Нет второго заказа и повторного списания или резервирования |
| Прерывание обмена | Оборвать тестовое соединение в выбранной точке | Видно незавершённое состояние; повтор позволяет получить согласованный результат |
| Ошибочные данные | Отправить пример с отсутствующим обязательным полем | Ошибка объяснима; запись не считается успешно обработанной |
| Конфликт изменений | Изменить согласованное поле с двух сторон | Применилось заранее определённое правило; изменение не потерялось незаметно |
Для каждой строки добавьте номер проверки, начальное состояние, фактический результат и ссылку на журнал. Ожидание «обмен работает» замените проверяемой формулировкой. Для денежных полей отдельно согласуйте округление, скидки, доставку и способ учёта налогов: одинаковый итог заказа ещё не доказывает правильность каждой строки.
Проверьте не только передачу, но и обработку
При штатном обмене по протоколу 1С проверка авторизации, передача файла и его обработка – разные этапы. Ответ success на запись файла не подтверждает завершение импорта. На этапе импорта progress означает необходимость повторить запрос, а success сообщает об окончании обработки файла. Поэтому успешное соединение или один ответ сервера не заменяют сверку данных.
В протоколе также предусмотрены согласование размера передаваемой части файла и обмен заказами. Проверяйте фактическую последовательность вашего модуля, включая завершение загрузки заказов. Если используется собственный API или очередь, опирайтесь на их контракт: названия режимов штатного протокола могут к ним не относиться.
Сопоставьте одну операцию по всей цепочке: исходная запись, отправленный пакет, результат обработки, запись получателя и отображение для пользователя. Сохраняйте время с часовым поясом, идентификаторы и диагностическое сообщение. Пароли, токены и лишние сведения о клиентах в отчёт не включайте.
Воспроизведите повторы, задержки и восстановление
Особенно полезна проверка момента, когда получатель уже сохранил заказ, но отправитель не получил подтверждение. Для отправителя результат неизвестен, поэтому возможна повторная передача. В руководстве RabbitMQ по надёжности такой риск описан прямо: при потере подтверждения сообщение может быть отправлено снова, а получатель должен учитывать дубликаты. Это относится к системам с RabbitMQ; наличие брокера не следует предполагать у любой интеграции с 1С.
Для вашего обмена сформулируйте требование: повтор той же операции не создаёт второе бизнес-действие. Затем проверьте его на данных, а не только по журналу запросов. Например, в условном испытании заказ TEST-104 передают дважды с тем же идентификатором. В 1С должен остаться один соответствующий заказ; предусмотренные резервирование и уведомление также не должны повториться. Способ реализации этого требования зависит от модуля обмена.
Отдельно проверьте недоступность получателя, задержанную доставку старого изменения после нового и остановку обработчика посреди пакета. Согласуйте, как выявляются необработанные записи и кто запускает повтор после исправления. Не требуйте общего отката всего пакета, если система обрабатывает записи по отдельности: важнее однозначно видеть, что принято, что отклонено и что осталось выполнить.
Примите результат и подготовьте запуск
После исправления ошибки повторите исходный сценарий и связанные с ним проверки. При согласованном ожидаемом объёме измерьте длительность обмена и задержку появления изменений. Объём и допустимое время задаёт проект; универсальная норма для любого магазина здесь не подходит.
Перед решением о запуске проверьте:
- контрольные товары, цены, остатки и заказы сверены с ожидаемыми значениями;
- повторы и прерывания не приводят к необъяснимой потере или дублированию операций;
- ошибки видны, для каждой известны причина и следующий шаг;
- зафиксированы версии компонентов и проверенные настройки;
- назначены ответственные за переключение, контрольный обмен и решение об остановке;
- описано, как восстановить согласованное состояние, если после запуска возникнет сбой.
Расхождения в суммах, принадлежности заказа, остатках или повторных бизнес-действиях – основание отложить запуск до исправления либо явно ограничить запускаемый сценарий. Оставшиеся замечания занесите в протокол с последствиями и ответственными, чтобы решение не зависело от устной договорённости.
Для обсуждения разработки сайта и интеграций с ITS подготовьте карту потоков, версии систем и несколько контрольных примеров. По ним проще определить состав проверки, границы доработок и критерии приёмки до подключения рабочего обмена.