BaseLinker integration - the new generator

Data publikacji: 14 May 2024

You only need a LIGHT file to carry out the integration - Baselinker already has a Basic file directly from us. 

How the integration with the IKONKA wholesaler works

The IKONKA wholesaler can be found in the list of wholesalers in the BaseLinker system administration panel. By following the tutorial below, you will gain access to all materials and successfully integrate your offer.

Important! To use the integration, you must be registered with a wholesaler: https://www.ikonka.eu/en/registration.html

Once you have completed the form, expect a return message to the email provided, this may take up to 24 hours.

You can easily integrate the BaseLinker system yourself. Use the instructions below. In a few simple steps you will have a complete product offer.

 

1) Log in and go to the XML generator: https://www.ikonka.eu/en/generator-xml.html

Once in, you will see the main panel:

Screen titled "GENERATOR XML". Options available:  Language: en-us  Currency: EUR  Heading: "You can download the finished version here!"  Tabs: XML (active), JSON.  XML section:  XML BASIC file url: https://noyrjrwgwrniaf.ikonka.eu/b041558f9ead01d18ec98147196f92e8acf8b238.xml?variant=b&lang=en-us&currency=EUR  XML LIGHT file url: https://noyrjrwgwrniaf.ikonka.eu/b041558f9ead01d18ec98147196f92e8acf8b238.xml?variant=l&lang=en-us&currency=EUR  Bottom note: "All files use UTF-8 encoding." Button: "Legend"

The link we will need is the link to the LIGHT XML file. Important! This is a ready-made file containing all the products in our offer.

Under the section with links to ready-made XML file versions, you will also find a list containing all the information about manufacturers required under the EU General Product Safety Regulation (GPSR):

Screen with heading: "You can download information about producers here!"  Active tab: XML  Label: "Producer XML file url:" Field with link: https://api.ikonka.eu/producers/b041558f9ead01d18ec98147196f92e8acf8b238.xml  Button with clipboard icon for copying the link.


!Please note that you will only need the LIGHT file to carry out the integration. BaseLinker has a BASIC file from us.

Breaking it down into separate files allows you to split the work of the integrator into two parts. The first BASIC file updates heavy data such as images and descriptions once a day, while with the LIGHT file the system performs an automatic stock synchronisation every hour. This minimises the risk of corruption, integration hangs and incorrect data being displayed.

2) Configuring the LIGHT file needed - i.e. what data will the file contain?

We can move the tiles with the product information as desired. In doing so, we create the order and list of information we need.

Important! To create the file, select configuration 2 - we will place the LIGHT file under this number.

Then drag the necessary tiles from the right-hand side ("Available fields") to the left-hand side - ("Selected fields"). At this stage of the configuration, select only the fields you want to update every hour of the LIGHT version - price, code, barcode, status, vat.

Screen with heading: "You can generate your personalized version here!" Subtext: "You can use up to 5 independent configurations simultaneously." Dropdown: Configuration: 2  Navigation tabs:  XML File  File configuration (active)  Product filtering  Latest Products  Two columns with fields:  Chosen fields:  Code  Barcode  Stock  VAT  Price  Available fields:  Discount group  Producer ID  Warnings  Name  Category  Description  Short description  Images  Delivery time  Quantity per carton  Next delivery  Volume  Weight  Too large for parcel locker


Done! Let's now move on to the next tab - goods filtering.

3) Merchandise filtering - i.e. what products will the file contain?

We see the message: This XML file should contain goods that meet the conditions:

Screen with heading: "You can generate your personalized version here!" Subtext: "You can use up to 5 independent configurations simultaneously." Dropdown: Configuration: 1  Navigation tabs:  XML File  File configuration  Product filtering (active)  Latest Products  Section: Filters Instruction text: "The XML file should contain products that meet the following conditions:"  Filter rows with three columns:  Field (first dropdown shows: name)  Operator (first dropdown shows: contains)  Value (empty text field)  Two additional dropdown rows with empty value fields.  Button: Save

We can generate any combination - e.g. all products from the warehouse with more than 10 items in stock.

 4) Check that the BaseLinker integration file works

 To verify that the integration file has been generated correctly, go back to the first tab XML FILE, copy the file and paste it into the browser window:

Screen with heading: "You can generate your personalized version here!" Subtext: "You can use up to 5 independent configurations simultaneously." Dropdown: Configuration: 1  Navigation tabs:  XML File (active, highlighted in green)  File configuration  Product filtering  Latest Products  Section with tabs: XML (active), JSON Label: "XML file url:" Field shows: link xml url Clipboard icon button for copying the link.  Footer text: "All files use UTF-8 encoding."


After a moment a string will appear:

Browser view of an XML file. Message at the top: "The given XML file does not contain any style information associated with it. Below is the document tree."  Displayed XML structure:<products>   <product>     <code>KX4268</code>     <barcode>5952410119047</barcode>     <stock>25</stock>     <vat>23</vat>     <price>6.89</price>   </product>   <product>     <code>KX4529</code>     <barcode>5901779367156</barcode>     <stock>0</stock>     <vat>23</vat>     <price>1.17</price>   </product>   <product>     <code>KX6598</code>     <barcode>6598</barcode>     <stock>0</stock>     <vat>23</vat>     <price>2.38</price>   </product>   <product>     <code>KX8062</code>     <barcode></barcode>     <stock>26</stock>     <vat>23</vat>     <price>2.02</price>   </product> </products>


DONE!



Subscribe to our newsletter!

We are not going to send you anything less than amazing or important

The administrator of your personal data is KIK sp. z o.o. sp. k. Your personal data will be processed in order to address you with information on the terms and conditions of cooperation and marketing content. Detailed information on the processing of your personal data and your rights can be found in the Privacy Policy: Newsletter.

Dbamy o Twoją prywatność

Zespół Ikonki dokłada wszelkich starań, aby Twoje dane były bezpieczne. 

Na tej stronie używamy plików cookies i podobnych funkcji do przetwarzania informacji o urządzeniach końcowych i danych osobowych. 

Przetwarzanie jest wykorzystywane do celów przechowywania informacji na urządzeniu lub dostęp do nich, wyboru podstawowych reklam, wyboru spersonalizowanych reklam, tworzenia profilu spersonalizowanych reklam, tworzenia profilu spersonalizowanych treści, wyboru spersonalizowanych treści, pomiaru wydajności reklam, pomiaru wydajności treści, opracowywania i ulepszania produktów, zapewnienia bezpieczeństwa, zapobiegania oszustwom i usuwania błędów, technicznego dostarczania reklam lub treści.

Klikając "AKCEPTUJĘ" wyrażasz zgodę na korzystanie w Internecie z technologii automatycznego śledzenia i zbierania danych, dostęp do informacji na Twoim urządzeniu końcowym i ich przechowywanie oraz na przetwarzanie Twoich danych osobowych przez KIK sp. z o.o. sp. k. w celach marketingowych (w tym do zautomatyzowanego dopasowania reklam do Twoich zainteresowań i mierzenia ich skuteczności).

Zaakceptowanie zgody jest dobrowolne. Udzieloną zgodę możesz wycofać.

Możesz żądać dostępu do Twoich danych osobowych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przeniesienia danych, wyrazić sprzeciw wobec ich przetwarzania.

Szczegółowe informacje na temat przetwarzania Twoich danych znajdują się w polityce prywatności.

Administratorem Twoich danych osobowych jest

KIK Sp. z o.o. Sp. k.

Aleja Tysiąclecia Państwa Polskiego 8,

15-111 Białystok 

NIP: 5423089180 

Regon: 200218804 

KRS: 0000613970