# 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](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/site-settings-service/site-settings)
* API Reference [Site Settings Service Service](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/site-settings-service)
* Multi-sites setup [Multi-site Architecture](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/quickstart/multisites)
  {% 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](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/standard-practices/mixins) to configure custom site attributes.

{% hint style="info" %}
See also the [How to add custom attributes to a site](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/site-settings-service/site-settings#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="https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/site-settings-service/site-settings#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="https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/configuration/site-settings-service/site-settings#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](https://developer.emporix.io/ce/system-management/authentication-and-authorization/authorization/site-permissions) guide.

If you're interested in the recommended sites and data setup, check out the [Multi-site Architecture](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/quickstart/multisites) guide.
{% endhint %}
