Ir al contenido principal

Las transacciones no se sincronizaron con NetSuite.

Escrito por Alvys Admin

📋 Se aplica a: Usuarios con el permiso "Facturación"

Módulo: Contabilidad > Transacciones con errores

Última revisión: junio de 2026 · Propietario: Equipo de soporte

Cuando una o más transacciones no se exportan correctamente de Alvys a NetSuite (también conocido como errores de sincronización de NS, errores de exportación contable o sincronización fallida), aparecen en la página de Transacciones con errores. Este artículo explica cómo identificar la causa de cada error y solucionarlo para que la transacción se sincronice correctamente.

Síntoma

Una o más transacciones no se sincronizaron correctamente entre Alvys y NetSuite. Las transacciones fallidas aparecen en la página de Transacciones con error (Contabilidad > Transacciones con error) con un mensaje de error que explica el motivo del fallo en la exportación. Las transacciones afectadas no se registran en NetSuite hasta que se resuelve el error y la transacción se sincroniza correctamente.

Causa

Las transacciones no se sincronizan cuando NetSuite rechaza la exportación. Los motivos de rechazo más comunes incluyen registros duplicados, nombres de clientes o proveedores no reconocidos, múltiples entidades coincidentes, asignaciones de subsidiarias incorrectas y conflictos de ID internos en transacciones que antes tenían valor cero. Cada fallo se registra con un mensaje y un código de error específicos para ayudar a identificar la causa raíz.

Resolución

Descripción general de la página de transacciones con errores

La página Transacciones con error (Contabilidad > Transacciones con error) es una lista centralizada de todas las transacciones que no se pudieron exportar de Alvys a NetSuite u otro sistema de contabilidad conectado.

La página de Transacciones con errores (Contabilidad > Transacciones con errores)

La página de Transacciones con errores (Contabilidad > Transacciones con errores)

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 devuelto por el sistema de contabilidad externo que 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.

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

    Antes de volver a sincronizar, asegúrese de que se hayan realizado las correcciones necesarias en la transacción. Para volver a sincronizar:

  1. Seleccione una o más transacciones en la página de Transacciones con errores.

  2. Haz clic con el botón derecho para ver las opciones del menú contextual "Sincronizar transacción" o "Sincronizar todas las transacciones".

  3. Haz clic en Sincronizar transacción y confirma la acción en el mensaje que aparece.

Menú contextual con la opción Sincronizar transacción

Menú contextual con la opción Sincronizar transacción

Utilice la opción Sincronizar todas las transacciones únicamente si todas las transacciones de la lista de Transacciones con errores están listas para exportarse. Las transacciones que aún requieran correcciones se omitirán.

Los siguientes tipos de entidades no se pueden volver a sincronizar desde la página de Transacciones con errores:

  • Deducción

  • Ingresos accesorios

  • Combustible

  • Peaje

  • Factura contable (igual que una factura resumida)

  • Depósito

  • Declaración del transportista

  • Declaración del conductor

Para las liquidaciones de transportistas, las facturas resumidas y el pago a los conductores , las correcciones y las resincronizaciones deben realizarse directamente desde sus páginas respectivas, en lugar de desde la página general de Transacciones con errores.

Borrar una transacción con error corregida manualmente en el sistema externo

Si una transacción se ha corregido manualmente en el sistema de contabilidad externo y ya no requiere ninguna acción en Alvys, se puede eliminar desde la página de Transacciones con errores:

  1. Seleccione una o más transacciones en la página de Transacciones con errores.

  2. Haz clic con el botón derecho para que aparezca la opción del menú contextual "Marcar como sincronizado".

  3. Haz clic en Marcar como sincronizado y confirma la acción en el mensaje que aparece.

Menú contextual con la opción Marcar como sincronizado

Menú contextual con la opción Marcar como sincronizado

Solo marque una transacción como sincronizada si el problema se ha resuelto por completo. Esta acción no se puede deshacer.

Error de registro duplicado en la exportación

Mensaje de error: "DuplicateRecord: Se ha detectado un intento de crear un registro duplicado. El ID externo de la transacción coincide con una transacción ya existente."

Causa: Ya existe un registro (factura o recibo) en NetSuite con el mismo número de transacción o ID externo. NetSuite impide la creación de registros duplicados.

Registro duplicado: Se ha detectado un intento de crear un registro duplicado. El ID externo de la transacción coincide con una transacción ya existente.

Error DuplicateRecord en la columna Mensaje de error

Error DuplicateRecord en la columna Mensaje de error

  1. Busque duplicados en NetSuite mediante la búsqueda global o la lista de transacciones. Busque por número de transacción, ID externo o nombre del proveedor o cliente asociado a la transacción.

  2. Resuelva el conflicto utilizando uno de los siguientes métodos:

    • Si el registro existente de NetSuite es válido y correcto, la transacción ya se habrá registrado. Vaya a la página de Transacciones con errores en Alvys, seleccione la transacción, haga clic con el botón derecho y elija Marcar como sincronizada para eliminarla de la lista de errores.

    • Si el registro existente en NetSuite es incorrecto o se creó como prueba, elimínelo en NetSuite y, a continuación, continúe con el siguiente paso.

  3. En Alvys, vaya a Contabilidad > Transacciones con errores. Seleccione la transacción, haga clic con el botón derecho y haga clic en Reintentar sincronización . Confirme la acción en el mensaje que aparece.

  4. Verifique en NetSuite que la transacción se haya creado correctamente y que esté vinculada al cliente, proveedor y filial correctos.

Si el error persiste después de completar estos pasos, consulte la sección "Si eso no funcionó" a continuación.

Cliente no encontrado en NetSuite.

Mensaje de error: "CustomerNotFound: No se encontró el cliente con el nombre '[Nombre del cliente]' y el ID '[ID del cliente]'"

Causa: Alvys no puede localizar al cliente en NetSuite utilizando el ID de cliente de NetSuite. Este error se produce cuando la opción "Usar clientes existentes" está activada y el campo ID de contabilidad externa en Alvys no aparece, contiene un ID incorrecto o apunta a un cliente que ya no existe en NetSuite.

  1. Verifique que el cliente exista y esté activo en NetSuite para la filial correspondiente. Para encontrar el ID de cliente de NetSuite, abra el registro del cliente en NetSuite; el ID aparece en la URL de la página con el formato: https://[netsuite-url] /app/common/entity/custjob.nl?id=12345 .

  2. En Alvys, abra el perfil del cliente o del agente. Introduzca el ID de cliente de NetSuite correcto en el campo ID de contabilidad externa para la filial correspondiente. Guarde el registro.

  3. Vaya a Contabilidad > Transacciones con errores. Seleccione la transacción, haga clic con el botón derecho y haga clic en Reintentar sincronización . Confirme la acción en el mensaje que aparece.

  4. Verifique en NetSuite que la factura se haya creado y esté vinculada al cliente y la filial correctos.

Se encontraron varias entidades con el mismo nombre.

Mensaje de error: "MultipleItems: Se encontraron varios elementos. Se encontraron varios proveedores para el nombre '[Nombre de la entidad]'"

Causa: Alvys encontró más de un registro en NetSuite con el mismo nombre y no puede determinar a cuál asociar la transacción. Para las facturas, la entidad es un proveedor. Para las facturas, la entidad es un cliente.

  1. Determina el tipo de transacción: las facturas utilizan un cliente como entidad; las facturas utilizan un proveedor.

  2. Localice los registros de entidades duplicados en NetSuite:

    • Para clientes: vaya a Listas > Relaciones > Clientes y busque el nombre de la entidad.

    • Para los proveedores: vaya a Listas > Relaciones > Proveedores y busque el nombre de la entidad.

  3. Elimine los registros duplicados. Se recomienda renombrarlos para que cada nombre de entidad sea único en NetSuite. Esto permite que Alvys identifique la entidad correcta al reintentar la operación.

  4. Vaya a Contabilidad > Transacciones con errores. Seleccione la transacción, haga clic con el botón derecho y haga clic en Reintentar sincronización . Confirme la acción en el mensaje que aparece.

  5. Verifique en NetSuite que la transacción se haya creado y esté vinculada a la entidad correcta.

Combinación no válida de entidad y filial

Mensaje de error: "UnknownError: Error al acceder a un recurso. Combinación no válida de entidad y subsidiaria."

Causa: El cliente o proveedor vinculado a la transacción no está asignado a la filial que se está utilizando. NetSuite requiere que cada registro de entidad esté asignado explícitamente a la filial a la que se hace referencia en la transacción.

Error desconocido: Error al acceder a un recurso. Combinación no válida de entidad y filial.

UnknownError: combinación no válida de entidad y subsidiaria

UnknownError: combinación no válida de entidad y subsidiaria

En el caso de las facturas, la entidad es un proveedor. En el caso de las facturas, la entidad es un cliente.

  1. Para determinar el tipo de entidad, identifique el tipo de transacción: las facturas utilizan un cliente; las facturas utilizan un proveedor.

  2. En NetSuite, abra el registro de la entidad y verifique el campo Subsidiaria:

    • Para clientes: vaya a Listas > Relaciones > Clientes y abra el registro del cliente.

    • Para los proveedores: vaya a Listas > Relaciones > Proveedores y abra el registro del proveedor.

  3. Corrija la asignación de la filial en NetSuite. Edite el registro de la entidad y agregue o asigne la filial correcta. Guarde el registro. Si su cuenta de NetSuite utiliza entidades con varias filiales, verifique que la opción Clientes con varias filiales o Proveedores con varias filiales esté habilitada en Configuración > Empresa > Habilitar funciones > OneWorld.

  4. Vaya a Contabilidad > Transacciones con errores. Seleccione la transacción, haga clic con el botón derecho y haga clic en Reintentar sincronización . Confirme la acción en el mensaje que aparece.

  5. Verifique en NetSuite que la transacción se haya creado y esté vinculada a la entidad y subsidiaria correctas.

Error al exportar una transacción actualizada con valor cero.

Mensaje de error: "UnknownError: Error desconocido. Se produjo un error inesperado. ID de error: [Sample Id]"

Causa: La transacción tenía originalmente un valor de cero ($0.00) mientras la opción "Ignorar transacciones con valor cero" estaba activada en Alvys. Debido a que la transacción se ignoró en ese momento, NetSuite no tiene registro de ella. Cuando posteriormente se actualizó la transacción a un valor distinto de cero y se intentó exportarla, NetSuite rechazó la exportación debido a conflictos internos de ID o secuencia de edición.

Error desconocido: Se ha producido un error inesperado. ID de error: [ID de muestra]

Error desconocido: error inesperado con un ID de error

Error desconocido: error inesperado con un ID de error

  1. Identifique la transacción afectada. Confirme que originalmente era de $0.00 y que posteriormente se actualizó a un valor distinto de cero.

  2. Este error no se puede resolver manualmente. Póngase en contacto con el soporte técnico de Alvys y proporcione la siguiente información:

    • Número de carga

    • Mensaje de error completo

    • ID de error (que se muestra en el mensaje de error)

Si eso no funcionó

Si una transacción sigue fallando después de seguir los pasos de resolución anteriores, compruebe lo siguiente antes de ponerse en contacto con el servicio de asistencia:

  • Confirme que la corrección se haya guardado en NetSuite antes de volver a intentarlo. En ocasiones, los cambios en NetSuite tardan un instante en propagarse antes de que el siguiente intento tenga éxito.

  • Confirme que la transacción sea de un tipo de entidad compatible (Carga, Viaje, Cheque electrónico o Recibo de nómina). Los tipos no compatibles no se pueden volver a intentar desde la página de Transacciones con error y deben corregirse desde su página de origen.

  • Revise las columnas Mensaje de error y Código de error en la página Transacciones con error. Un mensaje de error diferente después de reintentar la operación indica que el problema original se resolvió, pero surgió uno nuevo.

Si el error persiste y ninguna de las causas anteriores se aplica, comuníquese con el soporte de Alvys. Proporcione el mensaje de error, el código de error, el ID de transacción y el número de carga (si corresponde) para que el equipo pueda investigar.

Relacionado

Preguntas frecuentes

P: ¿Para qué se utiliza la página de Transacciones con Error?

A: Se trata de una vista centralizada de las transacciones que no se sincronizaron correctamente entre Alvys y NetSuite u otro sistema contable conectado. Permite a los usuarios revisar los mensajes de error, identificar la causa de cada fallo, corregir el problema subyacente y volver a intentar las transacciones que cumplan los requisitos.

P: ¿Dónde puedo acceder a la página de Transacciones con Error?

A: Navegue a Contabilidad > Transacciones con errores.

P: ¿Cómo puedo borrar manualmente un error de una transacción que ya ha sido corregida en NetSuite?

A: Seleccione la transacción en la página Transacciones con errores, haga clic con el botón derecho, elija Marcar como sincronizada y confirme. Utilice esta opción únicamente si el problema se ha resuelto por completo. Esta acción no se puede deshacer.

P: ¿Se pueden volver a sincronizar todas las transacciones fallidas desde la página de Transacciones con errores?

R: No. Solo los tipos de entidad Carga, Viaje, Cheque electrónico y Recibo de pago se pueden sincronizar directamente desde esta página. Los demás tipos de entidad deben corregirse y sincronizarse desde sus páginas de origen correspondientes.

P: ¿Por qué no veo la opción Reintentar sincronización para un registro?

A: La opción Reintentar sincronización solo está disponible para los tipos de entidad compatibles. Si la transacción es una Deducción, Combustible, Peaje, Depósito en garantía, Factura resumida (Factura contable), Estado de cuenta del transportista, Ingresos accesorios o Estado de cuenta del conductor, debe volver a sincronizarse desde la página donde se origina ese registro.

P: ¿Qué debo hacer si corregí manualmente la transacción en NetSuite?

A: Seleccione la transacción en la página Transacciones con errores, haga clic con el botón derecho y elija Marcar como sincronizada . Esto elimina la transacción de la lista de errores y la marca como resuelta. Esta acción no se puede deshacer.

P: ¿Qué causa un error de registro duplicado?

A: Ya existe una transacción en NetSuite con el mismo número de transacción o ID externo. NetSuite impide la creación de registros duplicados.

P: ¿Cómo puedo solucionar un error de cliente no encontrado?

A: Verifique que el cliente exista y esté activo en NetSuite y que el ID de cliente de NetSuite correcto esté ingresado en el campo ID de contabilidad externa del perfil del cliente o agente en Alvys. Después de corregir, vuelva a intentar la sincronización desde la página Transacciones con errores.

P: ¿Qué significa el error "Se encontraron varios elementos"?

A: NetSuite encontró más de un cliente o proveedor con el mismo nombre y no pudo determinar a cuál asociar la transacción. Cambie el nombre de los registros duplicados en NetSuite para que cada nombre de entidad sea único y vuelva a intentarlo.

P: ¿Por qué veo el mensaje "Combinación no válida de entidad y subsidiaria"?

A: El cliente o proveedor asignado a la transacción no está vinculado a la filial utilizada en dicha transacción en NetSuite. El registro de la entidad debe asignarse explícitamente a la filial correcta en NetSuite para que la exportación se realice correctamente.

P: ¿Se pueden corregir los errores relacionados con las filiales en Alvys?

R: No. Las asignaciones de subsidiarias deben corregirse en NetSuite actualizando el registro del cliente o proveedor para incluir la subsidiaria correcta.

P: ¿Qué causa el error UnknownError en las transacciones actualizadas con valor cero?

A: La transacción original era de $0.00 cuando la opción "Ignorar transacciones con valor cero" estaba activada, y posteriormente se actualizó a un valor distinto de cero. NetSuite rechaza la exportación debido a conflictos internos de ID o secuencia de edición, ya que no se creó ningún registro para la transacción cuando se procesó por primera vez.

P: ¿Puedo corregir yo mismo los errores de transacciones con valor cero?

R: No. Comuníquese con el soporte de Alvys y proporcione el número de carga, el mensaje de error completo y el ID de error que aparece en el mensaje de error.

P: ¿Cuándo debo ponerme en contacto con el servicio de asistencia de Alvys?

A: Póngase en contacto con el soporte técnico de Alvys si una transacción sigue fallando después de haber aplicado los pasos de resolución pertinentes, si el mensaje de error no es claro y no coincide con ninguno de los escenarios anteriores, o si encuentra un error desconocido que no se puede resolver mediante la solución de problemas estándar.

¿Ha quedado contestada tu pregunta?