# Baselinker

<figure><img src="/files/iZTPVTD8PMfHKQmnC15F" alt=""><figcaption><p>Installed baselinker app</p></figcaption></figure>

## Introduction

The **Baselinker App** bridges the gap between **Ergondoe PIM** and **Baselinker**, enabling data exchange via API. Designed to enhance your workflow, this app simplifies configuration and synchronization.

{% hint style="info" %}
Please be aware that Base (formerly Baselinker) API is limited to x requests per minute (depending on the package), so when you get a synchronization error, please check your API usage before reporting an error to us. To do so, please go to <https://panel-d.baselinker.com/other_api_token.php>. If this happens, please wait till the restrictions are lifted and synchronize the app again.
{% endhint %}

{% hint style="warning" %}
Base (formerly Baselinker) allows for an image to have a maximum size of 2MB, but for them to host a file, it must be sent in binary (base64) format. This conversion adds a significant amount of data to the image (30-40%). So, if you receive an error about file size during synchronization, that is the reason. The safe image size to send should be around 1.3MB.
{% endhint %}

{% hint style="danger" %}
Base (formerly Baselinker) allows multiple products to share the same SKU. However, Ergonode PIM does not support duplicate SKUs. If your Base account contains products or/and sets with identical SKUs, the synchronization app will not be able to process these products. To ensure proper synchronization, please make sure all products or/and in Base have unique SKUs.
{% endhint %}

## Key Features

* **Customizable Application Name**: Personalize your app instance by assigning a unique name.
* **Segment Selection**: Choose the relevant segment from the dropdown menu. Refer to the separate [Segments](/products/segments.md) page for detailed information on segments.
* **Configuration Wizard.**

{% hint style="success" %}
If a product with the same SKU exists in Baselinker and Ergonode PIM, it will be matched during the synchronization, and the mapped attributes from this product will be updated in Baselinker.
{% endhint %}

## **Additional Functions**

<figure><img src="/files/wSOmGp7qRbMVkxzDyHWR" alt=""><figcaption></figcaption></figure>

* **Run sync** – Manually trigger an incremental synchronization.
* **Run full sync** – Manually trigger a full synchronization.

<figure><img src="/files/HznZGvClymoUK0I8OCic" alt=""><figcaption></figcaption></figure>

* **Clear Cache** – Use this option to **trigger the first full synchronization during the next synchronization** (the extended process). When activated, it also allows you to modify the selected segment in the **Options** tab.

{% hint style="warning" %}
Changing the segment after initial synchronization may result in data loss in the Baselinker, and it's not recommended.
{% endhint %}

* **Delete App** – Use this option to **uninstall the app** and **remove all configurations** permanently. This action **cannot be undone**, so proceed with caution.

## Running the app

**Step 1: Configuration** Begin by navigating through the [**Options** ](/apps/about-apps-feature/available-apps/baselinker/options.md)and [**Configuration** ](/apps/about-apps-feature/available-apps/baselinker/configuration.md)section to tailor the app settings to your needs. Detailed explanations for each option and configuration can be found on linked pages.

**Step 2: Running the App** Once you’ve set up your preferences, click the ***Run synchronization*** button in the top-right corner to initiate synchronization processes.

**Step 3: History** After initiating a synchronization, the app will log an entry in the [**History** ](/apps/about-apps-feature/available-apps/baselinker/history.md)tab.

## Known app limitations

* Baselinker API limits can cause synchronization errors.  If this happens please wait till the restrictions are lifted and synchronize the app again.
* There is no way for now to limit the categories that are sent to Baselinker (all categories from the Ergonode PIM are sent).
* In select and multiselect attribute types, the options translations must be all lowercase letters.
* As SKU is a main identifier in Ergonode PIM, its value will not be sent to the mapped attribute in the Baselinker (it will always be sent as SKU).
* Unit type attributes can only be mapped with attributes of the same type on the Baselinker side (weight, height, width, length) and only if the attribute units in Ergonode correspond to those in Baselinker.
* **Maximum image size**: The correct limit for image size in Baselinker is **2MB.**
* The App does not support custom parameters created manually within your BaseLinker account.

{% hint style="info" %}
Since this is a basic connector it may not cover all needs. In case that happens, we could connect you with one of our partners for more custom solutions.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://usermanual.ergonode.com/apps/about-apps-feature/available-apps/baselinker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
