integracionandreani

<p>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.</p>
<p><strong>Disponible exclusivamente para tiendas con zonas de envío en Argentina.</strong></p>
<p><strong>Funcionalidades incluidas:</strong></p>
<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>
<p><strong>Antes de empezar:</strong></p>
<p>Necesitás generar tu <strong>Credential ID</strong> según tu tipo de cliente:</p>
<ul>
<li><strong>Clientes PyME:</strong> https://pymes.andreani.com/integraciones/ (seleccioná la opción WooCommerce)</li>
<li><strong>Clientes Corporativos:</strong> https://corporativo.andreani.com/woocommerce</li>
</ul>
<p>Una vez generada, configurás el método “Andreani Envios” en <em>WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> Ajustes <span aria-hidden="true" class="wp-exclude-emoji">→</span> Envío <span aria-hidden="true" class="wp-exclude-emoji">→</span> Zonas de envío</em>.</p>
<h3>External services</h3>
<p>Este plugin se conecta a las APIs de Andreani para obtener información de envíos, calcular tarifas y gestionar órdenes de envío.</p>
<p><strong>Servicio:</strong> APIs de Andreani<br />
<strong>Propósito:</strong> Cálculo de tarifas de envío, obtención de información de sucursales y generación de órdenes de envío<br />
<strong>Datos enviados:</strong><br />
– Información del producto (peso, dimensiones, valor)<br />
– Código postal de origen y destino<br />
– Credenciales de autenticación del cliente con Andreani<br />
– Datos de la orden de compra (cuando se genera un envío)<br />
– Información del destinatario (nombre, dirección, teléfono, email)</p>
<p><strong>Cuándo se envían los datos:</strong><br />
– Durante el cálculo de tarifas de envío en el checkout<br />
– Al consultar sucursales disponibles para envíos a sucursal<br />
– Al generar una orden de envío después de una compra exitosa</p>
<p><strong>Términos y condiciones:</strong> https://www.andreani.com/terminos-y-condiciones<br />
<strong>Política de privacidad:</strong> https://www.andreani.com/politica-de-privacidad</p>
<h3>Para desarrolladores</h3>
<p>Guía técnica del <strong>contrato público estable a partir de 1.5.0</strong>. Todo lo listado acá es seguro de usar desde temas, page builders o plugins custom. Los cambios breaking se anuncian en el Changelog.</p>
<h4>Modelo de integración</h4>
<p>El plugin es <strong>zero-config</strong> 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.</p>
<p><strong>Modo automático</strong> (default): los hooks de WooCommerce inyectan el selector de sucursales y los campos DNI en el checkout clásico.<br />
<strong>Modo manual</strong>: los hooks quedan desactivados, el integrador usa los shortcodes donde quiera.</p>
<p>Se configura en <em>WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> Envío <span aria-hidden="true" class="wp-exclude-emoji">→</span> (tu zona) <span aria-hidden="true" class="wp-exclude-emoji">→</span> Andreani Envios <span aria-hidden="true" class="wp-exclude-emoji">→</span> Modo de renderizado del checkout</em>.</p>
<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>
<p>Los shortcodes encolan sus assets on-demand — no requieren tildar <em>Forzar carga de assets</em>.</p>
<h4>Clases CSS públicas</h4>
<p>Contrato estable. Seguras de usar en CSS custom:</p>
<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>
<p>El CSS del plugin solo aplica estilos estructurales (layout, spacing). Color, tipografía y font-weight se heredan del tema.</p>
<p><strong>Ejemplo de override</strong> desde <em>Apariencia <span aria-hidden="true" class="wp-exclude-emoji">→</span> Personalizar <span aria-hidden="true" class="wp-exclude-emoji">→</span> CSS adicional</em>:</p>
<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>
<p>Ejemplo:</p>
<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>
<p>Emitidos en <code>document</code> como eventos jQuery y <code>CustomEvent</code> nativo — compatibles con listeners tradicionales y modernos.</p>
<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>
<p>Ejemplo (jQuery):</p>
<pre><code>jQuery( document ).on( 'andreani:sucursal-selected', function( e, detail ) {
    console.log( 'Sucursal elegida:', detail.code, detail.nombre );
} );
</code></pre>
<p>Ejemplo (vanilla JS):</p>
<pre><code>document.addEventListener( 'andreani:cp-changed', function( e ) {
    console.log( 'Nuevo CP:', e.detail.postcode );
} );
</code></pre>
<h4>API JavaScript</h4>
<p>El objeto <code>window.andreaniCheckout</code> expone:</p>
<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>
<p>Ejemplo:</p>
<pre><code>const info = window.andreaniCheckout.getSelected();
if ( info ) console.log( info.nombre );
</code></pre>
<h4>AJAX y nonce</h4>
<p>Endpoint público: <code>andreani_get_sucursales</code> (acepta usuarios no logueados).</p>
<p>Acepta dos nonces durante el ciclo 1.5.x:<br />
* <code>nonce</code> con acción <code>andreani_checkout_nonce</code> (recomendado, propio del plugin).<br />
* <code>security</code> con acción <code>update-order-review</code> (legacy de WC, para código custom que lo use).</p>
<p>El nonce legacy se remueve en una versión mayor futura.</p>
<h4>Compatibilidad</h4>
<ul>
<li><strong>Classic WooCommerce Checkout</strong>: soporte completo en modo <code>auto</code> o <code>manual</code>.</li>
<li><strong>Elementor / Divi / Bricks / Beaver Builder / Breakdance / Oxygen / cualquier builder futuro</strong>: modo <code>manual</code> con shortcodes. Funciona sin configuración adicional.</li>
<li><strong>WC Blocks Checkout (Gutenberg)</strong>: 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>
<p>La actualización a 1.5.0 es transparente — el upgrader corre automáticamente al entrar al panel de WP admin y:</p>
<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>
<p><strong>Si tenías código custom que dependía de:</strong></p>
<ul>
<li><code>andreani_has_shortcode</code> / <code>andreani_builder_meta_keys</code> (filters internos que no documentamos públicamente): <strong>removidos</strong>. Ya no son necesarios — los shortcodes encolan solos.</li>
<li>El checkbox <em>Forzar carga de assets</em>: <strong>sigue funcionando</strong> pero casi nunca es necesario. Úsalo solo como último recurso.</li>
</ul>


Andreani WooCommerce

Plugin oficial de Andreani para envíos en WooCommerce.

kijam

<p>Agregue Correo Argentino / Andreani / Oca ePack al complemento WooCommerce</p>
<h3>Descripción</h3>
<p>Correo Argentino / Andreani / Oca e-Pak para WooCommerce.</p>
<p>Estos complementos agregan las plataformas de envío más usadas en Argentina a su tienda WooCommerce. Soporta: Correo Argentino / Andreani / Oca e-Pak. Con este complemento podrás:<br />
– Cotizar Envíos (Incluyendo Correo Argentino)<br />
– Solicitar la sucursal de destino a tus clientes (Para envíos a Sucursal)<br />
– Generar etiquetas de forma automática (Solo Andreani y OCA; Para Correo Argentino se pre-carga en Mi Correo pero debe completar algunos pasos extras).</p>
<h3>Requisitos</h3>
<ul>
<li>WooCommerce</li>
<li><a href="https://cujiware.com/" rel="nofollow ugc">Membresía de Cujiware</a> (precio desde 15 USD/mes)</li>
<li>Usuario y Contraseña + Operativas si desea usar OCA e-Pak</li>
<li>Usuario y Contraseña del API + Número de Contrato + Número de Cliente si desea usar Andreani</li>
<li>Usuario y Clave de acceso en Mi Correo si desea usar Correos Argentino</li>
</ul>
<h3>Contribuir</h3>
<p>Puede contribuir al código fuente en nuestra página de <a href="https://github.com/kijamve/carriers-of-argentina-for-woocommerce" rel="nofollow ugc">GitHub</a>.</p>
<h3>Licencia</h3>
<p>GPLv2</p>


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

Agregue Correo Argentino / Andreani / Oca ePack al complemento WooCommerce

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