Extra Fees module changelog

All notable changes to OCMLabs Extra Fees are listed here. This module follows Semantic Versioning.

1.2.0

Changed

• The Adobe Commerce package (ocmlabs/module-extra-fees-commerce) now requires ocmlabs/module-extra-fees 1.2 or later, so both packages always install at matching versions.

Requirements

• Now supports Magento Open Source and Adobe Commerce 2.4.9 on PHP 8.4, in addition to 2.4.7 and 2.4.8. Fee tax, optional fees over REST, invoices and credit memos, the CSV export, and the Hyva cart were retested on 2.4.9. Installation on 2.4.10 and later is blocked until the module has been retested against it.

1.1.0

Added

• Six condition operators per condition row: Is, Is Not, >=, <=, >, < (numeric operators are scalar-only and never match multiselect values).
• Cart-level conditions: cart subtotal (base currency, evaluated against the live in-flight total), total item quantity, shipping country, shipping region, shipping postcode, customer group, shipping method, and payment method. Shipping- and payment-dependent conditions never match until the quote actually has that data.
• Min/Max amount caps for percentage fees, in base currency, applied before tax.
• Optional (customer-choice) fees: an opt-in checkbox in the checkout order summary, selection persisted on the quote and preserved across guest-to-customer cart merge, with REST selection endpoints for customer and guest carts.
• GraphQL coverage: Cart.ocmlabs_extra_fees, Cart.ocmlabs_available_optional_fees, the ocmlabsSetSelectedFees mutation, and CustomerOrder.ocmlabs_extra_fees.
• Admin REST CRUD for fees under /V1/ocmlabs-extra-fees, ACL-gated per route.
• Store view scoping per fee, with optional per-store display label overrides. Existing fees are backfilled to All Store Views on upgrade.
• Date-range scheduling (Active From / Active To), evaluated in each store view’s own timezone with inclusive bounds.
• Per-fee Tax Class override with fallback to the global Fee Tax Class, and a store-wide tax-inclusive fee entry option (Fee Amounts Include Tax).
• Multi-currency support: fixed amounts convert from base to display currency; percentage fees compute per currency from that currency’s own row totals.
• Fee Revenue report grid (Sales > Extra Fees > Fee Revenue) with per-order fee, tax, invoiced, and refunded amounts.
• Change Log audit grid recording every fee create, update, delete, enable, disable, and duplicate, with field-level diffs for admin form edits; entries survive fee deletion.
• Duplicate action on the fee grid; the copy is always created disabled.
• View-only admin role (OCMLabs_ExtraFees::view); existing roles with manage or delete access are backfilled automatically.
• Fee rows on guest order views, print views, and PDF invoices and credit memos.
• Translation dictionary (i18n/en_US.csv).

Changed

• Fee tax is now computed by Magento’s tax engine via associated taxables, using the fee’s effective tax class, instead of being applied as a flat amount only.
• The fee grid’s Conditions column shows the real stored operator per condition (e.g. color == 91 AND cart.subtotal >= 100).

1.0.1

Initial public release.

Features

• Fixed and percentage fees defined in the admin, each rendered as its own labeled line item in cart and checkout totals; multiple fees stack.
• Product attribute and SKU conditions with AND/OR combination; configurable products checked on both parent and child.
• Taxable flag per fee with a global Fee Tax Class setting.
• Fees persisted on orders and displayed across admin order views, customer account pages, and order, invoice, and credit memo emails.
• Invoice-once / refund-once lifecycle: the full fee is captured on the first invoice and refunded on the first credit memo after it, never more than was invoiced.
• Admin orders grid column for the order’s total fee amount.
• Clean uninstall via bin/magento module:uninstall OCMLabs_ExtraFees --remove-data.

Requirements

• Magento Open Source or Adobe Commerce 2.4.7 - 2.4.8
• PHP 8.3 - 8.4