5. Integrate Omnitron & Integrator

Before products can appear on your live site, you must first configure the catalog, product details, prices, stock information, payment, and shipping options in Omnitron. These configurations also enable data exchange between your ERP and Omnitron via Integrator Flows, ensuring real-time updates.

This section outlines the complete setup process—starting from catalog creation to address mapping—to ensure your products are ready for storefront.

1. Creating a Catalog

A Catalog is the foundational structure for managing products in Omnitron. It acts as a container that groups together product data, stock and price lists, and channel assignments. Every product you create, as well as its related configurations, must be assigned to a catalog to be published to the storefront.

Once the catalog is created:

• Products should be linked to this catalog.

• Price and stock lists should be associated.

• Sales channels should be assigned to this catalog to ensure proper product visibility.

Once the catalog is created, you can proceed with defining Attributes and Attribute Sets to describe your products in detail.

2. Creating Attributes and Attribute Sets

Before creating products, you need to define their characteristics. This is done through Attributes, which are specific properties like color, size, or material.

Once you have several attributes that logically belong together (e.g., size and color for clothing), you can bundle them into an Attribute Set. Attribute Sets make it easier to manage product structures and apply them consistently across similar product types or categories.

These elements not only help define your products clearly but also enable filtering and categorization in your storefront.

3. Creating Products

With your catalog and attributes and attribute sets in place, you can now begin creating products. Each product must be associated with a catalog and assigned an attribute set that reflects its characteristics.

To get started quickly, creating a Simple product type is enough for now. For detailed, step-by-step instructions on how to create and configure all product types, refer to the Product Types tutorial.

When creating a product, you will:

• Enter basic product information (name, SKU, base code, etc.).

• Select the appropriate attribute set.

• After entering basic product details and saving, a Product Pictures section will appear—upload at least one image. Images are mandatory for product visibility in storefront.

• Image Requirements & Limitations

  To ensure proper display and performance across all devices and channels, product images must meet the following requirements:

  • Accepted file formats: jpeg, jpg, png, gif, webp

  • Minimum requirement: At least one image must be uploaded per product.

  • Maximum dimensions: Image size is controlled by a dynamic configuration setting called MAX_IMAGE_DIMENSIONS, which ensures uploaded images do not exceed certain dimensions for performance and quality purposes.

    Default limits:

    Copy

    MAX_IMAGE_DIMENSIONS = {
      "WIDTH": 2000,
      "HEIGHT": 2000
    }

  If an uploaded image exceeds these dimensions, it may be automatically rejected or resized depending on system behavior and configuration.

  
• This way, the product you created will be listed in the Product Pool.

  

4. Creating a Price List

Every product must be assigned a price. To manage this, you first need to create a Price List in Omnitron. A price list can include multiple products, and each can have its own price within that list.

Key steps:

• Create a price list.

• Add product entries and define the selling price for each product.

5. Creating a Stock List

Just like pricing, stock availability is essential for product visibility and order processing. A Stock List defines the stock quantity of products and links them to a specific catalog and sales channel.

Key steps:

• Create a stock list.

• Add product entries and their available stock quantities.

6. Catalog Control and Assignments

The catalog configuration process includes multiple detailed steps—each of which must be followed carefully to ensure your products are correctly displayed in the storefront. From assigning products to catalogs, linking price and stock lists, setting categories, to final catalog validation and sorting—each task plays a critical role and must be completed carefully and thoroughly. Otherwise, even if your product configurations are technically correct, they may not be visible in the storefront.

1

Add Products to Catalog

On the Product List step, products are added to the catalog from the product pool.

• Products can be added individually or in bulk.

• If the Showing Added Products checkbox is selected, only unassigned products will be displayed.

• This step links products with the catalog.

2

Assign a Price List

From the Price List step, a relevant price list must be assigned.

• Without a price list, products won’t have pricing information and cannot be sold.

3

Assign a Stock List

Navigate to the Stock List step to assign a stock list to the catalog.

• Without stock data, products are considered unavailable.

4

Categorize Products

On the Categories step, the category tree is created, and products are assigned to categories.

• Category structure improves product discoverability and enhances product organization.

• For additional flexibility, product categorization can be done automatically using Auto Assign Rules, which allow bulk category assignments based on defined conditions. Explore more in the Product Categorization documentation.

5

Catalog Control (💡 The Most Critical Step)

The Catalog Control page is your final checkpoint to verify that all assignments are correctly made.

• After all assignments are made, apply the following filters on the product list section.

  • Catalog View: Only products with Catalog Filters and displays only the products that are linked to a catalog. This ensures that the product is part of a defined catalog structure and can be routed through sales channels.

  • Category View: Only products with Category Filters products that are assigned to a category. Products must belong to at least one category to be properly browsed and displayed on the storefront.

  • Price List View: Only products with Price List Displays products with a price defined via a price list. Without pricing, products cannot be purchased or shown with their price details.

  • Stock List View: Only products with Stock List Filters for products that have stock entries in the stock list. Products with no stock won’t be purchasable, even if visible.

  • Image: Exist Filters for products that have at least one image uploaded. As product images are mandatory for storefront visibility, this filter helps confirm visual completeness.

  
• After applying filters, if products do not appear in the product list, they will not show up in the storefront, even if all configurations are technically correct. It's essential to verify that everything is properly assigned to the correct catalog for products to be visible in the storefront.

6

Sorting

From the Sorting step, define how products should appear in each category or collection.

7

Assign Sales Channels

On the Sales Channels step, connect your catalog to the appropriate sales channels.

• Without a sales channel assignment, your catalog cannot go live in any store.

8

Configure Settings

In the Settings step, you can rename your catalog.

In summary, your catalog setup is only complete once all steps have been carefully followed and verified—especially via the Catalog Control page. Each configuration depends on the others, and skipping even one can result in products not appearing on the live site.

7. Creating a Payment Option

To enable order placement, at least one Payment Option must be configured in Omnitron. For a quick setup, we can define a Funds Transfer payment type.

As part of the configuration, a JSON config must be provided:

{"initial_order_status": "300"}

What does "initial_order_status": "300" mean?

This parameter defines the initial status the order will have immediately after it is created via this payment option.

• 300 → payment_waiting: The order has been received, but payment is still pending. The order remains on hold until the customer completes the payment process.

Then, define a bank account to be associated with Funds Transfer payment option:

• Create a bank

• Add an IBAN

This setup ensures that the payment method appears as an option during checkout.

8. Creating a Shipping Option

Shipping management requires defining both a Shipping Company and corresponding Shipping Options.

Steps include:

• Creating a shipping company with the correct ERP code (used as the slug in defining shipping option step).

• Defining a shipping option that references the company and includes calculator and rule, delivery time, etc.

These options determine how deliveries are calculated and presented to customers.

9. Creating a Delivery Option

Delivery Options define where products will be delivered, based on the customer's address, a retail store, or a pickup location. These options are crucial for managing the logistics flow, ensuring products are delivered to the correct destination.

You can configure delivery rules for:

• Customer's address

• Retail store delivery

• Pickup locations

10. Address Mapping

The final step before your products go live is configuring Address Mapping. This ensures that the geographical data from your ERP matches the address structure required by Omnitron.

By default, mappings for Turkey are preloaded. If you're operating in another country, you’ll need to manually map those addresses.

With these essential setups in place, you can now proceed with launching Project Zero to bring your products live and start selling.