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:

Siembra los defaults de checkout_modo y checkout_force_enqueue si faltan.
Normaliza keys de config_por_modo a slug ascii-safe (fix del envío gratis con nombres acentuados).
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.

Andreani WooCommerce