Descripción
PWL DTE para Bsale conecta tu tienda WooCommerce con Bsale, la principal plataforma de facturación electrónica y punto de oferta en Chile. Cuando un pedido se completa, el plugin genera automáticamente el documento de impuesto correspondiente (boleta o factura electrónica) y lo presenta al SII.
Características clave
- Boleta electrónica automática — se genera al completar el pedido (codeSii 39)
- Factura electrónica — el cliente marca «Necesito factura» en finalizar compra e indica su RUT y razón social
- Validación de RUT en tiempo real — verificación del dígito verificador con respuesta inmediata
- Compatible con finalizar compra clásico y por bloques — funciona con el finalizar compra por shortcode de WooCommerce y con el finalizar compra por bloques (WC 8.6+)
- Sincronización manual de inventario — actualiza el inventario de WooCommerce desde Bsale con un clic
- Prevención de duplicados — usa referenceId para no emitir el mismo DTE dos veces
- Shortcode
[pwl_dte]: muestra el documento de impuesto en la página de confirmación del pedido o en «Mi cuenta» - Entorno de prueba — prueba sin afectar documentos reales ante el SII
- Registros de actividad — historial detallado de cada DTE emitido con estado y número de folio
Requisitos
- WordPress 6.0 o superior
- WooCommerce 8.0 o superior
- PHP 8.0 o superior
- Cuenta activa de Bsale con token de API
Lite frente a Pro
La edición gratuita (Lite) incluye boleta, factura, campos en el pago, sincronización manual de inventario y shortcode de DTE.
La versión Pro añade: sincronización automática de existencias mediante cron, sucursal dedicada para el inventario, compatibilidad multi-sucursal (método de envío asignación de sucursal), reintentos automáticos para DTE fallidos, webhooks en tiempo real y facturas rectificativas en devoluciones.
Pro edition (commercial): Bsale DTE Pro — purchase and details on PluginLATAM
Servicios externos
Este plugin se conecta a la API de Bsale para generar y gestionar documentos de impuesto electrónicos (DTE) obligatorios por la normativa chilena (SII).
Qué datos se envían y cuándo
- Al completarse un pedido de WooCommerce, los datos del pedido (productos, cantidades, precios y datos de facturación del cliente como RUT y razón social) se envían a Bsale para crear un documento de impuesto (boleta o factura electrónica).
- Cuando el administrador de la tienda ejecuta la sincronización manual de inventario, se envían los SKU de los productos para recuperar los niveles de inventario actuales desde Bsale.
- Al probar la conexión a la API desde la página de ajustes, se hace una petición sencilla para verificar que el token es válido. No se envían datos de clientes.
Información del servicio
- Sitio web de Bsale: https://www.bsale.cl/
- Documentación de la API de Bsale: https://docs.bsale.dev/
- Hosts de API que usa este plugin:
- URL base de la API que usa el cliente:
https://api.bsale.io/v1/ - Uso adicional de la API v2 (para la importación de productos y la lectura de recursos en webhooks):
https://api.bsale.io/v2/
- URL base de la API que usa el cliente:
- Condiciones de uso: https://www.bsale.cl/sheet/condiciones-uso
- Política de privacidad: https://www.bsale.cl/sheet/politica-privacidad
Instalación
- Sube el plugin a
/wp-content/plugins/pwl-dte-for-bsale/o instálalo desde el directorio de plugins de WordPress. - Activa el plugin a través del menú «Plugins» de WordPress.
- Ve a «PWL DTE Ajustes» e introduce tu token de API de Bsale.
- Selecciona el entorno (prueba o producción) y la sucursal emisora.
- Haz clic en «Probar conexión» para comprobar que el token es válido.
- ¡Listo! Los DTE se generarán automáticamente al completarse los pedidos.
FAQ
-
¿Necesito una cuenta de Bsale?
-
Sí. Este plugin requiere una cuenta activa de Bsale y un token de API con permiso para emitir documentos.
-
¿Funciona en entorno de pruebas?
-
Sí. En «Ajustes Conexión» puedes activar el modo entorno de pruebas para probar sin emitir documentos reales ante el SII.
-
¿Qué ocurre si falla la generación del DTE?
-
El error queda registrado en «PWL DTE Registros DTE» con el mensaje de error de Bsale. Puedes reintentar manualmente desde la caja meta del pedido en la administración de WooCommerce.
-
¿Es compatible con el pago por bloques de WooCommerce?
-
Sí. Los campos RUT, nombre de la empresa y actividad económica funcionan tanto en el pago clásico ([woocommerce_checkout]) como en el pago por bloques (WC 8.6+).
-
¿El plugin descuenta inventario en Bsale?
-
Sí, si la opción está activa en los ajustes. Puedes controlarlo mediante el parámetro dispatch en los ajustes del documento.
-
¿Dónde veo los DTE generados?
-
Cada pedido de WooCommerce incluye una caja meta «Bsale — Documento de impuesto» con el tipo de documento, folio, estado y enlaces al PDF y a la URL pública. También puedes ver el historial completo en PWL DTE Registros DTE.
-
¿El plugin está traducido al español?
-
Yes. Volunteers add and update translations on translate.wordpress.org. If your WordPress dashboard is in Spanish, the plugin’s admin screens can appear in Spanish like other plugins.
-
Where can I buy or learn more about the Pro version?
-
The commercial Pro edition is available from PluginLATAM: Bsale DTE Pro — WooCommerce integration.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«PWL DTE para Bsale» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«PWL DTE para Bsale» está traducido en 2 idiomas. Gracias a los traductores por sus contribuciones.
Traduce «PWL DTE para Bsale» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
2.1.0
- Lite build: WordPress.org distribution no longer references the Pro-only license client in composer.json (require/repositories scrubbed at build time).
- Pro: PWL License client integration and license admin flow updates.
- Readme: added link to the commercial Pro product page on PluginLATAM.
- Readme: removed «Source Code and Build Tools» section from the plugin directory readme.
2.0.10
- Readme: simplified FAQ answer about Spanish translations (end-user wording).
2.0.9
- Corrección: detectar WooCommerce en plugins_loaded para que el orden alfabético de carga de plugin no muestre un aviso falso de «requiere WooCommerce».
- Corrección: cargar las traducciones al instante (evita un hook anidado en plugins_loaded) y usar como respaldo el archivo es_CL.mo incluido para configuraciones regionales en español (p. ej. es_ES) cuando no exista un archivo específico para la configuración regional.
2.0.8
- i18n: cadenas fuente en inglés (msgid) para traductores; catálogo completo en español de Chile (es_CL) y POT actualizado.
- Descripción de la cabecera del plugin alineada con las expectativas de metadatos en inglés de WordPress.org.
2.0.7
- Eliminada la lógica automática de desactivación cruzada entre plugins para cumplir la política de activación de WordPress.org (el usuario resuelve manualmente conflictos Lite/Pro).
- Cerradas las actualizaciones de coherencia 2.0.7 en metadatos del plugin y documentación de release.
2.0.6
- Corregidos hallazgos del escáner Plugin Check reforzando consultas preparadas en eventos de webhook.
- Sustituidas las llamadas de registro en tiempo de ejecución de la implementación anterior por la integración con el logger de WooCommerce para un registro seguro en producción.
- Mayor coherencia entre versiones publicadas y compilación, y validación de metadatos (incluidas salvaguardas de URI en la cabecera del complemento y flujo de despliegue sin cambio de versión).
2.0.5
- Mayor cumplimiento de la revisión de WordPress.org en escape, carga de recursos en el admin e i18n.
- Añadido flujo E2E Lite ejecutable con Playwright y actualizada la documentación de pruebas Lite.
2.0.0
- Plugin renombrado a PWL DTE para Bsale (slug: pwl-dte-for-bsale) para cumplir la política de marcas de WordPress.org.
- Scripts en línea migrados a wp_add_inline_script() según buenas prácticas de WordPress.
- Añadida la sección «Servicios externos» en el readme documentando el uso de la API de Bsale.
1.0.5
- Versión heredada anterior al nombre actual del plugin conforme a marcas.
1.0.1
- Corrección: en el finalizar compra por bloques (WC Blocks), el campo «Necesito factura electrónica» se lee correctamente usando el prefijo _wc_other/ que WooCommerce Blocks usa internamente. Corrige el problema por el que siempre se generaba una boleta en lugar de una factura con el finalizar compra por bloques.
1.0.0
- Primera versión pública.
- Generación automática de boleta y factura electrónica al completar el pedido.
- Campos RUT, razón social y giro en finalizar compra (clásico y bloques).
- Validación de RUT en tiempo real vía AJAX.
- Sincronización manual de inventario desde Bsale.
- Shortcode DTE para mostrar el documento en el sitio público.
- Modo entorno de pruebas para pruebas.
- Registros de actividad con filtros.