Importing Suppliers into Linnworks

The Import Suppliers task lets you import supplier records from your input file and create or update them in Linnworks based on your task configuration. Use this when you need to add new suppliers or keep existing supplier details in sync.

This article explains how the task works and what data it expects.

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 you can import. Only SupplierName is required for creation; include Id to target a specific existing supplier for update. Other fields are optional and will be passed to Linnworks if provided.

Create or Update by SupplierName / Email

<?xml version="1.0" encoding="utf-8"?>
<Suppliers>
  <Supplier>
    <SupplierName>Acme Supplies</SupplierName>
    <Email>[email protected]</Email>
    <Telephone>+44 191 555 0100</Telephone>
    <Website>https://www.acme.example</Website>
    <Address>1 Industrial Estate</Address>
    <City>Newcastle</City>
    <Region>Tyne and Wear</Region>
    <PostCode>NE1 1AA</PostCode>
    <Country>United Kingdom</Country>
    <Notes>Main stationery supplier</Notes>
  </Supplier>
</Suppliers>

Update an existing supplier by Id

<?xml version="1.0" encoding="utf-8"?>
<Suppliers>
  <Supplier>
    <Id>c151db43-f0e4-49b5-a8e8-01c956a92505</Id>
    <SupplierName>Acme Supplies</SupplierName>
    <Email>[email protected]</Email>
    <Telephone>+44 191 555 0199</Telephone>
    <Notes>Updated accounts contact</Notes>
  </Supplier>
</Suppliers>