📋 Se aplica a: Todos los usuarios con el permiso "Facturación" , excepto los conductores.
Módulo: Contabilidad > Transacciones con errores
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Este artículo explica cómo encontrar las transacciones que no se exportaron correctamente a QuickBooks Desktop, comprender por qué fallaron y resolverlas utilizando las opciones de la página Transacciones con error.
Descripción general
QuickBooks Desktop (QBD) ofrece una integración bidireccional: Alvys transfiere facturas, recibos y otros registros financieros a QuickBooks Desktop mediante el Conector Web de QuickBooks (QBWC). Si Alvys exporta estos registros y el Conector Web detecta un problema, la transacción afectada se registra en la página de Transacciones con error de Alvys, en lugar de perderse silenciosamente. Desde esta página, puede revisar el código y el mensaje de error de cada exportación fallida, volver a intentar la sincronización o marcar una transacción como resuelta sin volver a sincronizar. Esta guía explica cómo localizar las exportaciones fallidas, interpretar el motivo del fallo y solucionarlo.
Síntoma
Se presenta una o más de las siguientes condiciones:
Las transacciones aparecen en la página de Transacciones con error (Contabilidad > Transacciones con error) en Alvys.
En la columna Código de error o Mensaje de error aparece un código de error como QBWC1039, QBWC1088, Error 3140 o Error 3070.
El banner en la parte superior de la página de Transacciones con errores muestra el número de transacciones que aún no se han sincronizado con QuickBooks Desktop.
Una transacción se había exportado previamente, pero volvió a aparecer en la página de Transacciones con errores después de un cambio de versión de QuickBooks Desktop.
Causa
Cada código de error indica una causa distinta.
QBWC1039: El nombre duplicado ya existe en QuickBooks.
El error QBWC1039 se produce cuando QuickBooks rechaza un registro porque el nombre de la cuenta externa en Alvys ya existe en otra lista de QuickBooks Desktop. QuickBooks no permite nombres duplicados en sus listas (clientes, proveedores, empleados, etc.). Por ejemplo, si un cliente se llama "ABC Trucking" en Alvys y un proveedor con el mismo nombre ya existe en QuickBooks, la sincronización falla con este error.
Una variante relacionada del error QBWC1039 se produce cuando un archivo de empresa de QuickBooks Desktop ya contiene un registro para la aplicación Alvys. Esto sucede al agregar el archivo Alvys Web Connector (.QWC) al programa Web Connector y si ya existe un registro para dicha aplicación en el archivo. Al seleccionar "Eliminar" en Web Connector, solo se elimina el programador; no se elimina el registro de la aplicación del archivo de empresa de QuickBooks.
QBWC1088: El archivo de la empresa de QuickBooks no está abierto.
El error QBWC1088 se produce cuando el conector web no puede verificar el estado de una integración porque el archivo de la empresa de QuickBooks no está abierto. Este error también se produce durante la configuración inicial de la conexión cuando el archivo de la empresa no está abierto en el momento en que debería aparecer la solicitud del certificado de la aplicación.
Error 3140: Cuenta no válida o faltante
El error 3140 se produce cuando una transacción hace referencia a una cuenta de QuickBooks que no existe en el archivo de la empresa o que se introdujo incorrectamente en la asignación de cuentas de Alvys.
Error 3070: Se ha excedido la longitud del campo.
El error 3070 se produce cuando un valor de la transacción excede la longitud máxima de campo permitida por QuickBooks Desktop, generalmente debido a que el nombre del cliente, el nombre de la clase o la descripción son más largos de lo que QuickBooks acepta.
Transacción de $0 que aparece en la página de Transacciones con error.
Si la opción "Ignorar transacciones con valor cero" estaba activada y posteriormente se desactivó, todas las transacciones originales de $0 que se omitieron se reprocesan. Si una transacción ahora tiene un valor distinto de cero y la exportación no se completa correctamente, aparece en la página "Transacciones con error".
Transacciones que reaparecen después de un cambio de versión de QuickBooks
Si actualiza o degrada su versión de QuickBooks Desktop, el registro del conector web se desincronizará. Es posible que las transacciones que antes se sincronizaban correctamente vuelvan a aparecer en la página de Transacciones con errores.
Resolución
Navegue a la página de Transacciones con errores.
En Alvys, vaya a Contabilidad > Transacciones con errores . La página muestra todas las transacciones que no se pudieron exportar, con las siguientes columnas: Tipo de entidad, ID de transacción, Tipo de transacción, Nombre de usuario, Clase, Nombre, Número de referencia, Número de orden de compra, Cuenta, Descripción, Mensaje de error, Código de error, Fecha de creación y Total de la transacción.
Un banner en la parte superior muestra el número total y el valor en dólares de las transacciones no sincronizadas.
🖼️ [IMAGEN DE REFERENCIA: Captura de pantalla de la página de Transacciones con Error en Alvys que muestra la disposición de las columnas y el banner de transacciones no sincronizadas. Suba la imagen original de IC:14019710 para reemplazar esta imagen de referencia.]
Solución del problema QBWC1039: Nombre duplicado en QuickBooks
Anote el nombre que aparece en la columna Mensaje de error.
Abra QuickBooks Desktop y busque ese nombre en todos los tipos de listas (Clientes, Proveedores, Empleados, Otros nombres).
Determina si el duplicado es la misma entidad o una entidad diferente con el mismo nombre. Si es la misma entidad, fusiona o elimina el duplicado. Si son entidades diferentes, cambia el nombre de una de ellas para evitar conflictos.
Vuelva a la página de Transacciones con errores en Alvys, seleccione la transacción y seleccione Reintentar sincronización .
Solución de la variante de registro duplicado del conector web QBWC1039:
Abra QuickBooks Desktop e inicie sesión como administrador.
Pulse F2 o Ctrl + 1 para abrir la ventana de Información del producto y confirmar los datos del archivo de la empresa.
En el programa QuickBooks Web Connector, localice la entrada de Alvys y seleccione "Eliminar". Esto elimina únicamente el programador.
Descargue un nuevo archivo .QWC de Alvys (Administración > Integraciones > QuickBooks Desktop) y agréguelo al Conector web. Cuando aparezca la ventana Certificado de aplicación en QuickBooks Desktop, seleccione "Sí, siempre que se abra este archivo de empresa de QuickBooks".
Ejecute la sincronización del conector web y confirme que el proceso de transacciones se haya realizado sin errores.
🖼️ [MARCADOR DE POSICIÓN DE IMAGEN: Captura de pantalla del conector web de QuickBooks que muestra la entrada de Alvys con el botón Eliminar. Cargue la imagen original de IC:14019710 para reemplazar este marcador de posición.]
Resolución del error QBWC1088: El archivo de la empresa no está abierto.
Abra QuickBooks Desktop y abra el archivo de la empresa conectado a Alvys.
Si se trata de la configuración inicial de la conexión, confirme que la ventana del Certificado de aplicación aparece en QuickBooks Desktop después de agregar el archivo .QWC. Si no aparece la notificación, cierre el Conector web, asegúrese de que QuickBooks Desktop esté abierto con el archivo de empresa correcto y vuelva a agregar el archivo .QWC.
Ejecute la sincronización del conector web. Confirme que la conexión se complete y que las transacciones en la página de Transacciones con errores desaparezcan.
🖼️ [IMAGEN DE REFERENCIA: Captura de pantalla del archivo de la empresa QuickBooks Desktop abierto con la solicitud del certificado de la aplicación visible. Suba la imagen original de IC:14019710 para reemplazar esta imagen de referencia.]
Resolviendo el error 3140: Cuenta no válida
Anote el nombre de la cuenta que aparece en la columna Mensaje de error.
Abra QuickBooks Desktop y vaya a Listas > Plan de cuentas . Verifique que la cuenta exista y que su nombre coincida exactamente con el configurado en Alvys.
En Alvys, vaya a Administración > Integraciones > QuickBooks Desktop y revise las asignaciones de cuentas. Corrija los nombres de cuenta que no coincidan.
Vuelva a la página Transacciones con errores, seleccione la(s) transacción(es) afectada(s) y seleccione Reintentar sincronización .
Resolviendo el error 3070: Se ha excedido la longitud del campo.
Observe el campo al que se hace referencia en la columna Mensaje de error.
En Alvys, localice la carga o entidad a la que hace referencia el número de referencia y reduzca el valor que exceda el límite. QuickBooks Desktop limita la mayoría de los campos de nombre a 41 caracteres y los campos de descripción a 4095 caracteres.
Vuelva a la página Transacciones con errores, seleccione la(s) transacción(es) afectada(s) y seleccione Reintentar sincronización .
Resolviendo transacciones de $0 que reaparecieron
Localiza la transacción de $0 en la página de Transacciones con error.
Si la transacción no tiene valor y no necesita estar en QuickBooks, selecciónela y seleccione Marcar como sincronizada .
Si se debe exportar la transacción, verifique la configuración Ignorar transacciones con valor cero en Administración > Integraciones > QuickBooks Desktop y, a continuación, seleccione Reintentar sincronización .
Resolución de transacciones que reaparecieron después de un cambio de versión de QuickBooks
En el conector web de QuickBooks, elimine la entrada existente de Alvys.
Descargue un nuevo archivo .QWC desde Administración > Integraciones > QuickBooks Desktop en Alvys.
Abra QuickBooks Desktop con la versión correcta y el archivo de empresa correcto. Agregue el nuevo archivo .QWC al conector web. Cuando QuickBooks Desktop se le solicite, otorgue acceso a Alvys seleccionando "Sí, siempre que este archivo de empresa de QuickBooks esté abierto".
Ejecute la sincronización del conector web y confirme que las transacciones se procesan correctamente.
Utilizar Sincronizar todo y Marcar como sincronizado
En cualquier momento, puede utilizar las siguientes acciones en la página de Transacciones con errores:
Sincronizar todo: Seleccione el botón Sincronizar todo (arriba a la derecha) para intentar reexportar todas las transacciones que se encuentran actualmente en la página Transacciones con errores.
Reintentar sincronización: Seleccione una sola transacción y haga clic en Reintentar sincronización en la barra de acciones masivas para volver a exportar esa transacción específica.
Marcar como sincronizado: Seleccione una o más transacciones y marque "Marcar como sincronizado" en la barra de acciones masivas para descartarlas sin exportarlas a QuickBooks Desktop. Utilice esta opción cuando una transacción se haya resuelto directamente en QuickBooks Desktop o ya no sea necesaria.
🖼️ [IMAGEN DE REFERENCIA: Captura de pantalla que muestra las opciones del menú contextual Sincronizar transacción y Marcar como sincronizada en la página Transacciones con error. Suba la imagen original de IC:14019710 para reemplazar esta imagen de referencia.]
Solución de problemas
Si los pasos anteriores no resolvieron el error:
Confirme que el conector web de QuickBooks esté en funcionamiento y conectado al archivo de empresa correcto.
Confirme que la configuración de integración de Alvys en Administración > Integraciones > QuickBooks Desktop coincida con el archivo de empresa activo de QuickBooks.
Consulte la columna Mensaje de error en la página Transacciones con error para obtener información adicional más allá del código de error.
Si ninguna de las causas verificadas aplica, comuníquese con el soporte de Alvys e indíquele el código de error, el texto del mensaje de error y el número de referencia de la transacción afectada.
Preguntas frecuentes
P: ¿Cuál es la diferencia entre "Reintentar sincronización" y "Sincronizar todo"?
A: Reintentar sincronización reexporta una sola transacción seleccionada. Sincroniza todos los intentos de reexportar todas las transacciones que se encuentran actualmente en la página Transacciones con error a la vez.
P: ¿Qué hace la opción "Marcar como sincronizado"?
A: La opción "Marcar como sincronizado" elimina las transacciones seleccionadas de la página de Transacciones con errores sin enviarlas a QuickBooks Desktop. Utilice esta opción cuando la transacción ya se haya introducido directamente en QuickBooks o cuando no sea necesario exportarla.
P: ¿Por qué al seleccionar "Eliminar" en el conector web de QuickBooks no se elimina por completo la conexión con Alvys?
A: Al seleccionar "Eliminar", solo se borra el programador: la regla que indica al Conector web cuándo ejecutarse. El registro de la aplicación en el archivo de la empresa de QuickBooks no se elimina. Para volver a registrarla por completo, agregue un nuevo archivo .QWC y otorgue acceso nuevamente a través de la ventana Certificado de aplicación.
P: ¿Por qué volvieron a aparecer las transacciones en la página de Transacciones con error después de actualizar QuickBooks Desktop?
A: Cuando cambia la versión de QuickBooks Desktop, el registro del archivo de la empresa puede desincronizarse con la entrada del Conector web. Elimine la entrada anterior del Conector web, descargue un nuevo archivo .QWC de Alvys y vuelva a agregarlo con la versión correcta de QuickBooks abierta.
P: ¿Puedo exportar la lista de transacciones con errores?
R: Sí. En la página Transacciones con errores, seleccione el botón Exportar tabla (arriba a la derecha) y elija "Exportar todo como CSV" o "Exportar todo como Excel".
P: ¿Por qué aparece una transacción de $0 en la página de Transacciones con Error?
A: Si la opción "Ignorar transacciones con valor cero" estaba habilitada y luego deshabilitada, Alvys reprocesará las transacciones que se omitieron previamente. Use "Marcar como sincronizada" si no necesita exportarla, o "Reintentar sincronización" si debe exportarla.
