edit tax settings overview, add error code

Author: bc-andreadao

docs/store-operations/pricing/msf-international-enhancements.mdx

@@ -1,6 +1,6 @@
 # Price Lists - International Enhancements for Multi-Storefront
 
-<Callout>
+<Callout type="info">
   Tax-inclusive or exclusive price lists are in beta. Features may change based on user feedback or internal testing.
 </Callout>
 

docs/store-operations/tax/index.mdx

@@ -4,7 +4,7 @@ Tax settings allow you to choose how a store handles tax calculation and price d
 
 ## Estimate taxes and display prices based on tax zone
 
-The Tax Settings API supports cross-border transactions. You can localize storefront prices for shoppers from different regions. For example, you can display tax-inclusive or exclusive prices depending on the tax zone. This benefits single-storefront stores that sell to shoppers from different regions. This functionality applies to Stencil and GraphQL-powered storefronts.
+The Tax Settings API supports cross-border transactions. You can localize storefront prices for shoppers from different regions. For example, you can display tax-inclusive or exclusive prices depending on the tax zone. These global tax settings benefit single-storefront stores that sell to shoppers from different regions. If your store has multiple storefronts, see the [Price Lists - International Enhancements for Multi-Storefront](/docs/store-operations/pricing/price-lists-international-enhancements-for-multi-storefront) overview for price display settings. This functionality applies to Stencil and GraphQL-powered storefronts.
 
 To support cross-border transactions, the store identifies a tax zone for the shopper. The store then applies the tax zone and its settings to estimate taxes and display prices. For logged-in customers, the store uses the customer address to identify the tax zone. For guest shoppers, the store can use the shopper's geolocation to identify the zone if you enable this setting. Otherwise, the store uses the provided guest shopper tax zone ID.
 

reference/price_lists.v3.yml

@@ -81,7 +81,7 @@ paths:
         Returns a list of *Price Lists*. Optional parameters can be passed in.
 
         > #### Beta
-        > * The `prices_entered_with_tax` setting is in beta. Features may change based on user feedback or internal testing.
+        > * The `prices_entered_with_tax` setting is in beta.
         > * For more information on this setting, see [Price Lists - International Enhancements for Multi-Storefront](/docs/store-operations/pricing/price-lists-international-enhancements-for-multi-storefront).
       operationId: getPriceLists
       parameters:
@@ -271,7 +271,7 @@ paths:
         * name
 
         > #### Beta
-        > * The `prices_entered_with_tax` setting is in beta. Features may change based on user feedback or internal testing.
+        > * The `prices_entered_with_tax` setting is in beta.
         > * For more information on this setting, see [Price Lists - International Enhancements for Multi-Storefront](/docs/store-operations/pricing/price-lists-international-enhancements-for-multi-storefront).
       operationId: createPriceList
       parameters:
@@ -433,6 +433,32 @@ paths:
                       The error title describing the particular error.
                   type:
                     type: string
+        '400':
+          description: |
+            `prices_entered_with_tax` allowed values: `use_global`.
+          content:
+            application/json:
+              schema:
+                title: Error Response
+                type: object
+                properties:
+                  errors:
+                    title: Detailed Errors
+                    type: object
+                    properties: {}
+                    additionalProperties: true
+                  instance:
+                    type: string
+                  status:
+                    type: integer
+                    description: |
+                      The HTTP status code.
+                  title:
+                    type: string
+                    description: |
+                      The error title describing the particular error.
+                  type:
+                    type: string
     delete:
       tags:
         - Price Lists
@@ -478,7 +504,7 @@ paths:
         Returns a single *Price List*.
 
         > #### Beta
-        > * The `prices_entered_with_tax` setting is in beta. Features may change based on user feedback or internal testing.
+        > * The `prices_entered_with_tax` setting is in beta.
         > * For more information on this setting, see [Price Lists - International Enhancements for Multi-Storefront](/docs/store-operations/pricing/price-lists-international-enhancements-for-multi-storefront).
       operationId: getPriceList
       parameters:
@@ -565,7 +591,7 @@ paths:
         Updates a *Price List*.
 
         > #### Beta
-        > * The `prices_entered_with_tax` setting is in beta. Features may change based on user feedback or internal testing.
+        > * The `prices_entered_with_tax` setting is in beta.
         > * For more information on this setting, see [Price Lists - International Enhancements for Multi-Storefront](/docs/store-operations/pricing/price-lists-international-enhancements-for-multi-storefront).
       operationId: updatePriceList
       parameters: