Skip to main content

Lasership V2 Guide

Updated

 

EasyPost is integrated with the LaserShip web services and is certified by LaserShip to provide the following services via their platform:

  • Rating - EasyPost must upload a rate card of your LaserShip rates before you can retrieve rates when rate shopping on EasyPost.
  • Label Creation - create a shipping label for your package.
  • Supported Options - various shipping options offered by Lasership.
  • Orders - How orders behave on EasyPost’s LaserShip V2 integration.
  • Tracking - track your shipment through the LaserShip network. 

Rating

The EasyPost Lasership V2 integration supports rating by rate tables. This means that you must receive your rate card for your LaserShip account directly from LaserShip, then contact support@easypost.com to upload your rates to your EasyPost account. These rates are supplied by LaserShip and will be specific to your LaserShip account. 

Available Service Levels:

  • SameDay
  • NextDay
  • Weekend

Label Creation

The LaserShip V2 integration supports the following label types:

  • PNG
  • PDF
  • ZPL

Supported Options

The following options are required to use LaserShip V2:

  • dropoff_max_datetime (description in the below table)
  • pickup_min_datetime (description in the below table). Note that you will throw an error if you attempt to generate a label the same day if the current timestamp is too close to the pickup_min_datetime.
  • pickup_max_datetime (description in the below table)

The following options are supported with the LaserShip V2 integration:

 

Option

Type

Specification

Example

print_custom_1

String

You can optionally print custom messages on labels. The locations of these fields show up on different spots on the carrier's labels.

"Hello"

print_custom_2

String

An additional message on the label. Same restrictions as print_custom_1

"World"

dropoff_max_datetime

String

Per the LaserShip documentation: Must be in ISO 8601 - 2019-02-17T08:22:10Z. Must represent the local time converted to UTC based on the Timezone of the Injection Address. This should be the "CET" (Critical Entry Time) local time converted to UTC based on the Timezone of the Injection Address (ie the LaserShip facility address where this freight will arrive first). The formatting is:

YYYY-MM-DDTHH:MM:SS

"2019-02-17T08:22:10Z"

pickup_min_datetime

String

Per the LaserShip documentation: Must be in ISO 8601 - 2019-02-17T08:22:10Z - Mandatory for PickupType "LaserShip". This should be ONE hour before CPT (Critical Pull Time) local time converted to UTC based on the Timezone of the Origin Address. If the truck is loaded as the order are transmitted then the CPT (Critical Pull Time) local time converted to UTC based on the Timezone of the Origin Address is to be used.

The formatting is:

YYYY-MM-DDTHH:MM:SS

"2019-02-17T08:22:10Z"

pickup_max_datetime

String

Per the LaserShip documentation: Must be in ISO 8601 - 2019-02-17T08:22:10Z. This should be ONE hour after CPT (Critical Pull Time) local time converted to UTC based on the Timezone of the Origin Address.

The formatting is:

YYYY-MM-DDTHH:MM:SS

"2019-02-17T08:22:10Z"

handling_instructions

String

This is to designate special instructions for the carrier

"Fragile!"

content_description

String

Contain the description of the content of this one piece

"Contains food"

alcohol

Boolean

Specify if the shipment contains alcohol. Defaults to "false"

"true"

dry_ice

Boolean

Specify if the shipment contains dry ice. Defaults to "false"

"true"

perishable

Boolean

Specify if the shipment contains perishable items. Defaults to "false"

"true"

endorsement

String

To specify no return to sender

The only valid value is: “NO_RETURN_TO_SENDER”

 

JSON Example Usage:

options: {
 content_description: 'Describe the contents of this single shipment',
 dropoff_max_datetime: '2022-02-17T08:22:10Z',
 pickup_max_datetime: '2022-02-17T08:22:10Z',
 pickup_min_datetime: '2022-02-17T08:22:10Z'
}

 

Orders

Orders with LaserShip behave in a particular way, that all users should be aware of. When using the LaserShip V2 integration with the Orders object, you must specify your options for the first shipment within the order. If you need specific options on specific shipments within the order, you should use individual shipments via the shipment endpoint instead of orders due to this behavior. Orders are treated as a single master shipment, so you will only get the tracking code of the first shipment back via the EasyPost API. However, each label within the order will have its own unique tracking code. 

 

Tracking

LaserShip V2 tracking will work similarly to other carrier integrations, but one thing to note is that you must create the shipments through EasyPost if you want to track them. You will be able to receive all tracking events passed back to EasyPost from LaserShip from all your LaserShip shipments created on EasyPost. Since tracking with LaserShip requires authentication, we cannot track shipments made outside of EasyPost.

 

Addresses

When you enter your from_address and your return_address, you will need to ensure that you have entered the exact same address that is in your Business account within LaserShip. Double check with your LaserShip representative to make sure you have this address recorded in order to use it on your shipment.from_address. 

Related articles

Comments

0 comments

Article is closed for comments.

Powered by Zendesk