Connecting Passport to ShipHero

What is Passport? Passport is a modern international shipping carrier that integrates with ShipHero to streamline global label generation. By using Passport within ShipHero, merchants can automate the production of international shipping labels while ensuring compliance with global customs regulations.

Table of contents

• Key Passport Features
• How to Connect Passport to ShipHero
• Known Passport Limitations
• Passport Error Handling Tips

Key Passport Features

• International Label Generation: Generate ready-to-use international labels directly within the ShipHero packing workflow. Domestic shipments are not allowed.

• Incoterm Selection: The shipping method you select within ShipHero determines whether the order is processed as DDP (Delivered Duty Paid) or DDU (Delivered Duty Unpaid). Passport shipping methods with 'DDP' in the name (e.g., ExpressDdp, PriorityDdpDelcon) will be processed as Delivered Duty Paid, while Passport shipping methods with 'DDU' in the name (e.g., PriorityDdu, StandardDdu) will be processed as Delivered Duty Unpaid.

  NOTE: You cannot overwrite a Passport shipping method's assigned incoterm by changing the incoterm selection on the order details page or via automation rules. To change the incoterm for an order shipped via Passport you must select an applicable shipping method.

  What Are Incoterms? Incoterms, or International Commercial Terms, are a set of rules published by the International Chamber of Commerce (ICC) that define the responsibilities of sellers and buyers for the delivery of goods in international trade. They specify who is responsible for paying for and managing the shipment, insurance, documentation, customs clearance, and other logistical activities.

  Incoterm	Definition
  DDP	The shipper handles the payment of duties and taxes, ensuring no surprise fees for the customer upon delivery.
  DDU	The customer is responsible for paying duties and taxes to the local customs office before the package is released.

• Compliance and Documentation: Passport manages the electronic submission of customs data, reducing the manual paperwork required for international shipments.

How to Connect Passport to ShipHero

1. Go to the Shipping > Carriers page.
2. Click the Connect Carrier button and select Passport from the list of available carriers.
3. Enter the required information into the following fields:
4. Select Connect.

Getting the Access Token

To authenticate the connection between ShipHero and Passport's API, you must provide an API Access Token. This is a secure credential (maximum 255 characters) unique to your account.

To obtain your token:

1. Active Account: Ensure you have an active account at passportshipping.com.
2. Generate Token: Log in to your Passport dashboard to locate your API credentials. If you do not see an option to generate a token, please contact your Passport Account Manager.
3. Complete Connection: Once you have the token, paste it into the API Access Token field in the ShipHero Connect Carrier window to finish the setup.

Note: Access tokens are sensitive information. Ensure you store them securely and do not share them outside of your authorized integration users.

Available Settings after Connecting Passport

After connecting your Passport account to ShipHero the following settings are available for you to use:

• Cut-Off Time: Labels generated after this time will print with the creation date of the following day.
• Disable Quoting: Use this setting to prevent this account from being quoted in the rate shopping tools or when using the cheapest shipping methods. 

Known Passport Limitations

• Passport Insurance and quoting: Insurance costs are not included in the label cost returned by the Passport API. The displayed cost shows shipping and duty/tax only. Actual insurance charges (if selected) will appear on your Passport invoice. Here is more information on Shipping with Insurance.
• Tracking updates: Tracking updates may take 24-48 hours to appear for international shipments.
• Unsupported Features: The following features are not available for Passport: return labels, manifest generation, domestic shipments and P.O Box deliveries.
• Reference Fields: Passport only supports one reference field per shipment. ShipHero uses:
  • The configured carrier reference field, if set. Contact ShipHero Support to change the reference field.
  • Order ID, if no custom reference is configured.
  • If the order has a Tax ID entered, the reference will be formatted as: Tax ID: {value}
• DDP Country Restrictions: Passport DDP is not available in these countries:
  • Russia, North Macedonia, San Marino, Comoros, Libya
  • The British Virgin Islands, Grenada, Honduras, Montserrat
  • Saint Maarten, St. Barthelemy, St. Kitts & Nevis, St. Lucia, St. Martin, St. Vincent & Grenadines
  • Turks & Caicos, Samoa, Timor-Leste, Tonga, Vanuatu, Wallis & Futuna

Passport Error Handling Tips

• Passport does not ship domestically: appears when trying to ship to the same country as origin.
•  Weight cannot be blank: Missing package weight.
• Authorization failed: Invalid or expired API Access Token.
• Missing customs data: Ensure all products have HS codes, origin country, and customs values.
• Timeouts: If you experience timeout errors, please contact ShipHero support.
  • Label generation timeout: 60 seconds
  • Rate quote timeout: 20 seconds