In some regions, retailers must collect a fee on certain products and pass it on to a recycling or stewardship program. A well-known example is the tire recycling fee (also called a tire levy) that tire retailers collect in Canada and in some US states. The amount usually depends on where the order is shipped, and the customer cannot opt out of it.
The Environmental Fees add-on lets you set up such fees in your store. You decide which products a fee applies to and how much it costs in each shipping zone. The fee is then added to the order automatically and shown to the customer as a separate line item.
A fee is not a tax. It is a charge you collect on top of the product price, and you can choose whether tax should be calculated on it.
Note: The Environmental Fees add-on is available in X-Cart 5.6.x only. X-Cart 5.5.1 does not have it.
Enabling the add-on
Depending on your store, the add-on may already be enabled. If you see Fees in the Admin area menu (Store > Fees), you can skip this section.
To enable the add-on:
Go to Apps > My Apps.
Find Environmental Fees and switch it on.
The Environmental Fees add-on in My Apps.Click Apply changes and wait until the store finishes rebuilding.
The add-on has no separate settings page. Everything is configured in the Fees section.
How fees work
The add-on uses two building blocks:
Fee class is a group of products that have the same fee. For example, "Tire - Passenger" for passenger tires and "Tire - Truck" for truck tires. Fee classes work like tax classes, but they are separate from them.
Fee is a charge with a name and a set of rules. Each rule says: for products of this fee class shipped to this zone, charge this amount.
When a customer places an order, X-Cart checks each product in the cart. If the product has a fee class, and the fee has a rule for this class and for the zone of the shipping address, the fee is added to the order.
A fee is not charged when:
the product has no fee class (the Not assigned value);
the fee has no rule for the product's fee class and the customer's shipping zone;
the fee is disabled;
the product does not require shipping. The fee depends on the shipping destination, so a product that is not shipped does not get it.
Step 1: Create fee classes
You can access these options from Store > Fees > Fee Classes.
Click Create fee class.
Enter a name. Customers do not see it, so use any name that helps you recognize the group, for example, "Tire - Passenger".
Click Save changes.
Create a separate fee class for every group of products that needs its own fee or its own amount. For example, if passenger and truck tires have different fees, create two classes.
To rename a fee class, click its name, enter a new one, and click Save changes. To change the order of the classes in the list, drag them. To delete a fee class, click the trash icon next to it and save changes. All rules that use this class are deleted from your fees too, and the products that had this class get Not assigned, so no fee is charged for them until you assign another class.
Step 2: Create a fee
Go to Store > Fees > Fees and click Create fee.
In Fee title, enter the name that customers will see in the cart, at checkout, and on the invoice, for example, "Tire Recycling Fee".
Turn on Enabled. A new fee is disabled by default, and a disabled fee is not charged.
In the Fee rates by zones section, click Add new to add a rule. Add as many rules as you need, one row for each combination of fee class and zone.
Click Save changes.
Each rule row has these fields:
Fee class: the class of products the rule applies to.
Zone: the shipping zone the rule applies to. The zone is determined by the customer's shipping address. Zones are the same ones you use for tax rates.
Amount: a fixed amount in your store currency or a percentage. Use the $ / % switch to choose.
Apply per: Unit or Order.
Unit: the fee is charged for each unit of the product. A fixed amount is multiplied by the quantity. A percentage is calculated from the product subtotal (price × quantity) after discounts, such as a coupon.
Order: the fee is charged once for all matching products in the order. A fixed amount is charged as is. A percentage is calculated from the subtotal of all matching products.
Taxable: select this check box if tax should be calculated on the fee. See "Taxes on fees" below.
|
|
Example. A tire shop ships to British Columbia, where the fee is $6.50 per tire. You create the fee class "Tire - Passenger" and the fee "Tire Recycling Fee" with one rule: fee class "Tire - Passenger", zone "Canada" (or a zone you created for British Columbia), amount $6.50, apply per Unit. A customer who buys four tires pays $26.00 as the fee.
A few rules to keep in mind:
Only one rule of a fee is applied to a product, rules are not added together. If the shipping address belongs to several zones (for example, "United States" and "All Addresses"), the rule of the more specific zone is used. Do not add the same fee class and zone to a fee twice.
If you need different amounts for different regions, create zones for those regions and add a row for each zone.
To charge several fees for the same products, create several fees and use the same fee class in their rules. Each fee is shown on a separate line.
Taxes on fees
If Taxable is selected in the rule, tax is calculated on the fee in the same way as on the product it belongs to, using the tax rates for the shipping address. If Taxable is cleared, the fee is not taxed.
Taxable fees are also taken into account when taxes are calculated by TaxJar or Avalara AvaTax (if you use these add-ons), and by Canadian Taxes.
Step 3: Assign fee classes to products
A fee is charged only for products that have a fee class. There are several ways to assign it.
Product page
Go to Catalog > Products and open the product.
Open the Pricing & Inventory tab.
In the Fee class field (below Tax class), choose a class.
Click Update product.
The default value is Not assigned, which means no fee is charged for the product. When you clone a product, the clone gets the same fee class.
Bulk editing
To assign a class to many products at once:
Go to Catalog > Products. To find the right products faster, use the Fee class filter. For example, choose Not assigned to see products without a class.
Select the products.
Among the bulk edit options, choose Fee class.
Choosing to edit the Fee class for the selected products.On the Bulk Edit Fee Class page, choose a class and save changes.
The bulk edit page for the fee class of the selected products.The selected class replaces the current one for all selected products.
CSV import
The product CSV file has a feeClass column. Enter the name of the fee class in it. If a class with this name does not exist yet, it is created during the import. The column is also included when you export products.
Products from catalog integrations
Products imported through catalog and distributor integrations do not receive a fee class automatically. Assign classes after the import, using one of the methods above. For a large catalog, the easiest way is to filter products by category (for example, tires), select them all, and use bulk editing.
What customers see
The fee appears as a separate line in the order summary in the cart, at checkout, and on the order confirmation page. The line uses the Fee title you set. Customers cannot remove it. The fee is included in the order total.
Orders, invoices, and exports
Order page. In the Admin area, the fee appears among the order totals as a separate line with its title.
Invoice. The fee is shown as a separate line in the order totals, not included in the product price.
Draft orders. When you create an order manually, the fee is calculated automatically from the products and the shipping address. If the fee is taxable, a warning icon appears next to it with the message "This fee is taxable. Please verify that taxes have been applied correctly."
A draft order with the warning icon next to a taxable fee. The tooltip says that taxes should be checked.Order export. In the exported orders CSV file, each fee is a separate column with a name like
XCFEE.1 (surcharge). The number identifies the fee.
The order page in the Admin area with the Tire Recycling Fee among the order totals.
FAQ
Q: Is an environmental fee a tax?
A: No. It is a separate charge. You can choose whether to calculate tax on top of it using the Taxable option.
Q: Can customers remove the fee?
A: No. The fee is added automatically when the product, the fee class, and the shipping zone match a rule.
Q: How do I set different fees for passenger and truck tires?
A: Create a fee class for each type, for example, "Tire - Passenger" and "Tire - Truck". Assign them to the products and add a rule for each class in the fee.
Q: How do I charge different amounts in different provinces or states?
A: Create a zone for each region (or use existing zones), and add a rule row for each zone.
Q: Why is the fee not added to my test order?
A: Check the following:
the fee is enabled;
the product has a fee class;
the fee has a rule for this fee class and for the zone of the shipping address;
the product requires shipping and the order has a shipping address.
Q: Can I exempt specific customers from the fee?
A: No. The add-on does not have exemptions for specific customers or customer groups. The fee is charged to everyone whose order matches a rule.
Q: How is this different from a handling fee?
A: A handling fee is added to the shipping cost of a shipping method, and customers do not see it as a separate line. An environmental fee depends on the product and shipping destination and is shown as its own line. See Handling Fee.
Q: How is this different from the Core Charge add-on?
A: A core charge is a deposit that customers get back when they return an old part. An environmental fee is a non-refundable charge. See Core Charge add-on.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles









