Интеграция отправила заказ во внешнюю систему, но не получила ответ. Автоматически повторив запрос, она создала второй заказ с новым номером. Для покупателя это может означать двойную обработку, для склада — лишнее резервирование. Проблема не в скорости сети, а в отсутствии устойчивой связи между логической операцией и её повторной отправкой. Нужны идентификатор операции, подтверждение результата и журнал сверки.
Идемпотентность операции заказа — не то же самое, что уникальность SKU, ключ импорта товаров или защита формы от двойного клика. Важно определить, что два сетевых вызова означают одну бизнес-операцию, а два отдельных заказа одного человека могут быть действительно разными.
Прежде чем менять текущие настройки или код, зафиксируйте воспроизводимый пример, его исходные данные и правильное поведение. Разделите ошибку интерфейса, ошибку передачи данных и неверное бизнес-правило. Изучайте не только успешный путь, но и отмену, повтор, недостаток прав и отсутствие ответа внешнего сервиса.
Проверьте, предоставляет ли конкретный метод API гарантию для повторных вызовов и как долго хранит ключ. Нельзя переносить свойство одного метода на весь API. Для выбранного варианта документируйте допущения, условия лицензии, конкретную версию и то, что произойдёт при недоступности сервиса.
Сопоставляйте ID магазина, тип действия, нормализованные параметры, ID внешнего заказа и состояние обработки. При повторе сначала ищите результат. Для выбранного варианта документируйте допущения, условия лицензии, конкретную версию и то, что произойдёт при недоступности сервиса.
Для нестабильных интеграций используйте контролируемые повторы, диагностику ошибок и ручное разрешение неоднозначных операций. Для выбранного варианта документируйте допущения, условия лицензии, конкретную версию и то, что произойдёт при недоступности сервиса.
Если стандартного решения недостаточно, доработка интернет-магазина или интеграция оценивается по индивидуальному техническому заданию. Для Shopify, Shoptet и WordPress/WooCommerce агентство привлекает профильных партнёров. Наличие готового модуля не гарантирует, что он покроет все исключения.
Не вносите изменения в рабочие заказы без резервирования исходных данных и плана отката. Сначала подготовьте безопасные условные операции, согласуйте результаты, затем проверяйте поведение системы на соответствующей конфигурации.
Ниже условные значения и сценарии, подготовленные для согласования требований. Они не являются реальной историей клиента, измерениями трафика или обещанием универсальной совместимости. Каждый пункт должен получить отдельный фактический результат после теста.
В контрольном протоколе к каждому случаю добавляют входной идентификатор, шаг оператора, фактический ответ системы, журнал изменений, решение об исправлении и ответственное лицо. Важно сохранить тест до повторного запуска: повторяемость и отсутствие скрытых последствий важнее успешного зелёного сообщения в админке.
Приёмка невозможна без проверки отрицательных сценариев: отсутствующий идентификатор, повтор, обрыв сети, неверные права и попытка обработки неподходящих данных. Если правило зависит от учёта или условий договора, его подтверждает ответственный специалист.
Потребуются схема источника и приёмника, несколько обезличенных событий, API-документация, логи и номера дублированных заказов, условия тайм-аута, схема авторизации и тестовый доступ. Значения примеров условные.
Технические ограничения сверяйте по официальной документации; версия API, доступные права и тариф могут менять результат. Секреты авторизации и персональные сведения передаются только по безопасным каналам.
Техническая поддержка — 30 €/час, интеграции и разработка оцениваются индивидуально. Для оценки задачи пришлите ссылку на магазин и описание операции через контакты агентства. Ни срок внедрения, ни итоговые возможности конкретной системы без изучения доступа не обещаются.
Ключ повтора следует связывать с логической попыткой создать конкретный заказ, а не просто с датой или номером клиента. Сгенерированный новый UUID для каждой сетевой попытки не решает проблему: при тайм-ауте система всё равно создаст два заказа. В журнале полезно хранить ID исходного заказа, тип операции, контрольную подпись параметров, время, состояние и полученный внешний номер. Если внешний сервис реализует собственную идемпотентность, проверьте допустимый срок хранения ключа. Повторы за пределами этого срока могут требовать отдельной сверки.
Ошибка «не получили ответ» не доказывает, что операция не выполнена. Отправитель мог потерять связь уже после того, как внешняя система сохранила заказ или зарезервировала товар. В таком случае безопасный путь — сначала искать запись по стабильному ключу, а не сразу повторять создание. Если ответ сервера подтверждает ошибку валидации, повтор без исправления полей только нагрузит системы. В инструкциях сотрудникам следует явно различать состояния «ожидает», «результат неизвестен», «подтверждено» и «требует ручной проверки».
Две очереди интеграции иногда получают одно и то же событие одновременно. Простой запрос «есть ли заказ» с последующим созданием недостаточен, если оба исполнителя успевают увидеть пустой результат. Нужны согласованные гарантии уникальности и атомарного обновления на стороне ответственной системы. Проверяйте параллельные вызовы, различие параметров при старом ключе, повтор через сутки и недоступность внешнего поиска. В каждом тесте считайте не HTTP-ответы, а число реально созданных заказов и документов. Только после такой проверки можно доверять автоматическому восстановлению связи.