> ## 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 Online

> Encuentre su error de sincronización de QuickBooks Online y su solución: clientes, partidas, facturas, pagos, impuestos, cuentas y errores de conexión.

Cuando un registro no se sincroniza con [QuickBooks Online](https://www.fieldpulse.com/company/partners/quickbooks), FieldPulse le indica qué registro falló y por qué, para que pueda corregirlo y volver a sincronizarlo. Para cualquier registro que falle (clientes, facturas, pagos y más), use la herramienta de solución de problemas de la aplicación: 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.

## Descripción general

Los errores de sincronización ocurren cuando un registro no cumple una regla de [Descripción general de QuickBooks Online](/es/integrations/accounting/quickbooks-online/overview): un nombre duplicado, una cuenta faltante, un periodo contable cerrado o un artículo configurado con el tipo incorrecto. La mayoría se resuelve corrigiendo el registro en FieldPulse o en QuickBooks Online y volviendo a sincronizar. Esta página enumera los errores comunes según el registro al que afectan, con la causa y la solución de cada uno. Para ver qué registros requieren atención en este momento, use la página **QuickBooks Online Statistic** (estadísticas de QuickBooks Online); consulte [Cómo administrar QuickBooks Online después de sincronizar](/es/integrations/accounting/quickbooks-online/post-sync).

<img src="https://mintcdn.com/fieldpulse/CEfyoXWCPRJAXfyB/static/images/integrations/quickbooks-online/sync-errors/image1.png?fit=max&auto=format&n=CEfyoXWCPRJAXfyB&q=85&s=42912ab29e7ba36975e1780bfc705c9b" alt="El botón Failed Sync y el cuadro de diálogo QuickBooks Sync Failed con un error de correo no válido" width="1650" height="1332" data-path="static/images/integrations/quickbooks-online/sync-errors/image1.png" />

## Por qué no se sincronizan los registros

Antes de buscar un mensaje específico, revise los motivos más comunes por los que cada tipo de registro no se sincroniza:

* **Un cliente** puede no sincronizarse porque falta su correo o tiene un formato incorrecto; su nombre ya lo usa otro proveedor; el correo o el teléfono superan los 31 caracteres, o las notas superan los 4,000 caracteres; su nombre incluye dos puntos ( : ); es subcliente de un cliente principal que no está sincronizado; o está archivado en QuickBooks Online.

* **Una partida** puede no sincronizarse porque: falta un campo o tiene un formato incorrecto; el nombre supera los 100 caracteres o el SKU supera los 30; el nombre es igual al de otro artículo; no está marcada como producto o servicio en QuickBooks Online; su cuenta de ventas o de compras no está activa en QuickBooks Online; o es un artículo de tipo "Product - Inventory" (producto con inventario), pero su plan de QuickBooks Online no admite inventario.

* **Una factura** puede no sincronizarse porque: el cliente no está sincronizado; una partida no está sincronizada; las notas internas superan los 4,000 caracteres; o corresponde a un periodo contable cerrado en QuickBooks Online.

* **Un pago** puede no sincronizarse porque: la factura ya tiene sincronizado un pago archivado; o la factura relacionada no está sincronizada.

## Problemas comunes

### Errores de clientes

| **Mensaje de error** | **Causa** | **Solución** |
| - | - | - |
| "This name is being used by another vendor. Please use a different name." | Los clientes y los proveedores deben tener nombres para mostrar únicos. | Asigne al cliente un nombre para mostrar diferente. |
| "Duplicate Name Exists Error... Another entity is already using this name." | Dos clientes o proveedores tienen el mismo nombre para mostrar. | Elija otro nombre o agregue una abreviatura al final. |
| "Invalid Customer... The customer you have specified has been deleted." | El cliente está archivado en QuickBooks Online. | Reactive al cliente, deje que se vuelva a sincronizar y luego sincronice los registros relacionados. |
| "Invalid Email Address format..." | El correo del registro del cliente no es válido. | Corrija el correo para que tenga un formato válido, por ejemplo, [name@example.com](mailto:name@example.com). |
| "Please make the parent customer active first. Then you can make this sub-customer active." | El cliente principal está archivado. | Primero active al cliente principal y luego al cliente relacionado. |
| "Related Parent Customer # sync failed!" | El cliente principal no se ha sincronizado. | Abra el cliente principal y seleccione primero **Sync with QuickBooks** (sincronizar con QuickBooks). |
| "This customer cannot be deleted because it has one or more projects." | El cliente tiene un proyecto activo (cliente relacionado) en QuickBooks Online. | No puede archivar un cliente que tenga un proyecto activo o un cliente relacionado. |
| El cliente está archivado en QuickBooks Online (sin texto de error: el registro simplemente deja de sincronizarse) | El registro del cliente se marcó como inactivo en QuickBooks Online. | Reactive al cliente en QuickBooks Online y deje que se vuelva a sincronizar. |
| "Cannot Change Who Customer Bills With Error..." | No puede desvincular una relación entre cliente principal y subcliente mientras haya pagos del cliente principal aplicados a facturas del cliente relacionado. | Primero elimine esos pagos o facturas en QuickBooks Online. |
| "Cannot Delete Object... You can't make this customer inactive because it has sub customers." | El cliente tiene clientes relacionados activos. | Primero archive los subclientes. |
| "Delete Customer Has Unbilled Expenses Error..." | El cliente tiene cargos sin facturar. | Elimine o cierre los cargos sin facturar en QuickBooks Online antes de archivar al cliente. |
| "Delete List Has Balance Error... This customer can't be deleted because it has a non-zero balance." | El cliente tiene facturas abiertas. | Elimine o cierre las facturas abiertas en QuickBooks Online antes de archivar al cliente. |
| "You must enter the email address for this customer in order to email statements." | El registro del cliente no tiene dirección de correo. | Agregue una dirección de correo al registro del cliente. |
| "No name provided" (Title/GivenName/MiddleName/FamilyName/DisplayName/Suffix no pueden estar vacíos) | No hay ningún campo de nombre lleno. | Llene al menos uno de los campos de nombre obligatorios. |
| "Parent Cannot Be Child... This item can't be a sub-item of itself." | Un cliente está vinculado a sí mismo como su propio cliente principal. | Vincule el cliente a otro cliente, no a sí mismo. |
| "Invalid Reference Id: Customer assigned to this transaction has been deleted..." | El cliente de la transacción está archivado. | Reactive al cliente en QuickBooks Online y vuelva a sincronizarlo antes de sincronizar los registros relacionados. |
| "A project must be a sub-customer billed to its parent." | El proyecto (cliente relacionado) no está vinculado a un cliente principal. | Edite el proyecto y vincúlelo a su cliente principal. |
| "A project cannot contain sub-customers." | Un cliente relacionado está vinculado a un proyecto en lugar de a un cliente normal. | En su lugar, vincule el cliente relacionado al cliente principal que corresponda. |
| "Project records sync disabled" / "Related Project records sync disabled" | Este registro existe como proyecto en QuickBooks Online y la sincronización de proyectos está desactivada actualmente. | Comuníquese con soporte para activar la sincronización de proyectos de QuickBooks Online. |
| "This customer cannot be deleted because it is used on a recurring template." | El cliente se usa en una plantilla de factura recurrente en QuickBooks Online. | Primero archive la factura recurrente y luego archive al cliente. |
| "Another customer is already using this name and it cannot be merged because this customer has sub-customers." | El cliente tiene clientes relacionados vinculados. | Primero reasigne los clientes relacionados y luego combine los registros. |

### Errores de partidas y cuentas

| **Mensaje de error** | **Causa** | **Solución** |
| - | - | - |
| "Not a valid product or service name. Names must have at least one character and cannot include tabs, newlines or ':'." | El nombre del artículo tiene caracteres no válidos. | Use un nombre sencillo, sin dos puntos, espacios de más ni saltos de línea. |
| "You can't change a Category into another item type." | El artículo existe como categoría en QuickBooks Online. | Reemplácelo en el presupuesto o la factura por un artículo de tipo producto o servicio. |
| "Item # sync failed!" | El artículo de la factura no está sincronizado. | Abra el artículo y vuelva a sincronizarlo antes que la factura. |
| "There is no income account associated with the item." | El artículo no tiene una cuenta de ventas o de ingresos. | Seleccione una cuenta de ventas en el artículo y vuelva a sincronizar. |
| "Invalid account type used... the income account must have Account Type: 'Income'..." | Se usa un tipo de cuenta incorrecto para un artículo de inventario. | En el catálogo de cuentas de QuickBooks Online, configure la cuenta de ingresos con el tipo 'Income' / detalle 'Sales of Product Income' (y la cuenta de gastos con 'Cost of Goods Sold' / 'Supplies and Materials'). |
| "When you create an item, if Track Quantity on Hand is turned on, the item must be of type Inventory." | Un artículo lleva el control de la cantidad, pero no está configurado con el tipo Inventory. | Cambie el tipo del artículo a Inventory. |
| "Feature Not Supported Error... This feature is not included in your QuickBooks Online subscription." | Su plan de QuickBooks Online no admite la función (a menudo, el inventario). | Los artículos de inventario no se sincronizan en los planes que no admiten inventario: use un artículo de servicio o sin inventario, o cambie a un plan superior de QuickBooks Online. |
| "Invalid Type... Item of type Inventory cannot be changed to Service/Non-inventory item type." | No puede convertir un artículo de inventario a otro tipo. | Cree un artículo nuevo del tipo correcto. |
| La cuenta de ventas o de compras del artículo está inactiva en QuickBooks Online (falla de sincronización sin aviso) | La cuenta vinculada al artículo se marcó como inactiva en QuickBooks Online. | Reactive la cuenta en QuickBooks Online y luego vuelva a sincronizar el artículo. |
| "You can't change a bundle to another product or service type." | Este artículo existe como paquete en QuickBooks Online. | El tipo de este artículo no se puede cambiar. |
| "The account associated with this product or service has been deleted. Please undelete first or pick another one." | Se eliminó la cuenta de ventas o de compras del artículo. | Restaure la cuenta en QuickBooks Online o elija otra. |
| "When you create an item, if Track Quantity on Hand is turned off, the item cannot be of type Inventory." | Un artículo está configurado como Inventory, pero no lleva el control de la cantidad. | Cambie el tipo del artículo a Product - Non-inventory (producto sin inventario). |
| "Initial quantity on hand for an inventory item is required." | No se definió una cantidad inicial de inventario. | Defina la cantidad inicial de inventario al crear el artículo. |
| "You are not allowed to modify the quantity of an inactive inventory item." / "You need to activate this item before updating the quantity." | El artículo está archivado. | Reactive el artículo antes de editar su cantidad de inventario. |
| "Select a date that's after the last transaction for this item." | La fecha de la factura es anterior a la fecha de creación del artículo. | Ajuste la fecha de la factura o la fecha de creación del artículo. |
| "This needs to be active because it's the default product or service for sales." | El artículo o la cuenta se usa como predeterminado en QuickBooks Online. | No puede eliminar un artículo o una cuenta que se use como predeterminado en QuickBooks Online. |
| "Please make the parent product or service active first..." | El artículo principal está archivado. | Active el artículo principal antes de activar los artículos relacionados. |
| "Description-only Item can not be synced to QuickBooks!" | Este tipo de artículo de FieldPulse es solo de descripción y no está pensado para sincronizarse. | Puede ignorar este mensaje. |
| "You can't create or modify a transaction with a date that comes before you started tracking quantity on hand for \[item]." / "Transaction date is prior to start date for inventory item." / "You can't delete or void this transaction because it was created before you started tracking quantity on hand for \[item]." | El control de inventario comenzó después de la fecha de la factura. | En QuickBooks Online, cambie la fecha de inicio del control de inventario a una anterior a la fecha de la factura, o cambie la fecha de la factura. |
| "Item is a category!" / "An item in this transaction is set up as a category instead of a product or service." / "Categories cannot be used in transactions." | El artículo existe como categoría en QuickBooks Online. | Reemplácelo por un artículo de tipo producto o servicio: las categorías no se pueden usar en presupuestos ni en facturas. |

### Errores de facturas, pagos y montos

| **Mensaje de error** | **Causa** | **Solución** |
| - | - | - |
| "Draft invoice # is not available for sync!" | Las facturas en borrador no se sincronizan. | La factura se sincronizará cuando se finalice, es decir, cuando tenga el estado **Invoiced** (facturada). |
| "Enter a transaction amount that is 0 or greater." | El total de la factura no puede estar vacío ni ser menor que 0. | Ajuste los montos de las partidas o agregue más artículos. |
| "The discount amount can't be greater than the subtotal." | El descuento hace que el total sea menor que 0. | Reduzca el descuento para que el total sea 0 o mayor. |
| "Related Customer # sync failed!" | El cliente de la factura no está sincronizado. | Primero sincronice el cliente relacionado y luego la factura. |
| "Related Invoice # sync failed!" | La factura del pago no está sincronizada. | Primero sincronice la factura relacionada y luego el pago. |
| "This transaction is matched to a downloaded transaction. If you want to change the account, you need to unmatch the transaction first." | El registro está vinculado a una transacción descargada del banco en QuickBooks Online. | Edite el registro en QuickBooks Online, no en FieldPulse. |
| "Deposited Transaction cannot be changed" / "This transaction has been deposited..." | El pago ya se depositó en QuickBooks Online. | Edítelo en QuickBooks Online. |
| "Enter a transaction amount to continue." / "You must set a transaction amount." | El presupuesto o la factura están vacíos. | Agregue partidas antes de guardar. |
| "Cost estimate is not assigned to a valid project." | El presupuesto no está vinculado a un proyecto válido (cliente relacionado). | Abra el presupuesto y seleccione un proyecto válido antes de guardar. |
| "Related Class # sync failed!" | La clase asignada a la factura o al presupuesto no está sincronizada. | Asegúrese de que la clase esté activa en QuickBooks Online o cree una nueva. |
| "Invalid Reference Id: Class assigned to this transaction has been deleted. Before you can modify this transaction, you must restore \[class]." | La clase se eliminó en QuickBooks Online. | Restaure o vuelva a crear la clase en QuickBooks Online y asegúrese de que esté activa. |

### Errores de impuestos

| **Mensaje de error** | **Causa** | **Solución** |
| - | - | - |
| "Make sure all your transactions have a GST/HST rate before you save." | A una partida le falta una tasa de GST/HST (Canadá). | Edite cada partida, seleccione una tasa de GST/HST y guarde. |
| "Looks like you tried using an invalid or incorrect tax classification code. Try again with a different code." | El código de impuesto no es válido. | Seleccione otra tasa de impuesto que sea válida. |
| "We're sorry, we can't save the sales tax you're trying to set up right now." / "...QuickBooks encountered an error while calculating tax..." | Hay un error en el impuesto aplicado a las partidas. | Quite las partidas del registro y vuelva a agregarlas para restablecer el impuesto. |

### Errores de periodo contable y de conexión

| **Mensaje de error** | **Causa** | **Solución** |
| - | - | - |
| "Account Period Closed... Txn Date=# is before book closing date=#" / "...Cannot Update Through Services API..." | El periodo contable está bloqueado en QuickBooks Online. | Desbloquee el periodo en QuickBooks Online para sincronizar las actualizaciones o haga el cambio directamente en QuickBooks Online. |
| "Authorization Failure... You do not have access to use QuickBooks Online. statusCode: 401" | La cuenta con la que se hizo la conexión no tiene acceso. | Asegúrese de que la cuenta usada para conectarse esté activa y tenga permisos de administrador. |
| "Authorization Failure... Unknown Error during Authentication. statusCode: 500" | FieldPulse y QuickBooks Online se desconectaron. | Desactive la integración de QuickBooks Online y vuelva a activarla. |
| "Invalid Company Status... Subscription period has ended or canceled or there was a billing problem." | La suscripción de QuickBooks Online terminó o se canceló. | Resuelva el problema de facturación en QuickBooks Online. |
| "The action could not be completed because another user was creating, editing or deleting a transaction with inventory products at exactly the same time." | Alguien tiene el mismo registro abierto en QuickBooks Online. | Cierre el registro en QuickBooks Online y vuelva a intentarlo. |
| "Another user is currently accessing this company. Please try again." | Otra persona está editando el mismo registro. | Cierre el registro y vuelva a intentarlo. |
| "Stale Object Error... Another user finished before you did, so your work was not saved." | El registro se editó en dos lugares al mismo tiempo. | Cierre el registro en QuickBooks Online o en FieldPulse antes de volver a editarlo. |
| "An unexpected error occurred while accessing or saving your data." | Un problema temporal de sincronización. | Espere unos minutos y vuelva a intentarlo; comuníquese con soporte si el problema continúa. |
| "Something this action required is no longer available. Another user may have deleted it." | Otro usuario archivó el artículo o el registro. | Reactive el artículo o el registro, use otro o cree uno nuevo. |
| "Object Not Found... Another user has deleted this transaction." / "...Something you're trying to use has been made inactive." | El registro se eliminó o se marcó como inactivo. | Reactive el registro antes de volver a sincronizarlo. |
| "QuickBooks side does not have record with such ID to be resynced!" | El registro se eliminó en QuickBooks Online. | Reactívelo en QuickBooks Online o comuníquese con soporte para quitarlo de FieldPulse. |
| "You can't use \[x] because \[x] already exists..." / "There is a duplicated records in FieldPulse database!" / "There is a multiply entities by this criteria" / "There is a multiply records in QuickBooks!" / "There is already synced record present in FieldPulse database..." | Tiene un registro duplicado con el mismo nombre. | Cambie el nombre de uno de los duplicados antes de volver a sincronizar. |
| "Number out of range..." / "String length is either shorter or longer than supported..." | El nombre o el valor del registro está fuera de la longitud admitida. | Ajuste el nombre o el valor del registro para que quede dentro de la longitud admitida. |
| "Invalid ID... Id should be a valid number." / "Required param missing..." | Una falta de coincidencia de un ID o un parámetro a nivel del sistema. | Comuníquese con soporte si ve este error. |
| "Invalid Reference Id: \[x]" (una cuenta, un artículo o un cliente está inactivo, eliminado o ya no es válido) / "Invalid Reference Id: This account has been deleted." | El registro al que se hace referencia no está activo en QuickBooks Online. | Asegúrese de que el registro relacionado esté activo y sincronizado antes de sincronizar los registros que dependen de él; si hace referencia a una cuenta, revise su catálogo de cuentas. |

## ¿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).


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