> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Ecommerce Settings

# Type: Ecommerce Settings Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/ecommerce-settings/ecommerce-settings-object.md

## Description: eCommerce settings are a read-only snapshot of how a site's eCommerce is set up, collected from the APIs that own each value.
Each field is returned only when it's requested in `fields` and retrieved successfully.

## Schema:

```json
 Type: Ecommerce Settings Object | type: EcommerceSettings
 Description: eCommerce settings are a read-only snapshot of how a site's eCommerce is set up, collected from the APIs that own each value.
Each field is returned only when it's requested in `fields` and retrieved successfully.
       - name: additionalFeesServicePlugin  | type: ServicePluginConfiguration | description: Additional Fees service plugin configuration.
           - name: activeProviders  | type: Array<ActiveProvider> | description: Apps that implement the service plugin and are active on the site.
               - name: appId  | type: string | description: App ID of the provider.
               - name: triggerFlows  | type: Array<TriggerFlow> | description: Flows that trigger the provider.
       - name: validationsServicePlugin  | type: ServicePluginConfiguration | description: Validations service plugin configuration.
       - name: purchaseRecommendationsServicePlugin  | type: ServicePluginConfiguration | description: Purchase recommendations service plugin configuration.
       - name: tax  | type: TaxConfiguration | description: Tax configuration.
           - name: configured  | type: boolean | description: Whether the site has at least one tax region. Learn more about the [Tax Regions API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/introduction.md).
               - name: value  | type: boolean | description: 
           - name: taxIncludedInItemPrices  | type: boolean | description: Whether tax is included in item prices. Learn more about [tax inclusion in item prices](https://support.wix.com/en/article/including-tax-in-the-product-price).
       - name: discountRules  | type: DiscountRulesConfiguration | description: Discount rules configuration.
           - name: active  | type: boolean | description: Whether at least one discount rule that applies automatically is active now. A rule counts when it's active and the current time is within its active time frame, if it has one. Learn more about the [Discount Rules API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts/discount-rules/introduction.md).
       - name: checkout  | type: CheckoutSettings | description: Checkout settings. Learn more about the [Checkout Settings API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/settings/checkout-settings/introduction.md).
           - name: checkoutPolicies  | type: CheckoutPolicies | description: Checkout policies.
               - name: termsAndConditions  | type: TermsAndConditionsPolicy | description: Terms and conditions.
               - name: privacyPolicy  | type: PrivacyPolicy | description: Privacy policy.
               - name: returnPolicy  | type: ReturnPolicy | description: Return policy.
               - name: digitalItemPolicy  | type: DigitalItemPolicy | description: Digital item policy.
               - name: contactUs  | type: ContactUsPolicy | description: "Contact us" information.
               - name: customPolicy  | type: CustomCheckoutPolicy | description: Custom policy.
           - name: checkoutFields  | type: CheckoutFields | description: Settings that apply to checkout fields and the checkout process.
               - name: subscriptionCheckbox  | type: SubscriptionCheckboxField | description: Subscription checkbox. <br><br>  Controls the marketing consent checkbox shown to the buyer at checkout. By default, a single checkbox lets the buyer opt in to both email and SMS marketing at once. When `subscriptionCheckbox.splitByChannel` is `true`, checkout instead shows two separate checkboxes - one for email, one for SMS - so the buyer can opt into each channel independently.
               - name: policyAgreementCheckbox  | type: CheckboxField | description: Policy agreement checkbox. <br><br>  Defaults: + `visible`: `false` + `checkedByDefault`: `false`
               - name: giftCardRedeemEnabled  | type: boolean | description: Whether the ability to redeem a gift card is enabled. <br><br>  Default: `false`
               - name: mitEnabled  | type: boolean | description: Whether to allow for MIT transactions. <br><br>  Default: `false`
               - name: delayCaptureEnabled  | type: boolean | description: Whether to allow for Auth & Capture transactions. <br><br>  Default: `false`
               - name: captureBeforeExpiryEnabled  | type: boolean | description: Whether to automatically capture the transaction before the authorization expires.  Default: `true` >**Note:** this setting is only relevant when `delay_capture_enabled: true`.
           - name: checkoutBrand  | type: CheckoutBrand | description: Checkout brand settings.
               - name: header  | type: CheckoutHeader | description: Checkout header.
               - name: mainSection  | type: CheckoutMain | description: Main checkout area branding.
               - name: footer  | type: CheckoutFooter | description: Checkout footer branding.
               - name: global  | type: CheckoutGlobal | description: Global checkout branding.
           - name: createdDate  | type: string | description: Date and time the checkout settings were created.
               - name: seconds  | type: string | description: 
               - name: nanos  | type: number | description: 
           - name: updatedDate  | type: string | description: Date and time the checkout settings were updated.
           - name: checkoutBillingFields  | type: string | description: Billing information required to complete the checkout.
               enum: All_FIELDS, MINIMUM_REQUIRED_FIELDS
       - name: delivery  | type: DeliveryConfiguration | description: Destinations the site delivers to, and their delivery properties.
           - name: countries  | type: Array<CountryDeliveryProperties> | description: Countries the site delivers to, with their delivery destination properties.  When `restOfWorld` isn't returned, a country without `deliveryDestinationProperties` is delivered to only in the subdivisions listed in its `subdivisions`.
               - name: country  | type: string | description: 2-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
               - name: deliveryDestinationProperties  | type: DeliveryDestinationProperties | description: Delivery destination properties for the country.
               - name: subdivisions  | type: Array<SubdivisionDeliveryProperties> | description: List of subdivisions and their delivery destination properties.
           - name: restOfWorld  | type: DeliveryDestinationProperties | description: Delivery destination properties for every destination that `countries` doesn't cover: countries that aren't listed, and unlisted subdivisions of a country without `deliveryDestinationProperties`.  Returned only when the site delivers to the rest of the world.
               - name: postalCodeRequired  | type: boolean | description: Whether a postal code is required for delivery to this destination.
               - name: pickupOnly  | type: boolean | description: Whether only pickup is available at this destination.
       - name: premiumSite  | type: boolean | description: Whether the site has a premium plan that supports accepting payments.
       - name: businessInfo  | type: BusinessProperties | description: Business information, such as the business name, address, and contact details.
           - name: currency  | type: string | description: Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. Payment currency for the business (default is 'USD').
           - name: language  | type: string | description: Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. Used by the business for site content, emails, notifications, etc (default is 'en').
           - name: locale  | type: Locale | description: Locale for date, number, and measurement formatting (default is `en-US`).
               - name: language  | type: string | description: Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
               - name: country  | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format.
           - name: address  | type: Address | description: Physical address of the business.
               - name: country  | type: string | description: Country code.
               - name: subdivision  | type: string | description: Subdivision code in ISO 3166-2 format, e.g., "US-NY".
               - name: city  | type: string | description: City name.
               - name: postalCode  | type: string | description: Zip/postal code.
               - name: streetAddress  | type: StreetAddress | description: Street name and number.
               - name: addressLine  | type: string | description: Main address line, usually street and number as free text.
           - name: name  | type: string | description: Business name.
               - name: value  | type: string | description: 
           - name: email  | type: string | description: Business email address.
           - name: phone  | type: string | description: Business phone number.
           - name: fax  | type: string | description: Business fax number.
           - name: logo  | type: string | description: Path to the business logo in Wix Media.
           - name: timeZone  | type: string | description: Business time zone.
           - name: siteDisplayName  | type: string | description: Site display name.
       - name: businessLocale  | type: BusinessLocale | description: Business locale: currency, language, locale, weight unit, and unit system.
           - name: currency  | type: string | description: Currency the business accepts payments in. Three-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format.  Default: `USD`
           - name: language  | type: string | description: Language the business uses for site content, emails, and notifications. Two-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.  Default: `en`
           - name: locale  | type: Locale | description: Locale for date, number, and measurement formatting.  Default: `en-US`
           - name: weightUnit  | type: string | description: Weight unit, based on locale.
               enum: UNSPECIFIED_WEIGHT_UNIT, KG, LB
           - name: unitSystem  | type: string | description: Unit system, based on locale.
               enum: IMPERIAL, METRIC

```