LogoLogo
CommunitySupport PortalYouTubeStart a free trial
  • Welcome
  • Commerce Engine
  • Orchestration Engine
  • API Documentation
  • Release Notes
  • Changelog
  • Commerce Engine
  • Getting Started
    • General Concepts of Emporix
    • Creating your first tenant
    • Developer Portal
      • Manage Users
      • Manage API Keys
      • Tenant List
      • My Account
      • Manage Showcase and Sample Data
  • Customer Use Cases
    • Commerce Use Cases
      • Quote Process
      • Orders
      • Coupons and Redeeming Rewards
      • Returns
      • Payments
      • User Management and Approvals
      • Customer Social Login
      • Personalized Commerce - Customer Segments
      • Company Shared Orders and Customer Groups
    • Automated Use Cases
      • First Registration Coupon
      • Availability and Warehouse Assignment
      • Quote and Order Entry Automation
  • System Management
    • Introduction
    • Authentication and Authorization
      • Identity and Access Management (IAM)
      • Auth0
      • Emporix Single Sign-On (SSO)
    • Webhook Event Publishing
      • HTTP Webhook Strategy - HMAC Configuration
      • HTTP Webhook Strategy - Integration with Azure Service Bus
      • HTTP Webhook Strategy - Integration with Amazon Simple Queue Service (SQS)
    • Search
      • Universal Search Connector
      • Search Configuration
      • Indexing Service
    • Optimistic Locking
  • Extensibility and Integrations
    • Extensibility Cases
      • External Products, Pricing and Fees
      • Enabling Custom Extensions
    • Integrations
      • SAP Integration
    • Payment Systems
      • PayPal
      • Saferpay
      • Spreedly Gateway
      • Unzer
    • Third Party Add-Ons
      • Emporix Contentful App
      • Emporix Builder.io Plugin
      • Magnolia Emporix Connector
      • Zendesk Emporix Connect
    • Powered by AI
      • AI Smart Config
      • AI Smart Import
  • Core Commerce
    • Introduction
    • AI Assistance
    • Carts
    • Catalogs
    • Categories
    • Coupons
    • Customer Management
      • Approvals
      • Assisted Buying
      • Customer Groups
      • Customer Segments
    • Data Localization
    • Delivery Cycle Management
    • Mixin Schemas
    • Media Management
    • Orders
      • Shared Orders
    • Pricing
      • Pricing (Legacy)
    • Products
      • Availability, location, and stock levels
      • Brands
      • Labels
    • Quotes
    • Returns
    • Reward Points Management
    • Sites
    • Tax Classes
      • Tax classes (Legacy)
    • Measurement Units
  • Management Dashboard
    • Introduction
    • Customer Management
      • Companies
      • Customers
      • Groups
      • Segments
      • Coupons
    • Quotes
      • Quotes
      • Status Codes
    • Orders
      • Orders
      • SEPA
      • Returns
    • Catalogs
      • Catalogs
      • Categories
    • Products
      • Products
      • Product Templates
      • Labels
      • Suppliers
      • Brands
      • AI for a Product Description
    • Pricing
      • Price Models
      • Price Lists
    • Settings
      • Sites
      • Shipping Zones and Methods
      • Delivery Times
      • Units
      • Tax
      • Countries
      • Currencies
      • Languages
      • System Preferences
      • Custom Entities
      • Mixin Schemas
    • Administration
      • Users and Groups
      • Extensions
      • API Statistics
      • Webhooks
    • Extensions
    • Custom Instances
  • Additional Resources
    • Glossary
    • Videos
    • Emporix Community
Powered by GitBook
LogoLogo

Resources

  • Emporix.com
  • Developer Policy
  • Terms of Use

Find us

  • LinkedIn

© 2025 Emporix. All Rights Reserved.

On this page
  • Prerequisites
  • Use case examples
  • Overall sample data upload
  • Single data uploads
  • Files samples to upload
  • Import type: products with media
  • Import type: catalogs
  • Import type: brands
  • Import type: categories
  • Import type: prices
  • Import type: availability
  • Troubleshooting

Was this helpful?

Export as PDF
  1. Extensibility and Integrations
  2. Powered by AI

AI Smart Import

Get up to speed with Emporix by using AI Smart Import to transfer the data to the system.

PreviousAI Smart ConfigNextIntroduction

Last updated 8 days ago

Was this helpful?

The AI Smart Import feature simplifies the process of uploading and integrating data, allowing you to import information related to brands, categories, catalogs, products, prices, product media, availability, tax and product category assignment. Leveraging AI capabilities, it automatically maps the data from uploaded files to the data structure used in the Emporix system.

You can upload data in both JSON and CSV formats, with JSON serving as the source object format. Our Generate Mapping functionality activates the AI to transform and align all object data from the file format to the schemas required by Emporix, ensuring a seamless and accurate data import process. The feature also supports mixins for enhanced flexibility.

If you want to use sample data import, you should do so before configuring your tenant. This is because sample data requires a basic tenant configuration, including the main site, en language, and a standard tax class. This configuration is applied automatically during the sample data upload, so if you configure your tenant first, your settings may be overwritten during the data upload.

Prerequisites

Use case examples

Overall sample data upload

As a customer, you want to explore sample data for your tenant configuration to see how your own data could be organized in the Management Dashboard.

  1. Go to the AI Smart Import and choose Sample data import. This action adds sample data to your tenant for brands, categories, catalogs, products, prices, product media, availability, tax and product category assignment.

  2. Check the respective nodes in your Management Dashboard and view the sample data that was uploaded.

When the sample data upload is finished, you see the Last import date column updated. Mapping is not applied as it relates to single data uploads and no import logs are kept. You can view the results of the sample data upload by going to relevant nodes in Management Dashboard.

Single data uploads

As a customer, you want to upload only the categories data to the Management Dashboard.

  1. In the AI Smart Import, you can see different objects that can be imported. To import categories data, choose the Go to arrow and open the Categories import view.

  2. Choose Upload file and select your file containing the categories data you want to import.

Check the examples of the files that can be uploaded for the AI:

  1. When you upload the file, all the objects from the file are visible as the Source Objects. In this case the file held object data for 9 categories. Using the arrows in the Source Object field you can switch between different object categories.

  2. Choose Generate Mapping, this starts the transformation of the objects to match the object data schema used at Emporix.

  3. In the Transformations field you can check which fields were changed.

    For example: supercategoryId from the file data was transformed to parentId to match object schemas. You can check the transformations for all the uploaded categories. You can review the generated object mapping.

  4. To keep your object mapping choose Save. If you don't want to import the categories now, you can get back to the configuration at a later point and finish the process with the current mapping saved.

When you get back later to the mapping, the source object, the transformed object data and the logs are no longer visible, but the mapping is still valid.

  1. To import the categories as they are mapped, choose Import file. This creates the categories structure in the Emporix system.

  2. When the process is complete, you can also check the logs in the Import Logs tab.

Files samples to upload

With the AI import, you can upload data separately for products, catalogs, brands, categories, prices and availability. See the files in the table for the correct upload file format with mapping examples:

Import type: products with media

Import type: catalogs

Import type: brands

Import type: categories

Import type: prices

Import type: availability

Troubleshooting

If an error occurs during the import process, you can prompt the AI to correct the mapping, with up to five attempts allowed. If the issue persists, select Generate Mapping again to restart the mapping process.

To adjust object parameters, you can ask the AI to make specific changes using prompts such as:

  • Map the code field to the ID field.

  • Add the FR language to every product if it's missing.

  • Correct the mapping for the Snacks category.

This allows for precise customization and ensures accurate data handling.

To use AI Smart Import in Emporix Management Dashboard, add the - https://emporix-ai-import.web.app/ in the Management Dashboard -> Administration -> node.

AI Smart Import extension
Extensions
3KB
AISmartImportCategories.csv
4KB
AISmartImportCategories.json
15KB
AISmartImportProduct.csv
20KB
AISmartImportProduct.json
1KB
product.mapping
3KB
AISmartImportCatalog.csv
4KB
AISmartImportCatalog.json
350B
catalog.mapping
1KB
AISmartImportBrands.csv
2KB
AISmartImportBrands.json
267B
brands.mapping
3KB
AISmartImportCategories.csv
4KB
AISmartImportCategories.json
381B
categories.mapping
1KB
AISmartImportPrice.csv
3KB
AISmartImportPrice.json
229B
price.mapping
650B
AISmartImportAvailability.csv
2KB
AISmartImportAvailability.json
251B
availability.mapping