Andreani WooCommerce

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.4

• Pestaña “Mi cuenta” — los datos de tu cuenta de Andreani, la dirección desde la que despachás y la sucursal de origen, todo en un solo lugar.
• Sucursal de origen a tu elección — fijá la sucursal desde la que salen tus envíos; si no elegís ninguna, Andreani la sigue asignando por tu código postal, igual que antes.
• Tu tienda como remitente — la etiqueta vuelve a mostrar el nombre y la dirección de tu tienda; el nombre se precarga con el de tu empresa en Andreani y lo podés editar.
• Checkout por bloques de WooCommerce — soporte nativo: el selector de sucursal de retiro y el DNI se integran solos, sin configurar nada. El checkout clásico sigue igual.
• Botón “Pagar” — desde la grilla de envíos vas directo al portal de Andreani Pymes a pagar los envíos pendientes.
• Códigos postales en formato CPA — un código postal de origen como C1425ABC ya no rompe el alta de los envíos.

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.
• Funciona con el checkout clásico y con el checkout por bloques de WooCommerce: el selector de sucursal y el DNI se integran solos.
• 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.
• Botón “Pagar” para ir al portal de Andreani Pymes a pagar los envíos pendientes, desde la grilla.
• Exportación a CSV de los envíos.

Origen y remitente

• Pestaña “Mi cuenta” con los datos de tu cuenta de Andreani, la dirección desde la que despachás y la sucursal de origen.
• Sucursal de origen fijable, o automática por tu código postal.
• La etiqueta sale con el nombre y la dirección de tu tienda como remitente.

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.
• Compatible de forma nativa con el checkout por bloques (Gutenberg / WC Blocks) y con el checkout clásico.
• 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
– Al configurar la sucursal de origen desde el panel de administración

Endpoints adicionales consultados desde el panel de administración:
– GET https://woocommerce-api-acom.andreani.com/api/v1/Branch/origin?postalCode={cp} — lista las sucursales habilitadas como origen para el código postal de la tienda, para que elijas desde cuál despachás. Se consulta solo en la pantalla de configuración del método de envío.
– GET https://woocommerce-api-acom.andreani.com/api/v1/Branch/default-origin?postalCode={cp} — informa qué sucursal asigna hoy Andreani para el código postal de la tienda. Se consulta solo en la pantalla de configuración del método de envío.
– PATCH https://woocommerce-api-acom.andreani.com/api/v1/Settings/origin — al guardar la configuración con la credencial vinculada, informa a Andreani desde dónde despacha la tienda: calle, número, piso, localidad, provincia, código postal de origen, nombre del remitente y, si la fijaste, el código de la sucursal de origen. Se envía solo desde el panel de administración; si Andreani no responde, se reintenta más tarde.

Los dos GET reciben únicamente el código postal de origen de la tienda y la credencial de autenticación; el PATCH envía además la dirección de origen y el nombre del remitente descritos arriba. No se envían datos de compradores ni de pedidos.

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): soporte nativo desde 1.6.4 (selector de sucursal y DNI integrados por Store API, sin configuración).

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.