Shipping label Templates

Shipping label Templates

6. Shipping label Templates

Shipping labels can be managed from menu Embedded ERP > Order preparation > Shipping label templates.

From there you can configure the way our extension will export orders information into a CSV, text of PDF file.

Once packing step has been confirmed, order information file will be downloaded.

You can then import this kind of file into your carrier software system to print shipping labels.

Available tabs


NameSet there the shipping template name
StatusSet the status to Active to enable this shipping template
TypeSelect “Order details file export” for txt, csv & xml shipping templates. Set “simple address label” for PDF ones.
Associate shipping methodsWhen shipping labels will be generated for an order, it will retrieve the matching templates based on the shipping method(s) selected there.


There you can configure the shipping label files structure and content (only used for “Order details” labels).

File nameName of shipping labels generated, must include file extension in the file name. Ex : for a CSV file, name will be “your_template_name.csv”.
Mime typeSelect shipping label type. Must match with the file extension provided in the “file name” option.
File header lineSet scheme of file header (if exists). Most of the time this is the column’s names, separated by a coma or a semi-colon.
Header line for ordersSet scheme of header line for each order in the template. You can use available codes there, putting them between curly brackets. Ex : for code “order.increment_id”, you have to write “{order.increment_id}”.
Line for each products in ordersSet scheme of product lines in the template. This line is repeated for each product of an order.
Footer line for ordersSet scheme of footer line in the template. This line is added at the end of each order.
File footer lineSet scheme of file footer (if exists). Most of the time it’s only used to close XML tags opened in the file header field, in the case of XML files.


You don’t need to add a carriage return at the end of each field, as one will automatically be added at the end of File header line, Header line for orders, Line for each products in orders & File footer line fields in the files generated.


There you can configure the structure of the CSV files that will be imported from the tracking numbers import available from the Order preparation screen, at the Shipping step.

Skip first lineIf checked, first record will be skipped (useful if first line contains header)
Field separatorCharacter used to mark separation of field in a record.
Shipment reference column index (from 1)Position of the shipment reference
Order reference column index (from 1)Position of the order reference
Tracking number column index (from 1)Position of the tracking number
Create shipment if not existCreate a shipment if it doesn’t exist


Create shipment if not exist option will create shipment if the option is enabled but also create invoice according to your settings in ERP > Order preparation > Configuration > Packing > Create order invoice

Available codes

You can use these codes to include order or product details in file exported (only used for “Order details” labels).

Any code must be added between curly brackets to be replaced by its value during the export.

For example to include the order number, you should use :


How to configure

Depending of the type of shipping label created (see shipping label configuration), the configuration needed differs.

This section provides details about configuration needed for each kind of shipping label.

CSV & XML Order details file

“Order details” labels will export into a CSV file information about order and ordered products.

Important settings are the following ones :

  • General tab :
    • Type : “Order details”
  • Export tab :
    • File name : “XXXXX.csv” or “XXXXX.xml”
    • Mime type : “text, csv” or “xml”
    • Line break : “CR”

Then, you will have to configure export templates, to get correct information exported.

Here are some example for both “text, csv” and “xml” configurations.

CSV file : one line by order

  • File header line
  • Header line for orders
  • Output file
000000008;Olivier;Zimmermann;3.00;12 rue des champs elysees;paris;75001;FR

CSV file : one line by ordered product

  • Header line for orders
  • Line for each products in orders
  • Output file
o;000000008;Olivier;Zimmermann;3.00;12 rue des champs elysees;paris;75001;FR
p;2;NOK1260;Nokia 2460 3G;3067263547372
p;1;headset12;Nokia headset 10122;3097263999972

XML file

  • File header line
  • Header line for orders
<order id="{order.increment_id}">
  • Line for each products in orders
<product sku="{orderitem.sku}" qty="orderitem.qty_shipped">
  • Footer line for orders
  • File footer line
  • Final file exported
  <order id="000000008">
      <street>12 rue des champs elysees</street>
      <product sku="NOK1260" qty="2">
      <product sku="headset12" qty="1">

Address label PDF

“Address label” labels will generate PDF files containing order address.

Here are settings to apply for these shipping label templates :

  • General tab :
    • Type : “Address label”
  • Export tab :
    • File name : “XXXXX.pdf”
    • Mime type : “pdf”


You can also configure details about PDF generated from the configuration.

Tracking numbers CSV file

From the Order preparation screen, at the Shipping step, you get the possibility to import a CSV file that contains [order/shipment] references and their associated tracking numbers.

Here are settings to apply to be able to import these kind of files :

  • General tab :
    • Type : “Order details”
  • Export tab :
    • File name : “XXXXX.csv”
    • Mime type : “text, csv”
  • Import tab :
    • Skip first line : “Yes” if your file contains a header, else “No”.
    • Field separator : The columns separator in your file.
    • Shipment reference column index : The index of the shipment # in your file. (MANDATORY or “Order reference column” instead)
    • Order reference column index : The index of the order # in your file. (MANDATORY or “Shipment reference column” instead)
    • Tracking number column index : The index of the tracking # in your file. (MANDATORY)
    • Create shipment if not exist : If enabled, ERP will create shipments for all orders associated to tracking numbers imported if they were not already created.


All columns indexes start from 1, so for example if the shipment reference is available in the first column of your file, the “Shipment reference column index” setting must be set to “1”.

Others shipping label extensions

The shipping label system can work with some Magento extensions providing shipping label download features :

  • Socolissimo by Magentix Website
  • Chronopost official extension : Download

To make it work with these extensions, follow these few steps :

  • Create a new template
  • Give it a name and set it “Enabled”
  • In the “Mime type” dropdown, select “PDF”
  • In the “Type” dropdown, select the correct value
  • In the “Associated shipping method” list, check all magento shipping methods that should be handled with the extension
  • Go into the “Export” tab, then enter a name with the “PDF” extension at the end, like : “shipping_label.pdf”
  • Save the shipping template

Once done, in the order preparation module when you will end the Packing step, the button “Download shipping label” will generate the shipping label PDF automatically.

    • Related Articles

    • Manifest

      7. Manifest This article explains how to generate shipping manifest PDF. They will be mainly used to list parcels to give to the carrier pickup truck. Creation To create a new manifest, go into menu Order preparation > Manifest and click on ...
    • Concepts

      3. Concepts This page explains the main concepts of the Order preparation extension. Order preparation tabs The order preparation extension main screen displays 3 tabs in which it distributes orders : In stock orders : contains orders for which every ...
    • Workflow

      Order preparation workflow The order preparation screen is designed to easily manage orders shipments. It looks like : Concepts Batches & Steps Preparation steps are availale as “red buttons” at the top of the “Order preparation” screen. Note More ...
    • Product view

      7. Product view Inventory management extension adds a few new functions useful for products stock management, available directly from product pages. How to access Depending on whether it has been installed as it or with the full ERP package, the way ...
    • Purchase Orders

      5. Purchase Orders Purchase order Workflow There are 2 dfferent ways to create a new Purchase Order : From scratch, from the “Purchase order” menu, using button “Create a new Purchase Order” From the “Supply needs” screen (more information : Create a ...