Shopify добавила результат отмены заказа в API: как отличить запрос от завершения
Shopify добавила jobResult для асинхронной отмены заказа. Как проверить завершение, обработать ошибку и передать поддержке понятный статус.
Содержание статьи
В API Shopify 2026-10 появился отдельный результат отмены заказа — jobResult. Обновление объявлено 1 октября и помогает приложению проверить, завершилась ли асинхронная отмена успешно. Для поддержки магазина это возможность точнее разделять полученную просьбу, выполняемую операцию и подтверждённый итог.
Что добавлено к прежнему ответу
Поле jobResult метода orderCancel имеет тип OrderCancelJobResult и содержит сведения о статусе отмены, ошибках и затронутом заказе. Прежнее общее поле job осталось без изменений. Shopify не требует срочно переделывать существующие интеграции, которые продолжают использовать его.
Новая информация полезна там, где приложение раньше могло показать только общий технический статус задания. Но добавление поля не означает, что любой запрос на отмену теперь обязательно выполнится. Ошибку нужно обработать и объяснить сотруднику, а конечное состояние — связать с нужным заказом.
Как описать процесс для поддержки
Редакция рекомендует выделить отдельные состояния рабочего обращения: просьба получена, операция запущена, результат проверен. Это внутренняя организация работы, а не новые названия статусов Shopify. Сотрудник должен понимать, что уже произошло и что ещё нельзя обещать покупателю.
Не смешивайте полную отмену с запросом на изменение отдельных позиций. У этих процессов разные цели. Перед запуском следует сверить номер заказа и пожелание клиента, иначе технически корректный метод может выполнить не то действие, которое ожидалось.
Что проверить в интеграции
Составьте сценарии успешного завершения, ошибки и временно неизвестного результата. В каждом проверьте, что видит сотрудник и какое действие ему предлагается дальше. Один зелёный HTTP-ответ не должен превращаться в сообщение покупателю об отмене без проверки конечного результата.
Для неопределённого исхода заранее согласуйте порядок повторной проверки. Не отправляйте повторные операции автоматически только из-за задержки интерфейса. Сначала выясните состояние исходного задания и заказа. Точный механизм обращения к API выбирает разработчик по документации, а магазин задаёт ожидаемое поведение процесса.
Как принять изменение приложения
Приложите к результату теста идентификатор заказа, версию API, сведения о выполненном задании и окончательное состояние. Финансовые и операционные последствия проверяйте в соответствующих системах: новое поле описывает отмену, но само объявление не даёт универсальной гарантии по каждому связанному процессу магазина.
После выпуска посмотрите очередь обращений, которые долго остаются без результата. У каждого должно быть понятное основание ожидания и ответственный. Польза обновления проявляется в том, что поддержка может доказать завершение или передать конкретную ошибку, а не сообщать покупателю об успехе по факту отправленного запроса.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы