UPS WorldShip Integration


Previous Page  Next Page

Processing Shipments in WorldShip

 

1.Open UPS WorldShip.

 

2.Click on the UPS Import/Export Data menu.

 

3.Select Keyed Import option.  For the sub menu that appears, select the name of your ImportMap created in Creating an Import Map in WorldShip

 

NOTE: 

If the name does not appear on the menu, select the More option.  The name should appear in the list; if the name you entered does not appear in the list you will need to create the import map manually.  This is common for network setup of UPS or if WorldShip was installed on your PC using a path different than the default.

 

4.The Enter Import Key window opens.  Enter a Seradex OrderStream number for an approved shipment and press Enter (do NOT click on the Close button).  The data from the shipment will automatically populate the form.  Process the shipment as you normally would.  Enter a shipment number in the Enter Import Key window to process another order.

 

NOTE:  If you return to Seradex OrderStream and make changes to a shipment, you will not see the changes in WorldShip until you close and re-open the Enter Import Key window.

 

Creating an Import Map in UPS WorldShip

 

1.Open UPS WorldShip

 

2.On the Tools drop down menu, select Profile Editor. The Profile Editor screen will open.

 

Profile Editor Screen

Profile Editor Screen

 

3.Select your profile from the Profile Name drop down menu and click the Reference tab.  In the Reference Number 1 field enter 0.  Check the Use on all Packages box.

 

4.Click the Options tab and ensure the Quantum View Notify box is unchecked.  Click Close to return to the main Worldship screen.

 

5.Click the UPS Import/Export Data drop down menu and select Create/Edit Map.

 

 

6. In the New Map area, select Import from ODBC Database.

 

 

7. Select Shipment from the drop down list for the map type.

 

8. Enter a name for the map in the Name field (Choose any name e.g. WorldShip Import Map)

 

9. Click the Create button.  The Select an ODBC source box will open.

 

 

10. Select a ODBC connection (DSN):

 

This is the ODBC source (System DSN) that should point to your Seradex OrderStream ActiveM database where the source query to retrieve the Shipping information resides.  The query can look like this (e.g. query name: UPSShipments):

 

SELECT dbo.SalesOrder.SalesOrderNo, dbo.Shipping.ShippingNo, 'Shipping' AS Shipping, dbo.CustomerShipTo.Name AS ShipToName, dbo.CustomerShipTo.Phone AS ShipToPhone,

dbo.CustomerShipTo.Fax AS ShipToFax, dbo.Addresses.AddressL1 AS ShipToAddress1, dbo.Addresses.AddressL2 AS ShipToAddress2,

dbo.Addresses.AddressL3 AS ShipToAddress3, dbo.Addresses.PostalCode AS ShipToPostal, dbo.Cities.DescriptionShort AS ShipToCity,

dbo.StateProv.StateProvCode AS ShipToState, dbo.Countries.DescriptionTiny AS ShipToCountry, dbo.Contacts.Name AS ShipToContact,

dbo.Customers.CustomerNo AS BillToCustomerNo, dbo.Customers.Name AS BillToName, dbo.Customers.Phone AS BillToPhone, dbo.Customers.Fax AS BillToFax,

dbo.Customers.email AS BillToEmail, Addresses_1.AddressL1 AS BillToAddress1, Addresses_1.AddressL2 AS BillToAddress2,

Addresses_1.AddressL3 AS BillToAddress3, Addresses_1.PostalCode AS BillToPostal, Cities_1.DescriptionShort AS BillToCity,

StateProv_1.StateProvCode AS BillToState, Countries_1.DescriptionTiny AS BillToCountry, 'Order ' + dbo.SalesOrder.CustomerPO + ' has shipped' AS EmailText,

dbo.Shipping.Weight, '' AS Cancelled, dbo.Shipping.Comment AS UPSNotification1, '' AS Residential, dbo.Contacts.email

FROM dbo.StateProv RIGHT OUTER JOIN

dbo.Countries RIGHT OUTER JOIN

dbo.Cities RIGHT OUTER JOIN

dbo.Addresses INNER JOIN

dbo.SalesOrder INNER JOIN

dbo.CustomerShipTo ON dbo.SalesOrder.CustomerShipToID = dbo.CustomerShipTo.CustomerShipToID ON

dbo.Addresses.AddressID = dbo.CustomerShipTo.AddressID RIGHT OUTER JOIN

dbo.Shipping LEFT OUTER JOIN

dbo.Customers INNER JOIN

dbo.Addresses AS Addresses_1 ON dbo.Customers.AddressID = Addresses_1.AddressID ON dbo.Shipping.CustomerID = dbo.Customers.CustomerID ON

dbo.SalesOrder.SalesOrderID = dbo.Shipping.SalesOrderID ON dbo.Cities.CityID = dbo.Addresses.CityID ON dbo.Countries.CountryID = dbo.Addresses.CountryID ON

dbo.StateProv.StateProvID = dbo.Addresses.StateProvID LEFT OUTER JOIN

dbo.Contacts ON dbo.CustomerShipTo.ContactID = dbo.Contacts.ContactID LEFT OUTER JOIN

dbo.Cities AS Cities_1 ON Addresses_1.CityID = Cities_1.CityID LEFT OUTER JOIN

dbo.StateProv AS StateProv_1 ON Addresses_1.StateProvID = StateProv_1.StateProvID LEFT OUTER JOIN

dbo.Countries AS Countries_1 ON Addresses_1.CountryID = Countries_1.CountryID LEFT OUTER JOIN

dbo.Contacts AS Contacts_1 ON dbo.Customers.ContactID = Contacts_1.ContactID

WHERE (dbo.Shipping.Approved = 0)

 

11. Select UPS Shipments query from ODBC Tables drop down list on the left.  The list of fields in the table appears in the window below the drop down list.

 

12. Using the UPS WorldShip Field Map table below, you will now begin mapping fields from the UPS Shipments query of Seradex OrderStream ActiveM(on the left side) to the corresponding fields in WorldShip(on the right side).

 

 

13. The first field to map is ShippingNo. Before mapping it, you must define this field as the primary key.  Select ShippingNo and click on the Define   Primary Key for Import button.  This sets the shipping number in OrderStream as the primary identifier for the shipping record.  As small blue appears next to the ShippingNo row.

 

14. Now with ShippingNo still selected map the field.  Using the drop down list under WorldShip Fields, select the category(table), Package.  From the corresponding list the windows below Package, select the field Reference 1.  In essence, this relates Seradex OrderStream field, "ShippingNo" to the "Reference1" field in the "Package" category of WorldShip.

 

15. Click on the Connect button to link the fields.  A small red infinity symbol appears next to the fields indicting that they are now  linked.  You can then see the linked fields in the What You Have Mapped So Far list at the bottom of the screen.

 

16. Repeat steps 14 and 15 until you have mapped all of the fields listed in the table, UPS WorldShip Field Map, below.  (For  each field mapping, be sure to select the category listed in the table below from the WorldShip Fields drop down list).

 

17. When you get to the Shipping field you must perform a couple additional steps to map Service Type names in WorldShip to those you have setup in OrderStream(Ship Via)

 

18. After you map the Shipping field, highlight the mapping in the lower window, What You Have Mapped So Far.

 

19. Click the Edit button.

 

 

18. The Mapping Connections into Shipment Information window opens.  Click Translations.

 

19. In the Select a common map box, select Service. Click OK.  This loads the default service options into the External Field and WorldShip Field lists.

 

20. The External Field list represents the Seradex OrderStream names for corresponding WorldShip services listed in the WorldShip Field list. (i.e. 1DA is the OrderStream default name for WorldShip Next Day Air). Highlight each service type (i.e. Shipping methods) that you use.  In the External Field field type the name you used in OrderStream setup for that service type.  Click Rename to save each re-named service type.  (If make a mistake, click Translations, and then Service, OK to reload the default service option lists again.)  When you are finished renaming all your service types, click OK.

 

 

21. Continue mapping the fields according to the UPS WorldShip Field Map below.  When all of the fields are properly linked, click on the OK button.  Your view returns to the Create/Edit Map window.

 

UPS WorldShip Field Map (for versions 5.x and later)

 

Seradex OrderStream Field

WorldShip  Category

WorldShip Field

ShippingNo

Package

Reference1

CustomerNo

Ship To

CustomerID

Email

Ship To

Email Address

Email

Shipment Information

Notification Recipient 1Email

Shipping

Shipment Information

Service Type

Weight

Package

Weight

Cancelled

Shipment Information

Void Indicator

ShipToName

Ship To

Company Or Name

ShipToContact

Ship To

Attention

ShipToAddress1

Ship To

Address 1

ShipToAddress2

Ship To

Address 2

ShipToCity

Ship To

City or Town

ShipToState

Ship To

State/Province/County

ShipToPostal

Ship To

Postal Code

ShipToCountry

Ship To

Country/Territory

ShipToPhone

Ship To

Telephone

UPSNotification1

Shipment Information

QVN Ship Notification or Return Notification 1 Option

UPSNotification1

Shipment Information

QVN or Return Notification Option

SalesOrderNo

Package

Reference2

Residential

Ship To

Residential Indicator

 

22. Click OK to return to the WorldShip screen.