5. Integrate Omnitron & Integrator
Last updated
Was this helpful?
Last updated
Was this helpful?
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.
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.
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.
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.
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:
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.
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.
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.
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.
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.
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.
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:
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.
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.
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
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.
For step-by-step instructions on creating and configuring a catalog, refer to the tutorial.
For step-by-step instructions on creating and configuring attributes and attribute sets, refer to the tutorial.
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 tutorial.
While it’s possible to create and manage products manually, it’s strongly recommended to automate the process using the Integrator . This ensures real-time synchronization between your ERP system and Omnitron.
For step-by-step instructions on creating and configuring price lists, refer to the tutorial.
While this can be done manually, it's more efficient to use the Integrator , which pulls pricing information directly from your ERP.
For step-by-step instructions on creating and configuring stock lists, refer to the tutorial.
Use the Integrator to automate stock updates based on your ERP system. This avoids inconsistencies and ensures up-to-date inventory data.
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 documentation.
For step-by-step instructions on creating and configuring a payment option, refer to the tutorial.
For a complete list of available order status codes and their meanings, please refer to the .
Detailed instructions are available in the documentation.
See the and documentation for full setup guidance.
Follow the steps in the documentation to set up these delivery options based on the type of destination chosen.
Use the documentation to perform this task correctly.
