Se aplica a: Administración · Administración de socios · Soporte · Módulo: Gestión > Integraciones
Última revisión: junio de 2026 · Propietario: Equipo de soporte
Este artículo explica cómo localizar transacciones fallidas de QuickBooks Online en Alvys y cómo resolver los rechazos más comunes de la API de QBO, incluidos los números de documento duplicados, los conflictos de nombres duplicados, los tipos de cuenta no válidos y los errores de período contable cerrado.
Descripción general
Una transacción enviada desde Alvys a QuickBooks Online puede ser rechazada por QBO si los datos entran en conflicto con sus reglas. Esta guía (que también cubre los errores de sincronización y exportación de QBO) le muestra cómo encontrar cada exportación fallida en la cola de Transacciones con error , interpretar el mensaje de error de QBO, corregir el problema subyacente y volver a exportar para que la factura o el recibo se registren correctamente. Puede acceder a esta página desde el menú " Contabilidad " seleccionando Transacciones con error en Alvys.
Imagen que muestra el error de Alvys en la página de transacciones.
Síntoma
Se ha producido un error al exportar una transacción de Alvys a QuickBooks Online. La transacción aparece en la cola de transacciones con errores de Alvys con un mensaje de error de QBO, y la factura correspondiente no es visible en QBO.
Causa
QBO rechaza una exportación cuando la transacción contiene datos que entran en conflicto con las reglas de QBO. Las causas más comunes son:
Números de documento duplicados: un cliente de QBO ya tiene una factura con el mismo número.
Conflictos de nombres duplicados: Alvys intentó crear un nuevo cliente o proveedor en QBO, pero ya existe un registro con ese nombre (posiblemente de un tipo diferente o con caracteres especiales).
Tipo de cuenta no válido: la cuenta de QBO asignada en Alvys no es del tipo correcto para esa transacción (por ejemplo, se asignó una cuenta de ingresos donde se requiere una cuenta de gastos).
Periodo contable cerrado: la fecha de la transacción se encuentra dentro de un periodo que ha sido cerrado en QBO.
Resolución
Abra la cola de transacciones con errores.
En Alvys, vaya a Administración > Integraciones. Localice la sección Transacciones con errores (también llamada Cola de errores). Esta vista muestra todas las exportaciones fallidas con el mensaje de error devuelto por QBO.
La página Transacciones con errores incluye las siguientes columnas:
Tipo de entidad: El tipo de transacción de Alvys que no se exportó correctamente, indicando su origen. Algunos ejemplos son: Carga, Viaje, Recibo de pago, Deducción, Ingresos adicionales, Peaje, Combustible, Depósito en garantía, Cheque electrónico y Factura contable.
Tipo de transacción: Cómo se clasifica el registro en el sistema de contabilidad externo, como factura, recibo, nota de crédito, crédito de proveedor o asiento contable.
Clase: La filial asociada a la transacción.
Mensaje de error : El mensaje que devuelve QBO explica por qué falló la transacción.
Estado: El estado actual de la transacción, como Fallida o Resuelta.
Referencia : Identificadores adicionales para vincular la transacción, como el número de carga, el número de factura resumida o el número de viaje.
Total de la transacción : El importe total de la transacción.
Fecha de creación : Fecha en la que se intentó exportar la transacción por primera vez.
Lea el mensaje de error y aplique la solución correspondiente.
Haz clic en una transacción fallida para ver el mensaje de error completo de QBO. Compara el mensaje con la solución adecuada a continuación.
Resolución de números de documentos duplicados
Este error significa que un cliente de QBO ya tiene una factura con el número que Alvys intentó asignar. Alvys utiliza el número de carga de Alvys como número de factura cuando la configuración de números de transacción personalizados de QBO está habilitada.
En QBO, localice la factura existente con el número duplicado y determine si se trata de una transacción válida o de un error de importación anterior.
Si la factura existente de QBO es un duplicado o contiene un error, anúlela o elimínela en QBO.
Vuelva a Alvys, seleccione la transacción fallida en la Cola de errores y haga clic en Reexportar .
Si la factura de QBO con ese número corresponde a una transacción legítima que comparte el mismo número, debe cambiar el número de factura en la carga de Alvys antes de volver a exportarla. Abra la carga, edite el número de factura y, a continuación, vuelva a exportarla.
Resolución de conflictos de nombres duplicados
Este error significa que QBO rechazó la creación de un nuevo cliente o proveedor porque ya existe un registro con el mismo nombre, posiblemente bajo un tipo de entidad diferente o con una ligera variación en el nombre.
Imagen que muestra la página de Transacciones con errores con el error de documento duplicado para una transacción.
En QBO, busque en las listas de Clientes y Proveedores un registro con el mismo nombre o uno similar.
Determine el tipo de entidad correcto. Si el registro existe como cliente, pero Alvys intenta crearlo como proveedor (o viceversa), es posible que deba ajustar el campo Facturar como o Pagar como en Alvys para que coincida con el nombre exacto de QBO.
Una vez resuelto el registro de QBO, vuelva a Alvys y haga clic en Reexportar en la transacción fallida.
Solución de errores de tipo de cuenta no válido
Este error significa que la cuenta asignada en Alvys para este tipo de partida no es el tipo de cuenta QBO correcto (por ejemplo, se seleccionó una cuenta bancaria o una cuenta de patrimonio en lugar de una cuenta de ingresos o gastos).
Imagen que muestra la página de Transacciones con Error con el error de cuenta no válida para las transacciones.
En Alvys, vaya a Administración > Integraciones > Asignaciones de cuentas.
Localice la asignación del tipo de partida que se menciona en el mensaje de error y cámbiela al tipo de cuenta QBO correcto.
Vuelva a la cola de errores, seleccione la transacción fallida y haga clic en Reexportar .
Resolución de errores en periodos contables cerrados
Este error significa que la fecha de la transacción se encuentra dentro de un período contable que ya se ha cerrado en QBO.
Imagen que muestra la página de Transacciones con errores con el error de período contable cerrado para transacciones.
Inicie sesión en QBO y vaya a Configuración > Avanzado > Contabilidad.
Revisa la fecha de cierre. Si puedes modificar el período (eliminar la fecha de cierre o adelantarla), hazlo.
Vuelva a Alvys, seleccione la transacción fallida y haga clic en Reexportar .
Si no puede abrir el período contable, es posible que deba ajustar la fecha de la transacción en la carga en Alvys para que se encuentre dentro de un período abierto antes de volver a exportar. Comuníquese con su equipo de contabilidad para determinar la solución correcta para sus registros contables.
Resolviendo errores de objeto no encontrado (Error 610)
Este error significa que la transacción se envió correctamente a QuickBooks Online en un momento anterior, pero el registro se eliminó o se fusionó posteriormente en QBO.
Imagen que muestra la página de Transacciones con error con el error Objeto no encontrado para transacciones.
Comuníquese con el soporte técnico de Alvys e incluya el número de carga y el mensaje de error. El equipo de soporte reiniciará la transacción para que se pueda enviar un nuevo registro a QBO.
Resolución de errores de vinculación de transacciones (Error 620)
Este error se produce cuando no se puede vincular un pago a una factura porque el nombre del cliente en el pago no coincide exactamente con el nombre del cliente en la factura en QuickBooks Online.
Imagen que muestra la página de Transacciones con error con el error de vinculación de transacciones para transacciones
Comuníquese con el soporte de Alvys e incluya el número de carga y el mensaje de error. El soporte resincronizará el pago una vez que los nombres coincidan. No puede solucionar este error desde la página de Transacciones con errores.
Solución de errores de ID de referencia no válidos (Error 2500)
Este error significa que la cuenta del libro mayor a la que se hace referencia en la transacción se eliminó o se desactivó en QuickBooks Online después de que se configurara la asignación de cuentas en Alvys.
En QBO, vaya a Configuración > Plan de cuentas .
Localiza la cuenta a la que se hace referencia en el mensaje de error y reactívala.
Regresa a Alvys, selecciona la transacción fallida en la Cola de errores y vuelve a intentar la sincronización.
Solución de errores de validación empresarial (Error 6000)
Este error generalmente significa que la cuenta asignada a los depósitos de clientes en Alvys no es del tipo correcto en QuickBooks Online. QBO requiere que esta cuenta sea de tipo Banco u Otro activo circulante .
En QBO, vaya a Configuración > Plan de cuentas y verifique que la cuenta Depósitos de clientes esté configurada como tipo Banco u Otro activo corriente .
En Alvys, vaya a Administración > Integraciones > Asignaciones de cuentas y actualice la asignación de Depósitos de clientes si es necesario.
Póngase en contacto con el servicio de asistencia de Alvys para resincronizar la transacción afectada.
Reexportar la transacción
Tras solucionar el problema subyacente, seleccione la transacción corregida en la Cola de errores y haga clic en Reexportar . Alvys volverá a enviar la transacción a QBO.
Tipos de transacciones compatibles que se pueden resincronizar a partir de transacciones con errores.
No todas las transacciones se pueden sincronizar automáticamente desde esta página. Actualmente, solo se pueden sincronizar los siguientes tipos de entidades:
Carga
Viaje
Cheque electrónico
Recibo de nómina
Verificar en QBO
Inicie sesión en QBO y confirme que la factura o recibo aparece ahora bajo el cliente o proveedor correcto con los importes y números de referencia esperados.
Borrar una transacción errónea que ya corrigió en QuickBooks Online.
Si corrigió una transacción directamente en QuickBooks Online en lugar de volver a sincronizarla desde Alvys, puede marcarla como resuelta en Alvys para eliminarla de la lista de transacciones con errores.
Seleccione la transacción en la lista de Transacciones con error, haga clic con el botón derecho y seleccione Marcar como sincronizada . Confirme la acción cuando se le solicite. La transacción se eliminará de la cola de Transacciones con error.
Solución de problemas
El error persiste después de aplicar los pasos de resolución.
Si el error persiste después de seguir los pasos de solución anteriores:
Confirme que la integración de QBO sigue activa en Administración > Integraciones. Si la conexión aparece como caducada o desconectada, vuelva a conectar la integración e intente exportar de nuevo.
Confirme que las asignaciones de cuentas se hayan guardado correctamente y que ninguna asignación haga referencia a una cuenta de QBO que haya sido desactivada o eliminada en QBO.
Si el mensaje de error no está contemplado en los casos anteriores o si el mismo error aparece después de volver a exportar, póngase en contacto con el soporte técnico de Alvys e incluya el número de carga, el mensaje de error exacto de QBO y los pasos que ya haya realizado.
Preguntas frecuentes
P: ¿Dónde puedo ver una lista de todas las transacciones que no se sincronizaron con QuickBooks?
A: Vaya a Contabilidad > Transacciones con errores. Esta página muestra todas las exportaciones fallidas junto con el mensaje de error devuelto por QBO, el total de la transacción y el número de referencia de carga o viaje asociado.
P: ¿Qué transacciones puedo volver a sincronizar desde la página de Transacciones con errores?
A: Solo las transacciones de Carga, Viaje, Cheque electrónico y Recibo de pago se pueden sincronizar directamente. Otros tipos, como Deducción, Ingresos adicionales, Combustible, Peaje, Factura contable (factura resumida), Depósito en garantía, Estado de cuenta del transportista y Estado de cuenta del conductor, no se pueden sincronizar desde esta página y deben corregirse en sus módulos respectivos.
P: ¿Qué debo hacer si corregí un error manualmente en QuickBooks Online?
A: Seleccione la transacción en la lista de Transacciones con error, haga clic con el botón derecho y elija Marcar como sincronizada. Esto la elimina de la cola sin necesidad de volver a sincronizarla con Alvys.
P: ¿Cómo puedo solucionar el "Error 6430: Tipo de cuenta no válido"?
A: El tipo de cuenta asignado en Alvys para esa partida no coincide con el que espera QBO. Verifique el tipo de cuenta en el Plan de cuentas de QBO, actualice la asignación en la página de Integraciones de Alvys y vuelva a sincronizar la transacción.
P: ¿Qué causa el error "Existe un nombre duplicado" (Código 6240)?
R: QBO requiere nombres únicos a nivel global para todos los tipos de entidad. Si un nombre ya existe en un tipo de entidad diferente, agregue un sufijo distintivo en QBO (como "(Vendor)") e inténtelo de nuevo.
P: ¿Por qué recibo un error de "Período de cuenta cerrado" (Código 6200)?
A: La fecha de la transacción se encuentra dentro de un período bloqueado en QBO. Cambie la fecha de cierre en QBO (Configuración > Avanzado) para abrir el período, o actualice la fecha de la transacción en Alvys para que se encuentre dentro de un período abierto.
P: ¿Qué significa "Objeto no encontrado" (Error 610)?
A: La transacción se envió previamente a QBO, pero el registro se eliminó o se fusionó allí posteriormente. Comuníquese con el soporte de Alvys para restablecer y reenviar la transacción.
P: ¿Por qué no se puede vincular un pago a una factura (Error 620)?
A: El nombre del cliente en el pago no coincide exactamente con el nombre del cliente en la factura de QBO. Comuníquese con el soporte de Alvys para sincronizar nuevamente los nombres una vez que coincidan.
P: ¿Qué debo hacer si veo "ID de referencia no válido" (Error 2500)?
A: La cuenta del libro mayor se eliminó o se desactivó en QBO después de configurar la asignación. Reactive la cuenta en el Plan de cuentas de QBO y vuelva a intentar la sincronización en Alvys.
P: ¿Por qué falló el pago de mi factura con un "Error de validación comercial" (Código 6000)?
A: La cuenta de Depósitos de Clientes no está configurada como tipo Banco u Otro Activo Corriente en QBO. Actualice el tipo de cuenta en el Plan de Cuentas de QBO, actualice la asignación en Alvys si es necesario y póngase en contacto con el Soporte de Alvys para resincronizar.