UPS - Add New Integration

This guide will explain how to integrate a UPS account with Linnworks.

How to add UPS Shipping integration?

Go to Shipping > Integrations > + Add integration and select shipping vendor UPS

Integrate UPS

Follow integration steps:

  1. Enter an Account Name you wish to use to identify this integration within Linnworks. (this can be anything eg. UPS Shipping Account 1 but should be meaningful for later reference) and click Next. 
  2. Enter the Shipper Details (details below) and specify the language in Local Settings:
    • Company Name
    • Company URL
    • Attention Name
    • Title
    • Email Address
    • Phone Number
    • Address Line 1
    • Address Line 2
    • Address Line 3
    • City
    • State Province Code
    • Postal Code
    • Country
  3. Get familiar with the UPS Technology Agreement. You can click the link Open agreement in a new window to read the agreement in a separate screen.  Confirm that you agree with terms and conditions by selecting the tick box and then click Next:
    • Account Details
      • Shipper Number: The shipper number is the UPS Account number that must contain alphanumeric characters only. It is a six-digit reference number that can be found by logging into the UPS website > Payment Options > My Payment Methods > Number. 
      • Tax Identification Number: A maximum of 15-digits reference number. Conditionally required if EEI form (International forms) is requested.
      • Tax ID Type: Required - Applies to EEI form only.
      • Transportation Bill to
      • IOSS Registration Number
    • Third-Party (Optional)
      • Third Party Account Number: The account must be a valid UPS account number that is active. For US, PR and CA accounts, the account must be either a daily pickup account, an occasional account, or a customer B.I.N account, or a drop shipper account.
      • Third Party Postal Code
      • Third Party Country Code
    • Invoice Authentication
      Extra info is required in the Invoice Authentication. As per UPS' documentation:
      UPS Registration WebServices API enables UPS Ready and other Strategic Alliance customers to create MyUPS profiles on behalf of their customers. Registration will ensure that customers have proper My UPS login credentials and account association necessary to access the UPS shipping systems.
      Why authenticate (AIA) an account?
      Authentication is required for adding an existing account number to a MyUPS profile. The account must have generated an invoice within the past 90 days (US & Canada) and 45 days (all other countries). Authentication is performed as a security measure to ensure that only authorized customers can add accounts to profiles. In order to complete the authentication process, a user must provide account invoice details from one of the last three Delivery Service Invoices received within the last 90 days (US & Canada) and 45 days (all other countries). AIA is not required for new accounts or accounts that have not generated an invoice(s) within the last 90 days (US & Canada) and 45 days (all other countries).
      How to authenticate an account?
      The following data elements must be provided by the user for AIA:
      • Invoice Number
      • Invoice Amount
      • Invoice Date
      • Control ID (exactly as shown on the invoice if present)
      Lost or misplaced an invoice
      If a user does not have a recent invoice, the user must check with the UPS accounts payable department. The user can also get billing help online or call UPS Billing at 1-800-811-1648 to request a duplicate invoice.
      • Invoice Number
      • Invoice Date
      • Invoice Amount
      • Currency Code
      • Control ID
    • Ship From Address
      • Specify Ship From Address
  4. Enter the Pickup Schedule and Local Settings:
    • Local Settings
      • Local Time Zone
    • Pickup Schedule
      • Monday Pickup Time
      • Tuesday Pickup Time
      • Wednesday Pickup Time
      • Thursday Pickup Time
      • Friday Pickup Time
  5. Enter additional Shipper Details:
    • Shipper Details
      • Validate Address
      • Negotiated Rates
      • Declared Value
      • Shipper Release
    • Hazardous Materials
      • Emergency Phone
      • Emergency Contact
    • Dry Ice. For further information visit www.UPS.com/Help Center
      • Regulation Set
      • Unit of Measurement
    • Rating
      • Pickup Type
      • Customer Classification
      • Package Bill Type
  6. Enter the Export Details:
    • Export Details
      • Duties and Taxes Bill to
      • Split Duty VAT
      • Documents Only
      • Goods not in Free Circulation
      • Terms of Shipment
      • Reason for Export
      • Declaration Statement
      • Override Paperless
  7. If you will be using UPS® Worldwide Economy services with Master Carton shipments, enter the Exporter Address and Master Carton Details
    Exporter Address and Master Carton Details can also be added/amended later when you start using Master Carton shipments, by opening the Config section in the Shipping Integrations screen.
    • Exporter Address:
      • Exporter Company Name
      • Exporter Attention Name
      • Exporter Email Address
      • Exporter Phone Number
      • Exporter Address Line 1
      • Exporter Address Line 2
      • Exporter Address Line 3
      • Exporter City
      • Exporter State Province Code
      • Exporter Postal Code
      • Exporter Country Code
    • Master Carton Details:
      • Master Carton Package Width
      • Master Carton Package Height
      • Master Carton Package Depth
      • Master Carton Packaging Weight
      • Master Carton Packaging Type
      • Master Carton Service 
        NB! Master Carton details have to be adjusted per each Master Carton shipment prior to manifest filing. See more here.
  8. The registration is now complete, click Close to move on to adding UPS services to your integration.

Next Steps