See what the Linnworks integration can do →
Overview
This article catalogs the error messages the Linnworks integration can record in the iPaaS.com error logs, grouped by mapping collection flow. Each entry lists the message a subscriber sees, what causes it, and how to resolve it.
Supported Flows
Transaction To iPaaS.com
Transaction Line To iPaaS.com
Transaction Tracking Number From iPaaS.com
Product Inventory From iPaaS.com
Product Variant Inventory From iPaaS.com
Product and Variant From iPaaS.com
Error Collection
Transaction To iPaaS.com
No items available
No items are available, so the order will not be transferred.
Description: Raised by the order mapping filter when the order has no line items, or none of its item SKUs exist as Products in iPaaS.com.
Resolution: Ensure the order includes at least one line item and that those items' SKUs exist as Products in iPaaS.com before transferring the order.
Email address not found
No email address is provided in either the shipping or billing address.
Description: Raised by the order mapping filter when the order has no email address on either its shipping or billing address.
Resolution: Add a valid email address to the order's shipping or billing address in Linnworks, then re-sync the order.
Unable to link existing transaction
Unable to dynamically link to existing Linnworks transaction using NumOrderId. This may result in duplicate transaction records.
Description: Raised when the integration cannot link an incoming order to an existing iPaaS.com Transaction by its order number, which can lead to duplicate Transactions.
Resolution: Contact iPaaS.com Support if duplicate Transactions appear for the same order.
Transaction Line To iPaaS.com
Item not available
This item is not available in iPaaS, so it cannot be transferred.
Description: Raised by the line mapping filter when a line item's SKU does not exist as a Product in iPaaS.com.
Resolution: Transfer the matching Product to iPaaS.com, then re-sync the order so the line can be transferred.
Transaction Tracking Number From iPaaS.com
Invalid ID
Invalid Id: value is null or empty.
Description: The shipment Id sent to the integration is null or empty, so the tracking record cannot be identified.
Resolution: Ensure the shipment Id is provided in the expected format (a combined value such as <SalesOrderId>|<TrackingNumberId>) before sending the request.
Missing postal service ID or order ID
Invalid Id: missing postalServiceId or orderId.
Description: The shipment Id is missing its postal-service or order portion, so the integration cannot link the shipment.
Resolution: Ensure both the postal service and order portions of the shipment Id are present before sending the request.
Order not found or shipping info missing
Order not found or ShippingInfo is null for OrderId: {orderId}.
Description: The integration could not find the order for the given OrderId, or the order has no shipping information.
Resolution: Verify the OrderId corresponds to an existing order that has shipping details before triggering the transfer.
Transaction not found
No Transaction found for the order (orderId: {Id}) and Order Tracking: (trackingId: {Id}). Cannot add Shipping Info.
Description: Raised by the shipment mapping filter when no Linnworks order can be found for the originating Transaction, so shipping information cannot be added.
Resolution: Ensure the order has been transferred to Linnworks before adding its shipment.
Unable to create shipment
Unable to create Shipment in Linnworks from iPaaS.
Description: The integration attempted to create a shipment in Linnworks but the required data was missing or invalid, or Linnworks rejected the request.
Resolution: Verify the order, postal service, tracking number, and shipping details are populated and valid, and that the Linnworks order and postal service exist, then retry.
Unable to update shipment
Unable to update Shipment in Linnworks from iPaaS.
Description: The integration attempted to update a shipment in Linnworks but the shipment could not be found or the data was rejected.
Resolution: Ensure the shipment already exists in Linnworks and that the tracking, postal service, and order details are valid before retrying.
Product Inventory From iPaaS.com
Missing required field
SKU, LocationId, and Level are required to properly create inventory and must not be null or empty.
Description: A product inventory record is missing one of the required values — SKU, LocationId, or Level.
Resolution: Ensure each product inventory record maps a non-empty SKU, LocationId, and Level.
Product not found
Product could not be found by SKU {SKU} in Linnworks. Please make sure product exists.
Description: The integration could not find a Linnworks product for the given SKU, so its stock level cannot be set.
Resolution: Transfer the product to Linnworks (or confirm the SKU matches an existing Linnworks product) before setting its stock level.
Unable to create product prerequisite
Unable to create Product in Linnworks. This will prevent the transfer of the inventory.
Description: The integration attempted to create the product needed for the inventory transfer but the creation failed.
Resolution: Verify the product's required fields are mapped and valid, then retry. Contact iPaaS.com Support if the problem persists.
Product Variant Inventory From iPaaS.com
Missing required field
SKU, LocationId, and Level are required to properly create inventory and must not be null or empty.
Description: A product variant inventory record is missing one of the required values — SKU, LocationId, or Level.
Resolution: Ensure each variant inventory record maps a non-empty SKU, LocationId, and Level.
Product variant not found
Product Variant could not be found by SKU {SKU} in Linnworks. Please make sure product variant exists.
Description: The integration could not find a Linnworks product variant for the given SKU, so its stock level cannot be set.
Resolution: Transfer the product variant to Linnworks (or confirm the SKU matches an existing Linnworks variant) before setting its stock level.
Unable to create product prerequisite
Unable to create Product for Variant Inventory. This will prevent the transfer of the product variant inventory.
Description: The integration attempted to create the product needed for the variant inventory transfer but the creation failed.
Resolution: Verify the product's required fields are mapped and valid, then retry. Contact iPaaS.com Support if the problem persists.
Product and Variant From iPaaS.com
Unable to create variation group
Unable to create variation group with variants in Linnworks and saved external ids in iPaaS.com.
Description: The integration attempted to create a variation-group product with its variants in Linnworks but the creation failed, so external IDs were not saved.
Resolution: Verify the variation group and variant fields are mapped and valid, then re-sync so the external IDs can be saved.
Unable to create inventory item
Unable to create inventory item in Linnworks and saved external ids in iPaaS.com.
Description: The integration attempted to create a product in Linnworks but the transfer failed, so external IDs were not saved.
Resolution: Verify the product's required fields are mapped and valid, then retry.
Unable to update inventory item
Unable to update inventory item in Linnworks and saved external ids in iPaaS.com.
Description: The integration attempted to update a product in Linnworks but the request failed, so the changes were not applied.
Resolution: Verify the product's required fields are mapped and valid, then retry.
Duplicate SKU
Item with this SKU already exists.
Description: Linnworks rejected a product or variant because a product with the same SKU already exists and duplicate handling is not enabled for the collection.
Resolution: Ensure each product or variant has a unique SKU, or enable duplicate handling on the mapping collection before transferring.
Unsupported collision match field
Collision matching is only supported by SKU.
Description: Raised when duplicate handling on the collection is configured to match on a field other than SKU, which is the only supported match field.
Resolution: Set the mapping collection's duplicate handling to match on SKU. Contact iPaaS.com Support if you need help.