內容簡介
Andreani WooCommerce 外掛專為 WooCommerce 商店設計，讓客戶在結帳時選擇 Andreani 物流服務，並能在控制台中輕鬆管理運送、列印標籤及追蹤訂單，提升運送效率。
【主要功能】
• 結帳時選擇 Andreani 運送方式
• 自動計算運送成本與包裝方式
• 追蹤每個訂單的運送狀態
• 儲存包裝選項以便重複使用
• 整合運送標籤列印功能
• 提供運送新功能的更新通知
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
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.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:
– 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
.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 '
';
}, 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:
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.
