Manual shipment creation

Owned by Hidde Stokvis
Nov 04, 2019
3 min read

This guid is intended for customers who will use the shipping portal only for manual creation. It’s completely viable to start here and add an integration for Lightspeed, Magento 1 or Magento 2 later on.

1. Obtaining a Trunkrs API credentials

Once we are able to talk to Lightspeed through the Lightspeed API key, we also need to be able to talk our API. To connect your Shipping Portal account to our main system we ask for a:

  • Client ID,

  • and Client Secret

If you are a new customer, these will be sent to you by our Sales team once our IT has created the account. If you are an existing customer you can request this information by sending an email to tech.support@trunkrs.nl.

2. Creating a shipping portal account

Creating a Shipping Portal account is super easy and can be done by you yourself. Please follow these steps:

  1. Visit https://lightspeed.trunkrs.app/client/register

  2. Fill in the form and register for an account

  3. You can now login!

Currently, we only allow for 1 account per customer. This means whoever will be handling the printing of labels should have access to this account. We will change this behavior in the near future.

3. Configuring the Shipment Method

  1. After login in you will see Your Shipments page wherein you will find and manage all Trunkrs Shipments.

  2. Let’s hit the Plugin configurations in the menu for the: shipping method configuration

  3. You will see Configure Plugin button for the first time, this means the plugin is not yet configured and it needs to be configured.

  4. Start with completing your account details. These will be used as the sender information in our system.

  5. Because we are creating the shipments manually we can skip the step where we configure the integration. Just do the following to make it work

    1. set enable to “no”

    2. in the title field enter “Trunkrs Same Day”

    3. in the description field enter “Trunkrs Same Day”

    4. under advanced options set hide for non-stock products to “no”

  6. Finally let’s setup the connection with Trunkrs:

    1. under client id (staging) enter the staging client id you have received from Trunkrs

    2. under client secret (staging) enter the staging client secret you have received from Trunkrs

    3. under client id (production) enter the production client id you have received from Trunkrs

    4. under client secret (production) enter the production client secret you have received from Trunkrs

    5. set the API mode toggle to the left for staging (test mode) to create test shipments for which you will not be charged, or to the right for live mode to actually start shipping.

    6. finally let’s hit the blue button Test staging/live API Connection after loading it should show: connected! If this does not happen, please check the credentials.

    7. Let’s now hit the save button to return to the configuration steps overview

4. Creating 1 shipment manually

  1. Go to All shipments (top option left sidebar)

  2. Hit the green button + Create new shipment in the top right

  3. Fill out the form

There are two options same day and next day. Please realize that same day is only truly same day if you create your shipment before the cut off time

5. Bulk creating shipments

  1. Hit the Upload CSV in the left sidebar menu

  2. Upload any CSV that contains at least delivery info, email address and order reference or barcode

  3. You will see a list of 10 coloured fields. use the … button to map the fields to your CSV file. (Fields with an * are required)

  4. Hit continue to create the shipments