Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connection.

BaseLinker

The BaseLinker modules allow you to monitor, create, update, send, retrieve, list, and delete the orders, invoices, payments, and packages in your BaseLinker account.

Getting Started with BaseLinker

Prerequisites

[Note] Note
The module dialog fields that are displayed in bold (in the Boost.space Integrator scenario, not in this documentation article) are mandatory!

Connecting BaseLinker to Boost.space Integrator

To connect your BaseLinker account to Boost.space Integrator you need to obtain the API Key from your BaseLinker account and insert it in the Create a connection dialog in the Boost.space Integrator module.

1. Log in to your BaseLinker account.

2. Click Your Profile Icon > My Account > API.

3. Enter a name for the API and click Generate Token and copy the API Key to your clipboard.

61d5a8ba31e5b.gif

4. Go to Boost.space Integrator and open the BaseLinker module’s Create a connection dialog.

61d5a8bea7902.gif

5. In the Connection name field, enter a name for the connection.

6. In the API Key field, enter the API Key copied in step 3 and click Continue.

The connection has been established.

Orders

Watch New Orders

Triggers when a new order has been added.


Connection
Establish a connection to your BaseLinker account.

Limit
Set the maximum number of new orders Boost.space Integrator should return during one execution cycle.

Search Orders

Searches for orders or lists them all.


Connection
Establish a connection to your BaseLinker account.

Date Confirmed from
Enter (map) the date to search the orders that were confirmed on or after the specified date.

Date from
Enter (map) the date to search the order from the specified date.

Order ID from
Select or map the Order ID whose details you want to search.

Get Unconfirmed Orders
Select whether you want to search for the unconfirmed orders.

Status ID
Select or map the Status ID to list the orders with the specified status.

Filter by Email
Enter (map) the email address to list the orders that match the specified email address.

Limit
Set the maximum number of orders Boost.space Integrator should return during one execution cycle.

Get an Order

Retrieves a single order specified by ID.


Connection
Establish a connection to your BaseLinker account.

Order ID
Select or map the Order ID whose details you want to retrieve.

Create an Order

Creates a new order.


Connection
Establish a connection to your BaseLinker account.

Order Status ID
Select or map the status of the order.

Phone
Enter (map) the customer’s phone number.

Email
Enter (map) the customer’s email address.

Date Add
Enter (map) the date on which the order is being created.

User Comments
Enter (map) the notes for the order.

Admin Comments
Enter (map) the admin notes for the order.

Currency
Select or map the currency code applicable for the order.

Payment Method
Enter (map) the payment method for the order.

Payment Method Code
Select whether the payment method code is cash on delivery (payment on delivery).

Paid
Select whether the order is already paid.

Delivery Method
Enter (map) the delivery method of the order.

Delivery Price
Enter (map) the charges for the delivery of the order.

Delivery Full Name
Enter (map) the contact person’s full name to mention in the delivery address.

Delivery Company
Enter (map) the company name to mention in the delivery address.

Delivery Address
Enter (map) the order’s delivery address.

Delivery City
Enter (map) the city name to mention in the delivery address.

Delivery Postal Code
Enter (map) the delivery address postal code.

Delivery Point ID
Enter (map) the delivery pickup point ID.

Delivery Point Name
Enter (map) the delivery pickup point name.

Delivery Point Address
Enter (map) the delivery pickup point address.

Delivery Point PostCode
Enter (map) the delivery pickup point postal code.

Delivery Point City
Enter (map) the delivery pickup point city name.

Invoice Full Name
Enter (map) the billing address contact person’s full name.

Invoice Company
Enter (map) the billing address company name.

Invoice NIP
Enter (map) the billing address company’s VAT or tax number.

Invoice Address
Enter (map) the billing address.

Invoice City
Enter (map) the billing address city name.

Invoice Country Code
Select or map the billing address country code.

Want Invoice
Select whether the customer wants the invoice copy.

Extra Field 1
Enter (map) any additional fields you want to add.

Extra Field 2
Enter (map) any additional fields you want to add.

Products
Add the products to the order:


Storage
Select or map the product storage:


  • BaseLinker Database

  • Web Shop

  • Connected Wholesaler

Storage ID
Select or map the Storage ID.

Product ID
Select or map the Product ID.

Variant ID
Enter (map) the product Variant ID. Leave the field if the product variant is unknown.

Name
Enter (map) the product name.

SKU
Enter (map) the product’s SKU number.

EAN
Enter (map) the product’s EAN number.

Price Brutto
Enter (map) single item gross price.

Tax Rate
Enter (map) the product’s VAT rate.z

Quantity
Enter (map) the number of pieces of the product.

Weight
Enter (map) the single item weight in grams.

Invoices and Payments

Watch New Series

Triggers when a new invoice numeration series have been added.


Connection
Establish a connection to your BaseLinker account.

Limit
Set the maximum number of series Boost.space Integrator should return during one execution cycle.

Search Invoices

Searches for invoices or lists them all.


Connection
Establish a connection to your BaseLinker account.

Invoice ID
Select or map the Invoice ID whose details you want to search.

Invoice ID from
Select or map the option to search the invoices collected from the specified option.

Date from
Select or map the date to search the invoices collected from the specified date.

Order ID
Select or map the Order ID whose invoices you want to search.

Get External Invoices
Select whether you want to get the external invoices.

Series ID
Select or map the Series ID number to search the invoices with the specified ID.

Limit
Set the maximum number of invoices Boost.space Integrator should return during one execution cycle.

Add an Invoice to an Order

Adds an invoice to an order specified by ID.


Connection
Establish a connection to your BaseLinker account.

Order ID
Select or map the Order ID to which you want to add the invoice.

Series ID
Select or map the Series ID of the invoice you want to add.

Add a Payment to an Order

Adds a payment to an order specified by ID.


Connection
Establish a connection to your BaseLinker account.

Order ID
Select or map the Order ID to which you want to add the payment information.

Payment Done
Enter (map) the payment deposit amount. The value replaces the current payment in the order (it is not added up with the previous value). If the amount matches the order value, the order will be marked as paid.

Payment Date
Enter (map) the date on which the payment for the invoice is made.

Payment Comment
Enter (map) any additional information or notes about the payment.

Packages

List Packages

Lists all order packages.


Connection
Establish a connection to your BaseLinker account.

Order ID
Select or map the Order ID whose packages you want to list.

Limit
Set the maximum number of packages Boost.space Integrator should return during one execution cycle.

Create a Package

Creates a new package.


Connection
Establish a connection to your BaseLinker account.

Order ID
Select or map the Order ID for which you want to create the package.

Courier Code
Select or map the courier service through the package is being sent and enter the fields that auto-populate based on your selection.

Packages
Add the package details:


Weight
Enter (map) the weight of the package in centimeters.

Length
Enter (map) the length of the package in centimeters.

Height
Enter (map) the height of the package in centimeters.

Width
Enter (map) the width of the package in centimeters.

Delete a Package

Deletes a package.


Connection
Establish a connection to your BaseLinker account.

Courier Code
Select or map the Order ID whose packages you want to delete.

Order ID
Select or map the order whose package you want to delete.

Select Package By
Select or map the options to choose the package you want to delete:


  • Package ID

  • Package Number

Package ID
Select or map the Package ID you want to delete.

Package Number
Select or map the Package Number you want to delete.

Force Delete
Select whether you want to remove the parcel from the BaseLinker database in case of an error with the removal of the parcel in the courier API.

Other

Make an API Call

Performs an arbitrary authorized API call.


Connection
Establish a connection to your BaseLinker account.

Method
Enter the method you want to call. For example: getOrders

For the list of available endpoints, refer to the BaseLinker API Documentation.


Headers
Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.

Parameters
Enter (map) the parameters you want to retrieve.

Query String
Enter the request query string.

Example of Use – Get Invoices

The following API call returns all the invoices from your BaseLinker account:

MethodgetInvoices

61d5a8c128ce1.png

Matches of the search can be found in the module’s Output under Bundle > Body > invoices. In our example, 2 invoices were returned:

61d5a8c26c9e1.png