Shopify Tax: управляемый режим вводит новые ограничения Admin API

Shopify Tax managed mode управляет настройками магазина и поведением API для корректного расчёта налогов при продажах в США. Теперь часть операций записи через Admin API проверяется на соответствие требованиям этого режима.

Что изменилось

Изменения затрагивают приложения, которые настраивают рынки, публикуют товары, создают пользовательские позиции в заказах или управляют оформлением чекаута — при условии, что магазин использует Shopify Tax managed mode. Изменения делятся на четыре категории: критические изменения, устаревание, новая возможность и уточнение поведения.

Мутации `marketCreate` и `marketUpdate` теперь отклоняют попытки переопределить обязательные настройки валюты и отображения налогов для затронутых рынков. Валидация применяется только к управляемым мерчантом нерозничным рынкам, включающим США; рынки без США, розничные и управляемые третьими сторонами — не затронуты. Изменение действует во всех поддерживаемых версиях API, включая `unstable`. Запросы, не передающие `currencySettings` или `priceInclusions`, остаются без изменений.

Поле `taxable` в пользовательских позициях черновых заказов и редактирования заказов объявлено устаревшим — вместо него следует использовать `productCategoryId`. Одновременно добавлена возможность назначать категории товаров таким позициям. Управление видимостью футера чекаута теперь явно ограничено контентом, настраиваемым мерчантом, и не распространяется на транзакционную информацию от Shopify.

На что обратить внимание

Запросы, уже соответствующие требованиям managed mode или не передающие затронутые поля, продолжают работать без изменений. Запросы, пытающиеся переопределить требования режима, могут возвращать ошибки валидации. Магазины, не использующие Shopify Tax managed mode, не затронуты даже при наличии продаж в США.