# amasty/module-import-core

> Import Core by Amasty

`composer require amasty/module-import-core`

Canonical URL: https://packagento.com/amasty/module-import-core

## At a glance

- **Vendor**: amasty (https://packagento.com/amasty.md)
- **Latest version**: 1.12.2 — released 2025-11-10
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/amasty/module-import-core and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require amasty/module-import-core:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Import Core by Amasty

## README

<h3>Note:  This free solution version is offered to let you evaluate our code quality. It does not include ready-made entities such as products, orders, and customers, which are necessary for using the import/export functionality. To run imports, you will need to either create these entities yourself if skilled or purchase the full solution version on our website.
</h3>
<p>The package presented is a free version of the import solution for Magento 2. Install together with the <a href="https://github.com/AmastyLtd/module-export-core" target="_blank">Export Core</a> and <a href="https://github.com/AmastyLtd/module-import-export-core" target="_blank">Import\Export Core</a> to see the full scope of data transfer features between multiple platforms. The code and architecture are the same as in the original paid <a href="https://amasty.com/import-and-export-for-magento-2.html" target="_blank">Import and Export for Magento 2</a> extension but the core includes core functionality only and is suitable for manual data transfer. See the full scope of automatization features and entities available in the paid version <a href="https://export-extensions-m2.magento-demo.amasty.com/admin/amorderimport/profile/index/" target="_blank">in this demo</a> or <a href="https://calendly.com/yuliya-simakovich/book-a-demo" target="_blank">book a live demo</a> with the Amasty team to get a real-time consultation.</p>

![import-and-export-premium-key-features](https://github.com/AmastyLtd/module-import-core/assets/104132415/cc0b952b-24b0-4438-8db4-f91d6fd09d8e)


The paid version can be purchased as Lite, Pro and Premium packages. <a href="https://amasty.com/import-and-export-for-magento-2.html#choose_option" target="_blank">Visit our website</a> to see the pricing plans. A free package is the Lite version of the full <a href="https://amasty.com/import-and-export-for-magento-2.html" target="_blank">Import and Export for Magento 2</a> extension, but without ready-made entities for migration.

<h2>What is the Core package for?</h2>
<p>Import Core is used to upload data to the Magento 2 platform. The extension is built from scratch and has no intersections with the native import/export functionality developed by Magento itself. Even though a <b>free package does not include any ready-made entities</b> for import jobs, you can create compatibility with any entity you need and add them to the migration functionality available.</p>
<h2>Free version features</h2>
<p>The package helps you to:</p>
<ul>
<li><b>Perform manual one-time import of any entity:</b> the solution adds a separate interface that you can use for data migration but without the automatization options. It means that each import job is supposed to be configured separately and can’t be run automatically.</li>
<li><b>Choose import behavior:</b> add, update, delete information or add/update simultaneously.</li>
<li><b>Use 2 file formats:</b> CSV and XML formats are ready to use.</li>
<li><b>Use 2 sources for data storage:</b> upload files directly to the admin panel or extract them from local directories.</li>
<li><b>Match file settings during import:</b>map field names provided in a file with the Magento database to import data correctly.</li>
<li><b>Automatically modify the values:</b> use text, numeric, date or custom modifiers to change the values before importing or exporting (round prices, change the date, capitalize product names and so on). </li>
<li><b>Use filters:</b> import only relevant data by filtering the information presented in the file by any parameter.</li>
<li><b>Change performance settings:</b> choose the number of parallel processes according to your server capabilities.</li>
</ul>
<h2>Installation</h2>
<p>To install the package, run the following commands:</p>
<code>composer require amasty/module-export-core</code><br>
<code>php bin/magento setup:upgrade</code><br>
<code>php bin/magento setup:di:compile </code><br>
<code>php bin/magento setup:static-content:deploy (your locale)</code><br>
<br>
<p>See more details in the <a href="https://amasty.com/docs/doku.php?id=magento_2:composer_user_guide" target="_blank">Composer User Guide</a>. </p>
<h2>Import Configuration & Flow</h2>
<p><b>To import data successfully, you need to create the required entity or entities (e.g. products, orders, customers) first</b>. Let’s see how it works in the free version using the ‘Orders’ entity as an example.</p>
<h3>Import Configuration</h3>
<p>The logic of the import process has a tree structure. It means that first, you identify the key entities you want to upload (e.g. ‘Order’) and then you can add some specific subentities that you need (e.g. ‘Order Item’, ‘Order Shipment’, etc.).</p>

![164430753-613b68ab-3ce8-42e8-9881-6bc7116f9772](https://user-images.githubusercontent.com/104132415/200798896-4ab7ef2f-6270-484f-a09e-fad1342c99ba.png)

<h4>Step 1. Set the behavior </h4>
<p>Add, update or delete the data provided in the file from Magento. </p>

![164431381-9255b0e4-12b8-413e-b9cf-207896c89f19](https://user-images.githubusercontent.com/104132415/200799195-25e7a7d6-8f81-4bd5-af16-cf3953606da5.png)

<p>Choose validation strategy: it is possible to skip errors or stop the process if there are some. </p>

<h4>Step 2. Choose file type</h4>
<p>You can use either CSV or XML files.</p>

![164431713-cdb343ac-555e-4d5c-b03d-7f4bd5874fd8](https://user-images.githubusercontent.com/104132415/200799454-2029da20-cc62-477f-b614-e48d86bc9194.png)

<h4>Step 3. Specify import source </h4>

<p>Here you can upload the file manually or specify the path of the local directory.</p>

![164432062-07c7bf18-40b4-46cf-9f05-e7cdfb29a316](https://user-images.githubusercontent.com/104132415/200799594-f9aecbc1-d097-419a-a7ae-bcd3274cbbc3.png)

_(README truncated for .md surface. Full README on https://packagento.com/amasty/module-import-core.)_

## Recent Versions

| Version | Released |
|---|---|
| 1.12.2 | 2025-11-10 |
| 1.10.0 | 2025-02-03 |
| 1.8.0 | 2024-02-26 |
| 1.7.1 | 2023-11-14 |
| 1.7.0 | 2023-08-11 |
| 1.6.2 | 2023-06-19 |
| 1.6.1 | 2023-03-28 |
| 1.5.7 | 2022-11-09 |

## Dependencies

### Require

| Package | Constraint |
|---|---|
| amasty/base | >=1.21.0 |
| amasty/module-import-export-core | >=1.4.2 |
| php | >=7.4 |

## Quality

Latest release (1.12.2) passes the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | not tested | not tested | – | – |
| 2.4.8 | – | not tested | not tested | – |
| 2.4.9 | – | – | not tested | not tested |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Pass | 0 |  |
| PHPMD | Warning | 210 | 210 rule violations (MissingImport:123, IfStatementAssignment:22, ExcessiveMethodLength:15, CyclomaticComplexity:11, UnusedLocalVariable:10) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 3 | valid; 3 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Error | Error | – | – |
| 2.4.8 | – | Error | Error | – |
| 2.4.9 | – | – | Error | Error |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Error | Error | – | – |
| 2.4.8 | – | Error | not tested | – |
| 2.4.9 | – | – | Error | Error |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | N/A | 0 | no resolvable dependency tree to audit — Your requirements could not be resolved to an installable set of packages. Problem 1 |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["amasty/module-import-core"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

amasty is a Magento 2 vendor on Packagento. See https://packagento.com/amasty.md for their full catalogue.

