Description
Currently supported market: Bosnia and Herzegovina (BiH). Leanmerce Commerce Assistant provides guided setup checks, consumer-information guidance and PDF order confirmations for WooCommerce merchants operating under the supported BiH legal framework. The current ruleset includes jurisdiction-specific guidance for the Federation of Bosnia and Herzegovina, Republika Srpska and Brčko District where implemented. Legal rulesets for other countries are not included. The plugin helps merchants review and document selected requirements; it does not certify or guarantee legal compliance.
WooCommerce Distance Sales & Order Documentation by Leanmerce.
The Free plugin is useful on its own. It includes:
- a seven-step setup and BiH-oriented audit with actionable product-scope exclusions;
- a Basic PDF order confirmation with separate SKU, quantity and price columns, recorded VAT and the checkout customer note;
- a private original-confirmation archive and mail-submission status;
- attachment to one selected, enabled WooCommerce customer order email;
- authorized customer and guest access to an existing archived original, with PDF printing;
- current order printouts and original-document controls in order administration;
- a shared admin workspace, included BS/HR/SR-Latin/EN copy and privacy-safe diagnostics;
- shared Core contracts used by separately installed add-ons.
The Basic PDF is an order confirmation only. It is not a distance-sales contract, fiscal receipt, compliance certificate, or proof that a store complies with applicable law.
This release adds recorded standard WooCommerce Sale-price display. See docs/NATIVE-WOO-SALE.md. It does not include third-party discount-plugin adapters.
Version 0.12.12 additionally supports explicit item/buyer classifications and optional merchant-approved documentation profiles for services, digital content/software licences, business buyers and mixed orders. These documentation profiles do not extend or certify the existing BiH physical-goods legal rules. Unknown or excluded items remain outside new Commerce Assistant documentation while WooCommerce sales and emails continue. See docs/COMMERCE-PROFILES-v1.md. Free remains unlicensed and has no Pro trial timer.
Free and separate Pro
Free requires no paid license. A separately distributed Pro add-on can add contract/evidence workflows and authorized advanced PDF integrations. Pro contracts, Template Studio, theme-font preparation, fiscal/ERP REST services and advanced field configuration are not standalone Free features. Pro is not bundled, hidden or license-locked inside this Free package. Core interoperability code does not grant a Pro entitlement.
PDF and email behavior
Enable Basic PDF in Setup and select an eligible existing customer email. WooCommerce must actually send that enabled email; choosing Completed order does not make an On hold order complete. Gateways and custom emails can behave differently.
The archived original preserves recorded facts; a current printout is separate. Accepted or uncertain submissions are not blindly repeated. Eligible failed submissions can use the order’s document controls. Submission is not proof of inbox delivery.
Orders without an archived original, including older orders, are not silently reconstructed as historical originals. My Account offers the existing archived original only. See the included docs/FREE-USER-GUIDE.md for statuses and troubleshooting.
Requirements and compatibility
Requires WordPress 6.9+, PHP 8.3+ and active WooCommerce 10.8+. The release verification report records actual WordPress/WooCommerce, PHP, HPOS/legacy and Classic/Blocks combinations tested for this release. Declared minimum versions are not a claim that every intermediate combination was retested.
Privacy
The Free plugin does not send telemetry, analytics, merchant data, customer data, or license checks to Leanmerce servers. It does not install executable code from external servers. The built-in PDF renderer does not fetch remote resources.
Original confirmations and submission metadata are stored locally; the configured WordPress/WooCommerce mail transport delivers the selected email. Explicit Support links open the chosen support channel; they do not automatically upload diagnostics or order data. Diagnostics exports intentionally exclude customer/merchant PII, document contents, Terms contents, secrets, and license credentials by default. Review any file before voluntarily sharing it.
Legal note
The audit and documentation features are technical tools and do not constitute legal advice. Merchants remain responsible for verifying the legal requirements that apply to their business and transactions.
Installation
- Install and activate WooCommerce.
- Install and activate Leanmerce Commerce Assistant.
- Open Leanmerce > Commerce Assistant, then Setup (the label follows the selected plugin admin language).
- Complete the setup steps, run the audit and address its findings. Confirm setup completion when available.
- Enable Basic PDF and choose the appropriate enabled customer order email if PDF confirmations are wanted.
An update from the same leanmerce-commerce-assistant 0.12.7 plugin is an in-place update. Back up the database and private document storage first. Version 0.12.8 adds archive/submission tables; it does not uninstall the plugin, clear settings or regenerate historical documents. Earlier commerce-assistant or leanmerce-commerce-compliance folder transitions are different procedures; see MIGRATION.txt. Do not activate multiple Free identities.
FAQ
Is this a legal-compliance guarantee or legal advice?
No. Audit statuses are technical checks based on the supported BiH ruleset and supplied settings. Review warnings and blockers; a passing check is not certification or a substitute for legal review.
Does Free need Pro or a paid license?
No. Setup, audit, Basic PDF and existing Free document access work without Pro. Advanced integrations and contract production require the separately installed compatible Pro add-on.
Why is there no PDF in an email or My Account?
Check that Basic PDF is enabled, the selected customer email is enabled and was actually triggered, and an original exists. Use the order’s Documents panel for preparation/submission status. A current printout is not an archived original. No original is fabricated for an old order just by viewing it.
Can I safely resend an original?
Use the eligible confirmed document action, not repeated status changes. Already accepted or uncertain submissions are not automatically resent. An uncertain transport outcome must be investigated before another attempt. A recorded submission does not prove receipt or opening.
Which language setting changes the customer interface?
Included BS/HR/SR-Latin/EN catalogues control admin/PDF copy. My Account document labels follow the archived document language (or order-document language if no archive); generic endpoint/WordPress messages use gettext and the customer/site locale. Admin preference is not a frontend language switch. Included catalogues are not published WordPress.org language packs or translated directory pages. See languages/README.md.
Does the plugin send data to Leanmerce?
Not automatically from Free core. Support requests and any files you choose to share are deliberate actions. Do not send passwords, license keys or customer data. Separate add-ons and your mail provider have their own behavior.
Where are the Free source, build instructions and developer contracts?
Readable runtime and build sources are included in this public plugin ZIP. Optional tools/build-plugin.py rebuilds the archive, and tools/generate-unicode-assets.py reproduces the bundled font metrics from the pinned fonts. These developer tools use Python 3’s standard library; WordPress does not load them and Python is not needed to install or use the plugin. See BUILD-SOURCE.txt, docs/FREE-PDF-UNICODE.md, docs/FREE-DEVELOPER-INTEGRATION.md and docs/PDF-EXTENSION-DEVELOPER-API.md.
How do I get help?
Open Support in the plugin workspace to choose the existing Leanmerce support channels. Diagnostics are not uploaded automatically. Describe the versions, selected email and document status without sharing private customer data or credentials.
Screenshots
Changelog
0.12.12
- Add explicit product/variation kinds and consumer/business buyer classifications, with optional merchant-approved documentation profiles for services, digital licences, B2B and mixed orders.
- Retain the default BiH B2C physical-goods workflow and exclusions; new profiles are documentation-only and do not certify legal compliance or supply new statutory rules.
- Bind new checkout evidence to the exact approved public legal source, its rendered content and the displayed statement. Classic and Blocks capture final checkout facts and keep optional confirmation separate from source presentation.
- Capture business identity through native WooCommerce checkout fields; unsupported or incomplete Commerce Assistant profiles do not block standard WooCommerce sales and emails.
- Keep frozen evidence immutable across failed-checkout retries; a changed buyer or documentation context uses a separate order without rewriting the original context.
- Preserve exact UTF-8 and literal backslashes in new compound order metadata across legacy and HPOS storage, with read-only compatibility for valid existing array records and strict hash validation.
- Display frozen profile facts in both Free PDF renderers. Keep existing original confirmations, prices, VAT, email delivery, archives and historical documents unchanged.
- Add four-language profile administration and checkout controls, protected by existing capabilities and native request verification. Password-protected pages cannot be approved as public profile sources.
- Expose additive Core API 1.10.0 profile interfaces. Free remains standalone and unlicensed, with no trial timer or new database schema migration.
0.12.11
- Record standard WooCommerce regular/Sale prices during new checkout and show the recorded before-price, Sale saving and final amount in original confirmations and current printouts.
- Use recorded order-item monetary facts across later tax-rounding contexts; do not replace historical facts with current catalogue prices.
- Combine native Sale and recorded Woo coupon totals once, retaining WooCommerce payable and tax amounts and both Free PDF renderers.
- Preserve archived originals. No Discount Rules, carrier, fiscal, stock-location or store-specific connector is included.
0.12.10
- Keep the open PDF field SDK in Free and supply advanced operational configuration, resolution and optional customer delivery through the separate Pro companion; preserve existing integration identifiers.
- Include public, readable archive-builder and pinned-font metric-generator sources with complete reproduction instructions; no new runtime requirement.
- Show actionable virtual/downloadable product and variation audit results with saved, reversible individual and bulk exclusions.
- Preserve standard WooCommerce sales and email for excluded/digital/mixed orders while restricting new physical-goods documents.
- Improve existing-original download and printing for authorized customers and guests, including order-received pages.
- Preserve exact supported Unicode order text with a local PDF fallback independent of Pro.
- Correct saved delivery controls and aligned Free/Pro email guidance.
- Verify document attachments at the actual mail transport boundary, protect recipient privacy and avoid false submission records or blind retries.
- Protect the optional current-order PDF attachment without forcing another document or notification.
- Keep the advanced-PDF admin menu discoverable with compatible Pro while retaining authorization and signed-entitlement checks.
- Capture SKU on new order lines across WooCommerce creation paths; allow a read-only current-SKU fallback on current printouts.
- Capture validated provider-supplied tracking numbers and HTTPS links in new immutable originals.
- Show a connected provider’s dispatch location only on the authorized merchant’s current printout.
- Show recorded BiH tax-inclusive prices, per-line VAT and VAT already included in totals; do not recalculate WooCommerce tax.
- Print the standard checkout customer note in current PDFs and new originals, with safe multiline pagination.
- Preserve settings, identifiers, historical originals and contract-formation rules; update user/developer and build documentation.
0.12.10-dev.9
- Print the saved WooCommerce checkout customer note on new original confirmations and current order PDFs. Preserve historical originals and omit empty notes.
0.12.10-dev.8
- Show saved Bosnian VAT and tax-inclusive amounts in new confirmations and current PDFs.
0.12.10-dev.7
- Show the connected fulfillment provider’s dispatch location on the merchant’s current order printout.
0.12.10-dev.6
- Capture SKU on new WooCommerce product order lines outside Classic checkout. Preserve existing recorded SKU values.
- Show a current product SKU on current packing printouts when a legacy line has no recorded SKU, without backfilling archived originals.
- Render bounded, frozen delivery-tracking links supplied before a new original confirmation is sealed. Existing originals remain unchanged.
0.12.10-dev.1
- Show the full published virtual/downloadable product and variation list in Audit, with name, ID, SKU, reason and edit link.
- Add reversible per-product and bulk exclusions that affect Commerce Assistant only, never WooCommerce publication, checkout, downloads or standard email.
- Restrict new documents and physical-goods contract formation for unsupported/excluded and mixed orders; preserve existing archived originals.
- This is a private owner-UAT development candidate, not a published Stable release.
0.12.9
- Verify required database tables, columns and indexes before recording a completed migration or enabling document/audit features.
- Recover incomplete earlier migrations with serialized, bounded retries while preserving settings, orders, encrypted originals and submission history.
0.12.8
- Added a private, integrity-checked original-confirmation archive and durable submission records; later order edits do not rebuild originals.
- Clarified Documents-panel statuses and eligible confirmed sending; uncertain submissions are not automatically resent.
- My Account now downloads archived originals only. Older orders are not silently reconstructed.
- Improved SKU/quantity/price columns and fee presentation; current printouts remain distinct from originals.
- Improved shared navigation, overview, Support and BS/HR/SR-Latin/EN delivery guidance.
- Added saved-versus-unsaved delivery summaries and invoice/COD email guidance without changing existing choices.
- Added Core API 1.9.0 and typed operational-PDF SDK contracts. Advanced fields, execution and optional customer delivery require separate authorized Pro; contracts are not a Free feature.
- Kept advanced registration lazy; authorized projections have bounded data, privacy filtering and validated active links.
- Hardened PDF admin inputs and corrected Plugin Check annotations while retaining public identifiers and legal rules.
- Updated user/developer, privacy, language and build documentation. Archive tables are additive; settings, orders and historical files are retained.
0.12.7
- Use the shared Leanmerce admin umbrella and canonical local SVG.
- Keep Dashboard, Setup and Tools bookmarks with internal navigation.
- Scope admin assets to actual registered Commerce Assistant screens.
0.12.2
- Use the Leanmerce Commerce Assistant name, folder, main file and text domain.
- Preserve third-party admin notices; remove notice callback suppression.
- Keep development packaging tools outside the installable plugin.
- Preserve PDF renderer CSS, legal content and existing data identifiers.
The complete preserved release history is included in changelog.txt.

