# Sites

In the Emporix e-commerce system, a site represents a specific shop, warehouse, or another independent facility.

You can create multiple sites depending on your business needs, such as in the following scenarios:

* You own stores in multiple locations, where each store handles a different delivery area.
* You own stores in multiple locations, where taxes vary between each location.
* You own stores in multiple locations, where delivery options vary between each location.

You can manage your sites through the Emporix API Site Settings Service.

{% hint style="info" %}
For more information, see also:

* API Tutorial [Site Settings Service Tutorial](/api-references/api-guides/configuration/site-settings-service/site-settings.md)
* API Reference [Site Settings Service Service](/api-references/api-guides/configuration/site-settings-service.md)
* Multi-sites setup [Multi-site Architecture](/api-references/quickstart/multisites.md)
  {% endhint %}

## Properties

By default, each site is described by the following properties:

* Currency
* Default language
* Home base from which products are shipped
* Flag indicating whether the site is active
* Flag indicating whether the site is your business's default site
* Flag indicating whether prices assigned to the site are expressed as gross or net values
* List of countries that the site ships products to
* List of supported languages
* Name
* Unique site code

## Custom attributes

You can use [mixins](/api-references/standard-practices/mixins.md) to configure custom site attributes.

{% hint style="info" %}
See also the [How to add custom attributes to a site](/api-references/api-guides/configuration/site-settings-service/site-settings.md#how-to-add-custom-attributes-to-a-site) guide.
{% endhint %}

Predefined mixins available in the Emporix e-commerce system are described in the table below.

| Mixin name                | Purpose                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Coupon settings           | Defines settings for regular, referral, and reward points coupons.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Customer settings         | <p>Defines regular expressions which validate the following customer account information:</p><ul><li>Account password</li><li>Bank account owner's name</li><li>BIC</li><li>Email address</li><li>Phone number</li></ul>                                                                                                                                                                                                                                                                                                                                                                         |
| Debit settings            | <p>Specifies your business's financial information needed to enable direct debit payments on your storefront.</p><p><span data-gb-custom-inline data-tag="emoji" data-code="2139">ℹ️</span> <mark style="background-color:blue;">See:</mark> <a href="/spaces/d4POTWomuSS7d3dnh4Dg/pages/uvdxQzJkU6EcCd6YZYH1#how-to-set-up-direct-debit-payments"><mark style="background-color:blue;">How to set up direct debit payments</mark></a><mark style="background-color:blue;">.</mark></p>                                                                                                          |
| Delivery process settings | Defines settings related to delivery, such as expected time for a delivery vehicle to spend at one stop.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| General shop settings     | Specifies business information related to your storefront, such as the business's brand name, logo, or Facebook page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Image size                | Defines image resolutions for desktop, tablet, and mobile versions of your storefront.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Linkable pages            | Specifies relations between pages on your storefront and in your Content Management System.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Maps API key              | Specifies your Google Maps API key.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Merchant address          | Specifies your business's address information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Merchant information      | <p>Specifies your business's information such as company address, contact information, or financial information.</p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <mark style="background-color:red;">You need to configure your merchant information if you want to enable direct debit payments on your site.</mark></p>                                                                                                                                                                                                                                          |
| Order process settings    | <p>Defines settings related to checkouts, orders, payments, and delivery.</p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <mark style="background-color:yellow;">Emporix e-commerce system supports the following payment methods:</mark></p><ul><li>Cash</li><li>Credit card</li><li>Direct debit</li><li>Invoice</li></ul><p><br>See: <a href="/spaces/d4POTWomuSS7d3dnh4Dg/pages/uvdxQzJkU6EcCd6YZYH1#how-to-enable-payment-methods">How to enable payment methods</a>.</p>                                                                                     |
| Pickup settings           | Specifies addresses where customers can pick up their orders.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Product settings          | <p>Specifies custom packaging and cutting options for products.</p><p><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> <mark style="background-color:blue;">Examples of custom packaging options include paper, vacuum, or loose packaging.</mark></p><p><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> <mark style="background-color:blue;">Custom cutting options are often used for grocery-related products. Examples of custom preparation options include cutting options such as slices or preparation options such as marinade.</mark></p> |
| Template settings         | Defines conditions for templates used by your business.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

## Site-specific resources

Resources are configured either globally or on the site level. The following resources need to indicate a site that they apply to:

* Carts
* Delivery-related information:
  * Groups
  * Fees
  * Methods
  * Time windows
  * Zones
* Orders
* Payment methods
* Picklists and packlists
* Pickup points
* Product-related information:
  * Availabilities
  * Physical locations on sites
  * Promotions
  * Prices
  * Stock levels
  * Tax rates
* Shipping services

{% hint style="success" %}
You can enable site permissions feature that limits visibility of restriction-aware entities, such as company (legal entity), customer, cart, order, and quote for employees. Site code values serve as a tool to determine access to these entities for employee groups. Learn more in the [Site Permissions](/ce/system-management/authentication-and-authorization/authorization/site-permissions.md) guide.

If you're interested in the recommended sites and data setup, check out the [Multi-site Architecture](/api-references/quickstart/multisites.md) guide.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/ce/core-commerce/sites.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
