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

Почему публикация и работа устройства различаются

POS может хранить сборки расширений в кэше и работать без подключения. Новое поле shopify.extension.version показывает имя выполняемой версии — то же, что видно на странице Versions в Dev Dashboard. Оно доступно расширениям с API 2026-10; для более ранних версий поведение не меняется.

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

Что включить в обращение поставщику

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

Не сортируйте имена сборок как номера и не считайте большее значение более новым: Shopify прямо называет это непрозрачным именем. Сравнивайте точное совпадение с ожидаемым выпуском. У исполнителя должен быть собственный реестр, связывающий имя с датой и содержанием изменений.

Как проверить диагностику до релиза

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

Попросите разработчика показать оба случая: локальную разработку без имени и опубликованное расширение с ожидаемой версией. Затем включите сведения в доступный службе поддержки экран или журнал. Способ показа выбирает приложение; анонс не обещает готовую кнопку с номером релиза для каждого кассира.

Как использовать поле при проверке исправления

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

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