2Ship integration configuration

Introduction

No matter what your business shipment workflow is, the volume of products you ship, or where you ship to and from, 2Ship can be used by everyone. It allows you to make decisions on cost versus efficient shipping, such as which carrier is fastest, or least expensive. Paragon sends your shipment details to 2Ship and pulls data to display in Paragon, so data entry is minimal.

The 2Ship integration is currently only available by request. Contact support@paragon-erp.com for more info!

Setting up 2Ship integration

Depending on your region 2Ship has different api settings:

	API URL	UI URL
Canada	api	ship
EU	euroapi	euroship

Setting up the default 2Ship key

First, navigate to the settings page and click on my company.

Click on the edit button

Then, click on the add an attribute button.

Select 2Ship key from the dropdown menu.

Enter the 2Ship key provided by 2ship and click save.

If this is your only 2Ship key, you can skip the individual user accounts section.

Shipping with 2Ship under individual user accounts

With multiple users on Paragon, you may want to have different 2Ship keys assigned to different users. You can be logged into your specific 2Ship account when sending a shipment from Paragon. Each user can have their own unique 2Ship key associated to them, otherwise the default 2Ship key (stored in My Company settings) will be used.

Access the person module

To navigate to the person module, click on the more button from anywhere in Paragon, and select person.

Double-click the person who requires the 2Ship account so that you see the detail view. Click on the edit button.

Click on the add an attribute button.

Select 2Ship key from the dropdown menu.

Enter the 2Ship key provided by 2ship then click save.

Assign the person to a user profile

Navigate to the settings page and click on user management.

From there, you can edit specific user settings by clicking on the edit button next to their name and info.

Select the person you just assigned the 2Ship key to from the drop-down arrow and click accept.

Configure the integration

Set up box attributes in screen setup.

In order to integrate Paragon with 2Ship, we need to make sure that measurements for parcels and boxes will match up in 2Ship itself. For this, we need to add a few attributes to our screen setup.

First, navigate to the settings page and click screen setup.

Click packing list from the list of modules on the left. Then click on the edit button.

You will see an option to edit box attributes. Click this to add any missing attributes you may need for the rest of the process.

In this attribute modal, you will need to add weight uom and box weight if they are not already listed.

Remember to check the disallow multiple and always show options.

Click the accept button and remember to save before proceeding. After you save you will need to log out and back into Paragon to see any changes you've made.

Create a packing list with boxes

The next step is to create a packing list that you will use for the shipment. To navigate to the pack module, click the more button from anywhere in Paragon, and select pack.

You have the option to create a packing list from an existing pick or order, or you can make one from scratch manually. In either case, make sure your customer details and addresses are all in order as well as the items. Once you are happy with your packing list, issue your pack.

After your pack has been issued, you can click the action arrow and you will be given the option to box your packing list.

Now you can start assigning items and measurements to your boxes. Simply select the option for new box and select the standard box from the template dropdown. You will notice that some attributes may be missing from the template. Simply click edit and add the weight uom and box weight attributes.

If you added the box weight and weight UOM they will appear in 2Ship. If you didn't add them you can still add them manually.

When you're happy with your packed boxes, click review and then accept and you're ready to head over to the shipment process.

The following fields are being interfaced to 2ship

Basic Shipment Information

Shipment Reference - The shipment number from Paragon
Order Number - Order number + ID (e.g., "12345 (67890)")

Sender Information (Ship From)

Company Name - Organization name
Address Line 1 - Street address
Address Line 2 - Additional address info
Address Line 3 - Additional address info
City - Sender city
State - State/province code
Postal Code - ZIP/postal code
Country - Country code (e.g., "US")
Telephone - Phone number
Person Name - Contact person name
Email - Contact email

Recipient Information (Ship To)

Company Name - Customer company name
Address Line 1 - Street address
Address Line 2 - Additional address info
Address Line 3 - Additional address info
City - Destination city
State - State/province code
Postal Code - ZIP/postal code
Country - Country code
Telephone - Phone number
Person Name - Contact person name
Email - Contact email
Tax ID - For international shipments

Carrier & Service Information

Carrier ID - Shipping carrier (UPS, FedEx, etc.)
Service Code - Service level (Ground, Express, etc.)

Package Details (for each box/package)

Weight - Package weight
Weight Type - Units (pounds, kilograms)
Width - Package width
Length - Package length
Height - Package height
Dimension Type - Units (inches, centimeters)

Skid/Pallet Information

Weight - Skid weight

Product/Line Item Details (for each item)

Item ID - Internal item identifier
Quantity - How many units
Unit Value - Price per unit
Item Weight - Weight per item
Description - Product description
Made In Country Code - Country of origin
Harmonized Code - HS tariff code
Quantity Unit of Measure - Units (pieces, yards, etc.)

Textile/Apparel Specific Information

Yarn - Yarn composition
Fabric - Fabric details
Fiber - Fiber content
Textile - Textile classification
Textile Information - Additional textile details
NAFTA - NAFTA qualification
Is Dutiable - Whether item requires duties

International Shipping Information

Invoice Purpose - Reason for shipping (sale, repair, etc.)
Invoice Amount - Total shipment value
Terms of Sale - Incoterms (CIF, FOB, etc.)
Order Date - When order was placed
Pickup Date - When shipment will be picked up

Company Information (Importer/Exporter)

Importer of Record - Complete company details
Exporter of Record - Complete company details
Manufacturer - Product manufacturer details (if different)

System/Technical Information

LTL Class ID - Freight classification
Billing Options - How shipping will be billed
Webhooks - URLs for status updates
WS Key - API authentication key
Consolidation Unit - If part of consolidated shipment

The code essentially takes a complete order from ParagonERP and translates it into all the information 2Ship needs to create a shipping label and handle the logistics.

What's next?

Here are some articles related to the boxing function that may help you.

Using the boxing function

Configuring your boxing screen