Getting started with MoversConnect—a MoversSuite integration

Sync orders between the Supplier Portal and MoversSuite

Important: This integration requires admin access to MoversSuite. For technical assistance, please contact us prior to attempting your setup.


Steps 1–5 should be performed in MoversSuite Administration

Step 1: Set up XML

  1. Open MoversSuite Administration
  2. Navigate to Administration > XML Interface and click 'Click here to add a new Interface'
  3. Set Vendor Name to 'HandledDotCom'
  4. Save

    XML_Interface-1
  1. Navigate to Administration > XML System and click 'Click here to add a new XML System'
  2. Set Interface to 'HandledDotCom'
  3. Set Internal System to 'HandledDotCom'
  4. Click 'Click here to add a new XML System Data Type Map' — a new modal appears
  5. Set Xml System Data Type to 'Order Information'
  6. Set Name to 'HandledDotCom'
  7. Save (on modal)
  8. Save (on XML System)

    XML System-details

    XML System-1

Step 2: Connect

  1. Navigate to MoversConnect > VendorConnect 
  2. Expand the second 'Handled.com' section:

    Screen Shot 2021-03-24 at 10.07.08 AM
  3. Select the branch you wish to connect using the 'Click here to add a new Branch Item' button
  4. Copy the ID associated with the Parent Agency found in Supplier Portal > Settings > Integrations (MoversSuite section)
  5. Paste the ID into the 'External Code' field and click 'Save'
  6. Expand the first 'Handled.com' section:

    Screen Shot 2021-03-24 at 9.53.28 AM
  7. Click the 'Upload VendorConnect Settings To MoversConnect' button
  8. Any new orders will now sync when created

Step 3: Map commodity properties

  1. Navigate to Administration > Commodity
  2. Use the 'Click here to add a new Interface Item' to add 'HNDL' 
  3. Enter 'HHG' into the 'External Code' field

Step 4: Map shipper email type

  1. Navigate to Administration > Shipper Email Type Setup
  2. Expand the 'Primary' section
  3. Use the 'Click here to add a new Interface Item' to add 'Handled' and click 'Save' 

Step 5: Map house type properties

  1. Navigate to Customer Services > Address Location Type
  2. Expand the 'Apartment' section and use the 'Click to add a new Interface Item' button to select 'Handled' from the drop-down list 
  3. Enter 'apartment' (all lowercase) into the 'External Code' field and click 'Save'
  4. Expand the 'House' section and use the 'Click to add a new Interface Item' button to select 'Handled' from the drop-down list 
  5. Enter 'house' (all lowercase) into the 'External Code' field and click 'Save'
  6. Expand the 'Mini Storage' section and use the 'Click to add a new Interface Item' button to select 'Handled' from the drop-down list 
  7. Enter 'storage' (all lowercase) into the 'External Code' field and click 'Save'
  8. Use the 'Click to add a new Interface Item' to add 'Studio.' Then use the 'Click to add a new Interface Item' button to select 'Handled' from the drop-down list 
  9. Enter 'studio' (all lowercase) into the 'External Code' field and click 'Save'

Step 6: Map note type properties

  1. Navigate to Customer Services > Note Type
  2. Use the 'Click here to add a new Note Type' button to enter these values:
    1. Note type: Handled.com
    2. Van Line Code: HANDLEDCOM 
  3. Click 'Add' to save

Step 7: Test connection is working

  1. In the Supplier Portal, use the 'Send Test' button to confirm you are receiving orders 
  2. Confirm 'I Received Test Order' or contact us for help with troubleshooting