=== Despacho vía Starken Pro para WooCommerce ===
Contributors: AndresReyesDev
Tags: woocommerce, shipping, chile, starken, turbus, despacho, envios, courier, tracking, etiquetas
Donate link: https://www.anyda.xyz
Requires at least: 5.5
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 2026.07.01
License: MIT License
License URI: https://opensource.org/licenses/MIT

Cálculo de despacho en línea con Starken para WooCommerce. Cotización real, despacho a domicilio y agencia (normal/express), selección de agencia en el checkout, registro automático de envíos, seguimiento con webhooks y emisión de etiquetas.

== Description ==

**El plugin de Starken para WooCommerce más completo y actualizado del mercado.**

Calcula el despacho en línea con valores reales entregados por Starken, basándose en el tamaño y peso del envío. Incluye despacho a domicilio (normal/express) y retiro en agencia (normal/express), con cotización precisa según la comuna de destino.

= Funcionalidades gratuitas =

* **Cotización en línea real** contra la API de Starken (no valores fijos ni estimaciones).
* **Despacho a domicilio** normal y express.
* **Despacho a agencia** normal y express (retiro en sucursal Starken).
* **Selección de agencia preferida** en el checkout (clásico y WooCommerce Blocks) para cotizar según la agencia específica.
* **Compatible con HPOS** (High-Performance Order Storage) y Cart/Checkout Blocks de WooCommerce.
* **Regiones y comunas de Chile** nativas (ISO 3166-2:CL), filtrado dinámico de comunas según región.
* **Validación de RUT** chileno en el checkout.
* **Caché local de cotizaciones** (transients) para reducir llamadas a la API y acelerar el checkout.
* **Dimensiones por defecto** configurables para productos sin peso/medidas.
* **Envío de emergencia** (fallback) con costo fijo si la API no responde.
* **Auto-registro de API Key** desde la configuración del plugin (un clic).
* **Botón de probar conexión** para diagnosticar problemas.
* **Panel de administración con pestañas** organizadas: Conexión, Checkout, Cálculo, Seguimiento y Depuración.
* **Log detallado** opcional para diagnosticar problemas de cotización.

= Funcionalidades Premium =

Disponibles al activar un plan en [anyda.xyz](https://www.anyda.xyz):

* **Cotizaciones ilimitadas** (el plan gratis incluye 500 cotizaciones mensuales).
* **Seguimiento de despachos (Tracking)** con consulta automática a Starken cada 6/12/24 horas.
* **Webhooks firmados** (HMAC-SHA256) para recibir actualizaciones de estado en tiempo real.
* **Notificaciones por email** al cliente cuando cambia el estado del envío (registrado, en tránsito, en destino, entregado).
* **Bloque de seguimiento público** en la página de la orden con timeline visual de progreso.
* **Meta box de tracking** en el panel de administración de la orden.
* **Registro automático de despachos** al completar la orden (POST a la API con datos del receptor).
* **Margen de ganancia** configurable (monto fijo o porcentaje) sobre el costo del envío.
* **Logo de Starken** en el checkout en reemplazo del texto.
* **Emisión de etiquetas** (básica en PDF y oficial vía Starken) disponibles vía API.

= Planes y precios =

Los planes son jerárquicos y se gestionan en [anyda.xyz](https://www.anyda.xyz):

| Plan | Precio (CLP/mes) | Incluye |
|------|-------------------|---------|
| Gratis | $0 | 500 cotizaciones mensuales |
| Pro | $5.000 | Cotizaciones ilimitadas + registro de despachos + margen de ganancia + logo |
| Tracking | +$15.000 | Seguimiento automático + webhooks + notificaciones + bloque de progreso |
| Etiqueta básica | +$10.000 | Etiquetas PDF personalizadas |
| Etiqueta oficial | +$25.000 | Emisión oficial vía Starken con cuenta corriente del cliente |

= Importante =

* Es requerida una API Key gratuita desde [anyda.xyz](https://www.anyda.xyz) válida para el dominio de tu tienda. Sin esta no funcionará el plugin.
* El plugin funciona de manera nativa con las Regiones de Chile incluidas desde WooCommerce 6.0 (ISO 3166-2:CL).
* Si usas plugins que modifican el checkout y alteran los nombres de regiones/comunas (como MkRapel, MasterBip u otros), es probable que el plugin no funcione correctamente, ya que Starken requiere nombres específicos de comunas.
* Este plugin es específico para Starken y no funcionará con otros couriers como Chilexpress.

¿Dudas? ¿Consultas? ¿Soporte? Visita [anyda.xyz](https://www.anyda.xyz) y abre un ticket desde el apartado **Soporte**. Respondemos a la brevedad.

== Installation ==

= Instalación rápida =

1. Instala el plugin desde el directorio de plugins de WordPress o sube el archivo ZIP.
2. Ve a **WooCommerce → Ajustes → Envío → Starken**.
3. Genera tu API Key gratuita automáticamente con el botón "Generar API" o regístrate en [anyda.xyz](https://www.anyda.xyz).
4. Selecciona tu **comuna de origen** (la sucursal Starken más cercana).
5. Guarda los cambios. ¡Listo! El despacho Starken aparecerá en el checkout.

= Configuración =

El panel de administración está organizado en pestañas:

**Conexión**
* Habilitar/deshabilitar Starken
* API Key (auto-generable o manual)
* Comuna de origen
* Tarjeta de plan (free/premium/inválida) con fecha de renovación

**Checkout**
* Título visible para el cliente
* Ocultar envío a agencias
* Ocultar envío express
* Logo de Starken en el checkout (Premium)

**Cálculo de envío**
* Dimensiones y peso por defecto para productos sin datos
* Margen de ganancia fijo o porcentaje (Premium)
* Envío de emergencia (fallback con costo fijo)

**Seguimiento de despachos (Premium)**
* Notificaciones automáticas por email al cliente
* Frecuencia de consulta (6/12/24 horas)

**Desarrollo y depuración**
* Log detallado de comunicación con la API
* Botón "Probar conexión"

== Frequently Asked Questions ==

= ¿No calcula bien? =

Verifica lo siguiente:
* La API Key está correctamente configurada y es válida para tu dominio.
* Los productos tienen peso y dimensiones correctos (o activa las medidas por defecto).
* La comuna de origen es correcta (para Santiago metropolitano selecciona SANTIAGO).
* Usa el botón "Probar conexión" en la configuración para diagnosticar.

= ¿La API es gratis? =

Sí, es gratis hasta 500 cotizaciones mensuales. Esto sirve para el 90% de las tiendas activas. Si necesitas más cotizaciones, pasa a Premium en [anyda.xyz](https://www.anyda.xyz).

= ¿Qué incluye el plan Premium? =

Cotizaciones ilimitadas, registro automático de despachos, seguimiento con webhooks, notificaciones por email al cliente, bloque de progreso visual en la orden, margen de ganancia configurable, logo en checkout y emisión de etiquetas.

= ¿Funciona con WooCommerce Blocks (checkout nuevo)? =

Sí, el plugin es compatible con Cart/Checkout Blocks y con HPOS (High-Performance Order Storage).

= ¿Funciona con otros couriers? =

No. Este plugin es específico para Starken. Cada courier usa nombres distintos para comunas y ciudades, por lo que no es compatible con plugins de Chilexpress u otros.

= ¿Se asegura el funcionamiento? =

Este plugin depende de los sistemas de Starken. Si estos están funcionando todos somos felices. No podemos dar garantía de funcionamiento 100%, pero haremos nuestro mejor esfuerzo por mantener la aplicación operativa.

= ¿Puedo agregar un margen al despacho? =

Sí, con el plan Premium puedes agregar un recargo fijo ($CLP) o porcentaje (%) al costo real del envío. El cliente paga el envío + tu margen.

= ¿El seguimiento es automático? =

Sí, con el plan Tracking el sistema consulta Starken cada 6, 12 o 24 horas (configurable) y actualiza el estado en la orden. También recibe webhooks firmados con HMAC-SHA256 para actualizaciones en tiempo real.

== Screenshots ==
1. Panel de administración con pestañas (Conexión, Checkout, Cálculo, Seguimiento, Depuración)
2. Cálculo de despacho en el checkout clásico con opciones de domicilio y agencia
3. Selección de agencia preferida en el checkout
4. Tarjeta de plan en la configuración (free/premium)
5. Meta box de seguimiento en la orden
6. Bloque de progreso de tracking en la página de la orden
7. Notificación de cambio de estado por email

== Changelog ==

= 2026.06.28 =

* **Nuevo: Seguimiento de despachos (Tracking)** con consulta automática a Starken cada 6/12/24 horas
* **Nuevo: Webhooks firmados** (HMAC-SHA256) para actualizaciones de estado en tiempo real
* **Nuevo: Notificaciones por email** al cliente cuando cambia el estado del envío
* **Nuevo: Bloque de progreso visual** en la página de la orden con timeline de movimientos
* **Nuevo: Meta box de seguimiento** en el panel de administración de la orden
* **Nuevo: Registro automático de despachos** al completar la orden (POST a la API)
* **Nuevo: Selección de agencia preferida** en el checkout (clásico y WooCommerce Blocks)
* **Nuevo: Cotización basada en agencia específica** para mayor precisión
* **Nuevo: Margen de ganancia** configurable (fijo o porcentaje) sobre el costo del envío
* **Nuevo: Logo de Starken** en el checkout (reemplaza el texto)
* **Nuevo: Panel de administración con pestañas** (Conexión, Checkout, Cálculo, Seguimiento, Depuración)
* **Nuevo: Botón "Probar conexión"** para diagnosticar problemas
* **Nuevo: Tarjeta de plan** en la configuración (free/premium/inválida) con fecha de renovación
* **Nuevo: Auto-registro de API Key** desde la configuración del plugin (un clic)
* **Nuevo: Envío de emergencia** (fallback) con costo fijo si la API no responde
* **Nuevo: Log detallado** opcional para diagnosticar problemas de cotización
* **Nuevo: Validación de RUT** chileno en el checkout
* **Compatible con HPOS** (High-Performance Order Storage)
* **Compatible con Cart/Checkout Blocks** de WooCommerce
* Mejora: Caché local de cotizaciones con transients
* Mejora: Caché de agencias con expiración de 12 horas
* Mejora: Filtrado dinámico de comunas según región seleccionada
* Seguridad: Verificación de firma HMAC-SHA256 en webhooks con hash_equals
* Seguridad: Nonces en todas las acciones de administración

= 2022.05.28 =

* Se agrega funcionalidad de despacho mínimo
* Mejoras de código
* Añade opción de logo en finalizar compra
* Ordenan los assets

= 2022.05.26 =

* Se agrega notice al Dashboard de WordPress con instrucciones para obtener API.
* Se agrega indicación sobre despacho desde provincia de Santiago (incluido Puente Alto y San Bernando) ya que todos estos lugares deben seleccionar SANTIAGO como origen.

= 2022.05.24 =

* Se corrigen algunos errores de la nueva versión.
* Actualizado a la versión de API de Starken Pro.
* Incluye despacho a domicilio express y agencias (normal y express).
* Incluye regiones y comunas.
* Filtra las comunas basado en la región seleccionada.

= 2022.05.23 =

* Se actualiza el plugin para la nueva API de Starken Pro.

= 2020.12.26 =

* Se mejora el sistema de cache de la API para evitar realizar la misma consulta una y otra vez al servidor. Esto mejora significativamente los tiempos de respuesta.

= 2.2.0 =

* Se eliminan referencias de código externo.

= 2.1.0 =

* Optimización de código

= 2.0.1 =

* Mejoras en Cálculo de Despacho cortesía de @melvisnap

= 2.0.0 =

* Se cambia la manera de conectar a la API, se corrigen errores y fallas. Se hace obligatorio el uso de la API gratis que sea válida para el dominio.

= 1.2.0 =

* Nuevo: Se deja la opción de asignar tamaño y peso por defecto para los productos que no lo tengan.
* Nuevo: Opción de redondear el despacho.
* Mejoras de código cortesía de @neoixan

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 2026.07.01 =
Actualización mayor. Incluye seguimiento de despachos con webhooks, notificaciones por email, registro automático de envíos, selección de agencia en el checkout, margen de ganancia, compatible con HPOS y Blocks. Si estabas usando una versión previa, actualiza y regístrate en anyda.xyz para obtener tu API Key.

= 2022.05.23 =
Actualización obligatoria. Si estabas registrado previamente, debes volver a registrarte en anyda.xyz. Sin esta actualización no podrán realizar cálculos de despacho.
