Ir al contenido principal

QuickBooks Online: Identificación y resolución de transacciones fallidas

Escrito por Alvys Admin

📋 Aplicable 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 errores, interpretar el mensaje de error de QBO, corregir el problema subyacente y volver a exportar para que los registros de facturas o recibos se generen correctamente.

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

Abrir 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 (por ejemplo, carga o recibo de nómina).

  • Tipo de transacción: Cómo se clasifica la transacción en QuickBooks Online, como factura, recibo o nota de crédito.

  • Clase: La filial asociada a la transacción.

  • Mensaje de error: Mensaje de rechazo devuelto por QuickBooks Online.

  • Estado: Indica si la transacción ha fallado o se ha resuelto.

  • Referencia: El número de carga, el número de factura resumida o el número de viaje vinculado a la transacción.

  • Total de la transacción: El importe en dólares de la transacción.

  • Fecha de creación: La fecha en que la transacción se envió por primera vez a QuickBooks Online.

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.

  1. 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.

  2. Si la factura existente de QBO es un duplicado o contiene un error, anúlela o elimínela en QBO.

  3. 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.

  1. En QBO, busque en las listas de Clientes y Proveedores un registro con el mismo nombre o uno similar.

  2. 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.

  3. 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).

  4. En Alvys, vaya a Administración > Integraciones > Asignaciones de cuentas.

  5. 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.

  6. 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.

  7. Inicie sesión en QBO y vaya a Configuración > Avanzado > Contabilidad.

  8. Revisa la fecha de cierre. Si puedes modificar el período (eliminar la fecha de cierre o adelantarla), hazlo.

  9. 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.

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.

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.

  1. En QBO, vaya a Configuración > Plan de cuentas .

  2. Localiza la cuenta a la que se hace referencia en el mensaje de error y reactívala.

  3. Vuelva a Alvys, seleccione la transacción fallida en la Cola de errores y vuelva a intentar la sincronización.

Resolver errores de transacciones con valor cero (Error 2030)

Este error se produce porque la configuración "Ignorar transacciones con valor cero" en Alvys entra en conflicto con la forma en que QBO procesa la transacción.

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 restablecerá la configuración y sincronizará la transacción nuevamente.

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 .

  1. 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 .

  2. En Alvys, vaya a Administración > Integraciones > Asignaciones de cuentas y actualice la asignación de Depósitos de clientes si es necesario.

  3. 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.

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.

Tipos de transacciones compatibles para la resincronización

Los siguientes tipos de transacciones admiten la resincronización directamente desde la página de Transacciones con error: Carga, Viaje, Cheque electrónico y Recibo de nómina. Para resincronizar una de estas transacciones, haga clic con el botón derecho en ella en la lista de Transacciones con error y seleccione Sincronizar transacción . Para resincronizar todas las transacciones elegibles a la vez, haga clic con el botón derecho y seleccione Sincronizar todas las transacciones .

Los siguientes tipos de transacciones no se pueden volver a sincronizar desde la página de Transacciones con errores y deben corregirse en sus respectivos módulos antes de que se puedan volver a exportar: Deducción, Ingresos accesorios, Combustible, Peaje, Factura contable (también llamada factura resumida), Depósito en garantía, Estado de cuenta del transportista y Estado de cuenta del conductor.

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.

Profundiza más

¿Ha quedado contestada tu pregunta?