Orange Collar Media
Orange Collar Media
DOCS
OCMLABS/MODULE-EXTRA-FEES · SYSTEM SETTINGS

Configure the module switch and tax behavior in Stores > Configuration

MAGENTO 2.4.7 - 2.4.8 PHP 8.3+ LUMA + HYVÄ COMPOSER

Module settings live at Stores > Configuration > OrangeCollar > Extra Fees (section ocmlabs_extra_fees). Access requires the OCMLabs_ExtraFees::config ACL resource. Fee definitions themselves are managed separately under Sales > Extra Fees > Manage Fees.

General

FieldConfig pathDefaultDescription
Enable Extra Feesocmlabs_extra_fees/general/enabledNoMaster switch. When off, no fee is evaluated or displayed anywhere - even active, correctly configured fees. Useful for emergency disabling without touching individual fee records. Flush the cache after changing it.

Tax

FieldConfig pathDefaultDescription
Fee Tax Classocmlabs_extra_fees/tax/fee_tax_classNoneThe default tax class used for taxable fees whose own Tax Class field is set to “Use Default (Configuration)”. Uses the same product tax class list as the rest of Magento, but stored as a dedicated setting. When this resolves to None and the fee has no override, taxable fees are simply not taxed.
Fee Amounts Include Taxocmlabs_extra_fees/tax/fee_prices_include_taxNoWhen Yes, entered (or percentage-calculated) fee amounts are treated as tax-inclusive for any taxable fee with an effective tax class, and the tax engine derives the exclusive amount. Non-taxable fees and taxable fees with no effective tax class are unaffected. Store-wide; there is no per-fee override.

How the two tax settings interact with per-fee fields, min/max caps, and multi-currency stores is covered in Tax & Currency.