В Admin GraphQL API 2026-10 Shopify добавил историю вычисления контекстной цены варианта товара. Она помогает разработчику интеграции объяснить последовательность корректировок. Возможность анонсирована 17 сентября 2026 года и не изменяет сама по себе действующие цены магазина.

Что можно получить из истории

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

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

Пустая история не означает отсутствие корректировок

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

Поэтому сначала установите контекст цены отдельной проверкой, затем изучайте последовательность вычисления. Если список пуст, запишите именно это ограничение. Вывод «наценок нет» по одному пустому ответу будет необоснованным. Для покупателя по-прежнему важна фактическая цена в нужном сценарии оформления.

Как построить сверку для команды

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

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

Как принять объяснение расхождения

Подрядчик должен связать ответ API с проверенным контекстом и показать, что итог воспроизводится. Затем команда решает, соответствует ли он коммерческому намерению. Правильная арифметика может реализовывать неподходящее для магазина правило.

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