Australcode Facturación Electrónica SII & Stock for Bsale
| 开发者 | australcode |
|---|---|
| 更新时间 | 2026年10月1日 03:03 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- 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, with an optional email summary of the discrepancies found.
- 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.
- 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. Results go to the same notification email as on-demand audits.
- 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.
- WooCommerce 7.0 or later
- A Bsale account with API access
- WordPress 6.1 or later, PHP 7.4 or later
安装:
- Install the plugin from Plugins → Add New in your WordPress admin, or upload its folder to
/wp-content/plugins/australcode-dte-stock-sync-bsale. - Activate the plugin from the WordPress admin "Plugins" menu.
- Navigate to 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.
屏幕截图:
常见问题:
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.
Does rotating WordPress's security salts affect the plugin?
No. Since 3.8.8 the Bsale token is encrypted with the plugin's own key, stored in the database when it is first needed. To keep the key out of the database, define ACBSL_ENCRYPTION_KEY in wp-config.php; a token saved earlier moves to it on the next request. Once it is in use, do not change or remove that constant: the token becomes unreadable and you will have to enter it again.
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 connection between WooCommerce and Bsale.
How does Pro licensing work?
Pro is sold as an annual subscription (or a one-time lifetime license) 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.
What does the plugin cover besides issuing documents?
- Catalog sync — products, variants, SKUs, prices and stock come from Bsale into WooCommerce, with real-time stock webhooks. Multi-office stock is a Pro feature.
- Stock audit and traceability — an on-demand audit compares WooCommerce and Bsale stock, and a read-only ledger records every stock movement.
- No per-document fees — the free version issues boletas, facturas and credit notes at no cost per document; Pro is a flat subscription or lifetime license.
- Open source under GPLv2 — the full source of the free version is on WordPress.org. The plugin is 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?
The stock-by-branch widget is a Pro feature. 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, in Pro, 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 tune the webhook endpoint from my own code?
Yes, through these filters. The defaults fit Bsale's traffic, so most stores never need them:
acbsl_webhook_max_payload_bytes(filter) — largest request body the endpoint accepts, in bytes. Defaults to 1 MB; larger requests get HTTP 413.acbsl_webhook_rate_limit_per_min(filter) — requests per minute per IP that have not proven they come from your Bsale account (no matchingcpnIdor token). Defaults to 60. Return 0 to disable the limit.acbsl_webhook_rate_limit_per_min_authenticated(filter) — the same limit for requests that carry your account'scpnIdor the webhook token. Defaults to 1200, well above a Bsale burst, because Bsale sends every notification from a few IPs.acbsl_webhook_queue_time_budget(filter) — seconds each queue run may spend processing webhooks one by one. Defaults to 60, or half ofmax_execution_timeif that is lower.
Can I restyle the widget with CSS?
Yes (Pro). 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.
.acbsl-stock-by-office (container), .acbsl-stock-toggle (button), .acbsl-stock-results (results panel).
更新日志:
- Fixed: the Bsale token and the webhook secret no longer depend on WordPress's security salts. Before, rotating the salts (a standard step after a security incident) left them unreadable, and the plugin kept calling Bsale with the encrypted value: every call failed with 401. They now use their own encryption key and move to it on the first request after updating.
- Fixed: if the saved token cannot be read, the admin shows a persistent notice asking you to enter it again, and the plugin makes no calls to Bsale until you do. A rejected token no longer deletes the link between WooCommerce customers and their Bsale clients.
- Fixed: when an order is waiting for a stock transfer guide, receiving the guide in Bsale replaces the partial sales note with a complete one again, so the whole order stays reserved. It also works when the guide goes to a branch other than the main one.
- Fixed: when a store converts an order's sales note (nota de venta) into a boleta or factura inside Bsale, the plugin now finds that document and records it on the order instead of trying to issue another one. Before, it reported "no stock available" (the conversion had already used the stock), and issuing it by hand would have created a duplicate tax document.
- Fixed: if the document converted in Bsale does not match what the order charged, the plugin stops with a clear message instead of recording it or issuing another.
- Fixed: two translatable error messages about stock lost their note for translators in the published package, which WordPress.org's Plugin Check reports as an error. No change in how the plugin works.
changelog.txt.