Opentaps Shipping Setup

opentaps can access the web API's for UPS, US Postal Service, DHL, and Federal Express. To use opentaps with these shipping services, contact your representative and obtain the necessary shipping credentials. Then edit the file applications/product/config/shipment.properties and modify them as needed.

IMPORTANT NOTE: For external shipping rate estimates services to work properly, you must configure warehouses with the correct ZIP code.

Setting up the US Postal Service

You can register for an shipping API key on the USPS Web Site. There you can also apply for permission to use the Address Validation API on the USPS API Request Page, so that you can set up opentaps for address validation.

USPS may ask you to test your service. If so, see USPS Rate Calculator Setup for their specific instructions on how test it.

Once you have the production API keys, you will need to modify the file applications/product/config/shipment.properties to set the USPS webtools key and the production access URL.

When trying to get USPS rate estimates, make sure that you do not pass a <Container> tag in your string if you are requesting a rate for the Express and the Priority. Otherwise, you will get error messages like: "Invalid container type. Valid container types for Priority Mail are Flat Rate Envelope and Flat Rate Box." or "Valid container type for Express Mail is Flat Rate Envelope." See USPS Rate Estimate API.

Setting up UPS Shipping

You must be approved to use the Premium Shipping Tools from UPS, or you will not be able to schedule shipments and generate labels with opentaps. If when trying to schedule a shipment with UPS in opentaps you see the error:

 An error occurred [code:250003] with severity Hard: Invalid Access License number.

then your shipping credentials have not yet been approved for online shipping.