Category not found

Description

This error occurs when a product is to be linked to a category in the receiving system but the specified category cannot be found.

Cause

• The category does not exist in the receiving system.

• Incorrect category ID or category path (typo, wrong casing, extra whitespace).

• A parent category is missing or inactive.

• The category exists but is not published/activated.

• Missing or incorrect category mapping in the integration.

• Insufficient permissions or a stale cache in the receiving system.

Resolution

1. Search for the category in the receiving system and verify that it exists and is active.

2. Ensure the correct category ID/category path is sent (remove leading/trailing whitespace, correct casing).

3. Confirm that all parent categories exist and are active.

4. Review and update the category mapping in the integration.

5. Publish/activate the category in the receiving system and try again.

6. Clear any cache and rerun the sync.

Example

• Valid: categoryId = "12345" (exists and is active)

• Invalid: categoryId = "12345 " (trailing space)

• Invalid: categoryPath = "Jewelry/Rings/Gold" where “Gold” is missing in the system.