=== Adelys Connect para WooCommerce ===
Contributors: digitalek
Tags: woocommerce, crm, cotizaciones, productos, pedidos
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Cotiza en Adelys CRM con los productos de tu tienda WooCommerce, en vivo, y recibe y atiende tus pedidos desde Adelys.

== Description ==

**Adelys Connect** conecta tu tienda WooCommerce con tu cuenta de [Adelys CRM](https://adelys.app). Lo principal: cuando armas una cotización en Adelys, buscas y agregas los productos de tu tienda tal como están hoy, con su precio, existencias, imagen y descripción, sin copiar ni mantener un catálogo aparte.

Es una función de Adelys CRM: el plugin es gratuito, pero necesitas una cuenta de Adelys con la integración de WooCommerce. Página oficial, planes y guía: [adelys.app/adelys-connect.html](https://adelys.app/adelys-connect.html).

= Qué hace =

* **Cotiza con los productos de tu tienda.** En el selector de productos de una cotización, Adelys busca en tu tienda en vivo y trae título, descripción del producto, marca, categorías, precios regular y de oferta, SKU, imagen principal, enlace y disponibilidad. Si gestionas inventario, también la cantidad disponible; si registras el costo del producto, Adelys lo usa como costo interno y solo lo ven los roles con permiso de costos.
* **Productos agotados u ocultos, cuando tú lo pides.** Por defecto la búsqueda trae lo que ve un visitante de tu tienda y que tiene existencias o acepta pedidos pendientes. Con «Incluir sin stock» también salen los agotados, borradores, pendientes, privados, programados u ocultos, para cotizar lo que consigues con otro proveedor. Nunca los de la papelera.
* **Solo lectura sobre tus productos.** Adelys no crea, cambia ni borra productos, y no guarda tu catálogo: lo consulta cuando lo necesitas.
* **Pedidos al instante.** Cada pedido nuevo y cada cambio se envían a Adelys en segundo plano, con Action Scheduler, sin frenar tu checkout. Si Adelys no responde, el plugin reintenta a los 1, 5, 15, 60 y 240 minutos.
* **Pedidos en los dos sentidos.** Desde Adelys puedes cambiar el estado de un pedido, agregar notas privadas o para el cliente, reenviar los correos de WooCommerce, editar la dirección de envío o facturación y registrar reembolsos manuales. Cada cambio deja una nota privada en el pedido con el usuario de Adelys que lo hizo.

No muestra publicidad y no se comunica con ningún servicio que no sea Adelys (ver «External services»).

= Requisitos =

* Una cuenta de Adelys CRM con la integración de WooCommerce.
* WordPress 6.2 o superior y PHP 7.4 o superior con la extensión sodium (viene con PHP 7.4).
* WooCommerce 8.0 o superior (probado hasta 11.2). Compatible con el almacenamiento de pedidos de alto rendimiento (HPOS).
* Tu sitio debe usar https y responder en la API REST de WordPress.

= Seguridad =

* Conexión con un código de un solo uso que dura 15 minutos: nunca copias ni pegas un secreto.
* El secreto de la conexión se guarda cifrado (libsodium) con las claves de seguridad de tu `wp-config.php` y nunca se muestra en pantalla.
* Cada petición, en los dos sentidos, va firmada con HMAC-SHA256, con fecha (±5 minutos) y un nonce de un solo uso. Las claves son distintas en cada sentido.
* Las rutas REST del plugin rechazan cualquier petición sin firma válida y limitan el tamaño del cuerpo y la cantidad de peticiones por minuto.

== External services ==

Este plugin se conecta con **Adelys CRM** (`https://api.adelys.app`), el servicio de Digitalek con el que gestionas tu tienda desde Adelys. Sin una cuenta de Adelys y sin conectar la tienda, el plugin no envía nada.

Qué envía tu tienda a Adelys, y cuándo:

* **Al conectar** (cuando pegas el código y pulsas «Conectar»): el código de emparejamiento, la dirección de tu sitio, el nombre de la tienda, la moneda y las versiones del plugin, de WooCommerce y de WordPress. Después, una confirmación firmada.
* **Cada vez que se crea o cambia un pedido** (en segundo plano), y cuando pulsas «Reenviar pedidos recientes» (los de los últimos 7 días): número, estado, fechas, importes, método de pago, nota del cliente, direcciones de facturación y envío (nombre, empresa, dirección, teléfono y correo de facturación, y el RUC o la cédula del comprador si tu tienda lo guarda), líneas del pedido con sus metadatos visibles y métodos de envío.
* **Cuando Adelys consulta tu tienda** (al buscar productos para una cotización, abrir o refrescar un pedido): los productos que pide (título, descripción del producto, marca, categorías, precios, costo, cantidad, SKU, imagen principal, enlace, disponibilidad y estado de publicación) y los datos del pedido, con sus últimas notas.
* **Al desconectar** desde WordPress: un aviso para que Adelys revoque la conexión.
* **Cuando Adelys pide un diagnóstico** (1.4.0, para ayudarte desde soporte): versiones del plugin, de WooCommerce y de WordPress, la regla para reconocer productos de Intcomex con cuántos productos la cumplen y hasta 5 nombres, si hay correo para las órdenes de Adelys y de dónde sale (no el correo), cuántos envíos esperan y los últimos errores de envío sin correos, teléfonos ni direcciones.
* **Para buscar actualizaciones** (1.4.0, cuando WordPress revisa las actualizaciones, como mucho cada 12 horas): tu sitio descarga `https://adelys.app/descargas/adelys-connect.json` sin enviar ningún dato del sitio, y el paquete nuevo de `https://adelys.app/descargas/` cuando actualizas.

No se envían contraseñas, datos de tarjetas ni datos de tus usuarios de WordPress. Todo viaja por https y firmado.

* Términos del servicio: https://adelys.app/legal.html
* Política de privacidad: https://adelys.app/legal.html#privacidad

== Installation ==

1. Instala y activa WooCommerce 8.0 o superior.
2. Instala Adelys Connect desde Plugins → Añadir plugin (o sube el .zip que descargas en https://adelys.app/descargas/adelys-connect.zip) y actívalo.
3. En Adelys CRM, ve a Pedidos → Conexión WooCommerce, pulsa «Generar código de conexión» y luego «Copiar».
4. En WordPress, ve a WooCommerce → Adelys Connect, pega el código y pulsa «Conectar». El código dura 15 minutos y sirve una sola vez.

Instructivo con capturas, paso a paso: https://docs.adelys.app/conexiones/conectar-tu-tienda-woocommerce.html
5. Si quieres traer los pedidos de la última semana, pulsa «Reenviar pedidos recientes».

== Frequently Asked Questions ==

= ¿Qué datos salen de mi tienda hacia Adelys? =

Solo los necesarios para cotizar y atender tus pedidos desde Adelys. El detalle, y cuándo se envía cada cosa, está en «External services».

= ¿Adelys puede modificar mis productos? =

No. Los productos son de solo lectura. Lo único que Adelys puede escribir son las acciones sobre pedidos que se describen arriba.

= ¿Los reembolsos devuelven el dinero al cliente? =

No. Son reembolsos manuales: quedan registrados en WooCommerce pero no llaman a la pasarela de pago ni reponen inventario. Devuelve el dinero por el medio que corresponda.

= ¿Necesito una cuenta de Adelys? =

Sí. El plugin es gratuito, pero cotizar con tus productos y atender tus pedidos se hace en Adelys CRM. Planes: https://adelys.app/adelys-connect.html

= ¿Adelys guarda una copia de mis productos? =

No. Los consulta en vivo cuando buscas en una cotización. Al guardar una cotización, Adelys conserva una copia de la imagen de cada línea agregada desde la tienda, para que el documento no cambie si cambias la foto en tu tienda.

= Los pedidos tardan en llegar a Adelys =

Los envíos usan Action Scheduler, que depende de WP-Cron. Si tu sitio tiene pocas visitas, configura un cron real en tu hosting. Revisa el último envío y el último error en WooCommerce → Adelys Connect.

= ¿Qué pasa si cambio las claves de seguridad de wp-config.php? =

El secreto guardado deja de poder descifrarse. Desconecta y vuelve a conectar con un código nuevo.

== Screenshots ==

1. El selector de productos de una cotización en Adelys CRM: busca en tu tienda WooCommerce y agrega varios productos a la vez, con precio, existencias, imagen y descripción.
2. Los pedidos de tu tienda en Pedidos de Adelys, filtrados por origen WooCommerce.
3. La ficha de un pedido de la tienda en Adelys: cambia su estado, agrega notas o refréscalo desde la tienda.
4. WooCommerce → Adelys Connect antes de conectar: pega el código de un solo uso que generas en Adelys.
5. La tienda conectada: organización de Adelys, último envío y acciones.

== Changelog ==

= 1.4.1 =
* Los pedidos llegan a Adelys con el RUC o la cédula del comprador si tu tienda lo guarda (claves habituales de Panamá o la que indiques en «Clave del RUC»), para enlazar la venta con la ficha del cliente.

= 1.4.0 =
* Se actualiza solo desde adelys.app: WordPress muestra «Actualizar ahora» y puedes activar las actualizaciones automáticas en Plugins. El paquete solo se acepta de adelys.app y se verifica con su huella sha256 antes de instalarlo.
* Asistente de puesta en marcha en 3 pasos (conectar, cómo reconocer productos de Intcomex con vista previa, correo de las órdenes de Adelys). Puedes saltar un paso y volver a él.
* Adelys puede pedir un diagnóstico de la tienda (versiones, regla de Intcomex, correo de las órdenes, envíos pendientes y últimos errores), sin datos de tus clientes.
* Los pedidos llegan a Adelys con el ITBMS de cada línea.

= 1.3.1 =
* La confirmación y los avisos de las órdenes que crea Adelys llegan al correo de ventas (nuevo ajuste «Correo de las órdenes de Adelys»; vacío = el remitente de WooCommerce), no al de administración de WordPress. Tus demás órdenes no cambian.

= 1.3.0 =
* Adelys puede crear una orden en tu tienda (`/pedidos/crear`) con los productos que elijas, a los precios de tu tienda y en estado «Procesando», sin datos de tu cliente final. La misma referencia nunca crea dos órdenes.
* Rechaza con el motivo los productos que no existen, no están publicados o no tienen existencias.
* Lee el número de confirmación de Intcomex de la orden (un metadato configurable o una nota con el patrón que elijas) y marca los productos de Intcomex según la regla que configures (metadato, categoría, etiqueta o marca/proveedor).
* Nueva sección «Pedidos para Intcomex» en WooCommerce → Adelys Connect.
* Los cambios de las órdenes que creó Adelys (cancelada, reembolsada, completada, la nota con el número de Intcomex) llegan a Adelys al momento, sin volverse un pedido nuevo.

= 1.2.1 =
* Instrucciones más claras para conectar tu tienda: tres pasos en la pantalla del plugin, el recuadro del código más grande, mensajes de error que dicen qué hacer y «¿Algo no funciona?» con las causas comunes.

= 1.2.0 =
* Cotizaciones con la descripción completa del producto (con sus párrafos y viñetas), no la corta.

= 1.1.0 =
* Adelys puede pedir también productos agotados, borradores, pendientes, privados, programados, ocultos o con contraseña (`incluir_sin_stock`), para cotizar lo que consigues con otro proveedor. Nunca los de la papelera ni las variaciones sueltas.
* Por defecto la búsqueda ya no devuelve los productos agotados (sí los que aceptan pedidos pendientes).
* Cada producto trae su estado (`estado`) y si lo ve un visitante (`publico`).

= 1.0.1 =
* Los productos traen el costo interno (`costo`: costo de WooCommerce 9.x+ si está activado, o el de los plugins Cost of Goods más usados; una variación sin costo toma el de su producto) y la cantidad disponible (`cantidad`, solo si el producto gestiona inventario).
* Los títulos y textos normalizan los espacios raros (no separable, finos, de ancho cero) a un espacio normal.

= 1.0.0 =
* Primera versión: emparejamiento por código, productos en vivo, envío de pedidos en tiempo real y acciones sobre pedidos desde Adelys.

== Upgrade Notice ==

= 1.4.1 =
Envía el RUC del comprador a Adelys si tu tienda lo guarda.

= 1.4.0 =
Desde esta versión el plugin se actualiza solo desde adelys.app. Incluye el asistente de puesta en marcha y el ITBMS por línea.

= 1.3.1 =
Los avisos de las órdenes creadas desde Adelys van a tu correo de ventas, no al de administración.

= 1.3.0 =
Crea órdenes en tu tienda desde Adelys y lee el número de confirmación de Intcomex.

= 1.2.1 =
Instrucciones más claras para conectar tu tienda.

= 1.2.0 =
Las cotizaciones traen la descripción completa del producto.

= 1.1.0 =
Cotiza también productos agotados, borradores u ocultos cuando lo pidas desde Adelys; por defecto la búsqueda ya no trae los agotados.

= 1.0.1 =
Costo interno y cantidad disponible en los productos; textos sin espacios raros.

= 1.0.0 =
Primera versión.
