Linnworks
This page contains the setup guide and reference information for the Linnworks source connector.
Prerequisites
- A Linnworks account
Setup guide
Generate Credentials in Linnworks
- The Linnworks platform has two portals: Seller and Developer. To generate the necessary credentials, log in to the developer portal and select + New App.
- Input a name for your application and set the Application Type to
System Integration. - Select Edit for your new application. In the General tab, find and copy your Application ID and Application Secret. Click on the Installation URL to complete the installation of your app and acquire your API Token.
tip
The value of your API Token can be viewed at any time from the main dashboard of your account, listed in your app's Installs table.
Set up the connector in Airbyte
- Log in to your Airbyte Cloud or Airbyte Open Source account.
- From the Airbyte UI, click Sources > + New Source.
- Select Linnworks from the list of available sources.
- Enter a Name of your choosing.
- Enter your Application ID, Application Secret and API Token.
- Enter a Start date using the provided datepicker. When using Incremental sync mode, only data generated after this date will be fetched.
- Select Set up source and wait for the connection test to complete.
Supported streams and sync modes
The Linnworks source connector supports the following streams and sync modes:
| Stream Name | Full Refresh | Incremental |
|---|---|---|
| ProcessedOrders | ✓ | ✓ |
| ProcessedOrderDetails | ✓ | ✓ |
| StockItems | ✓ | X |
| StockLocations | ✓ | X |
| StockLocationDetails | ✓ | X |
Data type mapping
| Integration Type | Airbyte Type | Example |
|---|---|---|
number | number | 50.23 |
integer | integer | 50 |
date | string | 2020-12-31 |
datetime | string | 2020-12-31T07:30:00 |
array | array | ["Item 1", "Item 2"] |
boolean | boolean | True/False |
string | string | Item 3 |
Limitations & Troubleshooting
Expand to see details about Linnworks connector limitations and troubleshooting
Rate limits
Rate limits for the Linnworks API vary across endpoints. Use the links in the Supported Streams table to view each endpoint's limits. Rate limited requests will receive a 429 response, but the Linnworks connector should not run into Linnworks API limitations under normal usage.
Reference
Config fields reference
Field
Type
Property name
string
application_id
string
application_secret
API Token
required
string
token
string
start_date
Changelog
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.1.7 | 2024-02-22 | 35557 | Manage dependencies with Poetry |
| 0.1.6 | 2024-01-31 | 34717 | Update CDK and migrate to base image |
| 0.1.5 | 2022-11-20 | 19865 | Bump Version |
| 0.1.4 | 2021-11-24 | 8226 | Source Linnworks: improve streams ProcessedOrders and ProcessedOrderDetails |
| 0.1.3 | 2021-11-24 | 8169 | Source Linnworks: refactor stream StockLocations |
| 0.1.2 | 2021-11-23 | 8177 | Source Linnworks: add stream ProcessedOrderDetails |
| 0.1.0 | 2021-11-09 | 7588 | New Source: Linnworks |