Andreani WooCommerce

Wopisanje

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.

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 <select> de sucursales (funciona en el <tr> legacy y en el wrapper standalone).
• .andreani-sucursales-details — Bloque con nombre y dirección de la sucursal elegida (dentro del wrapper standalone).
• .andreani-sucursales-row — Fila del checkout clásico (legacy, solo en modo auto).
• .andreani-dni-field-shortcode — Wrapper del shortcode de DNI.

El CSS del plugin solo aplica estilos estructurales (layout, spacing). Color, tipografía y font-weight se heredan del tema.

Ejemplo de override desde Apariencia → Personalizar → CSS adicional:

.andreani-sucursales-standalone { background: #f7f7f7; border-radius: 8px; padding: 1rem; }
.andreani-sucursales-select { border: 2px solid #333; }

Filters PHP

• andreani_sucursales_markup( string $html, int $instance_id, string $cp_destino ) — Modifica el markup del selector.
• andreani_dni_field_markup( string $html, string $context, array $field_args ) — Modifica el markup del campo DNI del shortcode.
• andreani_should_enqueue_checkout( bool $should, string $razon ) — Fuerza o bloquea el encolado eager de assets. $razon puede ser is_checkout, force_enqueue o ''.

Ejemplo:

add_filter( 'andreani_sucursales_markup', function( $html, $instance_id, $cp ) {
    return '<div class="mi-wrapper-custom">' . $html . '</div>';
}, 10, 3 );

Eventos JS

Emitidos en document como eventos jQuery y CustomEvent nativo — compatibles con listeners tradicionales y modernos.

• andreani:ready — El plugin terminó de bindearse. detail: { wcClassic: boolean }.
• andreani:cp-changed — El CP cambió en algún input. detail: { postcode }.
• andreani:sucursal-selected — El usuario seleccionó una sucursal. detail: { code, nombre, direccion, wrapper, postcode }.
• andreani:error — Error de AJAX o validación. detail: { code, message?, postcode?, wrapper? }.

Ejemplo (jQuery):

jQuery( document ).on( 'andreani:sucursal-selected', function( e, detail ) {
    console.log( 'Sucursal elegida:', detail.code, detail.nombre );
} );

Ejemplo (vanilla JS):

document.addEventListener( 'andreani:cp-changed', function( e ) {
    console.log( 'Nuevo CP:', e.detail.postcode );
} );

API JavaScript

El objeto window.andreaniCheckout expone:

• andreaniCheckout.ajaxUrl — URL de admin-ajax.
• andreaniCheckout.nonce — token (acción andreani_checkout_nonce).
• andreaniCheckout.i18n — strings traducidas.
• andreaniCheckout.refresh( wrapper? ) — recarga sucursales para un wrapper específico o todos si se omite el argumento.
• andreaniCheckout.getSelected( wrapper? ) — devuelve { code, nombre, direccion } de la selección actual o null.
• andreaniCheckout.init( wrapper? ) — bindea selects inyectados dinámicamente (modals, popups de Elementor, etc.).

Ejemplo:

const info = window.andreaniCheckout.getSelected();
if ( info ) console.log( info.nombre );

AJAX y nonce

Endpoint público: andreani_get_sucursales (acepta usuarios no logueados).

Acepta dos nonces durante el ciclo 1.5.x:
* nonce con acción andreani_checkout_nonce (recomendado, propio del plugin).
* security con acción update-order-review (legacy de WC, para código custom que lo use).

El nonce legacy se remueve en una versión mayor futura.

Compatibilidad

• Classic WooCommerce Checkout: soporte completo en modo auto o manual.
• Elementor / Divi / Bricks / Beaver Builder / Breakdance / Oxygen / cualquier builder futuro: modo manual con shortcodes. Funciona sin configuración adicional.
• WC Blocks Checkout (Gutenberg): sin soporte nativo en 1.5.x (requiere integración por Store API — planificada para una versión mayor futura).

Migración desde 1.4.x

La actualización a 1.5.0 es transparente — el upgrader corre automáticamente al entrar al panel de WP admin y:

1. Siembra los defaults de checkout_modo y checkout_force_enqueue si faltan.
2. Normaliza keys de config_por_modo a slug ascii-safe (fix del envío gratis con nombres acentuados).
3. Fuerza un re-login contra la API de Andreani para sincronizar credenciales con la nueva persistencia de sesión.

Si tenías código custom que dependía de:

• andreani_has_shortcode / andreani_builder_meta_keys (filters internos que no documentamos públicamente): removidos. Ya no son necesarios — los shortcodes encolan solos.
• El checkbox Forzar carga de assets: sigue funcionando pero casi nunca es necesario. Úsalo solo como último recurso.