=== Andreani WooCommerce === License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Copyright: 2025 Andreani.com Requires at least: 5.0 Tested up to: 6.8 Stable tag: 1.5.3 Contributors: integracionandreani Donate link: Tags: woocommerce, shipping, andreani, envio, logistica Plugin oficial de Andreani para envíos en WooCommerce. == Description == Plugin oficial de Andreani para integrar sus servicios de envío en tu tienda WooCommerce. Permite a tus clientes elegir Andreani como opción de entrega durante el checkout y al merchant gestionar todos los envíos desde el panel de administración. **Disponible exclusivamente para tiendas con zonas de envío en Argentina.** **Funcionalidades incluidas:** * Método de envío "Andreani Envios" integrado en las zonas de WooCommerce * Cálculo de tarifas de envío en tiempo real durante el checkout * Selección de sucursales Andreani para envíos Puerta a Sucursal * Cotizador opcional en la página de producto * Generación automática de órdenes de envío al confirmar el pedido * Descarga de etiquetas en PDF (solo para clientes Corporativos) * Grilla administrativa para gestionar todos los envíos desde un solo lugar * Exportación a CSV de los envíos * Compatible con Elementor, Divi, Bricks y otros page builders * Compatible con HPOS (High-Performance Order Storage) de WooCommerce * API pública para desarrolladores (ver sección "Para desarrolladores") **Antes de empezar:** Necesitás generar tu **Credential ID** según tu tipo de cliente: * **Clientes PyME:** https://pymes.andreani.com/integraciones/ (seleccioná la opción WooCommerce) * **Clientes Corporativos:** https://corporativo.andreani.com/woocommerce Una vez generada, configurás el método "Andreani Envios" en *WooCommerce → Ajustes → Envío → Zonas de envío*. == Installation == 1. Instale el plugin de Andreani desde el repositorio de WordPress o suba el archivo ZIP manualmente. 2. Active el plugin en la sección de Plugins de WordPress. 3. Genera tu Credential ID según tu tipo de cliente (ver sección de Descripción). 4. Vaya a WooCommerce > Ajustes > Envío > Zonas de envío. 5. Agregue el método de envío "Andreani Envios" a la zona deseada. 6. Configure el método de envío con tu Credential ID y las opciones necesarias. == External services == Este plugin se conecta a las APIs de Andreani para obtener información de envíos, calcular tarifas y gestionar órdenes de envío. **Servicio:** APIs de Andreani **Propósito:** Cálculo de tarifas de envío, obtención de información de sucursales y generación de órdenes de envío **Datos enviados:** - Información del producto (peso, dimensiones, valor) - Código postal de origen y destino - Credenciales de autenticación del cliente con Andreani - Datos de la orden de compra (cuando se genera un envío) - Información del destinatario (nombre, dirección, teléfono, email) **Cuándo se envían los datos:** - Durante el cálculo de tarifas de envío en el checkout - Al consultar sucursales disponibles para envíos a sucursal - Al generar una orden de envío después de una compra exitosa **Términos y condiciones:** https://www.andreani.com/terminos-y-condiciones **Política de privacidad:** https://www.andreani.com/politica-de-privacidad == Para desarrolladores == Guía técnica del **contrato público estable a partir de 1.5.0**. Todo lo listado acá es seguro de usar desde temas, page builders o plugins custom. Los cambios breaking se anuncian en el Changelog. = Modelo de integración = El plugin es **zero-config** en page builders. No detecta Elementor, Divi, Bricks, etc. — los shortcodes encolan sus assets al momento de renderizarse, así que funcionan automáticamente en cualquier builder que respete el contrato de shortcodes de WordPress. **Modo automático** (default): los hooks de WooCommerce inyectan el selector de sucursales y los campos DNI en el checkout clásico. **Modo manual**: los hooks quedan desactivados, el integrador usa los shortcodes donde quiera. Se configura en *WooCommerce → Envío → (tu zona) → Andreani Envios → Modo de renderizado del checkout*. = Shortcodes = * `[andreani_sucursales]` — Selector de sucursales. Carga las sucursales según el CP presente en el formulario más cercano. Soporta múltiples instancias por página. * `[andreani_dni_field context="billing|shipping"]` — Campo DNI/CUIT. El atributo `context` acepta `billing` (por defecto) o `shipping`. Los shortcodes encolan sus assets on-demand — no requieren tildar *Forzar carga de assets*. = Clases CSS públicas = Contrato estable. Seguras de usar en CSS custom: * `.andreani-sucursales-standalone` — Wrapper del shortcode de sucursales. * `.andreani-sucursales-select` — El `