UPS Account Setup


StarShip v15.3 and higher supports UPS Web Services. Shipments are sent to UPS in real-time and labels/forms are returned and printed by StarShip. There's no end-of-day upload of the PLD.

Follow these steps to set up a UPS Account.

Important :  If your account has been issued an invoice in the past 90 days, you must fill out the Rating section (Step 8) with the invoice information.


  1. Select Setup > Carrier Interface > UPS.
  2. On the Main tab, accept the UPS Terms and Conditions.

  3. Accept the UPS Developer Kit Tracking Terms and Conditions. When you click the check box, a dialog with Tracking Terms and Conditions pops up. Click "Yes, I Do Agree" and then click OK.

  4. Click the Accounts tab. Available UPS accounts are defined by your registration key. Select the UPS Account from the Accounts grid and click the Edit button. You can also double-click the account.

  5. The UPS Developer Kit License and Registration Wizard appears. Click Next.

  6. Type in the account address information. You can also select a previously set up Address ID from the drop-down list to populate the address fields. Click Next.

  7. The UPS Developer Kit License and Registration Wizard helps you to complete the necessary requirements for registering the UPS Developer Kit. You will need to register each account individually. Complete the steps provided by the wizard.

    Please read the terms and conditions of the UPS technology agreement required for use of the UPS Developer Kit. You must scroll to the end of the agreement in order to enable the “Yes, I Do Agree” radio button. You can also print the agreement by clicking the Print button. When you have agreed to the terms by clicking Yes, I Do Agree, the Next button is enabled and you can continue with the setup process.

  8. Invoice Information

    Entering the invoice information will add the account to your UPS profile. This will allow shipping with UPS Web Services and access to the account's negotiated rates. Check this option if have a UPS invoice from the past 90 days :  "This account has been issued a UPS invoice within the past 90 days". Then, fill in the Invoice information from your last UPS Delivery Service Invoice.

    Dimensional Weight Factor

    For each UPS service, you can enter custom dimensional weight divisors that are used to calculate the billed weight. Although UPS calculates and returns both the list (published) and custom rates, only the list value of the billed weight is returned. The dimensional weight factors below are used by StarShip to calculate and display the custom billed weight value on the Ship screen.

    The factors default to list (published) values, but can be modified here to reflect contract rates. This will
    not affect the charges, only the billed weight that shows on-screen. So, for example, If you have any freight rules that use the billed weight field, it will be updated so that freight rules work correctly.
    Use the Revert to Defaults button to reset values to the original defaults.

    The default dimensional weight  for U.S. domestic service packages and Canada Origin packages to the U.S. are calculated as follows :
  9. The account is registered. Click OK.

    The wizard then steps you through the Settings and Accessorial Charges setup dialogs.

  10. Next, configure Contract Settings for your approved contract services:

    Select or deselect your registered contract services based on what you want to allow. If you select a service for which you are not registered, you will get an error when you try to rate/ship.

    UPS Mail Innovations and UPS SurePost
    When you enable one or both of these options, you will be able to select the Services to include and add or maintain USPS Cost Centers on the next screen, UPS Mail Innovations and UPS SurePost.

    Request UPS Hazardous forms
    When shipping UPS HazMat shipments prior to StarShip v9.1, users had to use a different system, such as Labelmaster DGIS (previously Masterform), to generate the hazardous forms. With StarShip v19.1 and higher, UPS Web Services can now validate HazMat shipments and return the required shipping papers.
    Check this option if you want to use the UPS-generated hazardous forms. A few notes before you select this option:

    UPS Web Services does not allow the combination of hazardous packages and non-hazardous packages in the same shipment. When the option to Request UPS Hazardous forms is checked, you will be required to create different shipments for hazardous and non-hazardous packages. If you want to create shipments with both hazmat and non-hazmat packages, you can leave this option unchecked and continue to use Labelmaster to generate your UPS HazMat shipping documents.

    Also, when you check this option, you will need to use different label stock to print the hazardous forms.
    For more information on acquiring and printing the required forms, see UPS HazMat/DG Shipments.

    Restricted Articles
    Certain items that UPS lists as restricted can still be shipped on a contractual basis but you must have a contract with regular volume and be able to adhere to all regulations before UPS accepts it. Once your contract has been approved to ship restricted articles, you can select those items you were approved for here.

  11. Set up UPS SurePost® and UPS Mail Innovations®.

    If you enabled the UPS SurePost service, at least one SurePost service must be selected. If the "Only UPS SurePost APO/FPO & PO Boxes" box is selected, SurePost will only be available to those specific destinations.

    When shipping from multiple locations with a single account, you can use the Cost Center to differentiate between locations. In the field provided, enter a Cost Center code and click Add. The code may be alphanumeric and is limited to 50 characters. You can add multiple cost centers, which appear in the list below. The Cost Center is optional for both Mail Innovations and SurePost shipments.

  12. Next, configure International settings. The first section allows you to select the International documents to request from UPS when you process an International shipment. The documents will be compiled together into one PDF file, called the "UPS International Forms" in Printing Setup. For more information, see International Documents Setup.

    Company is AES4 approved

    If you are AES4 Approved, check this box so you can file the EEI post-departure. This setting must be enabled in order for the EEI post-departure option to appear on the International tab when processing International shipments.

  13. These are the list and contract charges for some accessorials for your UPS account. Only the accessorials not supported by the UPS Developer Kit will be shown in this grid. If you are currently using the Contract charges, you can use the Revert to List Charges button to go back to list rates.

  14. Click Finish.