Botelix FAQ
Frequently asked questions regarding Botelix installation, deposit accounting, cross-border transactions, and WooCommerce checkout compatibility.
General deposit questions
Section titled “General deposit questions”Does Botelix convert currencies automatically?
Section titled “Does Botelix convert currencies automatically?”No. Beverage container deposit amounts are statutory obligations established by national law in specific national currencies (e.g., EUR, PLN, DKK, SEK, RON, HUF). Botelix charges a scheme fee only when the scheme currency matches your active WooCommerce store currency. It does not perform automated exchange rate conversions.
How are customer returns and deposit refunds handled?
Section titled “How are customer returns and deposit refunds handled?”Botelix manages the collection and transparent accounting of the deposit at purchase. Physical bottle returns and cash refunds take place through authorized reverse vending machines (RVM) or retail collection points. If an entire order is returned or cancelled in WooCommerce, the deposit fee is refunded using the standard WooCommerce refund tool.
What is a crate deposit (Kastenpfand)?
Section titled “What is a crate deposit (Kastenpfand)?”In several European markets (notably Germany), beverages sold in physical crates or plastic cases carry two separate deposits:
- Individual bottle deposits (e.g., 20 bottles x 0.08 EUR or 0.15 EUR).
- The outer crate deposit itself (e.g., 1.50 EUR for a standard beer crate).
Botelix allows you to set both the individual container unit rate and the outer crate deposit in the product editor.
Checkout and store behavior
Section titled “Checkout and store behavior”Does Botelix support both Classic and Block Checkouts?
Section titled “Does Botelix support both Classic and Block Checkouts?”Yes. Botelix registers deposits through the native WooCommerce Fees API. Deposit line items render seamlessly on classic shortcode cart/checkout pages as well as the modern WooCommerce Cart Block and Checkout Block.
How does Botelix detect the customer’s country?
Section titled “How does Botelix detect the customer’s country?”Botelix reads the customer’s shipping address first. If no separate shipping country is provided, it falls back to the billing country. Before a customer enters an address during checkout, WooCommerce’s native “Default customer location” setting determines the country.
How do variable products inherit deposit settings?
Section titled “How do variable products inherit deposit settings?”Variations follow the parent product’s scheme override. If a variation leaves the packaging container empty, it inherits the container type, units, and crate settings of the parent. If a variation specifies its own container, its custom rate and unit values take precedence.
What happens when an order ships outside supported schemes?
Section titled “What happens when an order ships outside supported schemes?”If Export Exemption is enabled (the default), international orders shipping outside the 16 supported national schemes receive zero deposit. If the export exemption is disabled, the store’s configured Default Scheme is applied.
Technical details and performance
Section titled “Technical details and performance”Does Botelix slow down store performance?
Section titled “Does Botelix slow down store performance?”No. Botelix is engineered for high performance and clean execution:
- Zero frontend JavaScript libraries are loaded.
- Zero external HTTP requests are made during page load or checkout.
- Fee calculations execute locally in memory during native WooCommerce cart recalculations.
How does VAT show on invoices and receipts?
Section titled “How does VAT show on invoices and receipts?”For untaxed schemes (e.g., Poland, Romania, Slovakia), the deposit appears as a non-taxable fee line. For taxed schemes (Germany, Denmark, Sweden, Finland), Botelix extracts the net share and applies the product’s tax class, so the total amount charged to the consumer matches the exact statutory gross deposit.
How does uninstall work?
Section titled “How does uninstall work?”When Botelix is deleted through the WordPress admin panel, uninstall.php deletes the botelix_settings option from the WordPress database across single sites and multisite networks. Product-level container metadata is preserved to protect your catalog data against accidental loss.