Description
Australcode Facturación Electrónica SII & Stock makes SII-compliant facturación electrónica — automatic emission of boletas, facturas, credit notes and dispatch guides (DTE) — for any WooCommerce store in Chile. Real-time sync of products, stock and prices from Bsale to WooCommerce. The Free version already includes real-time webhook stock updates, credit notes, and on-demand stock audit — with no per-document or per-boleta fees. Mature plugin in production since 2023, now part of the Australcode family.
It covers the full lifecycle of a Chilean e-commerce transaction: from product catalog sync to manual or automatic emission of the SII-compliant tax document required for each WooCommerce order.
Australcode is an independent developer. This plugin is a third-party integration for Bsale and WooCommerce; it is not affiliated with, endorsed by, or sponsored by Bsale, Defontana SpA, or the WooCommerce/Automattic trademark holders.
Free version
Everything you need to run a typical Chilean e-commerce store with WooCommerce + Bsale:
- Product sync — One-way synchronization from Bsale to WooCommerce. Imports product catalog including variants, SKUs, prices, and stock levels.
- Single-office stock — Stock from one configured Bsale office, with optional reserve buffer for in-person sales.
- Real-time stock updates via webhooks — Bsale stock changes propagate to WooCommerce in seconds.
- Manual emission of boleta and factura — Issue documents from the order admin screen. Document type auto-detected from customer billing data (RUT empresa factura, otherwise boleta).
- Credit notes (notas de crédito) — Manual emission for refunds.
- Chilean checkout fields — Adds RUT field with module-11 validation. Compatible with both Block-based Checkout and Classic Checkout.
- Order metabox — Per-order Bsale status, PDF link, document type, and re-emit controls.
- Email PDF to customer — Automatic dispatch of the emitted document to the customer’s email.
- Stock audit (on-demand) — Run-when-needed audit comparing WooCommerce and Bsale stock. Discrepancy detection and traceability.
- Diagnostics — Dashboard with API/webhook status, logs viewer with filters and retention policy, traceability ledger (read-only).
- HPOS compatible — Declares compatibility with WooCommerce High-Performance Order Storage and Cart/Checkout Blocks.
Pro version
Adds workflow automation, multi-warehouse support, and advanced B2B features:
- Auto-emission post-payment — Documents emitted automatically when WooCommerce orders reach configurable statuses (processing, completed, etc.). The killer time-saver.
- Multi-office stock aggregation — Sum stock across multiple Bsale offices.
- Stock transfer modes — Auto-move stock to main office via internal transfer or dispatch guide (guía de despacho) when an order requires stock from a secondary office.
- Sales notes (nota de venta) + automatic credit notes from refunds — Full B2B workflow automation.
- Dispatch guides (guías de despacho) — Inter-office stock transfers with electronic dispatch document.
- Dynamic document attributes — Custom attributes (e.g. WooCommerce order number) injected into each emitted document.
- Scheduled audits — Up to 3 daily automatic audit runs comparing WooCommerce Bsale stock, with optional auto-correction and email notifications.
- Custom field mapping — Map WooCommerce custom checkout fields (from third-party plugins) to Bsale invoice fields (rut_empresa, razón social, giro, dirección, comuna, ciudad).
- Stock-per-office display on frontend — Optional product page widget showing available stock per office.
- Per-shipping-method office routing — Emit documents from a specific Bsale office based on the WooCommerce shipping method (multi-warehouse).
- Daily auto-link by SKU — Cron job that auto-links unlinked WooCommerce products to Bsale variants by SKU match.
Pricing
Pro is sold as an annual subscription (or one-time lifetime license) with 1 site activation per license. A 5-site license is also available.
Learn more and purchase at https://bsale.australcode.io
Requirements
- WooCommerce 7.0 or later
- A Bsale account with API access
- WordPress 6.1 or later, PHP 7.4 or later
Bsale
Bsale is a Chilean SaaS platform for POS, inventory, and facturación electrónica (electronic tax document emission) compliant with SII (Servicio de Impuestos Internos, the Chilean tax authority). It is the de-facto choice for many Chilean small and medium e-commerce businesses to handle their day-to-day operations and tax compliance.
This plugin is an unaffiliated third-party integration. “Bsale” is a trademark of its respective owner.
External services
This plugin connects to two third-party services. Both are used only for the features described, and only as a result of an action you take (entering your Bsale API token, or activating a Pro license). No data is sent on a fresh install before you configure these features.
Bsale API (bsale.io / bsale.cl)
What it is: Bsale is the Chilean POS and electronic invoicing platform this plugin integrates with. The plugin is an unaffiliated third-party integration.
Data sent and when:
- Your Bsale API access token is sent with every request, to authenticate.
- Product, variant, SKU, price and stock queries are sent when you sync your catalog or when Bsale stock webhooks arrive.
- When a tax document is emitted (boleta, factura, credit note, dispatch guide), the order data required by the SII (customer RUT, razón social, line items, amounts) is sent to Bsale so it can issue the legal document.
This happens because the plugin’s purpose is to mirror your Bsale catalog into WooCommerce and to emit SII-compliant documents through Bsale. The connection is configured by you: you enter your own Bsale API token under “Australcode Bsale Configuración”.
- Terms of Service: https://www.bsale.cl/sheet/condiciones-uso
- Privacy Policy: https://www.bsale.cl/sheet/politica-privacidad
Freemius (freemius.com)
What it is: Freemius is the Merchant of Record and licensing provider used to manage the optional Pro license (checkout, activation, account, and updates).
Data sent and when:
- When you opt in (optional — you can skip it), your admin email and site URL are sent to Freemius so it can manage your account and license. The plugin is fully functional without opting in.
- Your license key and site URL are sent to Freemius when you activate, validate, or deactivate a Pro license through the native Freemius account screens, and periodically while a Pro license is active to re-check its status and deliver updates.
-
The free version does not require an account and works without contacting Freemius.
-
Terms of Service: https://freemius.com/terms/
- Privacy Policy: https://freemius.com/privacy/
Screenshots
Installation
- Upload the plugin folder to
/wp-content/plugins/australcode-bsale. - Activate the plugin from the WordPress admin “Plugins” menu.
- Navigate to Australcode Bsale Configuración (the admin is in Spanish).
- Enter your Bsale API access token (available in your Bsale account).
- Select your default office (sucursal) and configure document type preferences.
- Configure the Bsale webhook URL in your Bsale account to enable real-time stock updates.
To unlock Pro features, go to Australcode Bsale Mejorar a Pro and complete checkout through Freemius. Your Pro license activates automatically after purchase. (The admin is in Spanish; once Pro is active the same screen is labelled Licencia.)
FAQ
-
Do I need a Bsale account?
-
Yes, you need an active Bsale account with API access. The plugin connects to your existing Bsale account via API token.
-
What’s the difference between Free and Pro?
-
Free covers everything a typical Chilean e-commerce store needs: product/stock sync, manual emission of boletas and facturas, RUT validation, single-office stock, on-demand audit, real-time webhook updates. Pro adds workflow automation (auto-emission post-payment, scheduled audits, daily SKU auto-link), multi-warehouse support (multi-office stock aggregation, stock transfer between offices, per-shipping-method routing), and advanced B2B features (custom field mapping, dynamic document attributes, sales notes, automatic credit notes from refunds). The Pro features are distributed as a separate plugin (from australcode.io) and are not included in this free version.
See the Pro page for the full comparison.
-
Can I move from Free to Pro without losing my configuration?
-
Yes. Your Bsale account connection and general settings (API connection, document types, tax options) are stored independently of the Pro features, so when you move to the Pro version your existing configuration carries over — no re-entry needed.
-
What happens if I stop using Pro?
-
The free version is fully functional on its own — it keeps handling product/stock sync and manual emission of boletas and facturas. The Pro features are provided by the separate Pro version and are not part of this free plugin.
-
Is it compatible with the WooCommerce Block-based Checkout?
-
Yes, the plugin is compatible with both the Block-based Checkout (WooCommerce 8.0+) and the Classic Checkout. Chilean tax fields (RUT, razón social, giro) are added to both.
-
Can I emit boleta or factura selectively per order?
-
Yes. The order metabox allows manual override of the document type per order, useful for B2B orders where the customer requests a factura instead of a boleta. This works in both Free and Pro.
-
Does the plugin support multiple Bsale offices (sucursales)?
-
Yes — in Pro. Free supports a single configured office. Pro adds multi-office stock aggregation (sum of available units across selected offices) plus stock transfer modes for inter-office logistics.
-
What happens if a tax document emission fails?
-
Failed emissions are logged with the error reason. The order metabox includes a “Re-emit” button to retry manually. The plugin also has an automatic retry mechanism (Pro feature, configurable, opt-in) for transient failures.
-
Is the plugin HPOS compatible?
-
Yes, the plugin declares compatibility with HPOS (High-Performance Order Storage) and uses the WooCommerce data abstraction layer for all order operations.
-
Does the plugin work without Bsale (offline mode)?
-
No. The plugin is a Bsale integration — it requires an active Bsale account and API access to function. The plugin’s value is precisely the bidirectional sync between WooCommerce and Bsale.
-
How does Pro licensing work?
-
Pro is sold as an annual subscription through Freemius (Merchant of Record). After checkout your Pro license activates automatically; you can manage, sync or deactivate it from the native Freemius account screen. Freemius re-validates the license periodically while it is active. If Freemius is temporarily unreachable, your Pro features keep working — only an explicit change (refund, revocation, expiration) deactivates them.
-
Where can I find the plugin’s documentation?
-
Visit https://bsale.australcode.io for plugin documentation, support, and source code.
-
How does this plugin differ from other plugins that emit Chilean tax documents?
-
Several plugins issue Chilean boletas or facturas from WooCommerce. Australcode Bsale differs on three concrete points:
- Open-source under GPLv2 — the full source is on WordPress.org. You can audit, modify or fork it freely. No black box, no proprietary backend.
- Pro tier sold as an annual subscription via Freemius (Merchant of Record) — no pay-per-document and no per-boleta fees. Predictable cost at any volume.
- Full bidirectional sync with Bsale — not just emission: also syncs product catalog, multi-office stock, prices, stock audit ledger and movement traceability. Mature plugin in production since 2023.
-
How much does Pro cost?
-
Pro is sold as an annual subscription (or one-time lifetime license) with one site activation per license. A 5-site license is also available. Current pricing is on bsale.australcode.io.
-
Can I place the stock-by-branch widget somewhere else?
-
Yes. By default it renders under the add-to-cart form, which only exists on the standard product page. For page builders or custom templates, use the shortcode:
[acbsl_stock_by_office]Inside a product template it picks up the current product on its own. Elsewhere, name it explicitly:
[acbsl_stock_by_office product_id="123"] -
Can I change the widget from my own code?
-
Yes, through these filters and actions:
acbsl_should_render_stock_widget(filter) — decide whether the widget renders. Receives the default verdict (the product has a Bsale mapping) and the product ID. Return false to hide it, true to force it.acbsl_stock_by_office(filter) — the branch rows before they are cached and sent to the browser. Each row isoffice_name,available,in_stock. Use it to hide branches that are not open to the public, reorder them, or rename them. Note it runs before the 5-minute cache, so a per-visitor callback would leak the first visitor’s result to everyone.acbsl_stock_widget_html(filter) — the widget’s final markup. Return an empty string to suppress it.acbsl_before_stock_widget/acbsl_after_stock_widget(actions) — run right before and after the widget is emitted. Both receive the product ID.
-
Can I restyle the widget with CSS?
-
Yes. The widget inherits your theme’s colours and fonts, so it usually needs no work. To adjust the “in stock” badge text colour, set this custom property on your theme’s stylesheet:
--acbsl-badge-green-text— text colour of the in-stock badge. Defaults to#146c2e.
Every other element uses standard classes you can target directly:
.acbsl-stock-by-office(container),.acbsl-stock-toggle(button),.acbsl-stock-results(results panel).
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Australcode Facturación Electrónica SII & Stock for Bsale” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Australcode Facturación Electrónica SII & Stock for Bsale” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
3.7.6
- Fixed (important): in the free version, saving Settings wiped six options — even when saving a tab that does not touch them. Two of those options define which checkout field is the city and which is the comuna, so once they were lost the next document went to the SII with city and comuna swapped, with no warning. All sixteen options the free version does not display are now preserved intact. If this affected you, review the checkout mapping under Settings before emitting a new document.
- Fixed: customers who had already bought Pro but still had the free version installed saw an “Upgrade to Pro” screen with a button sending them to buy again, right next to the notice saying their license was active. That screen now recognises this state, shows the license as active, and offers the Pro download instead.
- Fixed: the “Save changes” button in Settings had no focus indicator, so keyboard users could not tell where they were.
- Fixed: progress counters contradicted each other across screens because each one counted its own scope without saying so. Each now names its scope, and the dashboard no longer invites you to connect Bsale when the connection is already in place.
- Fixed: the stock-per-office widget now announces itself correctly to screen readers — it reports whether it is expanded or collapsed and reads the result when it arrives — and its button meets the minimum touch target size.
- Fixed: the stock widget icon was an emoji; it is now a proper icon that inherits the theme colour.
- Changed: the plugin is now named “Australcode Facturación Electrónica SII & Stock for Bsale”. Same plugin, same data, same settings — nothing to do on your side.
- Internal: removed 59 per-request deprecation notices on PHP 8.4 and above, and fixed the two scripts that build and verify the free package, which had been failing silently since June.
3.7.5
- Fixed: the plugin no longer floods
debug.logwith Action Scheduler warnings. Two paths ran too early: the hourly self-check of scheduled tasks, and the task re-scheduling that runs once after every plugin update. Both now wait until Action Scheduler is ready, and the tasks are still scheduled — only deferred. - Changed: the licensing screen and its menu entry now read “Licencia” when Pro is active and “Mejorar a Pro” when it is not, and the Pro view states what the license covers. The card on that screen uses the same wording, so the whole screen speaks with one voice. This also removes an English label that was showing inside the Spanish admin.
- Fixed: the licensing screen was showing part of its text in English on sites running a Spanish locale other than Chilean Spanish — including
es_ES, which is what every site we know of runs. An English heading sat on top of eight bullets in Spanish. The plugin now falls back to its Chilean Spanish translation for any Spanish locale (es_ES,es_MX, and so on), and still steps aside if a translation for the exact locale is installed. - Fixed: admin interface polish, mostly on phones — the license box now stacks instead of overflowing, section actions and tabs no longer run off-screen, the save bar wraps on narrow widths, collapsible cards reopen at the right height, and focus outlines use the plugin’s own colour.
- Internal: the Pro licensing check now also requires the Pro build to be the one running, not just a valid license. No change for existing installs; it prevents Pro screens from ever appearing on a build that does not carry the Pro code.
3.7.4
- Fixed: saving settings on the free version could silently erase Pro configuration stored from a previous Pro license (shipping SKU / office mappings and payment-method mapping). Those values are now preserved when their fields are not part of the form, so reactivating Pro restores the setup intact.
- Fixed: on phones, the product and activity tables could overlap rows and cut off text. Rows now size to their content.
- Fixed: the log list showed an empty gap under each entry.
- Fixed: checkboxes and radio buttons in Settings now use the plugin’s own accent colour instead of the WordPress admin blue.
- Changed: clearer plugin description and accurate license information (single-site and 5-site licenses).
Older entries (3.7.3 and earlier) ship with the plugin, in changelog.txt.