內容簡介
Andreani WooCommerce 外掛將阿根廷 Andreani 物流服務整合至 WooCommerce 商店，讓顧客在結帳時可選擇 Andreani 配送，支援即時運費計算、門市取貨及自動產生託運單，專為阿根廷境內配送設計。
【主要功能】
• 新增「Andreani Envios」運送方式至 WooCommerce
• 結帳時即時計算 Andreani 運費
• 支援顧客選擇 Andreani 門市取貨（Puerta a Sucursal）
• 自動產生託運訂單與出貨標籤（企業客戶適用）
• 透過 Andreani API 即時取得門市與運費資訊
• 僅限阿根廷境內運送區域使用
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
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
.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): 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.
