# epuzzle/magento2-module-import-export > This module provides functionality to extend import and export in Magento 2. `composer require epuzzle/magento2-module-import-export` Canonical URL: https://packagento.com/epuzzle/magento2-module-import-export ## At a glance - **Vendor**: epuzzle (https://packagento.com/epuzzle.md) - **Latest version**: 2.0.0 — released 2025-09-22 - **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/epuzzle/magento2-module-import-export 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 epuzzle/magento2-module-import-export:* bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush ``` ## What it does This module provides functionality to extend import and export in Magento 2. ## README This module extends the default Adobe Commerce Import / Export functionality, making it easier to manage bulk data transfers for products, customers, orders, and custom entities. **It provides**: - **REST API for import** — enabling seamless integration with external systems (ERP, PIM, CRM, marketplaces, etc.). - **CLI command for manual operations** — you can run imports directly from the Magento CLI (`bin/magento epuzzle:import-export:csv-import path/to/file.csv`). - **Batch file processing** — large CSV files are automatically split into smaller batches for faster and safer processing. - **Flexible entity support** — you can work not only with standard Magento entities, but also with custom ones defined in your project. - **Asynchronous operations** — import and export tasks can run in the background, improving stability and reducing timeout issues. - **Developer-friendly integration** — designed for developers, store managers, and system integrators who need more control over synchronization processes. ## Builds Status [![Magento 2.4.7 Actions Status](https://github.com/epuzzle/magento2-module-import-export/workflows/magento247/badge.svg)](https://github.com/epuzzle/magento2-module-import-export/actions) [![Magento 2.4.8 Actions Status](https://github.com/epuzzle/magento2-module-import-export/workflows/magento248/badge.svg)](https://github.com/epuzzle/magento2-module-import-export/actions) ## Requirements 1. [Installed Magento 2 System](https://devdocs.magento.com/guides/v2.4/install-gde/bk-install-guide.html) 2. [Magento System Requirements](https://devdocs.magento.com/guides/v2.4/install-gde/system-requirements.html) ## Supported Magento 2 versions | **Version** | **Status** | **Notes** | |----------------------------------------------|------------|-----------| | **Magento Open Source/Adobe Commerce 2.3.*** | x | | | **Magento Open Source 2.4.3** | x | | | **Adobe Commerce 2.4.4+** | ✓ | | | **Magento Open Source 2.4.4+** | ✓ | | ## Documentation * [wiki](https://github.com/epuzzle/magento2-module-import-export/wiki) * [Installation Guide](https://github.com/epuzzle/magento2-module-import-export/wiki/Installation-Guide) * [User Guide](https://github.com/epuzzle/magento2-module-import-export/wiki/User-Guide) ## Postman API Use our ready-to-run Postman collection to explore and test the Import API endpoints. [Run In Postman](https://app.getpostman.com/run-collection/9225084-b4f95d21-4046-4918-911a-3c7201d619de?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D9225084-b4f95d21-4046-4918-911a-3c7201d619de%26entityType%3Dcollection%26workspaceId%3Ddbf5d198-105d-43d3-b911-f9fc763d1a07#?env%5BePuzzle%20Backend%20Localhost%5D=W3sia2V5IjoiYXBpVXJsIiwidmFsdWUiOiJodHRwczovL2VwdXp6bGUtYmFja2VuZC5sb2NhbC9yZXN0LyIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJzZWNyZXQiLCJkZXNjcmlwdGlvbiI6IiIsInNlc3Npb25WYWx1ZSI6Imh0dHBzOi8vZXB1enpsZS1iYWNrZW5kLmxvY2FsL3Jlc3QvIiwiY29tcGxldGVTZXNzaW9uVmFsdWUiOiJodHRwczovL2VwdXp6bGUtYmFja2VuZC5sb2NhbC9yZXN0LyIsInNlc3Npb25JbmRleCI6MH0seyJrZXkiOiJhcGlUb2tlbiIsInZhbHVlIjoiPEpTT05fV0VCX1RPS0VOPiIsImVuYWJsZWQiOnRydWUsInR5cGUiOiJzZWNyZXQiLCJkZXNjcmlwdGlvbiI6IiIsInNlc3Npb25WYWx1ZSI6ImV5SnJhV1FpT2lJeElpd2lZV3huSWpvaVNGTXlOVFlpZlEuZXlKMWFXUWlPak1zSW5WMGVYQnBaQ0k2TWl3aWFXRjBJam94TnpVMk9UYzROVFU1TENKbGVIQWlPakUzTlRZNU9ESXhOVGw5LmJUdTNNVERrM2FOUzFpMWlTazZqOTBpOHZYTGVULi4uIiwiY29tcGxldGVTZXNzaW9uVmFsdWUiOiJleUpyYVdRaU9pSXhJaXdpWVd4bklqb2lTRk15TlRZaWZRLmV5SjFhV1FpT2pNc0luVjBlWEJwWkNJNk1pd2lhV0YwSWpveE56VTJPVGM0TlRVNUxDSmxlSEFpT2pFM05UWTVPREl4TlRsOS5iVHUzTVREazNhTlMxaTFpU2s2ajkwaTh2WExlVEpiX2Y4S3JCWWQ2ZG9RIiwic2Vzc2lvbkluZGV4IjoxfV0=) ## License Copyright (c) 2025 ePuzzle contributors. This module is [MIT licensed](./LICENSE). Project coordinator: [support@epuzzle.org](mailto:support@epuzzle.org) ## Changelog 2.0.0 ============= * Important changes: * Moved business logic to the model layer * Added service contracts for importing CSV data: `ImportInterface`, `ImportResultInterface`, etc. * Changed ACL `EPuzzle_ImportExport::csv` to `EPuzzle_ImportExport::csv_import` * Added security controller to download import reports * New features: * Batching CSV files. Available in CLI command and REST API * Batching large CSV files before import process automatically * Added unit tests 1.0.0 ============= * New features: * Import CSV data using rest API * Import CSV data using CLI command ## Recent Versions | Version | Released | |---|---| | 2.0.0 | 2025-09-22 | | 1.0.0 | 2025-09-04 | ## Dependencies ### Require | Package | Constraint | |---|---| | epuzzle/magento2-module-base | ^1.0 | | epuzzle/magento2-module-file-uploader | ^1.0 | | magento/framework | * | ## Quality Latest release (2.0.0) fails 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 | 1 | Pass | – | – | | 2.4.8 | – | Pass | Pass | – | | 2.4.9 | – | – | 1 | 1 | ### 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 | 5 | 5 rule violations (ExcessiveMethodLength:2, IfStatementAssignment:1, NPathComplexity:1, UnusedLocalVariable:1) | | Cpd | Warning | 2 | 2 duplicated chunks spanning 46 total lines (min-lines=5, min-tokens=70) | | Composer validate | Info | 2 | valid; 2 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 | 3 | Pass | – | – | | 2.4.8 | – | Pass | Pass | – | | 2.4.9 | – | – | Pass | Pass | ### 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 | N/A | N/A | – | – | | 2.4.8 | – | N/A | N/A | – | | 2.4.9 | – | – | N/A | N/A | ### Security Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright. | Tool | Status | Findings | Summary | |---|---|---|---| | Composer audit | Pass | 0 | | | 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=["epuzzle/magento2-module-import-export"], 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 epuzzle is a Magento 2 vendor on Packagento. See https://packagento.com/epuzzle.md for their full catalogue.