UPS Link Setup Tabs


StarShip's UPS module supports small parcel and international shipments, with AES Direct integration for shipments requiring EEI (Electronic Export Information) filing.

Once you have your account information, you can enter it into StarShip from Setup > Carrier Interface > UPS or in the Carrier Interfaces section of the Initial Setup Wizard.


Notes :


Main Tab

This tab displays information about UPS communication settings and currently registered UPS accounts for this StarShip installation.



Disable use of UPS : Check this check box if you do not want UPS to be available for rating or shipping. UPS will not appear in the Carrier field on the Shipment tab.

UPS Terms and Conditions Accepted : Check this check box if you have read and agree to the UPS Terms and Conditions, accessible by clicking on the "Read..." link.



UPS Developer Kit Tracking Terms and Conditions accepted : Check this check box if you have read and agree to the UPS Developer Kit Tracking Terms and Conditions, accessible by clicking on the "Read..." link.


Enable background tracking

Background tracking collects shipment data so that you can look up delivery information for past shipments and generate late delivery reports from the StarShip Dashboard.

Background tracking must be globally enabled for StarShip in the StarShip Server under Tools > Options > Background Tracking. It can then be enabled/disabled for each individual carrier in carrier setup.



If you have successfully commissioned at least one account (displayed as the Main account), data regarding its parameters and the mailbox’s parameters are shown here.  The lower memo area displays account status information for each account separately.



Carriers Tab

The Carriers tab will only show UPS as a supported carrier. Entries cannot be added or deleted.


Accounts Tab

If you haven't already done so in the Initial Setup Wizard, you can commission or edit a UPS account from the Accounts tab. The Contract Services section shows all the UPS contract services available for the selected account. Enabled services will have a green dot beside them (see below). UPS automatically enables/disables these services based on your account.


See Set up a UPS account for instructions on how to set up and commission one or more UPS accounts.




Resend the Add Shipper Request

You may be instructed by tech support to resubmit the request to add a shipper number to the active mailbox. If the initial request failed, the Resend Add Shipper button will appear when you click on the account. Clicking this button will automatically resend the request to UPS.



Account Properties

Once your account is commissioned, you can configure account properties by selecting the account and clicking the Edit button. The following are the tabs that may appear, based on your account:



This is the address and contact information for this account.




This account has been set up with UPS to use Negotiated Rates

Check this check box if you have negotiated rates associated with the account and you want to use them in StarShip. You will also have to fill in the Invoice information from your last UPS Delivery Service Invoice. As noted on the dialog, it may take between 24-48 hours before you can use your negotiated rates.


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 are calculated as follows :





UPS International Shippers Agreement submitted

Check this check box if you have submitted the UPS International Shippers Agreement required to process International shipments with UPS.


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.


Next Barcode Reference Number

These settings configure the printing of bar coded labels. If you have shipped with this account using previous versions of StarShip or UPS WorldShip, the next barcode reference number needs to be set to a different range than was previously used to prevent the tracking numbers from overlapping.



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.


Restricted Articles

This tab appears if the Restricted Articles service is enabled by UPS for this account. The allowed articles are designated by a check mark next to the item. This is configured by UPS and cannot be modified.


End of Day History

This tab allows you to browse end of day history based on Posted Date or a date range, and status. You can also reupload the PLD or reprint end of day documents for shipments.

See : End of Day History



Fuel Surcharge

This tab displays the active fuel surcharges by active date, with the option of manually overriding them.




Reference Fields

Reference fields allow the recipient to track incoming packages using a reference field (such as the PO#) along with the ship date or your shipper number, or other information that may not normally appear in a shipment’s details. StarShip supports up to 5 different Reference fields at the package level and 2 different Reference fields at the shipment level. This tab also includes a section for other Reference fields: Special Instructions - Package Level and Receiver Location ID - Shipment Level.

Specify the shipment fields to include as reference fields by selecting them from the drop-down lists. Each of the standard shipment and package level reference fields have an optional two letter identifier to help the recipient identify the nature of the information. Reference fields and identifiers are uploaded to UPS at end-of-day processing.

The Label Tag column allows you to change the default tag on the label from Reference 1, 2, etc. to a label of your choosing.





This tab contains miscellaneous settings for adding information to labels under specific conditions.  

Show third party account number on the label

Enable this option to have StarShip print the account number of the billable third party on the shipping label.


Show freight collect account number on the label

Enable this option to have StarShip print the freight collect (recipient) account number on the shipping label.


Print thermal labels for Call Tags

With UPS Returns, StarShip will print a label only if "Print Return Label" is selected for UPS Returns under Shipment Options on the Shipment tab. If you need to print a Return Label for your own records, check this check box.


Use line items as commodities with UPS-generated commercial invoice and PLD upload (for Int'l shipments)

When this setting is checked, StarShip will individually upload each line item to UPS in the PLD file. For example, two items identified by the same code will be uploaded as two lines : Item A with quantity 1 and Item B with quantity 1, along with the individual item description, value, etc.

When unchecked, the items are rolled up by Schedule B Code in the PLD upload to UPS. So in the example above, the two items will be uploaded as one line with a quantity of 2, and the item description is derived from the Schedule B description.


Require package dimensions to ship

When checked, package dimensions must be entered on the Packaging tab in order to Ship/Process a shipment.


If this option is checked and package dimensions are missing from the shipment, Ship/Process will fail and an error message displays.





Additional Info

This tab displays the supported billing types and shipment options available for this carrier interface.