Importing Open Orders into Linnworks

The Import Orders task lets you import open orders from your input file and create or update them in Linnworks based on your task configuration. Use this to bring new channel orders into Linnworks or to enrich/update existing open orders.

Connection

Required
The Linnworks connection you would like to use for this task.

See the Connecting to Linnworks article for how to set up a connection to Linnworks.

Fail File

Required
Specifies the file where records that fail to process will be written.

This file captures any records that encountered errors during the import process, allowing you to easily identify and address issues. You can review the failed records later and take corrective action if needed.

Input File

Required
Defines the file containing the records to be imported and processed by the task.

The task will read and process the data from this file, applying any filters or conditions specified in the task settings. You can configure the input file format to match your data source, such as CSV, Excel, or other supported formats.

Success File

Required
Specifies the file where records that are successfully processed will be written.

These records are marked as successfully imported and can be used for tracking, reporting, or integration with other systems. The success file helps to clearly distinguish between successfully processed data and those that failed.

Prevent Reprocessing

Required
When enabled, this setting ensures that records are matched based on their external identifiers and prevents them from being reprocessed.

If a record with the same external ID has already been processed, it will be excluded from future imports, ensuring that the task doesn’t unnecessarily process the same record multiple times.

Zynk Settings

See Common Task Settings.

XML

Below are example payloads. Include only the sections and fields you need; the task will pass them to Linnworks.

<?xml version="1.0" encoding="utf-8"?>
<OpenOrders>
  <OpenOrder>
    <GeneralInfo>
      <Source>WEB</Source>
      <SubSource>Magento</SubSource>
      <ReferenceNum>WEB-100045</ReferenceNum>
      <ReceivedDate>2025-08-29T10:12:00</ReceivedDate>
      <DespatchByDate>2025-09-02T17:00:00</DespatchByDate>
      <PaymentStatus>Paid</PaymentStatus>
      <StateName>None</StateName>
      <StatusName>Open</StatusName>
      <LocationName>Default</LocationName>
      <IsParked>false</IsParked>
    </GeneralInfo>
    <CustomerInfo>
      <ChannelBuyerName>Jane Doe</ChannelBuyerName>
      <Address>
        <Address1>1 Industrial Estate</Address1>
        <Address2>Unit 4</Address2>
        <Address3>West Park</Address3>
        <Region>Tyne and Wear</Region>
        <PostCode>NE1 1AA</PostCode>
        <PhoneNumber>+44 191 555 0100</PhoneNumber>
      </Address>
      <BillingAddress>
        <Address1>Accounts Dept</Address1>
        <Address2>2 High Street</Address2>
        <Address3>City Centre</Address3>
        <Region>Tyne and Wear</Region>
        <PostCode>NE1 1AB</PostCode>
        <PhoneNumber>+44 191 555 0199</PhoneNumber>
      </BillingAddress>
    </CustomerInfo>
    <ShippingInfo>
      <PostalServiceName>Royal Mail 24</PostalServiceName>
      <Vendor>Royal Mail</Vendor>
      <TrackingNumber>RM123456789GB</TrackingNumber>
    </ShippingInfo>
    <Items>
      <OrderItem>
        <ChannelSKU>WIDGET-BLUE</ChannelSKU>
        <Title>Widget Blue</Title>
        <Quantity>2</Quantity>
        <Cost>12.50</Cost>
        <TaxRate>20</TaxRate>
        <Discount>0</Discount>
        <IsService>false</IsService>
      </OrderItem>
      <OrderItem>
        <ItemNumber>SVC-INSTALL</ItemNumber>
        <Title>Installation Service</Title>
        <Quantity>1</Quantity>
        <Cost>30.00</Cost>
        <IsService>true</IsService>
      </OrderItem>
    </Items>
    <TotalsInfo>
      <Subtotal>55.00</Subtotal>
      <Tax>11.00</Tax>
      <TotalDiscount>0.00</TotalDiscount>
      <TotalCharge>66.00</TotalCharge>
      <ShippingCharge>11.00</ShippingCharge>
      <Currency>GBP</Currency>
    </TotalsInfo>
    <ExtendedProperties>
      <ExtendedProperty>
        <Name>GiftMessage</Name>
        <Value>Happy Birthday!</Value>
        <Type>Text</Type>
      </ExtendedProperty>
    </ExtendedProperties>
  </OpenOrder>
</OpenOrders>