Andreani WooCommerce

Plugin oficial de Andreani para WooCommerce. Tus clientes cotizan y eligen Andreani en el checkout, y vos generás los envíos, imprimís las etiquetas y seguís cada pedido sin salir de tu panel. Y antes de vender, ves cómo viaja cada producto: con qué servicio, en cuántas cajas y cuánto cuesta.

Para tiendas con envíos en Argentina. Funciona para clientes PyME, Corporativos y Middle Market.

Novedades de la versión 1.8.7

• Aviso de seguimiento al comprador — Andreani le manda un mail a tu cliente con su número de seguimiento apenas lo tiene, y un botón para seguir el envío.

• Se activa con un clic — lo prendés desde la configuración del plugin, en la pestaña En tu tienda.

• Con el estilo de tu tienda — sale desde tu tienda, con los colores de tus mails de WooCommerce y el logo de Andreani; el asunto y los textos los cambiás en WooCommerce > Ajustes > Correos electrónicos.

• Una sola vez por pedido — el mail sale cuando el envío recibe su número y no se repite.

• Apagado si ya tenías el plugin — así no se duplica con el mail que tu tienda ya manda.

Novedades de la versión 1.8.6

• Promociones de envío — armá descuentos o recargos sobre el precio del envío, en porcentaje o monto fijo.

• Por servicio y por provincia — elegís a qué servicio de Andreani aplica y en qué provincias, con un mapa para marcarlas.

• Con fechas — definís desde y hasta cuándo vale, para Hot Sale, Black Friday o cualquier fecha.

• Tus clientes ven el precio final — el checkout muestra el nombre de la promoción junto al envío, y el pedido guarda cuánto se ajustó.

• El costo adicional ahora es una promoción — el que tenías cargado en cada modo de entrega se pasa solo a una promoción de recargo llamada “Costo adicional”.

• No cambia lo que factura Andreani — las promociones ajustan solo lo que paga tu cliente; Andreani te factura la tarifa de siempre.

• Envío gratis primero — si un modo de entrega tiene envío gratis, no se suma la promoción ni el costo adicional.

Paquetería o Bigger: el plugin lo resuelve

Cada producto se clasifica solo, con las mismas reglas que usa Andreani:

• Paquetería — hasta 50 kg, ningún lado de más de 165 cm y la suma de los tres lados hasta 300 cm. Todo el pedido viaja en una sola caja, con una etiqueta, a domicilio o a sucursal.

• Bigger — cuando el pedido supera alguno de esos límites. Cada producto viaja en su propia caja, solo a domicilio.

Si un producto se apila (sillas, banquetas) o viaja en varias cajas (un aire split, un mueble desarmado), lo configurás con una sola pregunta y el plugin calcula el resto.

Qué podés hacer

En el checkout

• Método de envío “Andreani Envios” integrado en las zonas de WooCommerce.

• Tarifas en tiempo real, a domicilio y a sucursal.

• Selección de la sucursal Andreani de retiro.

• Funciona con el checkout clásico y con el checkout por bloques: el selector de sucursal y el DNI se integran solos.

• Cotizador opcional en la página de producto.

• Envío gratis por monto mínimo y por modo de entrega.

Tus productos

• “Ver mis productos”: servicio de cada producto con su motivo, medidas, peso y forma de despacho, con filtros y búsqueda por nombre o SKU.

• Tres formas de despacho: en su caja, se apilan o en varias cajas, con un dibujo de cómo queda el envío para la cantidad que elijas.

• Probar cotización a cualquier código postal, incluso con cambios que todavía no guardaste.

• Simulador de carrito para cotizar compras con varios productos.

• Aviso de los productos sin medidas, que no se pueden enviar con Andreani.

• SKU de Andreani opcional: si tu producto ya tiene SKU en WooCommerce, se usa ese.

Gestión de envíos

• La orden de envío se genera sola al confirmarse el pedido.

• “Ver mis envíos”: todos tus envíos en un solo lugar, con búsqueda por pedido, cliente o número de seguimiento, y filtros por estado.

• Caja sugerida para armar cada pedido.

• Reintento de los envíos que no se pudieron generar.

• Botón “Pagar” para ir al portal de Andreani Pymes a pagar los envíos pendientes.

• Exportación de los envíos a CSV.

Etiquetas

• Etiquetas en PDF para clientes PyME, Middle Market y Corporativos.

• Formato A4 o térmica (Zebra), con vista previa y cantidad de etiquetas por página.

• Descarga masiva desde “Ver mis envíos”.

Seguimiento

• Número de seguimiento en el pedido apenas se genera el envío.

• Estado del envío actualizado automáticamente desde Andreani.

• Línea de tiempo del envío en el detalle del pedido.

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 a tu elección, o automática por tu código postal.

• La etiqueta sale con el nombre y la dirección de tu tienda como remitente.

Compatibilidad

• Compatible con HPOS (almacenamiento de pedidos de alto rendimiento) y con el checkout por bloques de WooCommerce.

• Compatible con Elementor, Divi, Bricks y otros page builders, mediante shortcodes.

• Liviano para tu servidor: consultas acotadas y procesos en segundo plano.

• API pública para desarrolladores (ver “Para desarrolladores”).

Antes de empezar

Necesitás tu Credential ID de Andreani:

• Clientes PyME: https://pymes.andreani.com/integraciones/ (elegí la opción WooCommerce)

• Clientes Corporativos: https://corporativo.andreani.com/woocommerce

Con 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:

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.

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.

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.

com/terminos-y-condiciones

com/politica-de-privacidad

Para desarrolladores

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-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):

nombre ); } );

Ejemplo (vanilla JS):

postcode ); } );

API JavaScript

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:

nombre );

AJAX y nonce

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

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

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.