baselinker

BaseLinker

Drive the BaseLinker API through the baselinker CLI. The whole API (~150 methods) is reachable through one universal command; you discover method names and params on demand.

Setup (once)

The CLI needs a token (BaseLinker panel -> My account -> API):

baselinker auth set <TOKEN>      # stored in ~/.config/baselinker/config.json
# or export BASELINKER_TOKEN=<TOKEN>

If baselinker is not installed: pipx install baselinker-mcp.

Workflow

1. Discover the method you need:

   baselinker methods              # all methods
   baselinker methods order        # filter by name or category substring
   baselinker methods inventory
   baselinker methods courier
   

   Each row is: methodName Category description.

2. Call it with JSON params:

   baselinker call <method> --params '<json>'
   

   Output is the raw JSON response. On API errors the CLI prints [ERROR_CODE] message and exits 1.

Common recipes

# New / unconfirmed orders
baselinker call getOrders --params '{"get_unconfirmed_orders": true}'

# Orders from a unix timestamp
baselinker call getOrders --params '{"date_confirmed_from": 1718000000}'

# Change order status
baselinker call setOrderStatus --params '{"order_id": 123456, "status_id": 4567}'

# List catalogs, then products in one
baselinker call getInventories
baselinker call getInventoryProductsList --params '{"inventory_id": 107776}'

# Update stock (products keyed by product_id, then warehouse->qty)
baselinker call updateInventoryProductsStock \
  --params '{"inventory_id": 107776, "products": {"PRODUCT_ID": {"bl_143933": 25}}}'

# Update prices
baselinker call updateInventoryProductsPrices \
  --params '{"inventory_id": 107776, "products": {"PRODUCT_ID": {"PRICE_GROUP_ID": 99.00}}}'

# Couriers + create a package + get label
baselinker call getCouriersList
baselinker call createPackage --params '{"order_id": 123456, "courier_code": "...", "fields": [], "packages": []}'
baselinker call getLabel --params '{"courier_code": "...", "package_id": 999}'

# Invoices
baselinker call getInvoices --params '{"id_from": 0}'
baselinker call addInvoice --params '{"order_id": 123456, "series_id": 0}'