=== BlumiDTE ===
Contributors: ragdev, blumidte, blumispa
Tags: electronic invoicing, chile, sii, dte, tax
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.3.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Official electronic invoicing integration for SII Chile. Automated emission of electronic receipts (Boletas) and invoices (Facturas).

== Description ==
BlumiDTE connects WordPress and WooCommerce stores directly with the Chilean Internal Revenue Service (Servicio de Impuestos Internos - SII) for automated, certified electronic invoicing.

Easily issue official Chilean electronic receipts (Boleta Electrónica - DTE 39) and electronic tax invoices (Factura Electrónica - DTE 33) in real time. Zero server configuration or digital certificate uploading required on your WordPress server: digital signature, CAF folio administration, TED barcode generation, and legal SII dispatch are securely managed via the official BlumiDTE cloud API (https://dte.blumi.cl).

= Key Features =
* Automatic DTE emission triggered upon order payment (Processing or Completed status).
* Native support for Chilean electronic receipts (Boleta 39) and tax invoices (Factura 33).
* Optional customer invoice request form on Checkout with strict Chilean RUT Module 11 validation.
* Direct official PDF attachment (with electronic tax barcode TED) delivered to the customer confirmation email.
* Certified compatibility with WooCommerce High-Performance Order Storage (HPOS) and Checkout Blocks.
* Seamless sandbox testing (SII Maullín environment) and production live mode (SII Palena).

== Installation ==
1. Upload the `blumidte` folder to the `/wp-content/plugins/` directory, or install the `.zip` file via your WordPress Admin under "Plugins > Add New".
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Navigate to WooCommerce > Settings > BlumiDTE.
4. Enter your BlumiDTE API Key obtained from https://dte.blumi.cl (or create your account directly from the settings tab).
5. Save changes. Your store is now ready for automatic certified invoicing with the Chilean SII.

== Frequently Asked Questions ==
= Where do I obtain my API Key? =
Sign in to your account at https://dte.blumi.cl, open the "API & Integration" sidebar menu, and copy your API Key.

= Can I test transactions before issuing live tax documents? =
Yes. You can enter a test API key (blumi_test_...) to simulate document generation and signing in the official SII Maullín sandbox without legal tax obligations.

== External Service Disclosure ==
This plugin connects to an external 3rd-party SaaS service: BlumiDTE Cloud API (https://dte.blumi.cl).

* What service is used and why?
BlumiDTE is a certified Chilean electronic invoicing platform operated by Blumi SpA. It provides the digital signing infrastructure, CAF authorization management, and encrypted dispatch to the Chilean Internal Revenue Service (Servicio de Impuestos Internos - SII) to issue legally valid electronic tax documents (DTE 33 Facturas and DTE 39 Boletas).

* What data is transmitted?
When a tax document is issued, order transaction details (product descriptions, quantities, unit prices, tax amounts, shipping totals) and customer billing data (Chilean RUT, business name, commercial activity/giro, address, and email) are transmitted over encrypted HTTPS to https://dte.blumi.cl to be stamped and registered with the Chilean SII.

* Terms of Service and Privacy:
- Terms of Service: https://blumi.cl
- Privacy Policy: https://blumi.cl

== Screenshots ==
1. BlumiDTE settings panel in WooCommerce with live connection status and API key configuration.
2. Checkout invoice request form with real-time Chilean RUT Module 11 validation.
3. Order details metabox showing Folio number, Track ID, and direct link to PDF with TED barcode.

== Changelog ==
= 1.3.6 =
* fix: Blindaje estricto del validador de RUT chileno en checkout (`is_valid_rut`) para evitar TypeErrors en PHP 8.x (`ctype_digit` y casteo entero).
* fix: Encolado correcto de scripts en pestaña de administración vía `wp_enqueue_script` y `wp_add_inline_script` conforme a las directrices de WordPress.org.
* doc: Actualización de colaboradores oficiales y divulgación de servicios externos conectados (API BlumiDTE).

= 1.3.5 =
* fix: Normalización de codificación UTF-8 en metadatos de receptor y emisor para timbrado SII.
* feat: Optimización en la descarga y adjunto de comprobantes PDF con timbre TED en correos transaccionales.

= 1.3.4 =
* sec: Validación y sanitización estricta de subida de certificado digital ($_FILES) para cumplimiento de WordPress.Security.ValidatedSanitizedInput.
* fix: Sincronización oficial de Stable Tag 1.3.4 y empaquetado Unix nativo.

= 1.3.3 =
* fix: Corregido el parser de verificación de API Key para aceptar respuestas canónicas JSON de la empresa emisora sin requerir wrapper redundante.
* fix: Normalización de metadatos de vigencia de certificado digital (días restantes y estado activo) para el monitor de folios.

= 1.3.2 =
* feat: Botón "Probar Conexión" interactivo junto a la API Key para validar en tiempo real la conexión con dte.blumi.cl y autenticación ante el SII sin necesidad de guardar primero.
* sec: Endpoint AJAX seguro con nonces criptográficos y sanitización estricta para la prueba de credenciales.

= 1.3.1 =
* fix: Unificación total de la experiencia de administración: "Consola BlumiDTE" y "Ajustes API" dirigen directamente a la Consola Oficial sin pantallas intermedias.
* fix: Redirección automática desde WooCommerce > Ajustes > BlumiDTE hacia la Consola Oficial para evitar interfaces duplicadas o desincronizadas.
* ui: Barra superior de marca 100% en fondo blanco puro (#ffffff) con bordes tenues acordes a la identidad oficial de Blumi y bust de caché CSS.

= 1.3.0 =
* feat: Consola integral de Facturación y Finanzas en WordPress con bento grid de métricas (Facturación Bruta, Ingreso Neto Real y Reserva IVA Débito F29).
* feat: Historial de DTEs emitidos con buscador en tiempo real y descarga de PDF oficial con timbre TED.
* feat: Monitor de Folios CAF autorizados por el SII con alertas de agotamiento y gestión de Certificado Digital (.pfx).
* feat: Inteligencia de Inventario WooCommerce con cálculo de valor de bodega en Neto real líquido e IVA retenido para el Fisco.
* fix: 100% de cumplimiento con las directrices oficiales de WordPress.org (Plugin Check) y eliminación de archivos ocultos.
* refactor: Estandarización de text domain 'blumidte' y compatibilidad con WordPress 6.7 y 7.1.

= 1.2.0 =
* feat: Direct physical PDF attachment (with TED barcode) attached to customer order confirmation emails.
* feat: Multi-hook automated dispatch supporting Chilean payment gateways (Webpay Plus, Flow, Mercado Pago) on 'processing' and 'completed' statuses.
* fix: Certified compatibility with High-Performance Order Storage (HPOS) and Cart/Checkout Blocks.
* fix: Chilean SII price calculations: Gross tax-inclusive prices for Boletas (39) and Net prices for Facturas (33).
* sec: Concurrency lock preventing double-emission on simultaneous gateway webhooks.
* ui: Clean settings design matching the official Blumi brand identity.
* feat: In-app account registration and plan upgrade powered by Webpay Plus from the WordPress admin.

= 1.0.0 =
* Initial release of BlumiDTE for WordPress and WooCommerce.
