USPS - Endicia Label Server Integration - Linnworks Documentation

You are currently viewing documentation for Linnworks Desktop, if you are looking for Linnworks.net documentation, click here.

USPS - Endicia Label Server Integration

Overview

Linnworks integrates directly with Endicia Label Server providing the functionality to control the printing of various types of labels, arrange collections, control when and how shipments are handled.

Endicia Label Server Integration

Open Linnworks
Go to the Settings tab and open Shipping Management
Scroll down to Endicia Label Server and click on the Configure symbol

Fig 1.1

Shipping Management

Fig 1.2

Endicia Configurator

Account Details

Enter you Account ID and Passphrase
This will be given to you by Endicia
If you haven't received this please contact them at "http://www.endicia.com/support/contact-support" and then Test your Credentials
There's then the choice of the Accounts Environment, this is where the labels can be made and tested in Testing Mode before changing your account to a Live account

Fig 2.1

Account Details

From Address

Click on the drop down arrow to the right of the From Address to enter your American returns address

Fig 3.1

From Address

Sender Settings

If the Show Return Address box is ticked the Returns Address will be printed on the label
The name of the Customs Signer must be entered as this is for Customs to know who is responsible for packing the items
Date Advance is how many days between consignment despatches

Fig 4.1

Sender Settings

Buy Postage

To buy postage, re-enter your Endicia Account's Passphrase
Here is also the option of not having to do this again
The estimated balance of your account with Endicia is shown (it will automatically update when you print labels)
Select how much postage you would like to purchase from the drop down box and click Buy Postage to make the purchase or Cancel

Fig 5.1

Buy Postage

Arrange Collection

Click on the Arrange Collection box to enter the details for your collections
In the Package Location you can choose to leave information about where the package is if it hasn't been able to be delivered into the hands of the buyer
Enter Special Instructions if there are any
Set the dates of processed orders you want to include in the collection
Once this info is filled in click on the Book Next Available Collection bar at the bottom

Fig 6.1

Arrange Collection

Fig 6.2

Package Location

Cancel Shipments

To cancel an order off of a shipment enter the Order ID and click OK
This will bring up the Order details
Click on the Void Shipping if wanting to cancel off the order

Fig 7.1

Cancel Shipments

Printer Config

In this you will find a list of available printers that you can then adjust to suit your needs
To change the Format simply double click in the box to bring up a drop down of choices
The Rotation can also be changed
To reset the printers back to their default setting just click on Reset

Fig 8.1

Printer Config

Label/Printer Mapping

This is where you can choose what type of labels are printed on which printer and with which kind of paper
They automatically show as System Default but click in the Selected Printer column next to the type of label you desire and a drop down of printer choices will show
Click in the Paper column for a selection of paper types to show
You can also change the Margins, the Orientation and the Scale

Fig 9.1

Label/Printer Mapping

Property Mapping

These properties are extended properties on the stock items used to describe international packages when they arrive at customs.
CountryOfOrigin should be the two-letter ISO-3166-1 Alpha-2 country code (e.g. FR for France or AU for Australia) or it can be the full country name (e.g. Canada or Italy).
HSTariffNumber values for your items are available from the US International Trade Commission website.
ContentsExplanation is a 50-character max description of the item. If there are multiple items in a shipment, you will be asked to describe the package contents or select the explanation. There is also a service-level option to accept the first item's description for the entire order without showing a dialog.

Fig 10.1

Extended Property Mapping

Adding a New Service

To add a new service click on the Add button
Select the service you require from the list and click OK
This brings up Endicia's Service Config
In here you can set up the service to do exactly as you wish

Fig 11.1

Adding a New Service

Fig 11.2

Endicia's Service Config

Selecting Mailpiece Shape and LabelSize

For each service, you must select a valid combination of Mail Class, Label Type, Mailpiece Shape and LabelSize otherwise you will get errors like "Missing or invalid element: Mailpiece Shape", "Missing or invalid element: Label Size".
A list of valid combinations is provided in this document: Endicia Label Server Valid Combinations

Fig 12.1

Invalid mailpiece shape

Fig 12.2

Invalid Label Size

Miscellaneous

When submitting order item data to UPS, Linnworks will not send composite child items. If your order contains a composite item, only data from the composite parent will be submitted.