UniGroup Upload Setup and Administration

 

UniGroup works in conjunction with MoversSuite Queue Service and MoversSuite API Service (Standard XML Pipeline) to transfer data between the two systems automatically or through manual options available through the Tools Menu.

 

The following table lists the administrative setting needed to create an environment to upload data to the UniGroup mainframe. Contact UniGroup for the latest supported codes and values for your system.

 

Administrative Setting

Description

Address Location Type Setup

UNIGROUP SPECIAL SERVICES UPLOAD:

Establish supported Location Codes that link to Location Type values associated to addresses set within Extra Stops and Name, Address, Phone. Set Location Codes as External Code values for the UniGroup interface.

UniGroup currently supports the following Location Codes (check with UniGroup for an updated list):

 

External Code

Description

01

Residence

02

Business

03

Storage-in-Transit

04

Permanent Storage

05

Pier to tradeshow

06

Warehouse or Drayage Co.

07

Other than listed

08

Agent warehouse

09

G11 (origin addresses only)

 

The last code of 09 is only supported for origin address locations.

Agent Setup

Verify that agents assigned to UniGroup orders link to a UniGroup supported Van Line; the Van Line for UniGroup must point to a Van Line Setup record with a Van Line Code of U or M.

UniGroup supported Agent records also link to Branch Setup records, which in turn supply the UniGroup affiliation to orders (Branch assignment) and to personnel (Default Branch assignment) records.

Commodity Setup

Establish proviso codes referenced by UniGroup for revenue classification and linked to an order through the Commodity setting within Move Information. UniGroup recognizes the following codes:

 

External Code

Description

SCOM

Special commodities

DISP

Safeguard

ELEC

Safeguard

 

 

Material Type Setup

Use this setup to link carton information to Item Code records.  Item descriptions must match the correct VL Service Code within Item Code Setup

Refer to UniGroup Carton Codes for a listing of generally accepted codes from UniGroup.

Note Type Setup

Use this setup to associate Note Type records to Van Line Code values supported by UniGroup for Memo Pad downloads.

Note:

If the application is unable to match on a Van Line Code during a Memo Pad download, then it will create a Note Type record automatically for the code.

Refer to Unigroup Memo Pad Download Content for usage.

See UniGroup Note Codes for a listing.

Personnel Setup

UNIGROUP SPECIAL SERVICES UPLOAD:

You must establish a Default Branch and User ID for each salesperson.

Set the Default Branch within the Branch tab to a record that links to a Van Line that links to UniGroup through Van Line Setup. The Van Line is set within Branch Setup.

Set the User ID within the Interface Mapping tab for the UniGroup Interface for each support salesperson record. The User ID must be established within UniGroup as well.

Salesperson is set on the order through the Name, Address, Phone tab.

Order Number Setup

Establish Order Number format and optionally specify a UniGroup affiliated Van Line for orders created in MoversSuite.

Payment Method Type Setup

UNIGROUP SPECIAL SERVICES UPLOAD:

Use this setup to define Payment Method Type records mapped to UniGroup External Code values for Special Services (SCOM) uploads.

UniGroup recognizes the following codes:

 

External Code

Description

CC

Inbound

PP

Outbound

AE

American Express

VC

Visa

MC

Mastercard

DC

Discover Card

 

 

Queue Service Setup

Verify the queue service setting are correct and functioning.

Optionally, add Queue Service Message Type Items for the services you wish to receive a copy of the message exchanged between the process and the MoversSuite Queue Service. The type of message types specific to UniGroup uploading include the following:

UniGroup HHG Upload

UniGroup MemoPad Upload

UniGroup Special Services Upload

UniGroup TransDocs Upload

 

Queue Service Server Setup

UNIGROUP HHG UPLOAD:

Create an entry for a HHG Upload from UniGroup. This record points MoversSuite to the request, retry, and error file locations.

 

Field

Value

Queue Service System

MoversSuite Queue Service

Queue Server Name

UniGroup HHG Upload

Discard All Bad Messages

(unchecked)

 

Create four Queue records underneath this one record as specified below.

 

Define a Request Queue:

 

Field

Value

Queue Role

Request Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\mss_hhgupload_request

 

Define a Mirror Queue:

 

Field

Value

Queue Role

Mirror Queue

Queue Type

IBM Messaging

Name of the IBM Messaging Queue

U99999.XMLA.ESTI.UPLOAD

Queue Manager Name

UPQX

Use Message Group

(checked)

Transport Type

TCP/IP

Encoding

ASCII

 

Define a Retry Queue:

 

Field

Value

Queue Role

Retry Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_hhgupload_retry

 

Define an Error Queue:

 

Field

Value

Queue Role

Error Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_hhgupload_error

 

UNIGROUP MEMOPAD UPLOAD:

Create an entry for a MemoPad Upload from UniGroup. This record points MoversSuite to the request, retry, and error file locations.

 

Field

Value

Queue Service System

MoversSuite Queue Service

Queue Server Name

UniGroup MemoPad Upload

Discard All Bad Messages

(unchecked)

 

Create four Queue records underneath this one record as specified below.

 

Define a Request Queue:

 

Field

Value

Queue Role

Request Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\mss_memopad_request

 

Define a Mirror Queue:

 

Field

Value

Queue Role

Mirror Queue

Queue Type

IBM Messaging

Name of the IBM Messaging Queue

U99999.XMLA.MEMO.UPLOAD

Queue Manager Name

UPQX

Use Message Group

(checked)

Transport Type

TCP/IP

Encoding

ASCII

 

Define a Retry Queue:

 

Field

Value

Queue Role

Retry Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_memoupload_retry

 

Define an Error Queue:

 

Field

Value

Queue Role

Error Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_memoupload_error

 

 

UNIGROUP SPECIAL SERVICES UPLOAD:

Create an entry for a Special Servicves Upload from UniGroup. This record points MoversSuite to the request, retry, and error file locations.

 

Field

Value

Queue Service System

MoversSuite Queue Service

Queue Server Name

UniGroup Special Services Upload

Discard All Bad Messages

(unchecked)

 

Create four Queue records underneath this one record as specified below.

 

Define a Request Queue:

 

Field

Value

Queue Role

Request Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\mss_memopad_request

 

Define a Mirror Queue:

 

Field

Value

Queue Role

Mirror Queue

Queue Type

IBM Messaging

Name of the IBM Messaging Queue

U99999.XMLA.ESTI.UPLOAD

Queue Manager Name

UPQX

Use Message Group

(checked)

Transport Type

TCP/IP

Encoding

ASCII

 

Define a Retry Queue:

 

Field

Value

Queue Role

Retry Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_specialservicesupload_retry

 

Define an Error Queue:

 

Field

Value

Queue Role

Error Queue

Queue Type

Microsoft Messaging

Path to the Microsoft Messaging Queue

.\private$\mss_specialservicesupload_error

 

 

Service Type Setup

Define service type records mapped to UniGroup Van Line Code values using this setup.

Shipment Type Setup

Use this setup to define Shipment Type records mapped to UniGroup Van Line Code values.

UniGroup recognizes the following codes:

 

External Code

Description

C

COD

 

N

National Account

 

G

Government/Non-Military

M

Government/Military

P

Prepaid

T

Transferee Prepaid

 

 

UniGroup Quotes to Go Setup and Administration

Define the web service information and data mappings needed to exchange data with the UniGroup Quotes to Go system.

Valuation Setup

Valuation per Pound Setup

UNIGROUP SPECIAL SERVICES UPLOAD:

Establish supported valuation codes that link to the UniGroup interface and verify that the Van Line associated to the record is a United Van Lines record (Van Line Code = U within Van Line Setup). Valuation is set for an order within the Move Information tab. The Special Services Upload also requires an associated Per Pound amount (also set within the Move Information tab).

Link External Codes for each supported valuation code to the UniGroup interface. UniGroup currently supports the following codes (check with UniGroup for an updated list):

 

Valuation Code

Description

G

No Deductible

A

$250 Deductible

B

$500 Deductible

 

 

XML Interface Setup

Define “UniGroup” as an interface and establish links between UniGroup External Codes and supported Van Lines and identify branches that will support UniGroup uploads through Branch Mapping.

XML System Setup

Define systems and sub-systems needed for exchanging data with UniGroup and TransDocs. 

See XML System Setup and XML System Setup (UniGroup) for details.

 

 

RELATED TOPIC:

PSI:Capture Integration Setup

TransDocs Integration Setup

UniGroup Quotes to Go Setup and Administration