Este plugin integra el m\u00e9todo de env\u00edo de Andreani directamente en tu tienda WooCommerce, permitiendo a tus clientes seleccionar Andreani como opci\u00f3n de entrega durante el proceso de compra.<\/p>\n\n
Importante:<\/strong> Este plugin est\u00e1 dise\u00f1ado exclusivamente para zonas de env\u00edo en Argentina.<\/p>\n\n Funcionalidades incluidas:<\/strong><\/p>\n\n Requisitos previos:<\/strong><\/p>\n\n Antes de configurar el plugin, necesitar\u00e1s generar tu Credential ID (hash de autenticaci\u00f3n) seg\u00fan el tipo de cliente:<\/p>\n\n Una vez generada tu credencial, podr\u00e1s configurar el m\u00e9todo de env\u00edo \"Andreani Envios\" en las opciones de WooCommerce (WooCommerce > Ajustes > Env\u00edo > Zonas de env\u00edo).<\/p>\n\n Este plugin se conecta a las APIs de Andreani para obtener informaci\u00f3n de env\u00edos, calcular tarifas y gestionar \u00f3rdenes de env\u00edo.<\/p>\n\n Servicio:<\/strong> APIs de Andreani\nProp\u00f3sito:<\/strong> C\u00e1lculo de tarifas de env\u00edo, obtenci\u00f3n de informaci\u00f3n de sucursales y generaci\u00f3n de \u00f3rdenes de env\u00edo\nDatos enviados:<\/strong>\n- Informaci\u00f3n del producto (peso, dimensiones, valor)\n- C\u00f3digo postal de origen y destino\n- Credenciales de autenticaci\u00f3n del cliente con Andreani\n- Datos de la orden de compra (cuando se genera un env\u00edo)\n- Informaci\u00f3n del destinatario (nombre, direcci\u00f3n, tel\u00e9fono, email)<\/p>\n\n Cu\u00e1ndo se env\u00edan los datos:<\/strong>\n- Durante el c\u00e1lculo de tarifas de env\u00edo en el checkout\n- Al consultar sucursales disponibles para env\u00edos a sucursal\n- Al generar una orden de env\u00edo despu\u00e9s de una compra exitosa<\/p>\n\n T\u00e9rminos y condiciones:<\/strong> https:\/\/www.andreani.com\/terminos-y-condiciones\nPol\u00edtica de privacidad:<\/strong> https:\/\/www.andreani.com\/politica-de-privacidad<\/p>\n\n Gu\u00eda t\u00e9cnica del contrato p\u00fablico estable a partir de 1.5.0<\/strong>. Todo lo listado ac\u00e1 es seguro de usar desde temas, page builders o plugins custom. Los cambios breaking se anuncian en el Changelog.<\/p>\n\n El plugin es zero-config<\/strong> en page builders. No detecta Elementor, Divi, Bricks, etc. \u2014 los shortcodes encolan sus assets al momento de renderizarse, as\u00ed que funcionan autom\u00e1ticamente en cualquier builder que respete el contrato de shortcodes de WordPress.<\/p>\n\n Modo autom\u00e1tico<\/strong> (default): los hooks de WooCommerce inyectan el selector de sucursales y los campos DNI en el checkout cl\u00e1sico.\nModo manual<\/strong>: los hooks quedan desactivados, el integrador usa los shortcodes donde quiera.<\/p>\n\n Se configura en WooCommerce \u2192 Env\u00edo \u2192 (tu zona) \u2192 Andreani Envios \u2192 Modo de renderizado del checkout<\/em>.<\/p>\n\n Los shortcodes encolan sus assets on-demand \u2014 no requieren tildar Forzar carga de assets<\/em>.<\/p>\n\n Contrato estable. Seguras de usar en CSS custom:<\/p>\n\n El CSS del plugin solo aplica estilos estructurales (layout, spacing). Color, tipograf\u00eda y font-weight se heredan del tema.<\/p>\n\n Ejemplo de override<\/strong> desde Apariencia \u2192 Personalizar \u2192 CSS adicional<\/em>:<\/p>\n\n Ejemplo:<\/p>\n\n Emitidos en Ejemplo (jQuery):<\/p>\n\n Ejemplo (vanilla JS):<\/p>\n\n El objeto Ejemplo:<\/p>\n\n Endpoint p\u00fablico: Acepta dos nonces durante el ciclo 1.5.x:\n* El nonce legacy se remueve en una versi\u00f3n mayor futura.<\/p>\n\n La actualizaci\u00f3n a 1.5.0 es transparente \u2014 el upgrader corre autom\u00e1ticamente al entrar al panel de WP admin y:<\/p>\n\n Si ten\u00edas c\u00f3digo custom que depend\u00eda de:<\/strong><\/p>\n\n\n
\n
External services<\/h3>\n\n
Para desarrolladores<\/h3>\n\n
Modelo de integraci\u00f3n<\/h4>\n\n
Shortcodes<\/h4>\n\n
\n
[andreani_sucursales]<\/code> \u2014 Selector de sucursales. Carga las sucursales seg\u00fan el CP presente en el formulario m\u00e1s cercano. Soporta m\u00faltiples instancias por p\u00e1gina.<\/li>\n[andreani_dni_field context=\"billing|shipping\"]<\/code> \u2014 Campo DNI\/CUIT. El atributo context<\/code> acepta billing<\/code> (por defecto) o shipping<\/code>.<\/li>\n<\/ul>\n\nClases CSS p\u00fablicas<\/h4>\n\n
\n
.andreani-sucursales-standalone<\/code> \u2014 Wrapper del shortcode de sucursales.<\/li>\n.andreani-sucursales-select<\/code> \u2014 El <select><\/code> de sucursales (funciona en el <tr><\/code> legacy y en el wrapper standalone).<\/li>\n.andreani-sucursales-details<\/code> \u2014 Bloque con nombre y direcci\u00f3n de la sucursal elegida (dentro del wrapper standalone).<\/li>\n.andreani-sucursales-row<\/code> \u2014 Fila del checkout cl\u00e1sico (legacy, solo en modo auto<\/code>).<\/li>\n.andreani-dni-field-shortcode<\/code> \u2014 Wrapper del shortcode de DNI.<\/li>\n<\/ul>\n\n.andreani-sucursales-standalone { background: #f7f7f7; border-radius: 8px; padding: 1rem; }\n.andreani-sucursales-select { border: 2px solid #333; }\n<\/code><\/pre>\n\nFilters PHP<\/h4>\n\n
\n
andreani_sucursales_markup( string $html, int $instance_id, string $cp_destino )<\/code> \u2014 Modifica el markup del selector.<\/li>\nandreani_dni_field_markup( string $html, string $context, array $field_args )<\/code> \u2014 Modifica el markup del campo DNI del shortcode.<\/li>\nandreani_should_enqueue_checkout( bool $should, string $razon )<\/code> \u2014 Fuerza o bloquea el encolado eager de assets. $razon<\/code> puede ser is_checkout<\/code>, force_enqueue<\/code> o ''<\/code>.<\/li>\n<\/ul>\n\nadd_filter( 'andreani_sucursales_markup', function( $html, $instance_id, $cp ) {\n return '<div class=\"mi-wrapper-custom\">' . $html . '<\/div>';\n}, 10, 3 );\n<\/code><\/pre>\n\nEventos JS<\/h4>\n\n
document<\/code> como eventos jQuery y CustomEvent<\/code> nativo \u2014 compatibles con listeners tradicionales y modernos.<\/p>\n\n\n
andreani:ready<\/code> \u2014 El plugin termin\u00f3 de bindearse. detail: { wcClassic: boolean }<\/code>.<\/li>\nandreani:cp-changed<\/code> \u2014 El CP cambi\u00f3 en alg\u00fan input. detail: { postcode }<\/code>.<\/li>\nandreani:sucursal-selected<\/code> \u2014 El usuario seleccion\u00f3 una sucursal. detail: { code, nombre, direccion, wrapper, postcode }<\/code>.<\/li>\nandreani:error<\/code> \u2014 Error de AJAX o validaci\u00f3n. detail: { code, message?, postcode?, wrapper? }<\/code>.<\/li>\n<\/ul>\n\njQuery( document ).on( 'andreani:sucursal-selected', function( e, detail ) {\n console.log( 'Sucursal elegida:', detail.code, detail.nombre );\n} );\n<\/code><\/pre>\n\ndocument.addEventListener( 'andreani:cp-changed', function( e ) {\n console.log( 'Nuevo CP:', e.detail.postcode );\n} );\n<\/code><\/pre>\n\nAPI JavaScript<\/h4>\n\n
window.andreaniCheckout<\/code> expone:<\/p>\n\n\n
andreaniCheckout.ajaxUrl<\/code> \u2014 URL de admin-ajax.<\/li>\nandreaniCheckout.nonce<\/code> \u2014 token (acci\u00f3n andreani_checkout_nonce<\/code>).<\/li>\nandreaniCheckout.i18n<\/code> \u2014 strings traducidas.<\/li>\nandreaniCheckout.refresh( wrapper? )<\/code> \u2014 recarga sucursales para un wrapper espec\u00edfico o todos si se omite el argumento.<\/li>\nandreaniCheckout.getSelected( wrapper? )<\/code> \u2014 devuelve { code, nombre, direccion }<\/code> de la selecci\u00f3n actual o null<\/code>.<\/li>\nandreaniCheckout.init( wrapper? )<\/code> \u2014 bindea selects inyectados din\u00e1micamente (modals, popups de Elementor, etc.).<\/li>\n<\/ul>\n\nconst info = window.andreaniCheckout.getSelected();\nif ( info ) console.log( info.nombre );\n<\/code><\/pre>\n\nAJAX y nonce<\/h4>\n\n
andreani_get_sucursales<\/code> (acepta usuarios no logueados).<\/p>\n\nnonce<\/code> con acci\u00f3n andreani_checkout_nonce<\/code> (recomendado, propio del plugin).\n* security<\/code> con acci\u00f3n update-order-review<\/code> (legacy de WC, para c\u00f3digo custom que lo use).<\/p>\n\nCompatibilidad<\/h4>\n\n
\n
auto<\/code> o manual<\/code>.<\/li>\nmanual<\/code> con shortcodes. Funciona sin configuraci\u00f3n adicional.<\/li>\nMigraci\u00f3n desde 1.4.x<\/h4>\n\n
\n
checkout_modo<\/code> y checkout_force_enqueue<\/code> si faltan.<\/li>\nconfig_por_modo<\/code> a slug ascii-safe (fix del env\u00edo gratis con nombres acentuados).<\/li>\n\n
andreani_has_shortcode<\/code> \/ andreani_builder_meta_keys<\/code> (filters internos que no documentamos p\u00fablicamente): removidos<\/strong>. Ya no son necesarios \u2014 los shortcodes encolan solos.<\/li>\n\n
1.5.0<\/h4>\n\n
\n
1.4.10<\/h4>\n\n
\n
1.4.9<\/h4>\n\n
\n
1.4.8<\/h4>\n\n
\n
1.4.7<\/h4>\n\n
\n
1.4.6<\/h4>\n\n
\n
1.4.5<\/h4>\n\n
\n
1.4.4<\/h4>\n\n
\n
1.4.3<\/h4>\n\n
\n
1.4.2<\/h4>\n\n
\n
1.4.1<\/h4>\n\n
\n
1.4.0<\/h4>\n\n
\n
1.3.0<\/h4>\n\n
\n
1.2.0<\/h4>\n\n
\n
1.1.0<\/h4>\n\n
\n