Plugin oficial de Andreani para envíos en WooCommerce.

Conra

Wanderlust Codes

Wanderlust – Integración para Andreani y WooCommerce

NO RECOMENDADO, Andreani hoy esta pidiendo minimo 300 envios mensuales para darte credenciales REST API. Por lo tanto recomendamos OCA o Correo Argent …

andreani

Fernando Vazquez

Grupo Logistico Andreani

Plugin oficial de Andreani. Simplifica la gestión de tus envíos con Andreani. Este plugin te permite gestionar fácilmente todas tus entregas, optimiza …

kijam

Envíos por Correo Argentino, OCA e-Pak y Andreani para WooCommerce en Argentina

Agregue Correo Argentino / Andreani / Oca ePack al complemento WooCommerce

integracionandreani

Plugin oficial de Andreani para integrar sus servicios de envío en tu tienda WooCommerce. Permite a tus clientes elegir Andreani como opción de entrega durante el checkout y al merchant gestionar todos los envíos desde el panel de administración.
Disponible exclusivamente para tiendas con zonas de envío en Argentina.
Funcionalidades incluidas:
<ul>
<li>Método de envío “Andreani Envios” integrado en las zonas de WooCommerce</li>
<li>Cálculo de tarifas de envío en tiempo real durante el checkout</li>
<li>Selección de sucursales Andreani para envíos Puerta a Sucursal</li>
<li>Cotizador opcional en la página de producto</li>
<li>Generación automática de órdenes de envío al confirmar el pedido</li>
<li>Descarga de etiquetas en PDF (solo para clientes Corporativos)</li>
<li>Grilla administrativa para gestionar todos los envíos desde un solo lugar</li>
<li>Exportación a CSV de los envíos</li>
<li>Compatible con Elementor, Divi, Bricks y otros page builders</li>
<li>Compatible con HPOS (High-Performance Order Storage) de WooCommerce</li>
<li>API pública para desarrolladores (ver sección “Para desarrolladores”)</li>
</ul>
Antes de empezar:
Necesitás generar tu Credential ID según tu tipo de cliente:
<ul>
<li>Clientes PyME: https://pymes.andreani.com/integraciones/ (seleccioná la opción WooCommerce)</li>
<li>Clientes Corporativos: https://corporativo.andreani.com/woocommerce</li>
</ul>
Una vez generada, configurás el método “Andreani Envios” en WooCommerce → Ajustes → Envío → Zonas de envío.
<h3>External services</h3>
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 y generación de órdenes de envío 
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
Términos y condiciones: https://www.andreani.com/terminos-y-condiciones 
Política de privacidad: https://www.andreani.com/politica-de-privacidad
<h3>Para desarrolladores</h3>
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.
<h4>Modelo de integración</h4>
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.
<h4>Shortcodes</h4>
<ul>
<li><code>[andreani_sucursales]</code> — Selector de sucursales. Carga las sucursales según el CP presente en el formulario más cercano. Soporta múltiples instancias por página.</li>
<li><code>[andreani_dni_field context="billing|shipping"]</code> — Campo DNI/CUIT. El atributo <code>context</code> acepta <code>billing</code> (por defecto) o <code>shipping</code>.</li>
</ul>
Los shortcodes encolan sus assets on-demand — no requieren tildar Forzar carga de assets.
<h4>Clases CSS públicas</h4>
Contrato estable. Seguras de usar en CSS custom:
<ul>
<li><code>.andreani-sucursales-standalone</code> — Wrapper del shortcode de sucursales.</li>
<li><code>.andreani-sucursales-select</code> — El <code><select></code> de sucursales (funciona en el <code><tr></code> legacy y en el wrapper standalone).</li>
<li><code>.andreani-sucursales-details</code> — Bloque con nombre y dirección de la sucursal elegida (dentro del wrapper standalone).</li>
<li><code>.andreani-sucursales-row</code> — Fila del checkout clásico (legacy, solo en modo <code>auto</code>).</li>
<li><code>.andreani-dni-field-shortcode</code> — Wrapper del shortcode de DNI.</li>
</ul>
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:
<pre><code>.andreani-sucursales-standalone { background: #f7f7f7; border-radius: 8px; padding: 1rem; }
.andreani-sucursales-select { border: 2px solid #333; }
</code></pre>
<h4>Filters PHP</h4>
<ul>
<li><code>andreani_sucursales_markup( string $html, int $instance_id, string $cp_destino )</code> — Modifica el markup del selector.</li>
<li><code>andreani_dni_field_markup( string $html, string $context, array $field_args )</code> — Modifica el markup del campo DNI del shortcode.</li>
<li><code>andreani_should_enqueue_checkout( bool $should, string $razon )</code> — Fuerza o bloquea el encolado eager de assets. <code>$razon</code> puede ser <code>is_checkout</code>, <code>force_enqueue</code> o <code>''</code>.</li>
</ul>
Ejemplo:
<pre><code>add_filter( 'andreani_sucursales_markup', function( $html, $instance_id, $cp ) {
 return '<div class="mi-wrapper-custom">' . $html . '</div>';
}, 10, 3 );
</code></pre>
<h4>Eventos JS</h4>
Emitidos en <code>document</code> como eventos jQuery y <code>CustomEvent</code> nativo — compatibles con listeners tradicionales y modernos.
<ul>
<li><code>andreani:ready</code> — El plugin terminó de bindearse. <code>detail: { wcClassic: boolean }</code>.</li>
<li><code>andreani:cp-changed</code> — El CP cambió en algún input. <code>detail: { postcode }</code>.</li>
<li><code>andreani:sucursal-selected</code> — El usuario seleccionó una sucursal. <code>detail: { code, nombre, direccion, wrapper, postcode }</code>.</li>
<li><code>andreani:error</code> — Error de AJAX o validación. <code>detail: { code, message?, postcode?, wrapper? }</code>.</li>
</ul>
Ejemplo (jQuery):
<pre><code>jQuery( document ).on( 'andreani:sucursal-selected', function( e, detail ) {
 console.log( 'Sucursal elegida:', detail.code, detail.nombre );
} );
</code></pre>
Ejemplo (vanilla JS):
<pre><code>document.addEventListener( 'andreani:cp-changed', function( e ) {
 console.log( 'Nuevo CP:', e.detail.postcode );
} );
</code></pre>
<h4>API JavaScript</h4>
El objeto <code>window.andreaniCheckout</code> expone:
<ul>
<li><code>andreaniCheckout.ajaxUrl</code> — URL de admin-ajax.</li>
<li><code>andreaniCheckout.nonce</code> — token (acción <code>andreani_checkout_nonce</code>).</li>
<li><code>andreaniCheckout.i18n</code> — strings traducidas.</li>
<li><code>andreaniCheckout.refresh( wrapper? )</code> — recarga sucursales para un wrapper específico o todos si se omite el argumento.</li>
<li><code>andreaniCheckout.getSelected( wrapper? )</code> — devuelve <code>{ code, nombre, direccion }</code> de la selección actual o <code>null</code>.</li>
<li><code>andreaniCheckout.init( wrapper? )</code> — bindea selects inyectados dinámicamente (modals, popups de Elementor, etc.).</li>
</ul>
Ejemplo:
<pre><code>const info = window.andreaniCheckout.getSelected();
if ( info ) console.log( info.nombre );
</code></pre>
<h4>AJAX y nonce</h4>
Endpoint público: <code>andreani_get_sucursales</code> (acepta usuarios no logueados).
Acepta dos nonces durante el ciclo 1.5.x: 
* <code>nonce</code> con acción <code>andreani_checkout_nonce</code> (recomendado, propio del plugin). 
* <code>security</code> con acción <code>update-order-review</code> (legacy de WC, para código custom que lo use).
El nonce legacy se remueve en una versión mayor futura.
<h4>Compatibilidad</h4>
<ul>
<li>Classic WooCommerce Checkout: soporte completo en modo <code>auto</code> o <code>manual</code>.</li>
<li>Elementor / Divi / Bricks / Beaver Builder / Breakdance / Oxygen / cualquier builder futuro: modo <code>manual</code> con shortcodes. Funciona sin configuración adicional.</li>
<li>WC Blocks Checkout (Gutenberg): sin soporte nativo en 1.5.x (requiere integración por Store API — planificada para una versión mayor futura).</li>
</ul>
<h4>Migración desde 1.4.x</h4>
La actualización a 1.5.0 es transparente — el upgrader corre automáticamente al entrar al panel de WP admin y:
<ol>
<li>Siembra los defaults de <code>checkout_modo</code> y <code>checkout_force_enqueue</code> si faltan.</li>
<li>Normaliza keys de <code>config_por_modo</code> a slug ascii-safe (fix del envío gratis con nombres acentuados).</li>
<li>Fuerza un re-login contra la API de Andreani para sincronizar credenciales con la nueva persistencia de sesión.</li>
</ol>
Si tenías código custom que dependía de:
<ul>
<li><code>andreani_has_shortcode</code> / <code>andreani_builder_meta_keys</code> (filters internos que no documentamos públicamente): removidos. Ya no son necesarios — los shortcodes encolan solos.</li>
<li>El checkbox Forzar carga de assets: sigue funcionando pero casi nunca es necesario. Úsalo solo como último recurso.</li>
</ul>

Alternatives to Andreani WooCommerce

Top alternatives