> ## Documentation Index
> Fetch the complete documentation index at: https://help.fieldpulse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de errores de sincronización de QuickBooks Desktop

> Referencia completa de los mensajes de error de sincronización de QuickBooks Desktop en FieldPulse y la solución exacta de cada uno: clientes, facturas, pagos, artículos y cuentas.

> **Quién lo usa:** un administrador que resuelve los registros que no se sincronizaron; la sincronización se ejecuta por sí sola. **Disponibilidad:** requiere QuickBooks Desktop y el conector de sincronización.

Cuando un registro no se sincroniza con [QuickBooks Desktop](/es/integrations/accounting/quickbooks-desktop/overview) (un [cliente](https://www.fieldpulse.com/features/customer-management), una factura, un [pago](https://www.fieldpulse.com/features/fieldpulse-payments) o un artículo), puede usar la herramienta de solución de problemas de la aplicación para ver el error exacto y corregirlo. Seleccione el botón **Failed Sync** (sincronización fallida) junto al registro para abrir una página con todos los errores de sincronización de ese registro. Esta página es la referencia completa de errores: busque su mensaje de error a continuación y siga la acción correspondiente.

<img src="https://mintcdn.com/fieldpulse/Z-aHosBQ4T7YM-2R/static/images/integrations/quickbooks-desktop/sync-errors/image1.png?fit=max&auto=format&n=Z-aHosBQ4T7YM-2R&q=85&s=fd66dae0fa527146746364f174377b05" alt="El botón Failed Sync abre el cuadro de diálogo QuickBooks Sync Failed con el error y su solución" width="1650" height="1332" data-path="static/images/integrations/quickbooks-desktop/sync-errors/image1.png" />

## Descripción general

Cada registro de FieldPulse que no se sincronizó tiene un botón **Failed Sync** que abre una página dedicada con todos los errores de sincronización de ese registro. La mayoría de los errores se deben a un campo demasiado largo, un carácter especial que QuickBooks rechaza, un nombre duplicado, un periodo contable cerrado o un registro relacionado que todavía no se ha sincronizado. Corrija la causa que indica el error y el registro se volverá a sincronizar. Para ver qué registros fallaron y cuándo se ejecutó la sincronización por última vez, use la página **Statistic** (estadísticas) que se explica en [Cómo administrar QuickBooks Desktop después de sincronizar](/es/integrations/accounting/quickbooks-desktop/post-sync).

## Problemas comunes

### Límites de longitud de los campos

QuickBooks Desktop impone una longitud máxima en muchos campos. Acorte el campo en FieldPulse hasta el límite indicado y vuelva a sincronizar.

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Name length (#) more than allowed (31)" / "The string # in the field 'Name' is too long." | Acorte el nombre a 31 caracteres o menos. |
| "FirstName length (#) more than allowed (25)" / "The string # in the field 'FirstName' is too long." | Acorte el nombre de pila a 25 caracteres o menos. |
| "LastName length (#) more than allowed (25)" | Acorte el apellido a 25 caracteres o menos. |
| "Phone length (#) more than allowed (21)" / "The string # in the field 'Phone' is too long." | Acorte el número de teléfono a 21 caracteres o menos. |
| "AltPhone length (#) more than allowed (21)" | Acorte el número de teléfono alterno a 21 caracteres o menos. |
| "Email length (#) more than allowed (1023)" | Acorte la dirección de correo a 1023 caracteres o menos. |
| "Desc length (#) more than allowed (4095)" | Acorte la descripción a 4095 caracteres o menos. |
| "Memo length (#) more than allowed (4095)" | Acorte el memo a 4095 caracteres o menos. |
| "Notes length (#) more than allowed (4095)" | Acorte las notas a 4095 caracteres o menos. |
| "BillAddress\_Addr1 length (#) more than allowed (41)" | Acorte la línea 1 de la dirección de facturación a 41 caracteres o menos. |
| "BillAddress\_Addr2 length (#) more than allowed (41)" | Acorte la línea 2 de la dirección de facturación a 41 caracteres o menos. |
| "BillAddress\_PostalCode length (#) more than allowed (13)" | Acorte el código postal de la dirección de facturación a 13 caracteres o menos. |
| "BillAddress\_State length (#) more than allowed (21)" | Acorte el estado de la dirección de facturación a 21 caracteres o menos. |
| "ShipAddress\_Addr1 length (#) more than allowed (41)" | Acorte la línea 1 de la dirección de envío a 41 caracteres o menos. |
| "ShipAddress\_Addr2 length (#) more than allowed (41)" | Acorte la línea 2 de la dirección de envío a 41 caracteres o menos. |
| "ShipAddress\_PostalCode length (#) more than allowed (13)" | Acorte el código postal de la dirección de envío a 13 caracteres o menos. |
| "ShipAddress\_State length (#) more than allowed (21)" | Acorte el estado de la dirección de envío a 21 caracteres o menos. |

### Caracteres especiales o no ASCII

QuickBooks Desktop rechaza los caracteres especiales y no ASCII en los nombres. Elimínelos y vuelva a sincronizar.

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Name value has non-ASCII characters" | Elimine los caracteres especiales del campo de nombre. |
| "FirstName value has non-ASCII characters" | Elimine los caracteres especiales del nombre de pila. |
| "LastName value has non-ASCII characters" | Elimine los caracteres especiales del apellido. |
| "CompanyName value has non-ASCII characters" | Elimine los caracteres especiales del nombre de la empresa. |

### Nombres y registros duplicados

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Duplicate Name Exists Error - The name supplied already exists. : Another customer, vendor or employee is already using this name." | Use un nombre único que no esté en uso en QuickBooks. |
| "Duplicate Name Exists Error", "The name supplied already exists. : null" | Use un nombre único que no esté en uso en QuickBooks. |
| "The name # of the list element is already in use." | Elija otro nombre; ya existe un registro con este nombre. |
| "There is a duplicated records in FieldPulse database!", "Matched records ids: #, #, # ..." | Corrija los duplicados en FieldPulse antes de sincronizar. |
| "There is already synced record present in FieldPulse database related to another instance on QuickBooks Desktop side", "Record id: # (name = #)" | Corrija los duplicados en FieldPulse antes de sincronizar. |
| "There was an error when modifying a Customers list, element '\[QuickBooks Desktop ID]'. QuickBooks error message: Cannot merge list elements." | Verifique que ningún otro cliente tenga el mismo nombre y que todos los campos se hayan llenado correctamente; luego vuelva a actualizar. |

### Periodo contable cerrado

La fecha del registro cae en un periodo que su contabilidad ya cerró. Cambie la fecha a una posterior a la fecha de cierre o pida a un administrador de QuickBooks que ajuste la configuración del periodo de cierre.

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "An attempt was made to modify a Estimate with a date that is on or before the closing date of the company..." | Cambie la fecha del presupuesto a una posterior a su fecha de cierre o pida a su administrador que ajuste la configuración en QuickBooks. |
| "An attempt was made to modify a Invoice with a date that is on or before the closing date of the company..." | Cambie la fecha de la factura a una posterior a su fecha de cierre o pida a su administrador que ajuste la configuración en QuickBooks. |
| "An attempt was made to modify a ReceivePayment with a date that is on or before the closing date of the company..." | Cambie la fecha del pago a una posterior a su fecha de cierre o pida a su administrador que ajuste la configuración en QuickBooks. |
| "There was an error when modifying a Estimate. QuickBooks error message: You may not create or edit a transaction dated on or before the dividing date." | Actualice la fecha del presupuesto o la configuración del periodo de cierre en QuickBooks. |
| "There was an error when modifying a Invoice. QuickBooks error message: You may not create or edit a transaction dated on or before the dividing date." | Actualice la fecha de la factura o la configuración del periodo de cierre en QuickBooks. |
| "There was an error when saving a Invoice. QuickBooks error message: You may not create or edit a transaction dated on or before the dividing date." | Actualice la fecha de la factura o la configuración del periodo de cierre en QuickBooks. |
| "Account Period Closed, Cannot Update Through Services API..." | Su contabilidad está cerrada para este periodo, por lo que no se pueden hacer cambios desde FieldPulse. Inicie sesión directamente en QuickBooks para actualizar este registro. |

### Campos obligatorios faltantes o vacíos

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "CustomerRef required but missed!" | Vincule este registro con un cliente antes de guardar. |
| "InvoiceLine required but missed!" | Agregue al menos una partida a la factura. |
| "SalesOrPurchase required but missed!" | Agregue la referencia de cuenta que falta para continuar. |
| "SOPAccount # sync failed!" | Agregue la referencia de cuenta que falta para continuar. |
| "Required param missing... Required parameter ExpenseAccountRef or IncomeAccountRef is missing in the request" | Agregue la referencia de cuenta que falta para continuar. |
| "There was an error when saving a Estimate. QuickBooks error message: The transaction is empty." | Agregue partidas al presupuesto antes de guardar. |
| "There was an error when saving a Invoice. QuickBooks error message: The transaction is empty." | Agregue partidas a la factura antes de guardar. |
| "There was an error when saving a ReceivePayment. QuickBooks error message: The transaction is empty." | Indique el monto del pago antes de guardar. |

### Códigos de impuesto e impuesto sobre las ventas

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Sales Tax Code # sync failed!" | Corrija el código de impuesto sobre las ventas antes de sincronizar. |
| "Related TaxRate # sync failed!" | Corrija la configuración de la tasa de impuesto antes de sincronizar. |
| "There is no correct Tax Code available to be assigned to this item" | Asigne un código de impuesto válido a este artículo. |
| "There is an invalid reference to QuickBooks Item Sales Tax # in the Invoice. QuickBooks error message: Transaction Sales Tax is currently disabled by preferences." | Active el impuesto sobre las ventas (Sales Tax) en QuickBooks antes de sincronizar. |
| "There was an error when modifying a Invoice. QuickBooks error message: The Transaction Sales Tax field cannot be left blank..." | Asigne un código de impuesto sobre las ventas a esta factura. |
| "There was an error when saving a Estimate. QuickBooks error message: The Transaction Sales Tax field cannot be left blank..." | Asigne un código de impuesto al presupuesto antes de guardar. |
| "There was an error when saving a Invoice. QuickBooks error message: The Transaction Sales Tax field cannot be left blank..." | Asigne un código de impuesto a la factura antes de guardar. |

### Artículos y cuentas

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Account # sync failed!" | Revise lo que ingresó o comuníquese con soporte si el problema continúa. |
| "Income Account # sync failed!" | Resuelva el problema de la cuenta de ingresos antes de sincronizar. |
| "Discount Account # sync failed!" | Corrija la configuración de la cuenta de descuentos antes de sincronizar. |
| "Assigned discount item not present!" | Asegúrese de que el artículo de descuento esté activo en QuickBooks y tenga un valor o % adecuado. |
| "Discount Item # not synced yet!" | Asegúrese de que el artículo de descuento esté sincronizado antes de usarlo. |
| "Related Item # not synced yet" | Asegúrese de que el artículo esté sincronizado antes de usarlo. |
| "Related Class # sync failed!" | Corrija la clase relacionada en QuickBooks antes de sincronizar. |
| "Related Customer # sync failed!" | Corrija la referencia al cliente antes de sincronizar. |
| "Related Invoice RefNumber:# sync failed!" | Corrija la factura vinculada antes de sincronizar. |
| "Related Payment Method # sync failed!" | Corrija el método de pago antes de sincronizar. |
| "Parent Customer # sync failed!" | Resuelva el problema de sincronización del cliente principal antes de volver a intentarlo. |
| "Parent Cannot Be Child... This item cant be a sub-item of itself." | Un artículo no puede ser subartículo de sí mismo. |
| "There is an invalid reference to a parent # in the Customers list." | Corrija la jerarquía de clientes antes de sincronizar. |
| "Invalid Type : Item of type Inventory cannot be changed to Noninventory item type" | No puede convertir un artículo de inventario en un artículo sin inventario. |
| "There is no OtherExpense/CostOfGoodSold account can be assigned to this item" | Asigne a este artículo una cuenta de gastos o de costo de ventas (Cost of Goods Sold) adecuada. |
| "There is OtherExpense account can be assigned to this item" | Asigne una cuenta de gastos válida. |
| "There is an invalid reference to QuickBooks Account # in the Item Non-Inventory..." | Restaure o reemplace el artículo eliminado para continuar. |
| "There was an error when modifying a ItemNonInventory. Cannot use SalesOrPurchaseMod aggregate when the item is reimbursable." | Este artículo es reembolsable y no se puede editar de esta forma. |
| "There was an error when modifying a ItemService. Cannot use SalesOrPurchaseMod aggregate when the item is reimbursable." | Este artículo es reembolsable y no se puede editar de esta forma. |

### Referencias eliminadas, faltantes o desactualizadas

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Invalid Reference Id : Product/Service assigned to this transaction has been deleted. Before you can modify this transaction, you must restore #" | Restaure o reemplace el artículo eliminado para continuar. |
| "Object # specified in the request cannot be found..." | El registro al que se hace referencia no existe en QuickBooks. Comuníquese con soporte si el problema persiste. |
| "The given object ID # in the field # is invalid." | El registro al que se hace referencia no existe en QuickBooks. Comuníquese con soporte si el problema persiste. |
| "The provided edit sequence # is out-of-date." | Recargue la versión más reciente del registro e inténtelo de nuevo. |
| "The 'address' field has an invalid value #. QuickBooks error message: The parameter is incorrect." | Corrija el formato de la dirección o elimine la dirección antes de sincronizar. |

### Permisos, modo y versión

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Insufficient permission level to perform this action." | Su cuenta de usuario de QuickBooks necesita un nivel de acceso más alto para completar esta acción. Consulte los [permisos de Web Connector](/es/integrations/accounting/quickbooks-desktop/pre-sync). |
| "There is an invalid reference to QuickBooks Post Account # in the ItemInventory. QuickBooks error message: To change the posting account, you must switch to single-user mode." | Cambie al modo de usuario único en QuickBooks para hacer este cambio. |
| "This feature is not enabled or not available in this version of QuickBooks." | Cambie a un plan superior de QuickBooks o quite la función no compatible. |
| "Feature Not Supported Error : ... not included in your QuickBooks Desktop Simple Start subscription." | Cambie a un plan superior de QuickBooks o quite la función no compatible. |

### Notas de crédito, eliminaciones y registros pendientes

| **Mensaje de error** | **Qué hacer** |
| - | - |
| "Credit memo saved as payment can not be synced to QuickBooks Desktop" | Las notas de crédito llegan a FieldPulse desde QuickBooks Desktop como pagos, y esos pagos no se pueden sincronizar de vuelta con QuickBooks Desktop. No necesita hacer nada: la nota de crédito ya está en QuickBooks Desktop. |
| "Delete Customer Has Unbilled Expenses Error... This customer cannot be deleted because there are unbilled charges for this customer." | Resuelva todas las transacciones sin facturar antes de eliminar al cliente. |
| "Pending sync from FieldPulse to QuickBooks Desktop" | Este registro está en espera de sincronizarse. No necesita hacer nada, a menos que se quede detenido. |

## ¿Necesita más ayuda?

Comuníquese con el [equipo de soporte de FieldPulse](https://www.fieldpulse.com/company/contact-us) por el chat de la aplicación o en [support@fieldpulse.com](mailto:support@fieldpulse.com).

Para conocer el proceso para encontrar y volver a sincronizar los registros fallidos, consulte [Cómo administrar QuickBooks Desktop después de sincronizar](/es/integrations/accounting/quickbooks-desktop/post-sync). Para saber qué se sincroniza y qué no, consulte [Configurar QuickBooks Desktop antes de sincronizar](/es/integrations/accounting/quickbooks-desktop/pre-sync).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.