Overview
This article catalogs the error messages you may encounter when synchronizing data between Catsy and iPaaS.com, grouped by mapping collection flow. Use it to identify what an error means and how to resolve it. Errors appear in the iPaaS.com Dashboard under Integration Monitoring and in the Error Logs.
Supported Flows
Add/Update Catsy Category TO iPaaS.com
Add/Update Catsy Product TO iPaaS.com
Add/Update Catsy Product FROM iPaaS.com
Catsy API
Add/Update Catsy Category TO iPaaS.com
Invalid Category ID
Invalid category ID format (id: {Id}). The ID must begin with 'Cat' or 'Col' with exact casing.
Description: The category or collection ID does not start with the required type prefix. Category IDs must begin with Cat and collection IDs with Col, using exact casing.
Resolution: When entering an ID on the Manual Sync page, include the full ID with its prefix (for example, Cat4000696937 or Col4000012345) and verify the casing matches exactly.
Duplicate Category Name
Unable to link to an existing iPaaS.com Category using Name. This may result in duplicate Category records.
Description: A category with the same name already exists in iPaaS.com, but the integration could not link the incoming Catsy category to it, so a duplicate category may be created.
Resolution: Review your iPaaS.com categories for duplicate names and ensure category names are unique and accurate so incoming records link to the correct category.
Parent Category Not Created
Unable to create the parent category. This will prevent the transfer of the product category.
Description: The incoming category names a parent category that could not be transferred to iPaaS.com. Because the parent could not be created, the child category is not transferred.
Resolution: Confirm the parent category is valid in Catsy, then retry the transfer.
Add/Update Catsy Product TO iPaaS.com
Duplicate Product SKU
Unable to link to an existing Catsy product using sku: {sku}. This may result in duplicate product records in Catsy.
Description: A product with the same SKU already exists, but the integration could not link the incoming product to it, so a duplicate product may be created in Catsy.
Resolution: Check for duplicate SKUs and ensure each product has a unique SKU so records link correctly.
Duplicate Variant SKU
Unable to link to an existing Catsy product variant using sku: {sku}. This may result in duplicate product variant records in Catsy.
Description: A product variant with the same SKU already exists, but the integration could not link the incoming variant to it, so a duplicate variant may be created.
Resolution: Check for duplicate variant SKUs and ensure each variant has a unique SKU.
Add/Update Catsy Product FROM iPaaS.com
Duplicate Product Link
Unable to link to an existing Catsy product. This may result in duplicate product records.
Description: The integration could not match the iPaaS.com product to an existing Catsy product by SKU, so a duplicate product may be created in Catsy.
Resolution: Verify the product's SKU matches the corresponding record in Catsy.
Product Update Missing Identifier
The product could not be updated because it has no identifier.
Description: An update was attempted for a product that has no Catsy identifier, so the update cannot proceed.
Resolution: Ensure the product has been created in Catsy before it is updated. Contact iPaaS.com Support at support@ipaas.com if the issue persists.
Catsy API
API Quota Exceeded
Catsy API quota exceeded. Too many requests. Available in {N} seconds.
Description: Catsy temporarily limited the number of requests the integration could make. Transfers resume automatically after the wait period shown.
Resolution: No action is usually required — transfers resume after the limit resets. If this happens often, lower the API Throttle Limit on the subscription settings so the integration sends requests more slowly.
Catsy API Error
The error message returned by the Catsy API.
Description: Catsy returned an error for a request. The message shown is Catsy's own response and describes the specific problem, such as a validation error or a missing required field.
Resolution: Review the message from Catsy, correct the underlying data or mapping, and retry. Contact iPaaS.com Support at support@ipaas.com if the cause is unclear.