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