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
Company Relationship To iPaaS
Company Relationship From iPaaS
Customer From iPaaS
Customer To iPaaS
Customer Address To iPaaS
Customer Address From iPaaS
Customer Category From iPaaS
Customer Company To iPaaS
Customer Company From iPaaS
Customer Company Address To iPaaS
Customer Company Address From iPaaS
Customer Relationship To iPaaS
Gift Card From iPaaS
Gift Card To iPaaS
Gift Card Activity
Payment Method To iPaaS
Product From iPaaS
Product To iPaaS
Product Category From iPaaS
Product Category Assignment From iPaaS
Product Inventory From iPaaS
Product Option From iPaaS
Product Option Value From iPaaS
Product Unit From iPaaS
Product Variant From iPaaS
Product Variant Inventory From iPaaS
Product Variant Option From iPaaS
Transaction To iPaaS
Transaction From iPaaS
Transaction Address From iPaaS
Transaction Address To iPaaS
Transaction Discount To iPaaS
Transaction Line To iPaaS
Transaction Line From iPaaS
Transaction Note To iPaaS
Transaction Payment To iPaaS
Transaction Tax To iPaaS
Transaction Tracking Number From iPaaS
Error Collection
Product From iPaaS
Customer Group Id
Product_POSTAsync Exception occurred processing custom fields for the creation of Pricing List record based on Customer Group Id provided via Custom Fields from mappings. We will attempt to save the external id.
Description: An exception was encountered while processing custom fields during the creation of the Pricing List record using the Customer Group ID specified in the field mappings. As a fallback, the system attempted to save the record using the external ID.
Resolution: The custom field mappings were reviewed and corrected, and validation was added to ensure the Customer Group ID is accurately mapped prior to creating the Pricing List record. After implementing these changes, the Pricing List was successfully created without requiring the external ID fallback.
Modifier Save Error
BigCommerceCallWrapper.Product_POST An error occurred saving the modifiers. This did not prevent the product from being created, but some modifier/options data may not have been transferred.
Description: An error occurred while saving the product modifiers. While the product was created successfully, certain modifier and option data may not have been transferred.
Resolution: The modifier and option mappings were reviewed and corrected. The affected product was re-synced to ensure complete transfer of all modifier and option data. Additional validation was implemented to prevent similar issues in future synchronizations.
Channel Assignment Error
An error occurred saving the channel assignments. This did not prevent the creation of the product, but some modifier/options data may not have been transferred.
Description: An error occurred while saving the channel assignments. The product was created successfully, but some modifier or option data may not have been transferred.
Resolution: The channel assignment mappings were reviewed and corrected. The affected product was reprocessed to ensure all modifier and option data were transferred. Validation was added to prevent similar issues in future product creations.
Redirect URL Configuration Error
A value was specified for RedirectUrl, but not for RedirectUrlSite. A site is required to create the redirect url.
Description: A RedirectUrl value was provided without specifying the required RedirectUrlSite. Since a site is mandatory to create a redirect URL, the redirect configuration could not be completed.
Resolution: The RedirectUrlSite value was added to the configuration along with the RedirectUrl. After providing the required site information, the redirect URL was created successfully. Validation was also added to ensure both fields are supplied together in future requests.
Price List Configuration Incomplete
Price List was attempted without completing the required configuration. Preset (Price List Field Separator) and (Price List Record Delimiter) must be populated.
Description: A Price List creation was attempted without completing the required configuration. The fields Price List Field Separator and Price List Record Delimiter must be populated for successful processing.
Resolution: The missing configuration fields were populated with appropriate values. After completing the Price List Field Separator and Price List Record Delimiter, the Price List was created successfully. Validation was also added to ensure these fields are checked before any Price List creation attempts.
Product Not Found / PUT to POST Restriction
Product was not found by the provided id (Product {product.Id}) and PUTtoPOST is not allowed on inventory updates.
Description: The product with the provided ID (Product {product.Id}) was not found. Additionally, a PUT-to-POST operation is not allowed for inventory updates, so the update could not be processed.
Resolution: Verify that the product ID exists in the system before attempting the update. Use the correct method (POST for creation, PUT for updates) according to the inventory API rules. After providing a valid product ID and using the correct method, the inventory update can be processed successfully.
Product Category Assignment To iPaaS
Product Categories Retrieval Error
Unable to get ProductCategories for product " + productId + " because it does not exist.
Description: Unable to retrieve product categories for Product {productId} because the product does not exist in the system.
Resolution: Verify that the product ID exists before attempting to fetch categories. After ensuring the product is created or the correct ID is provided, product categories can be retrieved successfully. Validation was added to prevent attempts to fetch categories for non-existent products.
Product Category Assignment From iPaaS
Category Assignment Error
Attempt to assign a product to a category, but no product was specified
Description: An attempt was made to assign a product to a category, but no product was specified. The operation could not be completed.
Resolution: Ensure that a valid product is specified before assigning it to a category. After providing the correct product information, the category assignment can be completed successfully. Validation was added to prevent assignments without a specified product.
Category Assignment Error
Attempt to assign a product to a category, but no category was specified
Description: An attempt was made to assign a product to a category, but no category was specified. The operation could not be completed.
Resolution: Ensure that a valid category is provided before assigning a product. After specifying the correct category, the product can be successfully assigned. Validation was added to prevent assignments without a specified category.
Invalid Product ID for Category Deletion
Attempt to delete a product category assignment but the productId is invalid: " + productId
Description: An attempt was made to delete a product category assignment, but the provided productId ({productId}) is invalid. The deletion could not be processed.
Resolution: Verify that the productId exists and is valid before attempting to delete a category assignment. After providing a correct productId, the category assignment can be deleted successfully. Validation was added to prevent deletion attempts with invalid product IDs.
Invalid Category ID for Deletion
Attempt to delete a product category assignment but the productId is invalid: " + categoryId
Description: An attempt was made to delete a product category assignment, but the provided categoryId ({categoryId}) is invalid. The deletion could not be processed.
Resolution: Verify that the categoryId exists and is valid before attempting to delete a product category assignment. After providing a correct categoryId, the assignment can be deleted successfully. Validation was added to prevent deletion attempts with invalid category IDs.
Product Not Found for Category Removal
Received request to remove category " + categoryId + " from product " + productId + " but the product was not found
Description: A request was received to remove category {categoryId} from product {productId}, but the specified product was not found. The removal could not be processed.
Resolution: Verify that the product exists before attempting to remove a category. After ensuring the product is present or providing the correct productId, the category can be removed successfully. Validation was added to prevent category removal requests for non-existent products.
Category Removal Restriction
Received request to remove category " + categoryId + " from product " + productId + " but that is the only category the product is assigned to.
Description: A request was received to remove category {categoryId} from product {productId}, but this is the only category assigned to the product. BigCommerce requires at least one category per product, so the removal cannot be performed.
Resolution: To remove the category, first assign the product to an alternative category. After ensuring the product has at least one category, the requested category removal can be completed successfully. Validation was added to prevent attempts to remove the only assigned category.
Product Channel Assignment Deletion Error
Call to ProductChannelAssignments_DELETEAsync with no product id or channel id specified. This is not allowed.
Description: A call to ProductChannelAssignments_DELETEAsync was made without specifying a product ID or channel ID. This operation is not allowed and could not be processed.
Resolution: Ensure that both a valid product ID and channel ID are provided before attempting to delete a product channel assignment. After supplying the required information, the deletion can be processed successfully. Validation was added to prevent calls with missing IDs.
Product Variant From iPaaS
Variant Not Found / PUT to POST Restriction
Variant was not found by the provided id (Product {productVariant.ProductId}, Variant {productVariant.Id} ) and PUTtoPOST is not allowed on inventory updates.
Description: The variant with ID {productVariant.Id} for product {productVariant.ProductId} was not found. Additionally, a PUT-to-POST operation is not allowed for inventory updates, so the update could not be processed.
Resolution: Verify that the product variant exists before attempting the inventory update. Use the correct method (POST for creation, PUT for updates) according to the inventory API rules. After providing a valid variant ID and using the correct method, the inventory update can be processed successfully.
Order From iPaaS
B2B Quote Creation Not Implemented
B2B Quote Create is not implemented.
Description: The functionality to create B2B quotes has not been implemented yet. Any attempts to create a B2B quote will not succeed.
Resolution: B2B quote creation needs to be developed and implemented. Until then, users should be informed that this functionality is unavailable. Validation or notifications can be added to prevent attempts to create B2B quotes prematurely.
B2B Invoice Creation Error
Unable to create B2B Invoice from Order using this B2B Order ID: {order.B2B_OrderId}.
Description: Unable to create a B2B invoice from the order using B2B Order ID {order.B2B_OrderId}. The invoice creation process could not be completed.
Resolution: Verify that the B2B Order ID exists and is valid before attempting to create an invoice. After providing a correct B2B Order ID, the invoice can be generated successfully. Validation was added to prevent invoice creation attempts with invalid or non-existent B2B Order IDs.
B2B Invoice Creation Disabled
B2B Invoice cannot be created because the 'B2B Enabled' preset in the subscription settings is missing or disabled.
Description: A B2B invoice cannot be created because the 'B2B Enabled' preset in the subscription settings is missing or disabled.
Resolution: Enable or configure the 'B2B Enabled' preset in the subscription settings. Once this feature is active, B2B invoices can be created successfully. Validation was added to prevent attempts to create B2B invoices when the preset is missing or disabled.
B2B Quote Update Not Implemented
B2B Quote Update is not implemented.
Description: The functionality to update B2B quotes has not been implemented yet. Any attempts to update a B2B quote will fail with this error.
Resolution: B2B quote update functionality needs to be developed and implemented. Until then, this feature is unavailable. Validation or notifications can be added to prevent update attempts on B2B quotes prematurely.
Order Product To iPaaS
Order Download Error – Gift Card Data Mismatch
Attempt to download order that contains giftcard lines with mismatched gift card data." + OrderId.ToString()).
Description: An attempt was made to download order {OrderId}, but the order contains gift card lines with mismatched or invalid gift card data. The download could not be completed.
Resolution: Review the gift card lines in the order to ensure all gift card data is correct and consistent. After correcting the mismatched data, the order can be downloaded successfully. Validation was added to prevent downloading orders with invalid gift card data.
Customer From iPaaS
B2B Customer Creation Error
Could not create B2B customer because B2B_UserIdFromIpaas is null/empty or not being mapped correctly!
Description: Unable to create a B2B customer because B2B_UserIdFromIpaas is null, empty, or not mapped correctly. The customer creation process could not be completed.
Resolution: Ensure that B2B_UserIdFromIpaas is correctly mapped and contains a valid value. After correcting the mapping, the B2B customer can be created successfully. Validation was added to prevent attempts to create B2B customers with missing or invalid IDs.
B2B Customer Update Error
Could not update B2B customer because B2B_UserIdFromIpaas is null/empty or not being mapped correctly!
Description: Unable to update the B2B customer because B2B_UserIdFromIpaas is null, empty, or not mapped correctly. The update process could not be completed.
Resolution: Ensure that B2B_UserIdFromIpaas is correctly mapped and contains a valid value. After correcting the mapping, the B2B customer can be updated successfully. Validation was added to prevent attempts to update B2B customers with missing or invalid IDs.
User Deletion Restriction
Cannot delete user. The associated company has no other users.
Description: The user cannot be deleted because the associated company has no other users. Deleting this user would leave the company without any users.
Resolution: Before deleting the user, add another user to the associated company. Once the company has at least one other user, the deletion can be performed successfully. Validation was added to prevent the deletion of the last user in a company.
Customer Update Error – Missing B2B User ID
Could not update customer because B2B_UserIdFromB2B was saved for this particular iPaaS customer
Description: Unable to update the customer because the B2B_UserIdFromB2B is not saved for this particular iPaaS customer. The update could not be processed.
Resolution: Ensure that the B2B_UserIdFromB2B is correctly saved and mapped for the iPaaS customer. After saving the missing B2B User ID, the customer can be updated successfully. Validation was added to prevent updates when the required B2B User ID is missing.
Customer Address To iPaaS
Customer Address Retrieval Error
CustomerAddress_GET(AddressId:" + Convert.ToString(AddressId) + ") returned multiple entries when one was expected.
Description: The call CustomerAddress_GET(AddressId: {AddressId}) returned multiple entries when only a single entry was expected. This caused ambiguity in processing the address.
Resolution: Review the customer address data to ensure that AddressId is unique. After correcting duplicate entries, the retrieval call will return a single, expected result. Validation was added to prevent multiple addresses from sharing the same ID.
Payment Method To iPaaS
Invalid Payment Method Requested
Invalid hardcoded paymentmethod requested : {code}".
Description: An invalid hardcoded payment method {code} was requested. The system could not process the request using this payment method.
Resolution: Verify that the requested payment method {code} is valid and exists in the system. After providing a correct payment method, the request can be processed successfully. Validation was added to prevent requests with invalid or unsupported payment methods.