📋 Aplicable a: Administrador · Administrador de socios
Módulo: Gestión > Integraciones
Proveedor: QuickBooks Online (Intuit) · Tipo de integración: Bidireccional · Dirección de sincronización: Alvys a QBO (facturas y recibos); QBO a Alvys (estado de pago)
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Este artículo explica cómo autorizar la conexión OAuth entre Alvys y QuickBooks Online, y cómo configurar los ajustes de sincronización para ingresos, gastos, facturas de conductores, requisitos de facturación de transportistas y asignación de filiales o flotas a clases o ubicaciones de QBO.
Qué hace esta integración
Alvys se conecta a QuickBooks Online (QBO, Intuit QuickBooks) mediante OAuth 2.0. Esto significa que usted se autentica (inicia sesión y autoriza) a través del portal de inicio de sesión de Intuit y Alvys recibe un token seguro; Alvys no almacena contraseñas. Una vez conectado, Alvys exporta, sincroniza y envía automáticamente las facturas de los clientes y las facturas de transportistas o proveedores cuando se procesan los envíos para su facturación. Cuando se registran los pagos en QBO, este envía el estado del pago a Alvys.
Requisitos previos
Antes de conectarse, complete todos los pasos en Requisitos previos de QuickBooks Online (Comience aquí) :
Confirma que tu suscripción a QBO sea Essentials, Plus o Advanced.
Verifique que su plan de cuentas incluya cuentas para cuentas por cobrar, cuentas por pagar, ingresos y gastos.
Habilite los números de transacción personalizados en QBO en Configuración > Cuenta y configuración > Ventas > Contenido del formulario de ventas si desea que las facturas de QBO utilicen los números de carga de Alvys.
Confirme que no existan períodos contables cerrados que abarquen las fechas de las cargas que planea exportar.
Necesitas el permiso "CompanyProfileManager" para conectarte y configurar la integración. Este permiso está disponible para los usuarios con el rol de "Administrador" o "Administrador de socios" .
Conectar / Autenticar
Abra la página de Integraciones. Vaya a Administración > Integraciones en Alvys y localice el mosaico de QuickBooks Online.
📷 [IMAGEN DE RESERVA] Página de Administración > Integraciones con el mosaico de QuickBooks Online. Recuperado de IC:14044254.
Inicie la conexión. Haga clic en Conectar en el icono de QuickBooks Online. Alvys le redirigirá a la página de autorización de Intuit.
📷 [IMAGEN DE RESERVA] Página de autorización de Intuit después de hacer clic en Conectar. Recuperación de IC:14044254.
Inicia sesión y autoriza. Inicia sesión con tus credenciales de QBO y haz clic en Conectar . Una vez autorizado, Intuit te redirigirá a Alvys y el estado de la conexión aparecerá como conectado.
📷 [IMAGEN DE RESERVA] El estado de la conexión muestra que está conectado en Alvys. Recuperado de IC:14044254.
Seleccione el archivo de empresa de QBO. Si su cuenta de Intuit tiene acceso a más de un archivo de empresa de QBO, seleccione el correcto en el menú desplegable. Solo se puede conectar un archivo de empresa por entidad legal de Alvys.
Mapeo de campos y datos
Tras la conexión, configure los ajustes de sincronización. Cada sección siguiente relaciona los datos de Alvys con el campo o comportamiento correspondiente de QBO.
Configuración de sincronización de ingresos. Esta configuración controla cómo Alvys exporta las facturas de los clientes a QBO:
Sincronizar ingresos con QBO: habilita o deshabilita la exportación de ingresos. Debe estar activada para enviar las facturas de los clientes.
Exportación automática de facturas: cuando está habilitada, Alvys pone automáticamente en cola la factura de un envío para su exportación en cuanto este se libera para facturación. Cuando está deshabilitada, las facturas deben exportarse manualmente desde la página de Transacciones.
Prefijo de factura: agrega un prefijo de texto a cada número de factura exportado a QBO, lo que ayuda a distinguir las facturas originadas por Alvys de otras facturas en su cuenta de QBO.
Cuenta de ingresos predeterminada: la cuenta de ingresos de QBO que se utiliza cuando no se configura ninguna asignación específica para una partida. Establézcala en su cuenta principal de ingresos por fletes.
Sincronizar ingresos: elija si desea exportar las facturas cuando la carga se libera para facturación o cuando la factura se marca como enviada al cliente.
Configuración de sincronización de gastos. Esta configuración controla cómo Alvys exporta las cuentas por pagar de los transportistas y las liquidaciones de los conductores a QBO:
Sincronizar gastos con QBO: habilita o deshabilita la exportación de gastos. Debe estar activada para enviar las facturas de los transportistas y los pagos a los conductores.
Exportación automática de facturas: cuando está activada, Alvys pone automáticamente en cola la factura del transportista o el pago del conductor para su exportación una vez finalizado el proceso. Cuando está desactivada, las facturas deben exportarse manualmente.
Cuenta de gastos predeterminada: la cuenta de gastos de QBO que se utiliza cuando no existe una asignación específica. Establézcala en su cuenta principal de transporte contratado.
Consolidación de facturas de conductores. Cuando su empresa paga a varios conductores en una sola liquidación, esta configuración controla si cada liquidación se exporta a QBO como una factura independiente o si todas las liquidaciones del mismo conductor en el mismo período se consolidan en una sola factura de QBO. La consolidación reduce el número total de transacciones en QBO y simplifica la conciliación.
Requisito de factura del transportista. Cuando esta configuración está habilitada, Alvys requiere que se registre un número de factura del transportista para una carga antes de que la factura de esa carga se pueda exportar a QBO.
Asignación de clases y ubicaciones. Si utiliza QBO Plus o QBO Advanced con Seguimiento de ubicaciones o Seguimiento de clases habilitado, puede asignar las filiales y flotas de Alvys a las ubicaciones y clases de QBO, respectivamente. Para configurar las asignaciones, expanda la sección Asignación de clases o Asignación de ubicaciones en la página de configuración de integraciones y asigne cada filial o flota de Alvys a la clase o ubicación de QBO correspondiente.
📷 [IMAGEN DE REFERENCIA] Secciones de Asignación de clases y Asignación de ubicaciones en la página de configuración de integración. Recuperado de IC:14044254.
Comportamiento de sincronización
Alvys exporta las transacciones a QBO en el momento en que se produce el evento desencadenante, ya sea automáticamente al liberar la facturación o mediante exportación manual, según la configuración de exportación automática. Cada transacción se envía individualmente; no existe una ventana de exportación por lotes.
Si QBO rechaza una transacción, esta aparece en la cola de Transacciones con error. Ninguna exportación posterior de esa carga se verá bloqueada por un rechazo anterior; cada transacción se reintenta de forma independiente al hacer clic en Reexportar.
El estado de pago se sincroniza entre QBO y Alvys periódicamente. Cuando QBO marca una factura como pagada, Alvys actualiza el estado de cobro o pago correspondiente. El estado de pago puede tardar varios minutos en actualizarse.
Verifica que funcione.
Navegue hasta una carga que haya sido liberada para facturación.
Abra la pestaña Transacciones en esa carga.
Haz clic en Exportar a QBO . Si la exportación automática estaba habilitada, la carga ya debería estar en la cola de exportación.
Inicie sesión en QBO y confirme que la factura o recibo aparece bajo el cliente o proveedor correcto con los artículos, importes y números de referencia esperados.
Regrese a Alvys y confirme que el estado de la transacción de la carga aparece como exportada .
Solución de problemas
El botón Exportar no es visible en la página de Transacciones.
Confirme que las opciones Sincronizar ingresos con QBO y Sincronizar gastos con QBO estén habilitadas en la configuración de integración. Si estas opciones están desactivadas, la exportación no estará disponible.
QBO muestra un archivo de empresa diferente al esperado.
Desconecta y vuelve a conectar la integración. Durante la reconexión, selecciona el archivo de empresa de QBO correcto en el menú desplegable cuando se te solicite.
La conexión aparece como establecida, pero las exportaciones están fallando.
Verifique que el token de OAuth no haya caducado. Desconecte y vuelva a conectar la integración para actualizar el token.
Límites / No compatible
Solo se puede conectar un archivo de empresa de QBO por entidad legal de Alvys. Las configuraciones con varias entidades requieren una conexión independiente para cada entidad legal.
QBO Simple Start no es compatible porque no incluye el módulo de Cuentas por Pagar.
El seguimiento de ubicación y clase en QBO requiere QBO Plus o QBO Advanced.
Preguntas frecuentes
P: ¿Puedo conectar más de un archivo de empresa de QBO a una sola cuenta de Alvys?
R: No. Cada entidad legal de Alvys puede conectarse a un único archivo de empresa de QBO.
P: ¿Qué plan de QBO necesito para usar el seguimiento de clases o ubicaciones con Alvys?
R: QBO Plus o QBO Advanced. El seguimiento de clases y ubicaciones no está disponible en Essentials ni en Simple Start.
P: ¿Qué hace la configuración de Requisito de factura del transportista?
A: Cuando está habilitada, Alvys requiere que se registre un número de factura del transportista en una carga antes de que la factura del transportista de esa carga se pueda exportar a QBO.
P: ¿Qué sucede con la conexión a QBO si mi sesión de Intuit se invalida?
A: El token de OAuth caduca. Desconéctese y vuelva a conectarse para generar un nuevo token.
P: ¿Cómo puedo exportar facturas manualmente si la exportación automática está desactivada?
A: Abra la carga, vaya a la pestaña Transacciones y haga clic en Exportar a QBO .