=== 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.8 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.6.2 Contributors: integracionandreani Donate link: Tags: woocommerce, shipping, andreani, envio, etiquetas Cotizá tarifas, generá envíos, imprimí etiquetas y seguí tus pedidos con Andreani. El plugin oficial para WooCommerce en Argentina. == Description == Plugin **oficial de Andreani** para integrar sus servicios de envío en tu tienda WooCommerce. Tus clientes eligen Andreani como opción de entrega durante el checkout, y vos gestionás todos los envíos —cotización, generación, etiquetas y seguimiento— desde el panel de administración, sin salir de WooCommerce. **Disponible exclusivamente para tiendas con zonas de envío en Argentina.** Funciona para clientes **PyME, Corporativos y Middle Market**. = Novedades de la versión 1.6.0 = * **Etiquetas para clientes PyME y Middle Market** — antes era exclusivo de Corporativos; ahora todos pueden descargar la etiqueta en PDF. * **Formato de impresión configurable** — elegí A4 o etiqueta térmica (Zebra) y la cantidad de etiquetas por página. * **Descarga masiva de etiquetas** — seleccioná varios envíos en la grilla y descargá todas las etiquetas de una sola vez. * **Seguimiento en tiempo real** — el número de seguimiento aparece en el pedido apenas Andreani lo genera, sin recargar la página. * **Estado logístico automático** — el envío muestra su estado real (pendiente de ingreso, en camino, listo para retirar, entregado, no entregado) y se sincroniza solo. * **Panel "Ver mis productos"** — revisá el peso y las dimensiones de tus productos, encontrá rápido los que no tienen esos datos cargados (los que no pueden cotizar) y probá la cotización por código postal para confirmar que todo funcione. * **Detalle del pedido rediseñado** — con línea de tiempo del envío y estado de pago siempre al día. = Qué podés hacer = **En el checkout** * Método de envío "Andreani Envios" integrado en las zonas de WooCommerce. * Cálculo de tarifas 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. * Envío gratis configurable por monto mínimo y por modo de entrega. **Gestión de envíos** * Generación automática de la orden de envío al confirmar el pedido. * Grilla administrativa para gestionar todos los envíos desde un solo lugar. * Reintento de envíos que no se pudieron generar. * Exportación a CSV de los envíos. **Etiquetas** * Descarga de etiquetas en PDF para clientes PyME, Middle Market y Corporativos. * Formato de impresión configurable: A4 o etiqueta térmica (Zebra), con cantidad de etiquetas por página. * Descarga masiva desde la grilla. **Seguimiento** * Número de seguimiento visible en el pedido apenas se genera. * Estado logístico real del envío, actualizado automáticamente desde Andreani. * Línea de tiempo del envío en el detalle del pedido. **Productos** * Panel "Ver mis productos" con el peso, las dimensiones y los bultos de cada producto. * Filtro para encontrar rápido los productos sin peso o sin dimensiones — los que no pueden cotizar en el checkout. * Probador de cotización por código postal para verificar que un producto cotiza correctamente, sin tener que generar una orden. **Compatibilidad** * 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 la credencial, configurás el método "Andreani Envios" en *WooCommerce → Ajustes → Envío → Zonas de envío*. == Installation == = Requisitos previos = * WordPress 5.8 o superior y WooCommerce 5.0 o superior. * PHP 7.4 o superior. * Una tienda con zonas de envío en Argentina. * Tu **Credential ID** de Andreani (ver más abajo cómo obtenerlo). = Paso 1 — Instalar el plugin = Desde el panel de WordPress: andá a *Plugins → Añadir nuevo*, buscá **"Andreani WooCommerce"**, instalalo y activalo. También podés subir el archivo ZIP manualmente desde *Plugins → Añadir nuevo → Subir plugin*. = Paso 2 — Obtener tu Credential ID = Generá tu credencial según tu tipo de cliente: * **PyME:** https://pymes.andreani.com/integraciones/ (elegí la opción WooCommerce). * **Corporativo:** https://corporativo.andreani.com/woocommerce = Paso 3 — Configurar el método de envío = 1. Andá a *WooCommerce → Ajustes → Envío → Zonas de envío*. 2. Entrá a la zona donde querés ofrecer Andreani (o creá una nueva para Argentina). 3. Agregá el método de envío **"Andreani Envios"**. 4. Editá el método y pegá tu **Credential ID**. El plugin detecta automáticamente tu tipo de cliente al validar la credencial. 5. Ajustá las opciones que necesites: contratos, costos adicionales, envío gratis, cotizador en producto y formato de impresión de etiquetas. = Paso 4 — ¡Listo! = Tus clientes ya pueden elegir Andreani en el checkout. Gestioná todos tus envíos desde *Andreani → Envíos* en el panel de administración. == Frequently Asked Questions == = ¿Qué necesito para empezar a usar el plugin? = Una tienda WooCommerce con zonas de envío en Argentina y tu **Credential ID** de Andreani. Lo generás en https://pymes.andreani.com/integraciones/ (PyME) o https://corporativo.andreani.com/woocommerce (Corporativo). = ¿El plugin sirve para clientes PyME y Corporativos? = Sí. Soporta clientes **PyME, Corporativos y Middle Market**. El plugin detecta tu tipo de cliente automáticamente cuando validás tu Credential ID, y habilita las funciones que correspondan. = Andreani no aparece como opción en el checkout. ¿Qué reviso? = Verificá que: (1) el método "Andreani Envios" esté agregado a la **zona de envío** que cubre el código postal del comprador, (2) tu **Credential ID** esté cargado y validado, y (3) el producto tenga **peso y dimensiones** cargados (sin esos datos no se puede cotizar). Desde la versión 1.6.0, el panel **Ver mis productos** (en el menú *Andreani*) te muestra de un vistazo qué productos no tienen peso o dimensiones, y te deja probar la cotización por código postal. Activá el modo debug (ver más abajo) para ver el detalle en los logs. = ¿Puedo imprimir etiquetas siendo cliente PyME? = Sí. Desde la versión 1.6.0, la descarga de etiquetas en PDF está disponible para clientes **PyME, Middle Market y Corporativos**. Antes era exclusivo de Corporativos. = ¿Qué formatos de impresión de etiquetas soporta? = Podés elegir entre **A4** o **etiqueta térmica (Zebra)**, y configurar la **cantidad de etiquetas por página**. Se configura en las opciones del método de envío. = ¿Puedo descargar varias etiquetas a la vez? = Sí. Desde la **grilla de envíos** (*Andreani → Envíos*) seleccionás los envíos que quieras y descargás todas las etiquetas en una sola operación. = ¿Cómo veo el estado de un envío? = El estado logístico (pendiente de ingreso, en camino, listo para retirar, entregado, no entregado) se muestra en la grilla de envíos y en el detalle de cada pedido, y se **actualiza automáticamente** desde Andreani. El número de seguimiento aparece apenas Andreani genera el envío. = ¿Funciona con mi page builder (Elementor, Divi, Bricks)? = Sí. El plugin es compatible con Elementor, Divi, Bricks y otros builders mediante shortcodes (`[andreani_sucursales]` y `[andreani_dni_field]`), sin configuración adicional. Ver la sección "Para desarrolladores". = ¿Es compatible con HPOS (almacenamiento de pedidos de alto rendimiento)? = Sí, el plugin es totalmente compatible con HPOS de WooCommerce. = ¿Funciona con el checkout de bloques (Gutenberg / WC Blocks)? = El checkout clásico tiene soporte completo. Para el checkout de bloques se usa el modo manual con shortcodes; la integración nativa por Store API está planificada para una versión futura. = ¿Cómo activo los logs para diagnosticar un problema? = Activá el modo debug en la configuración del plugin. Los registros quedan disponibles en *WooCommerce → Estado → Logs*. == Screenshots == 1. Grilla de envíos: gestioná todos tus envíos de Andreani desde un solo lugar, con estado logístico, filtros y descarga de etiquetas. 2. Detalle del pedido: número de seguimiento, línea de tiempo del envío y estado de pago siempre al día. 3. Configuración del método de envío "Andreani Envios": Credential ID, contratos y opciones. 4. Selección de sucursal Andreani durante el checkout. 5. Configuración del formato de impresión de etiquetas (A4 o térmica Zebra). 6. Cotizador de envío en la página de producto. == 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, generación de órdenes de envío y descarga de etiquetas **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 - Al descargar la etiqueta de un envío y al consultar su estado de seguimiento **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 `