Мы используем файлы cookie для работы сайта, аналитики и рекламы. Вы можете принять, отклонить или настроить их.

Настройки файлов cookie

Обязательные файлы cookie используются для корректной работы сайта и всегда включены. Аналитические и маркетинговые файлы cookie используются только с вашего согласия.


Условия | GDPR | Файлы cookie

Обязательные файлы cookie

Всегда включены. Эти файлы cookie необходимы для работы сайта и его основных функций. Их нельзя отключить.

Аналитические файлы cookie

Disabled

Эти файлы cookie используются для сбора обезличенной статистики о посещаемости сайта (например, Google Analytics), чтобы улучшать работу сайта. Они устанавливаются только с вашего согласия.

Маркетинговые файлы cookie
Disabled
Эти файлы cookie используются для показа персонализированной рекламы и измерения эффективности рекламных кампаний (например, Meta / Facebook Pixel). Они устанавливаются только с вашего согласия.
Блог RU
Повторный запрос интеграции использует один ключ заказа и не создаёт дубль.
Интернет-магазины

Интеграция повторно создаёт заказы в магазине: как организовать ключ операции и безопасный повтор

Интеграция отправила заказ во внешнюю систему, но не получила ответ. Автоматически повторив запрос, она создала второй заказ с новым номером. Для покупателя это может означать двойную обработку, для склада — лишнее резервирование. Проблема не в скорости сети, а в отсутствии устойчивой связи между логической операцией и её повторной отправкой. Нужны идентификатор операции, подтверждение результата и журнал сверки.

Идемпотентность операции заказа — не то же самое, что уникальность SKU, ключ импорта товаров или защита формы от двойного клика. Важно определить, что два сетевых вызова означают одну бизнес-операцию, а два отдельных заказа одного человека могут быть действительно разными.

Причины и границы диагностики

Прежде чем менять текущие настройки или код, зафиксируйте воспроизводимый пример, его исходные данные и правильное поведение. Разделите ошибку интерфейса, ошибку передачи данных и неверное бизнес-правило. Изучайте не только успешный путь, но и отмену, повтор, недостаток прав и отсутствие ответа внешнего сервиса.

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

Варианты решения

Ключ идемпотентности поддерживаемого API

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

Собственный реестр операций

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

Очередь и процесс сверки

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

Если стандартного решения недостаточно, доработка интернет-магазина или интеграция оценивается по индивидуальному техническому заданию. Для Shopify, Shoptet и WordPress/WooCommerce агентство привлекает профильных партнёров. Наличие готового модуля не гарантирует, что он покроет все исключения.

Порядок подготовки и реализации

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

  1. Присвойте каждой бизнес-операции один стабильный идентификатор, независимый от количества сетевых попыток.
  2. Зафиксируйте состав параметров заказа; изменённые товары или сумму не отправляйте как незаметный повтор прежней операции.
  3. До отправки создайте запись операции в журнале с состоянием ожидания и ссылкой на заказ магазина.
  4. При успешном ответе сохраните внешний ID атомарно либо предусмотрите проверяемую процедуру восстановления.
  5. При тайм-ауте сначала выясните фактический результат по ключу операции или поиску внешнего заказа.
  6. Ограничьте повторные отправки и отделите временную сетевую ошибку от постоянной ошибки бизнес-валидации.
  7. Разработайте экран или выгрузку сверки для операций с неизвестным исходом и права ручного исправления.

Практический разбор

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

  1. Связь оборвалась до передачи запроса — повтор с тем же ключом должен создать ровно одну запись, если API допускает повтор.
  2. Сервер сохранил заказ, но ответ потерялся — повтор должен вернуть уже существующий результат, а не создать дубль.
  3. Ответ пришёл, но локальное сохранение external_id не состоялось — перед созданием нового заказа нужна сверка по ключу.
  4. Два исполнителя параллельно взяли одно событие — блокировка или атомарное условие исключает двойную запись.
  5. Первый запрос содержит две позиции, повтор — одну: это изменение операции, его нельзя скрывать под прежним ключом.
  6. Внешний API не поддерживает идемпотентность — используется собственная таблица сопоставления, проверки и согласованный режим восстановления.
  7. Сотрудник вручную перезапускает задачу — интерфейс предлагает проверить существующий внешний номер и журнал.
  8. Повторный webhook приходит через час — обработчик распознаёт старый event ID и не делает второе списание.

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

Что считается завершённой работой

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

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

Материалы для оценки и источники

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

Технические ограничения сверяйте по официальной документации; версия API, доступные права и тариф могут менять результат. Секреты авторизации и персональные сведения передаются только по безопасным каналам.

Техническая поддержка — 30 €/час, интеграции и разработка оцениваются индивидуально. Для оценки задачи пришлите ссылку на магазин и описание операции через контакты агентства. Ни срок внедрения, ни итоговые возможности конкретной системы без изучения доступа не обещаются.

Стабильный идентификатор и жизненный цикл операции

Ключ повтора следует связывать с логической попыткой создать конкретный заказ, а не просто с датой или номером клиента. Сгенерированный новый UUID для каждой сетевой попытки не решает проблему: при тайм-ауте система всё равно создаст два заказа. В журнале полезно хранить ID исходного заказа, тип операции, контрольную подпись параметров, время, состояние и полученный внешний номер. Если внешний сервис реализует собственную идемпотентность, проверьте допустимый срок хранения ключа. Повторы за пределами этого срока могут требовать отдельной сверки.

Разделите неизвестный результат и неуспех

Ошибка «не получили ответ» не доказывает, что операция не выполнена. Отправитель мог потерять связь уже после того, как внешняя система сохранила заказ или зарезервировала товар. В таком случае безопасный путь — сначала искать запись по стабильному ключу, а не сразу повторять создание. Если ответ сервера подтверждает ошибку валидации, повтор без исправления полей только нагрузит системы. В инструкциях сотрудникам следует явно различать состояния «ожидает», «результат неизвестен», «подтверждено» и «требует ручной проверки».

Как проверить конкурентные повторы

Две очереди интеграции иногда получают одно и то же событие одновременно. Простой запрос «есть ли заказ» с последующим созданием недостаточен, если оба исполнителя успевают увидеть пустой результат. Нужны согласованные гарантии уникальности и атомарного обновления на стороне ответственной системы. Проверяйте параллельные вызовы, различие параметров при старом ключе, повтор через сутки и недоступность внешнего поиска. В каждом тесте считайте не HTTP-ответы, а число реально созданных заказов и документов. Только после такой проверки можно доверять автоматическому восстановлению связи.