Aplica a: Todas las plataformas (IFS / IFC / IFB) | Audiencia: Proveedores / Administradores o Distribuidores / Administradores
Descripción general
IdeaRoom admite una integración nativa con Avalara AvaTax para el cálculo automático y en tiempo real del impuesto sobre las ventas dentro de tu configurador. Una vez activada, Avalara utiliza la dirección completa del cliente (cuando está disponible) para calcular la tasa impositiva correcta al momento del pago, en miles de jurisdicciones de EE. UU., en lugar de basarse en una simple búsqueda por código postal.
Este artículo explica lo que necesitas proporcionar y qué esperar una vez que la integración esté activa.
💡 ¿Por qué Avalara? Si tu negocio vende en varios estados o condados, las tasas impositivas pueden variar significativamente según la ubicación. Avalara elimina las conjeturas al obtener tasas precisas y específicas de cada jurisdicción en tiempo real, manteniendo tus transacciones listas para auditoría.
Antes de comenzar
Requisitos previos:
Una cuenta activa de Avalara AvaTax
Acceso de administrador a tu cuenta de Avalara para obtener tu ID de cuenta y clave de licencia
Coordinar con tu Gerente de Éxito del Cliente (CSM) de IdeaRoom para completar la configuración del sistema
Pasos
1. Inicia sesión en tu cuenta de Avalara y localiza tu ID de cuenta
Inicia sesión en tu Consola de administración de Avalara en admin.avalara.com.
Tu ID de cuenta es un identificador numérico asociado con tu suscripción de Avalara. Puedes encontrarlo navegando a Configuración > Todas las configuraciones de AvaTax dentro de la Consola de administración.
💡 ¿Necesitas ayuda para encontrarlo? Avalara tiene una guía paso a paso aquí: ¿Cómo localizo mis números de cuenta?
2. Genera o recupera tu clave de licencia
Tu clave de licencia se utiliza junto con tu ID de cuenta para autenticar la conexión de IdeaRoom con la API de Avalara.
⚠️ Importante: Solo existe una clave de licencia por cuenta de Avalara, compartida en todas las aplicaciones comerciales conectadas. Si generas una nueva clave, se romperán todas las conexiones existentes con otros sistemas que usen la clave anterior. Antes de generar una nueva clave, confirma con tu equipo que ninguna otra aplicación esté conectada actualmente con la clave existente.
Si necesitas generar o recuperar tu clave de licencia, sigue la guía de Avalara aquí: Obtén tu clave de licencia
3. Envía tus credenciales a IdeaRoom
Una vez que tengas tu ID de cuenta y tu clave de licencia, envía ambos a tu CSM de IdeaRoom de forma segura. IdeaRoom configurará la integración en el sistema para tu cuenta específica.
Deberás especificar si deseas que la integración se habilite en:
Entorno de prueba (Staging) — recomendado primero, para verificar el funcionamiento
Producción — tu configurador en vivo
💡 Consejo: Recomendamos realizar pruebas en el entorno de staging primero para confirmar que los cálculos de impuestos aparecen correctamente antes de activarlo en producción.
4. Confirma que el área de cobertura de Avalara coincide con tu área de ventas
Antes de activar la integración, verifica que los estados y regiones cubiertos en tu cuenta de Avalara coincidan con el área de ventas configurada en tu configurador de IdeaRoom.
Si IdeaRoom está configurado para vender en estados que no están cubiertos por tu suscripción de Avalara, los cálculos de impuestos fallarán silenciosamente para los clientes en esas ubicaciones.
Para revisar tu cobertura en Avalara, accede a tu Consola de administración y revisa tus jurisdicciones de nexo registradas en Configuración > Nexo.
5. IdeaRoom activa Avalara como tu proveedor de impuestos
Una vez que tus credenciales estén confirmadas y las áreas de cobertura alineadas, IdeaRoom establecerá Avalara como el proveedor de impuestos sobre ventas activo para tu configurador. No se requiere ninguna acción de tu parte en este paso.
Recibirás confirmación de tu CSM una vez que la integración esté activa y lista para pruebas.
6. Prueba la integración
Después de que tu CSM confirme que la integración está habilitada, realiza una prueba cargando tu configurador y avanzando por el proceso de pago utilizando una dirección completa válida dentro de tu área de ventas.
Debería aparecer una línea de impuestos en el resumen de precios, calculada en función de la dirección de entrega del cliente.
⚠️ Nota: El impuesto solo se calculará para direcciones dentro de tu área de ventas configurada. Probar con una dirección fuera de esa área no devolverá ningún resultado de impuesto; esto es un comportamiento esperado, no un error.
Solución de problemas
No aparece ningún impuesto durante el proceso de pago.
Si no aparece ninguna línea de impuesto, verifica lo siguiente:
Confirma que estás probando con una dirección dentro de tu área de ventas en IdeaRoom.
Verifica que el estado o región que estás probando esté cubierto en la configuración de nexo de Avalara.
Comprueba que tu ID de cuenta y clave de licencia se proporcionaron correctamente a IdeaRoom; incluso un pequeño error tipográfico causará que la conexión con la API falle.
Comunícate con tu CSM de IdeaRoom para confirmar que las credenciales se guardaron correctamente y que Avalara está configurado como el proveedor de impuestos activo.
Acciones de seguimiento
Una vez que la integración esté activa, también puedes querer:
Confirmar que las líneas de impuestos aparecen correctamente en los presupuestos enviados por correo electrónico a los clientes
Revisar el historial de transacciones de Avalara en la Consola de administración para verificar que las transacciones se están registrando (si el registro de documentos está habilitado)
Notificar a tu equipo de ventas que el cálculo de impuestos ahora es automático y se basa en la dirección del cliente
Resumen
Habilitar la integración de Avalara en IdeaRoom proporciona a tus clientes cálculos precisos y en tiempo real del impuesto sobre las ventas al momento del pago, basados en su dirección de entrega. La configuración requiere obtener tu ID de cuenta y clave de licencia de Avalara y compartirlos con tu CSM de IdeaRoom, quien completará la configuración en el sistema. Una vez activa, los cálculos de impuestos son completamente automáticos; no se requiere mantenimiento manual de tu parte.
¿Aún necesitas ayuda?
Comunícate con el equipo de soporte de IdeaRoom a través del widget de Servicio en SalesView.