Andreani para WooCommerce
Descripción
Calcula costos de envío con Andreani en tiempo real, genera guías de envío y rastrea paquetes en tu tienda WooCommerce. Este plugin te permite ofrecer a tus clientes una opción de envío confiable y rastreable a través de Andreani en Argentina.
Índice
- Andreani para WooCommerce
Cómo Instalar
Para instalar este plugin, sigue las instrucciones generales de instalación de plugins de WooCommerce que puedes encontrar en nuestra guía de instalación de WooCommerce.
Cómo Configurar
Configuración del Manager
El Manager es el componente central que controla la configuración general para todos los transportistas. Para configurarlo:
- Ve a WooCommerce > Ajustes > Integración > "Envíos para Argentina"
- Configura los siguientes campos:
Configuración General del Manager
- Habilitar/Deshabilitar: Activa o desactiva el módulo de envíos
- API Host: Servidor de la API (por defecto: shipping.yipi.app)
- API Key: Tu clave de licencia de Cujiware. Para obtener tu licencia, consulta nuestra guía de licencias
Credenciales de Transportistas
- Usuario de Andreani: Credenciales para generar etiquetas (opcional)
- Contraseña de Andreani: Credenciales para generar etiquetas (opcional)
Configuración de Moneda
- Conversión de Moneda: Opciones para manejar diferentes monedas
- Desactivar módulo
- Usar tasa de conversión oficial
- Usar tasa de conversión manual
- Tasa de Conversión Manual: Valor personalizado para la conversión
Campos Personalizados
Si ya tienes instalado otro plugin que agrega campos personalizados al checkout (como "Checkout Field Editor", "WooCommerce Checkout Manager" o "Checkout Fields Manager"), estos campos podrían duplicarse con los que necesita Correo Argentino.
Para evitar la duplicación, puedes configurar el meta-key que usa tu plugin para guardar estos datos en la orden de WooCommerce.
Por ejemplo, si tu plugin guarda el DNI como "_billing_dni", debes configurar ese valor en el campo "Meta-key para DNI". De esta manera, Andreani obtendrá los datos directamente de los campos existentes en lugar de crear nuevos campos en el checkout. Si no configuras estos meta-keys, el sistema agregará automáticamente los campos necesarios al checkout.
Los campos son:
- Meta-key para DNI: Campo personalizado para el DNI
- Meta-key para Teléfono: Campo personalizado para el teléfono
- Meta-key para Altura (Facturación): Campo personalizado para la altura
- Meta-key para Altura (Envío): Campo personalizado para la altura
- Meta-key para Departamento (Facturación): Campo personalizado para el departamento
- Meta-key para Departamento (Envío): Campo personalizado para el departamento
- Meta-key para Piso (Facturación): Campo personalizado para el piso
- Meta-key para Piso (Envío): Campo personalizado para el piso
Configuración del Transportista Andreani
- Ve a WooCommerce > Ajustes > Envío > Andreani
- Habilita el método de envío
- Configura los siguientes campos:
Información del Remitente Andreani
- Código Postal: Ingresa el código postal de origen
- Provincia: Selecciona la provincia de origen
- Ciudad: Ingresa la ciudad de origen
- Calle: Ingresa la calle de origen
- Número: Ingresa el número de la dirección
- Piso: Ingresa el piso (opcional)
- Departamento: Ingresa el departamento (opcional)
- Detalle: Información adicional de la dirección
- Nombre Completo: Nombre del remitente o razón social
- Tipo de DNI: Selecciona el tipo de documento (DNI, CUIT, CUIL)
- DNI: Número de documento
- Teléfono: Número de contacto
- Email: Correo electrónico de contacto
Configuración de Productos Andreani
- Peso por defecto: Peso predeterminado para productos sin peso especificado
- Ancho por defecto: Ancho predeterminado para productos sin dimensiones
- Alto por defecto: Alto predeterminado para productos sin dimensiones
- Profundidad por defecto: Profundidad predeterminada para productos sin dimensiones
Configuración de Envío Andreani
- Tipo de Envío: Selecciona entre entrega a domicilio o en sucursal
- Sucursal de Origen: Selecciona la sucursal de Andreani más cercana
- Recolección en Tienda: Activa si Andreani recoge los paquetes en tu tienda
- Tiempo de Entrega: Tiempo estimado de entrega si el servicio no lo proporciona
- Cálculo de Cajas: Algoritmo para calcular las cajas necesarias
- Smart: Selecciona las mejores cajas para todo el pedido
- Forzar una caja: Intenta que todo quepa en una caja
- Una caja por producto: Separa cada producto en su propia caja
Configuración de Costos
- Cargo Fijo: Monto fijo a agregar al costo de envío
- Porcentaje de Cargo: Porcentaje a agregar al costo de envío
- Monto Mínimo: Valor mínimo del costo de envío
- Monto Máximo: Valor máximo del costo de envío
Configuración de Descuentos
- Monto Mínimo para Descuento: Monto mínimo del carrito para aplicar descuento
- Peso Mínimo para Descuento: Peso mínimo del pedido para aplicar descuento
- Porcentaje de Descuento: Porcentaje a descontar del costo de envío
- Monto de Descuento: Monto fijo a descontar del costo de envío
Envío Gratuito
- Activar Envío Gratuito: Habilita la opción de envío gratuito
- Modo de Envío Gratuito: Selecciona cómo se aplicará el envío gratuito
- Usar "Envío Gratuito" si se aplica un cupón de envío gratuito
- Usar "Envío Gratuito" si hay un cupón aplicado y se cumplen los criterios
- Usar "Envío Gratuito" si hay un cupón aplicado o se cumplen los criterios
- Usar "Envío Gratuito" automáticamente solo si se cumplen los criterios
- Monto Mínimo: Monto mínimo del carrito para envío gratuito
- Peso Mínimo: Peso mínimo del pedido para envío gratuito
- Provincias: Selecciona las provincias con envío gratuito
Restricciones
- Categorías Excluidas: Productos de estas categorías no podrán usar este método
- Provincias Excluidas: Este método no estará disponible en estas provincias
- Monto Mínimo de Activación: Monto mínimo del carrito para activar el método
- Monto Máximo de Activación: Monto máximo del carrito para activar el método
- Peso Mínimo de Activación: Peso mínimo del pedido para activar el método
- Peso Máximo de Activación: Peso máximo del pedido para activar el método
Otros Ajustes
- Ocultar Tiempo de Entrega: Oculta la etiqueta de tiempo estimado de entrega
- Debug: Activa el modo debug para registrar eventos
Cómo Utilizar
Generación de Guías de Envío
-
Cuando un pedido es procesado, el sistema calculará automáticamente el costo de envío basado en:
- Peso y dimensiones de los productos
- Dirección de entrega
- Tipo de envío seleccionado
- Configuración de costos y descuentos
-
Para generar una guía de envío:
- Ve a WooCommerce > Pedidos
- Selecciona el pedido
- En la sección de envío, haz clic en "Generar Guía de Envío"
- El sistema generará la guía usando las credenciales configuradas
Rastreo de Paquetes
-
El sistema permite rastrear los paquetes de dos formas:
- Automáticamente: Los estados se actualizan según la información de Andreani
- Manualmente: Puedes verificar el estado en cualquier momento
-
Para rastrear un paquete:
- Ve a WooCommerce > Pedidos
- Selecciona el pedido
- En la sección de envío, verás el estado actual y el número de seguimiento
- Haz clic en "Actualizar Estado" para obtener la información más reciente
Configuración de Productos
-
Para productos con dimensiones específicas:
- Edita el producto en WooCommerce
- En la pestaña "Datos del producto", configura:
- Peso
- Dimensiones (largo, ancho, alto)
- Guarda los cambios
-
Para productos sin dimensiones:
- El sistema usará los valores predeterminados configurados
- Puedes modificar estos valores en la configuración del transportista
Consideraciones Importantes
-
Moneda:
- El sistema soporta ARS y USD
- Puedes configurar la conversión automática o manual
- Las tasas de conversión se actualizan diariamente
-
Debug:
- Activa el modo debug para registrar eventos
- Los logs se guardan en WooCommerce > Estado > Registros
- Para más información sobre cómo activar y ver los logs, consulta nuestra guía de logs
-
Restricciones:
- Configura cuidadosamente las restricciones por categoría y provincia
- Considera los límites de peso y monto para cada transportista
- Ajusta los tiempos de entrega según la zona