Legacy module
The module described in this article has been marked as a legacy module. This means the following:
-
We don't create new features for this module or fix any bugs.
-
The module is not available anymore in Xentral instances (demo or licensed) created after 28-Sep-2022. If you as a new user have special requirements that could only be fulfilled by this module, please contact our customer support team to discuss a solution.
For more information, see also Why is Xentral deprecating some modules (Legacy modules) and what does this mean for you?
With the LogoiX shipping method, you connect or link your xentral to the shipping service company LogoiX to create online labels for shipping. You can design these labels individually. The website of the shipping service provider with further information can be found here.
A general overview of the shipping methods and parcel labels you can use in xentral, you can find here.
LogoiX offers you the following features:
-
Using a self-made label template
-
Determination of the freight type
-
Specifying a DeepL description in the delivery note
-
Selection of the recipient type
-
Information on fragile cargo
To connect LogoiX to xentral, you need the API data for your account. You can get these from your LogoiX business account manager.
Various settings you can make in xentral for the use of the shipping method LogoiX among other things the new creation of the dispatch type and the organization of XML labels.
Under Administration > Settings > Shipping methods > Overview > +NEW > LogoiX you create the new shipping method.
Fill in the following fields:
-
Designation: Freely choose a designation for the shipping method. This is displayed in xentral among other things in the order for selection in the drop-down menu
-
Type: Specify the type/field label. You can generally choose this as long as it is not required for store mapping or other mappings. Ideally you should keep default
-
Module: Select Logoix from the drop-down menu
-
Project: Optionally select a project, provided that a separate LogoiX shipping type is created for each project
-
Active: By ticking it, you activate the shipping type and make it visible and usable
-
No postage check: By ticking no postage check will be performed in the order
-
Printer parcel stamp: Select from the drop-down menu the default printer, which prints the parcel stamps
-
Printer export: Select from the drop-down menu the default printer, which prints the export papers
-
Shipping mail: Select the behavior of the shipping mail from the drop-down menu. "Default behavior" means that a standard tracking email will be sent, "no shipping email" means that no tracking email will be sent for this shipping type, and "custom text template" means that a custom shipping confirmation text template will be used for this shipping type, regardless of the project and logistics process
-
Use label template: If you check this field, you can select a label template from the field below. But this field is optional
-
Label template: If you checked the "Use label template" field, you can now select a label template you created previously from the drop-down menu
-
API username: Enter your API username. You can learn this from your LogoiX business account manager
-
API password: Enter your API password. You can also learn this from your LogoiX business account manager
When finished, click Save.
If you want to use XML labels, you must first create and set them. This is done under Administration > Settings > System > Labels via the +NEW button:
In any case, fill in the following fields:
-
Name: Assign a label name that indicates at a glance that this is a label for LogoiX
-
XML: Enter your freely chosen XML code, which you use to customize the label
For example, you can use the following XML code to create your custom Label use:
<label> <barcode x="3" y="15" size="3" type="1">{LIX}</barcode> <line x="3" y="18" size="3">{LIX}</line> </label> -
Use as: Select the format of the label from the drop-down menu.
For more information on creating labels, see here.
If you have selected the label to be larger in the label settings, you can also specify the recipient and delivery address.
For example, you can use the following XML code to create your customized label:
<label>
<span class="hljs-tag"><span class="hljs-name">line</span>
<span class="hljs-attr">x</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "3"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>sender<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span>=< span class="hljs-string"> "6"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{ABSENDERNAME}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span>=< span class="hljs-string"> "9"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{ABSENDERSTRASSE}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span>=< span class="hljs-string"> "12"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{ABSENDERPLZ}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "10"</span> <span class="hljs-attr">y</span>=< span class="hljs-string"> "12"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{ABSENDERORT}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><span class="hljs-name">barcode</span> <span class="hljs-attr">x</span>=< span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span>=<span class="hljs-string"> "15"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">type< /span>=<span class="hljs-string"> "1"</span>></span>{LIX}<span class="hljs-tag">barcode</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "3"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "18"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{LIX}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "60"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "3"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>recipient<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "60"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "6"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{NAME}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "60"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "9"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{STRASSE}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "60"</span> <span class="hljs-attr">y</span> =<span class="hljs-string"> "12"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{PLZ}<span class="hljs-tag">line</span>>
<span class="hljs-tag"><<span class="hljs-name">line</span> <span class="hljs-attr">x</span>=<span class="hljs-string"> "69"</span> <span class="hljs-attr">y</span>=< span class="hljs-string"> "12"</span> <span class="hljs-attr">size</span>=<span class="hljs-string"> "3"</span>></span>{location}<span class="hljs-tag">line</span>>
</label>
Once you have made all the settings as described above, you can test the parcel mark printing in the shipping center, in an order or even in a single delivery note. To do this, under Fulfillment > Delivery note > Details > Delivery note, in the Delivery note area, select the Shipping methodLogoiX from the drop-down menu. Click the Save button before navigating to the package marker dialog.
Next, click on the Parcel label tab in the delivery note and create a package mark for the included items via Print shipping label.
After your test print is complete, you can subsequently cancel the package stamp in the LogoiX business customer portal.
The LogoiX shipping method offers you more features in the package stamp dialog:
Insert a content description
In the delivery note you can optionally specify a content description of your goods in the package. Use the field content description. Be as concise as possible, because this content description can also be read on the online label.
Determining the type of cargo
In addition, you can set the freight type of your shipment via a drop-down menu. You can choose between parcel, bulky goods, euro pallet and one-time pallet in the field Freight type
Determination of the recipient
You can also specify the recipient individually. Use for this the drop-down menu in the field Recipient and select between private person and company.
Determination of fragile cargo
If the cargo is fragile, you can also make that clear on the parcel label. Check the box Fragile and only click on Print shipping label afterwards.