jprdonnelly/airbyte
1
0
Fork 0
mirror of synced 2025-12-21 11:01:41 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
bmoric/schema-mapping-postgres
airbyte/docs/integrations/sources/linnworks.md
octavia-bot-hoard[bot] d67e829ecd 🐙 source-linnworks: run up-to-date pipeline [2025-10-14] (#68061) 
# Update source-linnworks

This PR was autogenerated by running `airbyte-ci connectors
--name=source-linnworks up_to_date --pull`

We've set the `auto-merge` label on it, so it will be automatically
merged if the CI pipelines pass.
If you don't want to merge it automatically, please remove the
`auto-merge` label.
Please reach out to the Airbyte Connector Tooling team if you have any
questions or concerns.


## Operations

- Upgrade the base image to the latest version in metadata.yaml: Skipped

- Update versions of libraries in poetry: Successful

- PATCH bump source-linnworks version to 0.1.66: Successful

- Build source-linnworks docker image for platform(s) linux/amd64,
linux/arm64: Successful

- Get dependency updates: Successful

- Create or update pull request on Airbyte repository: Successful

- Add changelog entry: Successful




## Dependency updates

We use [`syft`](https://github.com/anchore/syft) to generate a SBOM for
the latest connector version and the one from the PR.
It allows us to spot the dependencies that have been updated at all
levels and for all types of dependencies (system, python, java etc.).
Here are the dependencies that have been updated compared to
`airbyte/source-linnworks:latest`.
Keep in mind that `:latest` does not always match the connector code on
the main branch.
It is the latest released connector image when the head commit of this
branch was created.

| Type | Name | State | Previous Version | New Version |
|------|------|-------|-------------|------------------|
| python | MarkupSafe | updated | 3.0.2 | **3.0.3** |
| python | PyYAML | updated | 6.0.2 | **6.0.3** |
| python | attrs | updated | 25.3.0 | **25.4.0** |
| python | cachetools | updated | 6.1.0 | **6.2.1** |
| python | cattrs | updated | 25.1.1 | **25.3.0** |
| python | certifi | updated | 2025.8.3 | **2025.7.9** |
| python | charset-normalizer | updated | 3.4.3 | **3.4.4** |
| python | idna | updated | 3.10 | **3.11** |
| python | multidict | updated | 6.6.4 | **6.7.0** |
| python | platformdirs | updated | 4.3.8 | **4.4.0** |
| python | propcache | updated | 0.3.2 | **0.4.1** |
| python | pydantic | updated | 1.10.22 | **1.10.24** |
| python | requests | updated | 2.32.4 | **2.32.5** |
| python | typing_extensions | updated | 4.14.1 | **4.15.0** |
| python | yarl | updated | 1.20.1 | **1.22.0** |
| python | source-linnworks | removed | 0.1.60 | **not present** |

> [!IMPORTANT]
> **Auto-merge enabled.**
> 
> _This PR is set to merge automatically when all requirements are met._

Co-authored-by: octavia-bot-hoard[bot] <230633153+octavia-bot-hoard[bot]@users.noreply.github.com>
2025-10-14 16:11:48 -04:00

145 lines
11 KiB
Markdown
Raw Permalink Blame History

# Linnworks
This page contains the setup guide and reference information for the [Linnworks](https://www.linnworks.com) source connector.
## Prerequisites
- A Linnworks account
## Setup guide
### Generate Credentials in Linnworks
1. The Linnworks platform has two portals: Seller and Developer. To generate the necessary credentials, log in to the [developer portal](https://developer.linnworks.com) and select **+ New App**.
2. Input a name for your application and set the **Application Type** to `System Integration`.
3. 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
1. Log in to your [Airbyte Cloud](https://cloud.airbyte.com/workspaces) or Airbyte Open Source account.
2. From the Airbyte UI, click **Sources** > **+ New Source**.
3. Select **Linnworks** from the list of available sources.
4. Enter a **Name** of your choosing.
5. Enter your **Application ID**, **Application Secret** and **API Token**.
6. Enter a **Start date** using the provided datepicker. When using Incremental sync mode, only data generated after this date will be fetched.
7. 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](https://docs.airbyte.com/cloud/core-concepts/#connection-sync-mode):
| Stream Name | Full Refresh | Incremental |
| :--------------------------------------------------------------------------------------------- | :----------- | :---------- |
| [ProcessedOrders](https://apps.linnworks.net/Api/Method/ProcessedOrders-SearchProcessedOrders) | ✓ | ✓ |
| [ProcessedOrderDetails](https://apps.linnworks.net/Api/Method/Orders-GetOrdersById) | ✓ | ✓ |
| [StockItems](https://apps.linnworks.net//Api/Method/Stock-GetStockItemsFull) | ✓ | X |
| [StockLocations](https://apps.linnworks.net/Api/Method/Inventory-GetStockLocations) | ✓ | X |
| [StockLocationDetails](https://apps.linnworks.net/Api/Method/Locations-GetLocation) | ✓ | 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
<details>
<summary>
Expand to see details about Linnworks connector limitations and troubleshooting
</summary>
### Rate limits
Rate limits for the Linnworks API vary across endpoints. Use the [links in the **Supported Streams** table](#supported-streams-and-sync-modes) 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.
</details>
## Changelog
<details>
<summary>Expand to review</summary>
| Version | Date | Pull Request | Subject |
| :------ | :--------- | :------------------------------------------------------- | :-------------------------------------------------------------------------- |
| 0.1.66 | 2025-10-14 | [68061](https://github.com/airbytehq/airbyte/pull/68061) | Update dependencies |
| 0.1.65 | 2025-10-07 | [67530](https://github.com/airbytehq/airbyte/pull/67530) | Update dependencies |
| 0.1.64 | 2025-09-30 | [66816](https://github.com/airbytehq/airbyte/pull/66816) | Update dependencies |
| 0.1.63 | 2025-09-24 | [66657](https://github.com/airbytehq/airbyte/pull/66657) | Update dependencies |
| 0.1.62 | 2025-09-09 | [66059](https://github.com/airbytehq/airbyte/pull/66059) | Update dependencies |
| 0.1.61 | 2025-08-23 | [65379](https://github.com/airbytehq/airbyte/pull/65379) | Update dependencies |
| 0.1.60 | 2025-08-16 | [64985](https://github.com/airbytehq/airbyte/pull/64985) | Update dependencies |
| 0.1.59 | 2025-08-09 | [64611](https://github.com/airbytehq/airbyte/pull/64611) | Update dependencies |
| 0.1.58 | 2025-07-19 | [63494](https://github.com/airbytehq/airbyte/pull/63494) | Update dependencies |
| 0.1.57 | 2025-07-12 | [63107](https://github.com/airbytehq/airbyte/pull/63107) | Update dependencies |
| 0.1.56 | 2025-07-05 | [62568](https://github.com/airbytehq/airbyte/pull/62568) | Update dependencies |
| 0.1.55 | 2025-06-28 | [62153](https://github.com/airbytehq/airbyte/pull/62153) | Update dependencies |
| 0.1.54 | 2025-06-21 | [61854](https://github.com/airbytehq/airbyte/pull/61854) | Update dependencies |
| 0.1.53 | 2025-06-14 | [61076](https://github.com/airbytehq/airbyte/pull/61076) | Update dependencies |
| 0.1.52 | 2025-05-24 | [59903](https://github.com/airbytehq/airbyte/pull/59903) | Update dependencies |
| 0.1.51 | 2025-05-03 | [59265](https://github.com/airbytehq/airbyte/pull/59265) | Update dependencies |
| 0.1.50 | 2025-04-26 | [58771](https://github.com/airbytehq/airbyte/pull/58771) | Update dependencies |
| 0.1.49 | 2025-04-19 | [58202](https://github.com/airbytehq/airbyte/pull/58202) | Update dependencies |
| 0.1.48 | 2025-04-12 | [57753](https://github.com/airbytehq/airbyte/pull/57753) | Update dependencies |
| 0.1.47 | 2025-04-05 | [57089](https://github.com/airbytehq/airbyte/pull/57089) | Update dependencies |
| 0.1.46 | 2025-03-29 | [56649](https://github.com/airbytehq/airbyte/pull/56649) | Update dependencies |
| 0.1.45 | 2025-03-22 | [56053](https://github.com/airbytehq/airbyte/pull/56053) | Update dependencies |
| 0.1.44 | 2025-03-08 | [55464](https://github.com/airbytehq/airbyte/pull/55464) | Update dependencies |
| 0.1.43 | 2025-03-01 | [54760](https://github.com/airbytehq/airbyte/pull/54760) | Update dependencies |
| 0.1.42 | 2025-02-22 | [54365](https://github.com/airbytehq/airbyte/pull/54365) | Update dependencies |
| 0.1.41 | 2025-02-15 | [53815](https://github.com/airbytehq/airbyte/pull/53815) | Update dependencies |
| 0.1.40 | 2025-02-01 | [52725](https://github.com/airbytehq/airbyte/pull/52725) | Update dependencies |
| 0.1.39 | 2025-01-25 | [51807](https://github.com/airbytehq/airbyte/pull/51807) | Update dependencies |
| 0.1.38 | 2025-01-11 | [51157](https://github.com/airbytehq/airbyte/pull/51157) | Update dependencies |
| 0.1.37 | 2024-12-28 | [50634](https://github.com/airbytehq/airbyte/pull/50634) | Update dependencies |
| 0.1.36 | 2024-12-21 | [50148](https://github.com/airbytehq/airbyte/pull/50148) | Update dependencies |
| 0.1.35 | 2024-12-14 | [48880](https://github.com/airbytehq/airbyte/pull/48880) | Update dependencies |
| 0.1.34 | 2024-11-25 | [48665](https://github.com/airbytehq/airbyte/pull/48665) | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.1.33 | 2024-11-04 | [48271](https://github.com/airbytehq/airbyte/pull/48271) | Update dependencies |
| 0.1.32 | 2024-10-29 | [47877](https://github.com/airbytehq/airbyte/pull/47877) | Update dependencies |
| 0.1.31 | 2024-10-28 | [47116](https://github.com/airbytehq/airbyte/pull/47116) | Update dependencies |
| 0.1.30 | 2024-10-12 | [46798](https://github.com/airbytehq/airbyte/pull/46798) | Update dependencies |
| 0.1.29 | 2024-10-05 | [46406](https://github.com/airbytehq/airbyte/pull/46406) | Update dependencies |
| 0.1.28 | 2024-09-28 | [46124](https://github.com/airbytehq/airbyte/pull/46124) | Update dependencies |
| 0.1.27 | 2024-09-21 | [45730](https://github.com/airbytehq/airbyte/pull/45730) | Update dependencies |
| 0.1.26 | 2024-09-14 | [45571](https://github.com/airbytehq/airbyte/pull/45571) | Update dependencies |
| 0.1.25 | 2024-09-07 | [45262](https://github.com/airbytehq/airbyte/pull/45262) | Update dependencies |
| 0.1.24 | 2024-08-31 | [44968](https://github.com/airbytehq/airbyte/pull/44968) | Update dependencies |
| 0.1.23 | 2024-08-24 | [44740](https://github.com/airbytehq/airbyte/pull/44740) | Update dependencies |
| 0.1.22 | 2024-08-17 | [44304](https://github.com/airbytehq/airbyte/pull/44304) | Update dependencies |
| 0.1.21 | 2024-08-10 | [43604](https://github.com/airbytehq/airbyte/pull/43604) | Update dependencies |
| 0.1.20 | 2024-08-03 | [43183](https://github.com/airbytehq/airbyte/pull/43183) | Update dependencies |
| 0.1.19 | 2024-07-27 | [42608](https://github.com/airbytehq/airbyte/pull/42608) | Update dependencies |
| 0.1.18 | 2024-07-20 | [42235](https://github.com/airbytehq/airbyte/pull/42235) | Update dependencies |
| 0.1.17 | 2024-07-13 | [41778](https://github.com/airbytehq/airbyte/pull/41778) | Update dependencies |
| 0.1.16 | 2024-07-10 | [41432](https://github.com/airbytehq/airbyte/pull/41432) | Update dependencies |
| 0.1.15 | 2024-07-09 | [41219](https://github.com/airbytehq/airbyte/pull/41219) | Update dependencies |
| 0.1.14 | 2024-07-06 | [40870](https://github.com/airbytehq/airbyte/pull/40870) | Update dependencies |
| 0.1.13 | 2024-06-26 | [40549](https://github.com/airbytehq/airbyte/pull/40549) | Migrate off deprecated auth package |
| 0.1.12 | 2024-06-25 | [40275](https://github.com/airbytehq/airbyte/pull/40275) | Update dependencies |
| 0.1.11 | 2024-06-22 | [40146](https://github.com/airbytehq/airbyte/pull/40146) | Update dependencies |
| 0.1.10 | 2024-06-06 | [39196](https://github.com/airbytehq/airbyte/pull/39196) | [autopull] Upgrade base image to v1.2.2 |
| 0.1.9 | 2024-04-19 | [37188](https://github.com/airbytehq/airbyte/pull/37188) | Updating to 0.80.0 CDK |
| 0.1.8 | 2024-04-12 | [37188](https://github.com/airbytehq/airbyte/pull/37188) | schema descriptions |
| 0.1.7 | 2024-02-22 | [35557](https://github.com/airbytehq/airbyte/pull/35557) | Manage dependencies with Poetry |
| 0.1.6 | 2024-01-31 | [34717](https://github.com/airbytehq/airbyte/pull/34717) | Update CDK and migrate to base image |
| 0.1.5 | 2022-11-20 | [19865](https://github.com/airbytehq/airbyte/pull/19865) | Bump Version |
| 0.1.4 | 2021-11-24 | [8226](https://github.com/airbytehq/airbyte/pull/8226) | Source Linnworks: improve streams ProcessedOrders and ProcessedOrderDetails |
| 0.1.3 | 2021-11-24 | [8169](https://github.com/airbytehq/airbyte/pull/8169) | Source Linnworks: refactor stream StockLocations |
| 0.1.2 | 2021-11-23 | [8177](https://github.com/airbytehq/airbyte/pull/8177) | Source Linnworks: add stream ProcessedOrderDetails |
| 0.1.0 | 2021-11-09 | [7588](https://github.com/airbytehq/airbyte/pull/7588) | New Source: Linnworks |
</details>
Reference in New Issue View Git Blame Copy Permalink