PWL DTE for Bsale

Description

PWL DTE for Bsale connects your WooCommerce store with Bsale, the leading electronic invoicing and point-of-sale platform in Chile. When an order is completed, the plugin automatically generates the corresponding tax document (boleta or factura electrónica) and submits it to the SII.

Key Features

• Automatic boleta electrónica — generated when an order is completed (codeSii 39)
• Factura electrónica — customer checks “I need an invoice” at checkout and provides their RUT and company name
• Real-time RUT validation — check digit verification with instant feedback
• Classic and Blocks checkout compatible — works with WooCommerce shortcode checkout and the new Blocks checkout (WC 8.6+)
• Manual stock sync — update WooCommerce stock from Bsale with one click
• Duplicate prevention — uses referenceId to avoid issuing the same DTE twice
• [pwl_dte] shortcode — display the tax document on the order confirmation page or My Account
• Sandbox mode — test without affecting real SII documents
• Activity logs — detailed record of every DTE issued with status and folio number

Requirements

• WordPress 6.0 or higher
• WooCommerce 8.0 or higher
• PHP 8.0 or higher
• Active Bsale account with API token

Lite vs Pro

The free (Lite) edition includes boleta, factura, checkout fields, manual stock sync, and DTE shortcode.

The Pro version adds: automatic cron-based stock sync, dedicated stock office, multi-office support (shipping method → office mapping), automatic retry for failed DTEs, real-time webhooks, and credit notes on refunds.

External Services

This plugin connects to the Bsale API to generate and manage electronic tax documents (DTEs) required by Chilean tax law (SII).

What data is sent and when

• When a WooCommerce order is completed, the order details (products, quantities, prices, and customer billing information such as RUT and company name) are sent to Bsale to create a tax document (boleta or factura electrónica).
• When manual stock sync is triggered by the store admin, product SKUs are sent to retrieve current stock levels from Bsale.
• When testing the API connection from the settings page, a simple request is made to verify the token is valid. No customer data is sent.

Service information

• Bsale website: https://www.bsale.cl/
• Bsale API documentation: https://docs.bsale.dev/
• API hosts used by this plugin:
  • Default API base URL used by the client: https://api.bsale.io/v1/
  • Additional v2 endpoint usage (for product import and webhook resource reads): https://api.bsale.io/v2/
• Terms of service: https://www.bsale.cl/sheet/condiciones-uso
• Privacy policy: https://www.bsale.cl/sheet/politica-privacidad

Source Code and Build Tools

This plugin includes generated production assets under assets/ (for example assets/admin/js/admin.js and assets/public/js/checkout*.js).

The non-compiled source code is publicly available in the project repository:

• Source repository: https://github.com/PluginLATAM/PWL-dte-for-bsale-lite
• JavaScript/CSS source files: resources/admin/ and resources/public/
• Build configuration: package.json, vite.config.js, tailwind.config.js, postcss.config.js

To build assets locally:

1. Install dependencies: npm install
2. Development/watch mode: npm run dev
3. Production assets build: npm run build