Creating your first tenant

Create your first tenant.

The first step in the e-commerce system is creating a tenant. A tenant represents a business subscription to our services and is required to access the following products:

The first step in the Emporix e-commerce system is creating a tenant. A tenant represents a business subscription to our services and is required to access the following products:

• Emporix API — the core of our e-commerce system.

• Emporix Developer Portal — a platform where you can manage your tenants, team members, and Emporix API access credentials.

• Emporix Management Dashboard — a content management system where you can manage your business resources related to product management, marketing, order fulfillment, and more.

Free trial You can try out the e-commerce features completely free of charge for 14 days. With the free trial, you get full access to the production-ready e-commerce system, so you can test all of its functionalities before you decide to become our partner.

What are the differences between a free trial and a paid plan?

Apart from the free trial being time-limited, there are no differences between free trials and paid plans — both operate in production environments. This approach brings the following benefits:

• Full experience of the e-commerce system during the free trial.

• Easy migration from a free trial to a paid plan (your data remains in the system).

When your free trial ends, the sales team will contact you to hear about your experience with our products.

Setting up a first tenant

You can create and configure a tenant through the Emporix Developer Portal.

Creating an account

To set up an Emporix tenant, create an account in the Developer Portal. The following registration methods are available:

• Password-based authentication

• Single sign-on (requires additional configuration of an Identity Provider service, to learn more see Single Sign-On)

• Social login with the following platforms:

  • Google

  • LinkedIn

  • Microsoft

When creating an account on the Developer Portal, you need to use a business email address. Email addresses registered to public domains are rejected by the registration form.

Registering an account gives you the ADMIN permissions in the Developer Portal and in the Management Dashboard.

Once you create an account, you can start creating a tenant straightaway.

Alert for Unrecognized Browser Logins

There is a security feature implemented in our system to enhance the protection of your account. Whenever a login attempt is made from an unrecognized browser or device, an alert email is automatically generated and sent to the email address associated with your account.

This alert email is designed to promptly notify you of any login activities that may be unauthorized or suspicious. If you receive such an alert email and you haven't recently logged in or attempted to access your account from a new browser or device, we strongly advise you to take immediate action to secure your account. This includes changing your password and reviewing your account activity, as well as reporting this fact to your organization.

Note that the alert feature works for email and password logins, while for social logins through external platforms, it has to be configured separately by the provider.

Creating a tenant view:

Choosing a tenant name

A tenant name is its unique identifier in the Emporix e-commerce system. To call any Emporix API endpoint, you need to pass the tenant name in the form of a path parameter. When coming up with a name for your tenant, your business name is usually a good choice.

Your tenant name must fulfill the following criteria:

• It must start with a letter.

• It must be between 3 and 10 characters long.

• It can only contain lowercase letters (without diacritics) and numbers.

Selecting a language

Specify the language in which your business communicates with suppliers and customers.

When creating a tenant, you can choose one of the following languages:

• English

• German

Select one of the available languages. Once your tenant is ready, you'd be able to change the selected language or add multiple languages for your tenant by using the Emporix API or Management Dashboard.

To learn more about language configurations, check out the Language Configuration guide.

Selecting a currency

Your tenant's currency configuration specifies which currencies are accepted by your business.

When creating a tenant, you can choose one of the following currencies:

• EUR — Euro

• GBP — Pound sterling

• NOK — Norwegian krone

• USD — United States dollar

The currency chooser on the lists the currencies most commonly used by our partners and allows you to select a single currency only. However, you can add any currency or set up multiple currencies for your tenant with the help of Emporix API.

To learn more about currency configurations, check out the Currency guide.

Including OE

If you plan to use the OE for automating workflows and business processes, you can select the Include OE option to get access to the full potential of Commerce Orchestration Platform.

Subscribing to the newsletter

Stay up-to-date with the latest news about our products and services.

Creating a tenant

Once you fill out the form, choose Create a tenant and wait a couple of minutes for your tenant to finish setup. When your tenant is ready, you are redirected to its dashboard on the Emporix Developer Portal. Check your inbox, as you should receive the confirmation email.

Out-of-the-box configuration

Once your tenant is ready, you get immediate access to various resources.

Emporix API

The Emporix API is the core of the e-commerce system. With the API, you can easily manage your business resources.

To prevent unauthorized access to your business sensitive data, your tenant is provided with different API credentials:

• Emporix API — used to access the API from a business owner's perspective.

• Storefront API — used to access the API from a customer's perspective. These credentials are used to perform basic actions on a storefront — browse products, view prices, or add products to cart.

• Custom API - build your custom scopes to access different services and assign permissions to the users

You can access your tenant's API credentials in the API Keys section of the Developer Portal.

To learn more about our API, check out the Getting started with Emporix API.

Sample data

To make onboarding easier, some of the resources are automatically configured with sample values.

If you want to check specific values configured for your tenant, you need to call the API endpoints referenced in the table.

Resource	Data available out-of-the-box	API endpoint
Categories	ProductRoot — top-level container for all product categories Two sample product categories	Retrieving a list of categories
Global (tenant-wide) configurations	Country, currency, and language configuration Email settings Measurement units' conversion factors Order statuses Product availability information Product packaging options Product tax classes Storefront URLs	Retrieving configurations
Measurement units	Set of most commonly used measurement units.	Finding units by filters with sorting and paging
Site settings	Main site with a set of basic settings, such as: Default and supported languages Delivery timeframes Supported countries Payment methods Product packaging options Regular expressions for customers' account information Restrictions on order placements Storefront image sizes	Retrieving a site

External applications

To improve your customers' shopping experience, you can enable an external application for search and indexing. Check out Search Configuration and Indexing Service documentation.

Indexing of your tenant's data in Algolia is disabled by default. If you want to enable this functionality, reach out the Support Team.

Performance tests

To ensure good system performance for all our partners, we need to know in advance if you plan to run any load, stress, or other types of performance tests on your tenant. In such cases, contact the Support Team.