StockEasy: Magento 2 Stock Management and Reorder Automation

#Overview

StockEasy adds intelligent Magento 2 stock management and reorder automation to your store. It replaces the default product grid with a richer stock view, calculates reorder quantities based on real sales velocity, and automates CSV imports and email reports so you spend less time firefighting stock problems.

The module works in single-source mode and with Magento's Multi-Source Inventory (MSI) - per-source quantities, salable quantity tracking, and source-specific reorder calculations are all supported.

This module helps you:

• See all key stock data - qty, salable qty, reorder need, velocity, EDT, EDX - directly in the product grid
• Calculate reorder quantities automatically using recent or seasonal sales history
• Import stock updates in bulk via CSV, on a schedule or on demand
• Scan barcodes in the admin to update quantities without touching a keyboard
• Email low-stock, inventory-change, and in-stock reports to buyers or warehouse managers on a defined schedule

#When to use this

Use StockEasy when you want to:

• Know exactly which products need reordering and in what quantity, without running manual queries
• Replace daily or weekly manual stock checks with automated email reports sent directly to buyers
• Update hundreds of stock levels at once from a supplier's CSV feed, manually or on a schedule
• Track per-warehouse quantities when using MSI and need one clear view across all sources
• Calculate safety stock buffers and lead-time-aware reorder points per product or globally

#Key capabilities

• Enhanced product grid - adds Qty, Salable Qty, Reorder, iReorder, Trigger Qty, EDT, EDX, iVelocity, MOQ, MXOQ, Cost, and more as optional columns
• Reorder Qty - fires when stock falls below a configurable Trigger Qty; respects MOQ/MXOQ floors and ceilings
• iReorder Qty (Intelligent Reorder) - uses historical velocity, lead time, and buffer period to project how much to order; recalculates hourly
• CSV import - bulk-update qty, cost, price, source, operation type (set/add/subtract), MOQ, MXOQ, lead time, and more
• Auto-import scheduling - run recurring CSV imports unattended; each schedule can target a different source or operation
• Barcode scanning - camera or handheld scanner updates stock directly in the browser
• Automated email reports - four report types (default, low stock, inventory changes, back-in-stock), each with independent schedule and recipient settings
• PDF and CSV export - mass-export filtered product lists from the grid; field selection and sort order are fully configurable
• MSI support - per-source quantity tracking with graceful fallback to single-source mode
• Import log - full audit trail of every import operation with replay support

#Installation

StockEasy installs via Composer, then activates with a license key from your Moogento.com account. The whole flow takes about 5 minutes.

#Step 1: Get your Composer keys from Moogento.com

1. Sign in at https://www.moogento.com and open My Plugins in your account menu.
2. Find StockEasy in the list of plugins you own.
3. Generate (or reveal) the Composer access keys for that plugin - a public key and a private key.
4. Add your install domain to the key. Each Composer key is tied to a specific domain - if you're installing on yourstore.com, add yourstore.com to the key's allowed domains. The Composer download will be rejected on any other domain.

If you run staging and production on different domains, add both - separate keys per environment are fine too.

#Step 2: Install the module with Composer

From your Magento 2 root directory:

composer require moogento/module-stockeasy

When Composer asks for credentials, paste the public key as the username and the private key as the password. They'll be cached in ~/.composer/auth.json for future runs.

#Step 3: Enable the module in Magento

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean

If you run php bin/magento module:status Moogento_Stockeasy you should see it listed as enabled.

#Step 4: Add your license key in the Moogento admin

1. Still on https://www.moogento.com > My Plugins, copy the license key for StockEasy (separate from the Composer keys you used above).
2. In your Magento admin, go to Stores > Configuration > Moogento > Licenses.
3. Find the row for StockEasy and paste the license key.
4. Click Save Config, then run php bin/magento cache:clean once.

The license validates within a few seconds. You should see the module's status flip to active. If it stays inactive, double-check the domain on the license matches where you've installed - domain mismatch is the most common cause.

#Setup overview

Most setup happens in:

Stores > Configuration > Moogento > StockEasy

You'll mainly work with:

• General - enable the module, configure automatic stock-status updates, and set import log retention
• Reorder & iReorder: Defaults - global thresholds and calculation model for reorder suggestions
• Products Page: Columns - choose which columns appear in the enhanced product grid
• Schedule: Auto-Imports - set up recurring CSV import jobs
• Schedule: Auto-Emailed CSVs & PDFs - configure report recipients, schedules, and filters
• Format: Auto-Emailed & Manually-Generated CSVs & PDFs - choose fields, sort order, and product attributes for exported reports
• Filter: Manually-Generated CSVs & PDFs - exclude EOL products from manual exports
• Process: CSV - map your supplier's CSV column headers to StockEasy fields
• Process: Scan - configure the barcode scanner attribute and history size

#Common setups

#Set up intelligent reorder calculations

StockEasy calculates two types of reorder quantities. Reorder Qty fires a simple threshold trigger. iReorder Qty (intelligent reorder) uses sales velocity and a configurable forward-looking model to suggest how much to order. Setting sensible global defaults gets both working immediately.

#How to set it up

1. Go to: Stores > Configuration > Moogento > StockEasy > Reorder & iReorder: Defaults

2. Set:

   • iReorder: Stock buffer period = the number of days of stock you want on hand at all times (e.g. 30)
   • iReorder: Calculation model = Recent history for most stores; Seasonal history if your sales are heavily seasonal
   • Reorder & iReorder: Qty Type = Salable Qty if you want to factor in reservations; Stock Qty for raw warehouse count
   • Reorder (& sometimes iReorder): Trigger Qty = the stock level below which a Reorder Qty is generated (e.g. 5)
   • Reorder & iReorder: MOQ = your supplier's minimum order quantity (e.g. 12)
   • Reorder & iReorder: MXOQ = the maximum you'd ever order in one go (e.g. 500)
   • Reorder & iReorder: Ignore EOL products = Yes to skip discontinued lines

3. Save config

#Notes

• Per-product Lead Time and Buffer Period values add to the global buffer - they do not replace it.
• Set Force override to Yes only if you want these global settings to take precedence over any per-product settings already saved.
• iReorder requires at least one night of cron runs to populate velocity data. If iReorder shows 0 immediately after install, that is expected - values appear after the nightly moogento_stockeasy_smart_reorder_queue job runs.

#Configure automatic CSV import from a supplier feed

If your supplier emails or FTPs a stock CSV on a regular schedule, you can configure StockEasy to pick it up and apply it automatically.

#How to set it up

1. First, map your supplier's column headers. Go to: Stores > Configuration > Moogento > StockEasy > Process: CSV

   Set:

   • CSV column title for: SKU = the exact header in your file (e.g. sku, Item Code)
   • CSV column title for: Qty = e.g. stock_qty, OnHand
   • CSV column title for: Operation type = the header of the column that says set, add, or subtract (leave blank if you always want to set qty)
   • Map any other columns (Cost, Lead time, MOQ, MXOQ) that your feed includes

2. Save config.

3. Now set up the schedule. Go to: Stores > Configuration > Moogento > StockEasy > Schedule: Auto-Imports

   In the scheduler UI, add an entry with the file path or URL, frequency, and source (for MSI stores).

4. Set Auto-set 0 for negative quantity = Yes if your supplier feed can contain negative values you want to treat as zero.

5. Save config.

#Notes

• An empty schedule means no automatic jobs run. Re-saving the config after adding a schedule entry normalises the stored JSON.
• For very large files (tens of thousands of rows), use the CLI command php bin/magento moogento:stockeasy:fast-csv-import for a direct batch import that bypasses the queue.
• View the result of every import run at Moogento > StockEasy > Import Log.

#Schedule automated low-stock email reports

StockEasy can email a low-stock or back-in-stock report to your buyer or warehouse manager without any manual action.

#How to set it up

1. Go to: Stores > Configuration > Moogento > StockEasy > Schedule: Auto-Emailed CSVs & PDFs

2. In the report scheduler, add an entry and set:

   • Report type (Low Stock, Inventory Changes, In Stock, or Default)
   • Recipient email address(es)
   • Schedule (hourly, daily, weekly)
   • Filters: Only if Qty < Trigger Qty, Only if Reorder Qty > 0, Only if Status = Enabled, Only OOS, Ignore EOL

3. Save config.

#Notes

• Each report entry has its own filter settings independent of the global config.
• Only once? prevents the same product appearing in every report until its stock is replenished - useful for low-stock alerts you want to send once per stockout event.
• The report cron (moogento_stockeasy_send_reports) runs every hour. The first send will occur at the next scheduled hour boundary.

#Features reference

#Products Page Columns

Stores > Configuration > Moogento > StockEasy > Products Page: Columns

Lets you choose which data columns appear in the enhanced Catalog > Products grid. Available columns include Qty, Salable Qty, Reorder Qty, iReorder Qty, Trigger Qty, MOQ, MXOQ, EDT (Estimated Days Till stockout), EDX, Lead Time Days, Buffer Period, Sold, iVelocity, Cost, Price, multi-store price, Manage Stock, Status, Visibility, Category, Type, Thumbnail, Qty Refunded, Import Log Status, and EOL.

Enable Uses: StockEasy grid design in the General group to apply the optimised Products page layout that makes this data easier to read.

Config path: moogento_stockeasy/grid/column

#Export Format: CSVs and PDFs

Stores > Configuration > Moogento > StockEasy > Format: Auto-Emailed & Manually-Generated CSVs & PDFs

Controls the fields, sort order, and product attributes included in both auto-emailed reports and manually triggered exports from the product grid.

• Included fields: In CSV report - pick which data fields appear in exported CSVs
• Sort CSV by / CSV Sort direction - default sort applied to all CSV exports
• Add product attributes to CSV - append any product attribute as an extra column
• Fields to include in PDF report - same choices for the PDF output
• Total Fields to include in PDF report - column totals shown in the PDF footer

Config path: moogento_stockeasy/export/

#Filter: Manually-Generated CSVs and PDFs

Stores > Configuration > Moogento > StockEasy > Filter: Manually-Generated CSVs & PDFs

• Filter by: EOL attribute - when set to Yes, products marked as End-of-Life are excluded from any CSV or PDF you generate manually from the product grid. Auto-emailed reports have their own per-schedule EOL filter.

Config path: moogento_stockeasy/attributes/eol

#Barcode Scanning

Stores > Configuration > Moogento > StockEasy > Process: Scan

The barcode scanner lets admin users update stock quantities using a camera or handheld scanner, without typing. Navigate to Moogento > StockEasy > Import Log to see the scan history (each scan is logged as an import operation).

Configuration:

• Which product attribute are we scanning? - default is SKU; change to barcode, EAN, or any product attribute
• Scan history size? - how many previously-scanned items to show on screen (default: 10)
• Show additional attribute - display one extra product attribute alongside the scanned item for a visual double-check
• Stock qty barcode key - download a printable barcode sheet for entering numeric quantities without a keyboard, useful when using a handheld scanner

Config path: moogento_stockeasy/scan/

#Pre-Process: Product Data (Manual Calculation)

Stores > Configuration > Moogento > StockEasy > Pre-Process: Product Data

The Manual button triggers iReorder calculations for up to 5,000 products immediately, without waiting for the scheduled cron. Use this after changing global defaults or after a bulk import to see updated reorder quantities right away.

Config path: moogento_stockeasy/manual_calc/calc_now

#Advanced configuration

#Per-product Lead Time and Buffer Period

#What it does

Each product can carry its own Lead Time and Buffer Period values, which are added on top of the global defaults when calculating iReorder Qty. This lets you account for slow-moving or long-lead products without changing global settings.

Per-product fields are edited directly in the product edit form under the StockEasy tab, not in the configuration section.

#Setup

1. Open a product in Catalog > Products.
2. Find the StockEasy product tab.
3. Set Lead Time Days and/or Buffer Period for that product.
4. Save the product.

#Notes

• If Force override is set to Yes in Stores > Configuration > Moogento > StockEasy > Reorder & iReorder: Defaults, per-product settings are ignored and global values apply to all products.
• Leave per-product fields blank to inherit the global defaults.

#MSI source mapping for CSV imports

#What it does

When Magento MSI is active, you can include a Stock source column in your import CSV to direct quantity updates to a specific warehouse source. This allows a single CSV to update multiple sources simultaneously.

#Setup

1. Go to: Stores > Configuration > Moogento > StockEasy > Process: CSV

2. Set CSV column title for: Stock source to the header in your CSV that contains the source code (e.g. warehouse, source_code).

3. Ensure the source codes in your CSV match exactly the source codes configured in Inventory > Sources.

#Notes

• Importing to a non-existent source code will skip those rows silently; check the Import Log for skip counts.
• Auto-remove from Reserved Stock (General group, Pro Plan) clears MSI reservations on CSV import - useful when an external system is the authoritative stock source and you want salable qty to equal the imported qty immediately.

#Auto-set stock status on quantity changes

#What it does

Two Pro Plan settings in the General group keep Magento's stock status in sync automatically when you change quantities via the grid, CSV, or scanner - without needing to manually set "In Stock" or "Out of Stock".

#Setup

1. Go to: Stores > Configuration > Moogento > StockEasy > General

2. Set:

   • Auto-set in-stock: When qty becomes positive = Yes - marks a product as In Stock as soon as its qty goes above zero
   • Auto-set out-of-stock: When configurable product has no children with Qty > 0 = Yes - marks a configurable product Out of Stock when all its variants are at zero

3. Save config.

#Notes

• These settings only apply to quantity changes made through StockEasy (grid edit, CSV import, barcode scan). They do not retroactively update products whose qty was changed through other Magento tools.
• Both settings require a Pro Plan license.

#Tips & best practices

• Run a manual calculation (Pre-Process: Product Data > Manual) after changing global reorder defaults to see updated iReorder quantities immediately without waiting for the nightly cron.
• Use Seasonal history as the iReorder calculation model if your store has strong seasonal demand peaks - it uses the same period last year rather than the most recent period.
• Keep Keep import log records (General group) set to at least 2–3 days during initial CSV import setup. Extend it to 7–14 days if you want a fuller audit trail. Logs are pruned nightly.
• When importing from a supplier CSV for the first time, run a small test file (10–20 rows) manually through Moogento > StockEasy > Import and review the Import Log before enabling automated imports.
• Set a low Trigger Qty (e.g. 5) as a safety net for fast-moving products. Even if iReorder is your primary signal, Reorder Qty provides a backup alert when stock is critically low.
• Use Only once? in auto-emailed report filters to prevent the same low-stock product flooding daily reports - it only reappears after being restocked.
• For large catalogs, the CLI fast-import (php bin/magento moogento:stockeasy:fast-csv-import) is significantly faster than the web-based import for files over a few thousand rows.

#Troubleshooting

#iReorder quantities show 0 for all products

All iReorder values appear as zero in the product grid after enabling the module.

• Cause: Velocity data has not yet been collected. iReorder requires daily sales history stored in moo_stockeasy_ivelocity_data_days, which is populated by the nightly moogento_stockeasy_collect_products_data_per_day cron.
• Check: Confirm Magento cron is running: bin/magento cron:status. Then check whether the table moo_stockeasy_ivelocity_data_days has any rows.
• Resolution: Let the cron run for at least one full day. For an immediate check, use the Manual button under Stores > Configuration > Moogento > StockEasy > Pre-Process: Product Data to queue up to 5,000 products without waiting.

#Auto-import schedule is not running

CSV imports were configured in Schedule: Auto-Imports but no imports are executing.

• Cause: An empty or malformed schedule JSON is stored in moogento_stockeasy/reports/import_options. This can happen if the schedule was partially saved during a previous session.
• Check: Navigate to Stores > Configuration > Moogento > StockEasy > Schedule: Auto-Imports and inspect whether any schedule entries are visible.
• Resolution: Re-save the Auto-Imports configuration page. A re-save normalises any legacy malformed value and writes a valid JSON schedule. Also confirm Magento cron is active - the import cron (moogento_stockeasy_import) runs every 5 minutes.

#Quantity mismatch between StockEasy columns and Magento inventory

The Qty or Salable Qty shown in the StockEasy grid does not match what Magento shows elsewhere.

• Cause: Possible source mapping mismatch (MSI), timezone differences in velocity calculations, or a pending stock index.
• Check: If MSI is active, verify the source codes in your CSV or per-product settings match the codes in Inventory > Sources exactly. Run bin/magento indexer:reindex cataloginventory_stock to refresh the stock index.
• Resolution: After reindexing, run bin/magento cache:clean and reload the product grid. If the mismatch persists in MSI mode, check the SourceItemManager source-code mappings against the actual source codes configured in Magento.

#Barcode scanner camera does not initialise

The camera-based scanner shows a blank panel or a permission prompt that does not resolve.

• Cause: Browser camera permissions are blocked, or the admin is being accessed over HTTP instead of HTTPS. Camera APIs require a secure context.
• Check: Confirm the admin URL uses https://. Open browser dev tools and check for a NotAllowedError or NotFoundError in the JavaScript console.
• Resolution: Ensure the admin is served over HTTPS. In the browser, navigate to site settings and explicitly allow camera access for the admin domain. If testing on a local dev environment without a certificate, use a hardware barcode scanner (USB HID) instead of the camera.

#Grid columns are missing after enabling the module

Expected StockEasy columns (Qty, iReorder, EDT, etc.) do not appear in the Catalog > Products grid.

• Cause: UI component cache is stale, or column visibility was not saved after configuration.
• Check: Go to Stores > Configuration > Moogento > StockEasy > Products Page: Columns and confirm the desired columns are selected.
• Resolution: Save the column config, then run php bin/magento cache:clean layout block_html. Reload the product grid. If columns still do not appear, run php bin/magento setup:di:compile and php bin/magento cache:clean.

#FAQs

#How does StockEasy's Magento 2 stock management and reorder automation work?

Open Catalog > Products - StockEasy adds a Reorder Qty column that shows a non-zero value for any product whose stock has fallen below your configured Trigger Qty. You can also filter the grid by the Reorder or iReorder columns to list only products that need attention. See Common setups - Set up intelligent reorder calculations for how to configure the thresholds.

#What is the difference between Reorder Qty and iReorder Qty?

Reorder Qty is a simple threshold trigger: it generates a suggested quantity when stock falls below the Trigger Qty. iReorder Qty (intelligent reorder) uses historical sales velocity, your supplier's lead time, and a safety buffer to project exactly how much to order for the period ahead. iReorder is more accurate for stores with consistent or seasonal demand; Reorder is a useful fallback safety net.

#How do I import stock quantities from a CSV file?

Go to Moogento > StockEasy > Import (or use the CSV import section accessible from the product grid) to upload a CSV manually, or configure a scheduled auto-import under Stores > Configuration > Moogento > StockEasy > Schedule: Auto-Imports. First map your CSV column headers to StockEasy fields under the Process: CSV config group so the module knows which column contains SKU, Qty, and any other data you want to update.

#How do I stop StockEasy from emailing low-stock reports every day for the same products?

Enable Only once? in the filter settings for that report entry under Stores > Configuration > Moogento > StockEasy > Schedule: Auto-Emailed CSVs & PDFs. With this on, a product is only included once per stockout event - it reappears in the report only after its stock is replenished and drops again.

#Does StockEasy work with Magento Multi-Source Inventory (MSI)?

Yes, StockEasy supports MSI. The product grid can show per-source quantities, CSV imports can target individual sources using a source-code column, and iReorder calculations respect salable quantity across all sources. On single-source stores it falls back to standard inventory automatically.

#Is StockEasy compatible with Hyvä, Luma, and Porto themes?

StockEasy is an admin-only module - all its functionality lives in the Magento backend (product grid, config pages, import/export, barcode scanner, email reports). There is no storefront output, so it is fully compatible with Hyvä, Luma, Porto, and any other frontend theme.

#What happens if I disable StockEasy?

Disabling StockEasy stops all cron jobs (iReorder calculations, stock history snapshots, auto-imports, auto-emailed reports) and removes the enhanced columns from the product grid. The Magento product catalog and native inventory data are untouched. Re-enabling the module and running php bin/magento cache:clean restores all features; velocity data accumulated before disabling is preserved in the database.

#How much does StockEasy cost and which plan do I need?

Pricing and plan details are available at https://www.moogento.com. Several features - including Auto-set in-stock/out-of-stock on quantity changes, Auto-remove from Reserved Stock, and the Is in stock CSV column - require the Pro Plan. Core features (enhanced grid, iReorder, CSV import, barcode scan, auto-emailed reports) are available on lower plans. Check your plan level under Stores > Configuration > Moogento > Licenses.

#Why is iReorder showing 0 when I first install StockEasy?

iReorder needs at least one day of sales velocity data before it can calculate a meaningful quantity. The nightly cron (moogento_stockeasy_collect_products_data_per_day) collects this data; once it has run, the hourly iReorder cron will populate values. Use the Manual button under Stores > Configuration > Moogento > StockEasy > Pre-Process: Product Data to trigger an immediate calculation once data is available.

#Can I update stock for multiple warehouse locations at once?

Yes - if MSI is enabled, include a Stock source column in your import CSV that matches the source codes configured in Inventory > Sources. One CSV can update multiple sources in a single import run. Configure the column header mapping under Stores > Configuration > Moogento > StockEasy > Process: CSV.

#Related guides

• ExportEasy - generate and schedule advanced product data exports including stock fields; complements StockEasy's built-in CSV/PDF reports for more complex export layouts
• PickPack - relies on accurate stock levels that StockEasy maintains; iReorder and real-time quantity updates help ensure pick lists reflect actual warehouse state

#Need help?

• moo@moogento.com
• Include:
  • Magento version
  • Module name
  • What you're trying to do