README

mhinspeya/module-orderitemsgrid is a Magento 2 extension that manages order item synchronization, status tracking (picked/returned), and credit memo automation based on external database connections and payment configurations.

Main Functionalities

1. Order Item Grid Synchronization: Syncs order items with a custom/external database connection to retrieve picked status, quantity, ean, size, color, model number, and channel.
2. Cron Jobs:
   • CreditMemo: Regularly populates the custom order item grid from the sales table and external database data.
   • Redata: Automatically generates credit memos and initiates refunds for items that are not picked or returned, using Magento REST API integration.
3. Admin Grid Management: Displays synced order items in the admin UI listing. Offers inline-editing and direct Credit Memo actions for administrators.

Compatibility Status

• Magento 2.4.8 Compatibility: Fully compliant with modern routing, DI patterns, and API interfaces.
• PHP 8.4 Support: Fully refactored to eliminate dynamic property deprecations, Zend logger dependencies, and direct object manager usages.

Installation

Method 1: Manual Installation (Zip/File Copy)

1. Extract/copy the module source into app/code/MHinspeya/OrderItemsGrid.
2. Enable the module:

   php bin/magento module:enable MHinspeya_OrderItemsGrid
   

3. Update the database schema and compile code:

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

4. Flush the cache:

   php bin/magento cache:flush
   

Method 2: Installation via Composer

1. Make the module package available in your repository source config.
2. Install via composer:

   composer require mhinspeya/module-orderitemsgrid
   

3. Enable, compile, and upgrade the application:

   php bin/magento module:enable MHinspeya_OrderItemsGrid
   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento cache:flush
   

Configuration

To allow automated API-based credit memos/refunds:

1. Configure credentials under Stores > Configuration > Credit Memo Settings (e.g. creditmemo/general/credit_user and creditmemo/general/credit_password).
2. Custom database connection details should be defined under your global env.php file using the resource name custom.

Specifications

• Model: OrderItemGrid
• Resource Model: OrderItemGrid, Collection
• Repository: OrderItemGridRepository
• UI Listing Component: mhinspeya_orderitemsgrid_orderitemgrid_listing