Overview
This document provides a comprehensive overview of all error messages explicitly defined within the integration code. Its purpose is to maintain clarity, accuracy, and consistency across all error handling. Each error entry includes the error title, detailed message, trigger condition, and the proposed resolution.
Supported Flows
Product From iPaaS
Product Variant From iPaaS
Product/Variant Delete From iPaaS
Customer From iPaaS
Transaction From iPaaS
Error Collection
Product From iPaaS
Special Character Replacement
Could not {create}/{update} product because product SKU contains special characters and no Special Character Replacement is specified. {Id}
This error can occur during the Product From iPaaS flow when the Product SKU contains special characters (such as /,?, or #) and no Special Character Replacement is configured in the Subscription Settings.
To prevent this issue, ensure that the Product SKU does not include special characters, or configure a Special Character Replacement value so that invalid characters are automatically replaced before sending the Product to the integration.
Missing Store
Could not {create}/{update} product because no store is provided for product: {this.Id}
This error can occur during the Product From iPaaS flow when no Store information is provided for the Product. The exception is thrown if the StoreId property is null or an empty list, indicating that the system does not know which store(s) the Product should be associated with.
To prevent this issue, ensure that at least one valid Store ID is included in the Product payload (StoreId) before sending the data. Verify that the source system is correctly mapping Store IDs and that the target integration requires and supports Store-level Product creation.
Missing External Id Delimiter
Could not {create}/{update} product because preset (Variant External Id Delimiter) is not specified in the Subscription Settings.
This error can occur during the Product From iPaaS flow when the Variant External ID Delimiter is not configured in the subscription (integration) settings. The system requires this delimiter to correctly construct or parse unique external IDs for product variants. If the delimiter value is null or empty, the product creation process cannot continue and throws an exception.
To prevent this issue, ensure that a valid Variant External Id Delimiter is defined in the integration’s subscription settings (for example: -, _, or |) before sending Product or Variant data to the integration.
Product Creation Failed
Failed to {create}/{update} product in Mailchimp.
This error can occur during the Product From iPaaS flow when the Mailchimp integration rejects the Product due to missing required fields or incomplete subscription settings.
To prevent this issue, ensure that all mandatory Product fields are properly populated and that the required subscription settings are correctly configured before transferring the Product to the integration.
Product Deletion Failed
Error: Product_Delete Exception occurred. Exception is: {Message}
This error occurs when an error is encountered while attempting to delete a Product.
Verify that the Product exists in the target system, that the Product ID being sent is valid, and the target system is accessible at the time of deletion.
Product Variant From iPaaS
Special Character Replacement
Could not {create}/{update} product variant because variant SKU contains special characters and no Special Character Replacement is specified. {Id}
This error can occur during the Product Variant From iPaaS flow when the Product variant SKU contains special characters (such as /,?, or #) and no Special Character Replacement is configured in the subscription settings.
To prevent this issue, ensure that the product variant SKU does not include special characters, or configure a Special Character Replacement value so that invalid characters are automatically replaced before sending the product variant to the integration.
Missing Store
Could not {create}/{update} product variant because no store is provided for product variant: {this.Id}
This error can occur during the Product Variant From iPaaS flow when no Store information is provided for the Product. The exception is thrown if the StoreId property is null or an empty list, indicating that the system does not know which store(s) the Product should be associated with.
To prevent this issue, ensure that at least one valid Store ID is included in the Product variant payload (StoreId) before sending the data. Verify that the source system is correctly mapping Store IDs and that the target integration requires and supports Store-level Product creation.
No Parent Found
{ParentId} this variant parent does not interlink with Mailchimp
This error occurs when trying to process a product variant, but its parent product is not linked (interlinked) with Mailchimp. The system attempts to fetch the parent product’s external ID; if it is missing or empty, it cannot associate the variant with a parent, so an exception is thrown.
To resolve this issue, ensure that the parent product exists in Mailchimp and is correctly interlinked with the integration before creating or updating variants. Verify that the parent product has a valid external ID in the system so that all its variants can be associated correctly.
Missing External Id Delimiter
Could not {create}/{update} product variant because preset (Variant External Id Delimiter) is not specified in subscription settings.
This error can occur during the Product Variant From iPaaS flow when the Variant External ID Delimiter is not configured in the subscription (integration) settings. The system requires this delimiter to correctly construct or parse unique external IDs for product variants. If the delimiter value is null or empty, the product creation process cannot continue and throws an exception.
To prevent this issue, ensure that a valid Variant External Id Delimiter is defined in the integration’s subscription settings (for example: -, _, or |) before sending Product or Variant data to the integration.
Product Variant Creation Failed
Failed to {create}/{update} product in Mailchimp
This error can occur during the Product flow in iPaaS when the Mailchimp integration rejects the Product due to missing required fields or incomplete subscription settings.
To prevent this issue, ensure that all mandatory Product fields are properly populated and that the required subscription settings are correctly configured before transferring the Product to the integration.
Product/Variant Delete From iPaaS
Product Deletion Failed
Error: Product_Delete Exception occurred. Exception is: {Message}
This error occurs when an error is encountered while attempting to delete a Product.
Verify that the Product exists in the target system, that the Product ID being sent is valid, and the target system is accessible at the time of deletion.
Could not Delete Product Variant
Could not delete product variant because preset (Variant External Id Delimiter) is not specified in subscription settings
This error occurs during the Product Variant Delete From iPaaS flow when the Variant External Id Delimiter is not configured in the subscription settings. The system relies on this delimiter to split the Variant External ID into the Product Variant ID and Product ID. If the delimiter is missing or empty, the ID cannot be parsed correctly, and the delete operation fails, resulting in the exception.
Verify that the Product exists in the target system, that the Product ID being sent is valid, and the target system is accessible at the time of deletion.
Product Variant Deletion Failed
Error: Product_Variant_Delete Exception occurred. Exception is: {Message}
This error occurs when an error is encountered while attempting to delete a Product Variant.
Verify that the Product Variant exists in the target system, that the Product Variant ID being sent is valid, and that the target system is accessible at the time of deletion.
Customer From iPaaS
ListId is empty
No value is specified for ListId. This is a required field.
This error occurs during the Customer (Member) From iPaaS flow when the ListId value is missing, null, or empty. The ListId is a mandatory parameter that identifies the Mailchimp Audience (List) where the customer/member should be created.
To resolve this issue, ensure that a valid Mailchimp ListId is provided and correctly mapped in the iPaaS flow.
Duplicate Email Address
Mailchimp indicated that there was a duplicate email for {emailAddress}, but a search for that email returned no exact matches.
This error occurs when Mailchimp reports that the email address already exists in the list, but the system’s search does not find any matching member. In simple terms, Mailchimp thinks the email is a duplicate, but the integration cannot locate it in the list.
To fix this issue, first check that the email actually exists in the correct Mailchimp list. Make sure the integration uses the correct ListId and that the email format matches exactly. If the email exists, update the existing member instead of creating a new one, and ensure proper mapping before sending data to prevent this error.
Unable to Search Customer using email & store Id
While Getting Customer, you must provide a customer email and a store id.
This error occurs when either the customer email or the StoreId is missing while trying to fetch a customer from Mailchimp. Both values are required to search for the customer. If either of them is missing, the system cannot identify which customer to retrieve, and it throws an exception.
To resolve this issue, ensure that both the customer’s email and the StoreId are provided before calling this function.
Unable to Search Customer using customer Id & store Id
While Getting Customer, you must provide a customer Id and a store id.
This error occurs when either the customer Id or the StoreId is missing while trying to fetch a customer from Mailchimp. Both values are required to search for the customer. If either of them is missing, the system cannot identify which customer to retrieve, and it throws an exception.
To resolve this issue, ensure that both the customer’s Id and the StoreId are provided before calling this function.
Unable to Search Customer using customer Id & store Id
While Getting Customer, you must provide a customer Id and a store id.
This error occurs when either the customer Id or the StoreId is missing while trying to fetch a customer from Mailchimp. Both values are required to search for the customer. If either of them is missing, the system cannot identify which customer to retrieve, and it throws an exception.
To resolve this issue, ensure that both the customer’s Id and the StoreId are provided before calling this function.
Merge Field does not exist
The specified merge field does not exist, so we attempted to create it. However, the field name is invalid as a merge field tag. Only numbers or capital letters are supported, and the length must be less than 10.
This error occurs when the system tries to create a Mailchimp merge field with an invalid name. Mailchimp merge field tags must only contain capital letters (A-Z) or numbers (0-9) and must be 10 characters or fewer. If the name does not meet these rules, an exception is thrown.
To fix this issue, ensure that any merge field names being created follow Mailchimp’s naming rules: only uppercase letters or numbers, and the length must be less than 10 characters.
Merge Field does not exist
The specified merge field does not exist, so we attempted to create it. However, the field name is invalid as a merge field tag. Only numbers or capital letters are supported, and the length must be less than 10.
This error occurs when the system tries to create a Mailchimp merge field with an invalid name. Mailchimp merge field tags must only contain capital letters (A-Z) or numbers (0-9) and must be 10 characters or fewer. If the name does not meet these rules, an exception is thrown.
To fix this issue, ensure that any merge field names being created follow Mailchimp’s naming rules: only uppercase letters or numbers, and the length must be less than 10 characters.
Transaction From iPaaS
Length of ID exceeded
Id character count is greater than 49.
This error occurs when the Order ID exceeds 49 characters. Mailchimp imposes a limit on the length of order IDs, and if the ID is too long, the system cannot process the order, resulting in an exception.
To resolve this issue, ensure that all order IDs are 49 characters or fewer before sending them to Mailchimp.
Customer is not linked
The Customer is not interlinked with Mailchimp. Please provide a valid Customer.
This error occurs when trying to create an order in Mailchimp, but the CustomerId is null. Mailchimp requires that every order be linked to a valid customer in the specified store. If the customer is not interlinked or the CustomerId is missing, the system cannot create the order, and an exception is thrown.
To fix this issue, ensure that the order is associated with a valid customer already created in Mailchimp. Verify that CustomerId is correctly populated and mapped from your source system, and that the customer exists in the specified StoreId before sending the order creation request.
Missing Store ID
The StoreId is not provided in the order’s custom fields.
This error occurs when trying to create an order in Mailchimp, but the StoreId is missing in the order data. Mailchimp requires each order to be linked to a valid store, and if StoreId is not provided in the custom fields of the order, the integration cannot determine which store the order belongs to, leading to the exception.
To resolve this issue, ensure that every order includes a valid StoreId in its custom fields before sending it to Mailchimp.