baselinker

N8N community node for the BaseLinker API — orders, shipments, and inventory.

Package Information

Downloads: 63 weekly / 164 monthly
Latest Version: 0.1.0
Author: Aled

Documentation

n8n-nodes-baselinker

A community N8N node for the BaseLinker API.

Replaces Zapier for pushing tracking numbers and courier info from BigCommerce (or any source) into BaseLinker, plus order management and inventory updates.


Supported operations

Shipment

Operation API method Description
Add Manual Tracking createPackageManual Push a tracking number and courier name to an existing order

Order

Operation API method Description
Get Orders getOrders Retrieve orders with optional filters (date, status, email, etc.)
Update Status setOrderStatus Change an order's status
Update Fields setOrderFields Edit delivery address, notes, payment method, and more

Inventory

Operation API method Description
Update Stock updateInventoryProductsStock Bulk update product stock levels in a catalogue
Update Prices updateInventoryProductsPrices Bulk update product prices in a catalogue

Installation

Option A — N8N community nodes UI (self-hosted)

  1. Go to Settings → Community Nodes → Install.
  2. Enter n8n-nodes-baselinker and click Install.

Option B — manual (self-hosted)

cd ~/.n8n/custom  # or your custom nodes directory
npm install n8n-nodes-baselinker

Restart N8N after installing.


Credentials

Generate your API token in BaseLinker: Account & other → My account → API.

In N8N, add new credentials of type BaseLinker API and paste the token.


Typical workflow: BigCommerce → BaseLinker tracking

This replicates the Zapier flow you were running:

BigCommerce Trigger (shipment created)
  └─► BaseLinker › Shipment › Add Manual Tracking
        order_id      = {{ $json.baselinker_order_id }}
        courier_code  = {{ $json.shipping_provider }}
        tracking_number = {{ $json.tracking_number }}

You'll need to map the BigCommerce order to a BaseLinker order ID. The cleanest approach is to store the BaseLinker order ID as a custom field in BigCommerce when the order is first synced, then reference it here.


Building from source

npm install
npm run build

The compiled output lands in /dist. Point N8N at the package root.


API rate limits

BaseLinker allows 100 requests per minute. For bulk inventory operations, batch your products — the API accepts up to 1,000 products per request.


Useful BaseLinker API methods to call manually for setup

  • getCouriersList — get valid courier codes for your account
  • getOrderStatusList — get status IDs to use with Update Status
  • getInventories — get inventory/catalogue IDs for stock/price updates

Discussion