> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Transacciones que no se sincronizaron con NetSuite
> Resuelva fallos de exportaci贸n a NetSuite en Alvys: registros duplicados, nombres de cliente o proveedor desconocidos, discrepancias de subsidiaria y conflictos de ID interno en re-sincronizaciones.
馃搵 **Se aplica a:** Usuarios con el permiso **"Billing"**
**M贸dulo:** Accounting > Error Transactions
Cuando una o m谩s transacciones no se exportan de Alvys a NetSuite (tambi茅n denominados fallos de sincronizaci贸n NS, errores de exportaci贸n contable o sincronizaci贸n fallida), aparecen en la p谩gina Error Transactions. Este art铆culo explica c贸mo identificar la causa de cada fallo y resolverlo para que la transacci贸n se sincronice correctamente.
## S铆ntoma
Una o m谩s transacciones no se sincronizaron de Alvys a NetSuite. Las transacciones fallidas aparecen en la p谩gina Error Transactions (Accounting > Error Transactions) con un mensaje de error que describe por qu茅 fall贸 la exportaci贸n. Las transacciones afectadas no se registran en NetSuite hasta que se resuelva el error y la transacci贸n se vuelva a sincronizar 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 cliente o proveedor no reconocidos, varias entidades coincidentes, asignaciones de subsidiaria no coincidentes y conflictos de ID interno en transacciones previamente con valor cero. Cada fallo se registra con un mensaje de error y un c贸digo de error espec铆ficos para ayudar a identificar la causa ra铆z.
## Resoluci贸n
### Resumen de la p谩gina Error Transactions
La p谩gina Error Transactions (Accounting > Error Transactions) es una lista centralizada de todas las transacciones que no se exportaron de Alvys a NetSuite u otro sistema contable conectado.
*La p谩gina Error Transactions (Accounting > Error Transactions)*
### La p谩gina Error Transactions incluye las siguientes columnas:
* **Entity Type:** El tipo de transacci贸n de Alvys que no se export贸, mostrando de d贸nde se origin贸 la transacci贸n. Los ejemplos incluyen Load, Trip, Paystub, Deduction, Accessorial Revenue, Toll, Fuel, Escrow, E-check y Accounting Invoice.
* **Transaction Type:** C贸mo se clasifica el registro en el sistema contable externo, como Invoice, Bill, Credit Memo, Vendor Credit o Journal Entry.
* **Class:** La subsidiaria asociada a la transacci贸n.
* **Error Message**: El mensaje devuelto por el sistema contable externo que explica por qu茅 fall贸 la transacci贸n.
* \*\*Status: \*\*El estado actual de la transacci贸n, como Failed o Resolved.
* **Reference**: Identificadores adicionales para vincular la transacci贸n, como n煤mero de carga, n煤mero de factura resumen o n煤mero de viaje.
* **Transaction Total**: El importe total de la transacci贸n.
* **Date Created**: La fecha en que se intent贸 exportar la transacci贸n por primera vez.
### Tipos de transacci贸n admitidos que se pueden volver a sincronizar desde Error Transactions
No todas las transacciones se pueden volver a sincronizar autom谩ticamente desde esta p谩gina. Actualmente, solo los siguientes tipos de entidad se pueden volver a sincronizar:
* **Load**
* **Trip**
* **E-check**
* **Paystub**
Antes de volver a sincronizar, aseg煤rese de haber realizado las correcciones necesarias en la transacci贸n. Para volver a sincronizar:
1. Seleccione una o m谩s transacciones en la p谩gina Error Transactions.
2. Haga clic con el bot贸n derecho para mostrar las opciones del men煤 contextual **"Sync Transaction"** o **"Sync All Transactions."**
3. Haga clic en **Sync Transaction** y confirme la acci贸n en el aviso.
*Men煤 contextual con la opci贸n Sync Transaction*
Use **Sync All Transactions** solo si todas las transacciones de la lista Error Transactions est谩n listas para exportar. Las transacciones que a煤n requieran correcciones se omitir谩n.
### Los siguientes tipos de entidad no se pueden volver a sincronizar desde la p谩gina Error Transactions:
* Deduction
* Accessorial Revenue
* Fuel
* Toll
* Accounting Invoice (equivalente a una factura resumen)
* Escrow
* Carrier Statement
* Driver Statement
Para **liquidaciones de transportistas, facturas resumen y pago de conductores**, las correcciones y re-sincronizaciones deben realizarse directamente desde sus p谩ginas respectivas en lugar de desde la p谩gina general Error Transactions.
### Borrar una transacci贸n con error corregida manualmente en el sistema externo
Si una transacci贸n se ha corregido manualmente en el sistema contable externo y ya no requiere acci贸n en Alvys, puede borrarla de la p谩gina Error Transactions:
1. Seleccione una o m谩s transacciones en la p谩gina Error Transactions.
2. Haga clic con el bot贸n derecho para mostrar la opci贸n del men煤 contextual **"Mark as Synced."**
3. Haga clic en **Mark as Synced** y confirme la acci贸n en el aviso.
*Men煤 contextual con la opci贸n Mark as Synced*
Marque una transacci贸n como sincronizada solo si el problema est谩 completamente resuelto. Esta acci贸n no se puede deshacer.
### Error Duplicate Record en la exportaci贸n
**Mensaje de error:** "DuplicateRecord: An attempt to create a duplicate record has been detected. The external id of the transaction matches an already existing transaction."
**Causa:** Ya existe un registro (factura o factura de proveedor) en NetSuite con el mismo n煤mero de transacci贸n o External ID. NetSuite impide la creaci贸n de registros duplicados.
DuplicateRecord: An attempt to create a duplicate record has been detected. The external id of the transaction matches an already existing transaction.
*Error DuplicateRecord en la columna Error Message*
1. Busque el duplicado en NetSuite usando Global Search o la lista de transacciones. Busque por n煤mero de transacci贸n, External ID o el nombre del proveedor o cliente asociado a la transacci贸n.
2. Resuelva el conflicto usando uno de los siguientes enfoques:
* Si el registro existente de NetSuite es v谩lido y correcto: la transacci贸n ya se ha registrado. Vaya a la p谩gina Error Transactions en Alvys, seleccione la transacci贸n, haga clic con el bot贸n derecho y elija **Mark as synced** para borrarla de la lista de errores.
* Si el registro existente de NetSuite es incorrecto o se cre贸 como prueba: elim铆nelo en NetSuite y contin煤e con el siguiente paso.
3. Vaya a Accounting > Error Transactions en Alvys. Seleccione la transacci贸n, haga clic con el bot贸n derecho y haga clic en **Retry sync**. Confirme la acci贸n en el aviso.
4. Verifique en NetSuite que la transacci贸n se cre贸 correctamente y est谩 vinculada al cliente, proveedor y subsidiaria correctos.
Si el error persiste despu茅s de completar estos pasos, contin煤e con **Si eso no funcion贸** a continuaci贸n.
### Cliente no encontrado en NetSuite
**Mensaje de error:** "CustomerNotFound: Customer not found for name '\[Customer Name]' and id '\[Customer ID]'"
**Causa:** Alvys no puede localizar el cliente en NetSuite usando el ID de cliente de NetSuite. Este error se activa cuando el ajuste "Use Existing Customers" est谩 habilitado y el campo External Accounting ID en Alvys falta, 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 subsidiaria 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 broker. Introduzca el ID de cliente de NetSuite correcto en el campo External Accounting ID para la subsidiaria correspondiente. Guarde el registro.
3. Vaya a Accounting > Error Transactions. Seleccione la transacci贸n, haga clic con el bot贸n derecho y haga clic en **Retry sync**. Confirme la acci贸n en el aviso.
4. Verifique en NetSuite que la factura se cre贸 y est谩 vinculada al cliente y subsidiaria correctos.
### Varias entidades encontradas con el mismo nombre
**Mensaje de error:** "MultipleItems: Multiple items found. Multiple vendors found for name '\[Entity Name]'"
**Causa:** Alvys encontr贸 m谩s de un registro en NetSuite con el mismo nombre y no puede determinar a cu谩l adjuntar la transacci贸n. Para facturas de proveedor, la entidad es un proveedor. Para facturas, la entidad es un cliente.
1. Determine el tipo de transacci贸n: las facturas usan un cliente como entidad; las facturas de proveedor usan un proveedor.
2. Localice los registros de entidad duplicados en NetSuite:
* Para clientes: vaya a Lists > Relationships > Customers y busque el nombre de la entidad.
* Para proveedores: vaya a Lists > Relationships > Vendors y busque el nombre de la entidad.
3. Resuelva los duplicados. El enfoque recomendado es renombrar los registros duplicados para que cada nombre de entidad sea 煤nico en NetSuite. Esto permite que Alvys identifique la entidad correcta al reintentar.
4. Vaya a Accounting > Error Transactions. Seleccione la transacci贸n, haga clic con el bot贸n derecho y haga clic en **Retry sync**. Confirme la acci贸n en el aviso.
5. Verifique en NetSuite que la transacci贸n se cre贸 y est谩 vinculada a la entidad correcta.
### Combinaci贸n no v谩lida de entidad y subsidiaria
**Mensaje de error:** "UnknownError: Error while accessing a resource. Invalid combination of entity and subsidiary."
**Causa:** El cliente o proveedor vinculado a la transacci贸n no est谩 asignado a la subsidiaria que se est谩 usando. NetSuite requiere que cada registro de entidad est茅 expl铆citamente asignado a la subsidiaria referenciada en la transacci贸n.
UnknownError: Error while accessing a resource. Invalid combination of entity and subsidiary.
*UnknownError: combinaci贸n no v谩lida de entidad y subsidiaria*
Para facturas de proveedor, la entidad es un proveedor. Para facturas, la entidad es un cliente.
1. Identifique el tipo de transacci贸n para determinar el tipo de entidad: las facturas usan un cliente; las facturas de proveedor usan un proveedor.
2. En NetSuite, abra el registro de la entidad y compruebe el campo Subsidiary:
* Para clientes: vaya a Lists > Relationships > Customers y abra el registro del cliente.
* Para proveedores: vaya a Lists > Relationships > Vendors y abra el registro del proveedor.
3. Corrija la asignaci贸n de subsidiaria en NetSuite. Edite el registro de la entidad y a帽ada o asigne la subsidiaria correcta. Guarde el registro. Si su cuenta de NetSuite usa entidades multi-subsidiaria, verifique que Multi-Subsidiary Customers o Multi-Subsidiary Vendors est茅 habilitado en Setup > Company > Enable Features > OneWorld.
4. Vaya a Accounting > Error Transactions. Seleccione la transacci贸n, haga clic con el bot贸n derecho y haga clic en **Retry sync**. Confirme la acci贸n en el aviso.
5. Verifique en NetSuite que la transacci贸n se cre贸 y est谩 vinculada a la entidad y subsidiaria correctas.
### Exportaci贸n fallida de una transacci贸n con valor cero actualizada
**Mensaje de error:** "UnknownError: Unknown error. An unexpected error occurred. Error ID: \[Sample Id]"
**Causa:** La transacci贸n ten铆a originalmente valor cero (\$0.00) mientras el ajuste "Ignore Zero Valued Transactions" estaba habilitado en Alvys. Como la transacci贸n se ignor贸 en ese momento, NetSuite no tiene registro de ella. Cuando la transacci贸n se actualiz贸 posteriormente a un valor distinto de cero y se intent贸 exportar, NetSuite rechaz贸 la exportaci贸n debido a conflictos de ID interno o secuencia de edici贸n.
UnknownError: Unknown error. An unexpected error occurred. Error ID: \[Sample Id]
*UnknownError: error inesperado con un Error ID*
1. Identifique la transacci贸n afectada. Confirme que ten铆a originalmente \$0.00 y desde entonces se ha actualizado a un valor distinto de cero.
2. Este error no se puede resolver manualmente. Contacte con el soporte de Alvys y proporcione lo siguiente:
* Load Number
* Mensaje de error completo
* Error ID (mostrado 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 contactar con soporte:
* Confirme que la correcci贸n se guard贸 en NetSuite antes de reintentar. Los cambios en NetSuite a veces requieren un momento para propagarse antes de que un reintento tenga 茅xito.
* Confirme que la transacci贸n es un tipo de entidad admitido (Load, Trip, E-check o Paystub). Los tipos no admitidos no se pueden reintentar desde la p谩gina Error Transactions y deben corregirse desde su p谩gina de origen.
* Revise las columnas Error Message y Error Code en la p谩gina Error Transactions. Un mensaje de error cambiado despu茅s del reintento indica que el problema original se resolvi贸 pero se introdujo un nuevo problema.
Si el error persiste y ninguna de las causas anteriores se aplica, contacte con el soporte de Alvys. Proporcione el Error Message, Error Code, Transaction Id y Load Number (si corresponde) de la transacci贸n para que el equipo pueda investigar.
## Relacionado
* NetSuite Integration Collection: [https://help.alvys.com/en/articles/13689009-netsuite-integration-collection](/es/help/integrations/netsuite-integration-collection)
## Preguntas frecuentes
**P: 驴Para qu茅 se usa la p谩gina Error Transactions?**
**R:** Es una vista centralizada de las transacciones que no se sincronizaron de Alvys a NetSuite u otro sistema contable conectado. Permite a los usuarios revisar mensajes de error, identificar la causa de cada fallo, corregir el problema subyacente y reintentar las transacciones elegibles.
**P: 驴D贸nde puedo acceder a la p谩gina Error Transactions?**
**R:** Vaya a Accounting > Error Transactions.
**P: 驴C贸mo borro manualmente un error de una transacci贸n que ya se corrigi贸 en NetSuite?**
**R:** Seleccione la transacci贸n en la p谩gina Error Transactions, haga clic con el bot贸n derecho, elija **Mark as synced** y confirme. Use esta opci贸n solo si el problema est谩 completamente resuelto. Esta acci贸n no se puede deshacer.
**P: 驴Se pueden volver a sincronizar todas las transacciones fallidas desde la p谩gina Error Transactions?**
**R:** No. Solo los tipos de entidad Load, Trip, E-check y Paystub se pueden volver a sincronizar directamente desde esta p谩gina. Otros tipos de entidad deben corregirse y volver a sincronizarse desde sus p谩ginas de origen respectivas.
**P: 驴Por qu茅 no veo la opci贸n Retry sync para un registro?**
**R:** La opci贸n Retry sync solo est谩 disponible para tipos de entidad admitidos. Si la transacci贸n es Deduction, Fuel, Toll, Escrow, Summary Invoice (Accounting Invoice), Carrier Statement, Accessorial Revenue o Driver Statement, 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?**
**R:** Seleccione la transacci贸n en la p谩gina Error Transactions, haga clic con el bot贸n derecho y elija **Mark as synced**. 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 Duplicate Record?**
**R:** Ya existe una transacci贸n en NetSuite con el mismo n煤mero de transacci贸n o External ID. NetSuite impide la creaci贸n de registros duplicados.
**P: 驴C贸mo resuelvo un error Customer Not Found?**
**R:** Verifique que el cliente exista y est茅 activo en NetSuite y que el ID de cliente de NetSuite correcto est茅 introducido en el campo External Accounting ID del perfil del cliente o broker en Alvys. Despu茅s de corregir, vuelva a sincronizar desde la p谩gina Error Transactions.
**P: 驴Qu茅 significa el error Multiple Items Found?**
**R:** NetSuite encontr贸 m谩s de un cliente o proveedor con el mismo nombre y no pudo determinar a cu谩l adjuntar la transacci贸n. Renombre los registros duplicados en NetSuite para que cada nombre de entidad sea 煤nico y luego reintente.
**P: 驴Por qu茅 veo "Invalid combination of entity and subsidiary"?**
**R:** El cliente o proveedor asignado a la transacci贸n no est谩 vinculado a la subsidiaria usada en esa transacci贸n en NetSuite. El registro de la entidad debe asignarse expl铆citamente a la subsidiaria correcta en NetSuite antes de que la exportaci贸n tenga 茅xito.
**P: 驴Se pueden corregir en Alvys los errores relacionados con subsidiarias?**
**R:** No. Las asignaciones de subsidiaria deben corregirse en NetSuite actualizando el registro del cliente o proveedor para incluir la subsidiaria correcta.
**P: 驴Qu茅 causa el UnknownError para transacciones con valor cero actualizadas?**
**R:** La transacci贸n ten铆a originalmente \$0.00 mientras el ajuste "Ignore Zero Valued Transactions" estaba habilitado, y luego se actualiz贸 a un valor distinto de cero. NetSuite rechaza la exportaci贸n debido a conflictos de ID interno o secuencia de edici贸n porque 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. Contacte con el soporte de Alvys y proporcione el Load Number, el mensaje de error completo y el Error ID mostrado en el mensaje de error.
**P: 驴Cu谩ndo debo contactar con el soporte de Alvys?**
**R:** Contacte con el soporte de Alvys si una transacci贸n sigue fallando despu茅s de aplicar los pasos de resoluci贸n relevantes, si el mensaje de error no es claro y no coincide con ninguno de los escenarios anteriores, o si encuentra un UnknownError que no se puede resolver mediante la soluci贸n de problemas est谩ndar.