Tax calculation requests now include merchant business entity information
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 01, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-04.
What changed
As of API version 2026-04, tax calculation requests sent to Tax Partner Apps include merchant business entity information. This provides details about the business entity responsible for a transaction, enabling tax partners to apply the appropriate tax rules. What's new Tax calculation requests now feature a new merchant_business_entity field at the root level of the request. This field includes the following details: id: The business entity Global ID, in the format gid://shopify/BusinessEntity/{id} company_name: The legal name of the business entity display_name: The display name of the business entity address: The business entity's address, including: country province Address lines (address1, address2) city zip The field is present only when the merchant has configured a business entity for the shop.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →