Atlas Order Numbers

 

When Atlas changes an order number, MoversSuite can be set to have the updated Atlas Order Number replace the previous order number set within MoversSuite. More specifically, MoversSuite can check to see if the order download includes a Previous Order (PREORD) attribute. If one is found, then this number is compared to any existing Atlas order in MoversSuite and, if it’s found, then we update the Order Number in MoversSuite to reflect the new order associated with the download.

 

To enable this functionality, there is a simple setup required; however, by default, this option is turned off. To turn on this functionality, an XML System Option must be added to the Atlas XML System Setup record within the Admin Tool. For details on this setup, see Atlas Integration Initial Setup  and then “Step 5. XML System Setup” for those settings.

 

There are very important notes when it comes this functionality and how it works in certain MoversSuite versions, due to the development process. The caveats are:

 

    In releases 2024.22, 2024.23, and 2024.24, Atlas downloads worked as if this new XML System Option was set to true; therefore, all users had this functionality by default. There is no way to turn this feature off in these specific versions. Setting this option while these versions are installed will have no effect while these versions are running.

 

    Once release 2024 R25 or higher is installed, Atlas downloads will work as if this new XML System Option was set to false. To have this functionality, the setup is required.

 

Of note, the Order Number change only occurs if there is not revenue entered on the prior order (the PREORD). In the Atlas Order Number changes and revenue has been entered on the “PREORD,” then the following happens:  

 

    The “PREORD” order in MoversSuite keep the same order number.

    A new order will be created based on the new shipment coming in from Atlas.

    From the new order, the user can get to the “original” order by using the Related Order section > “Go To” button, located within Move Information.

 

The specific attributes related to this update from the Atlas Download XML include the following:

 

Attribute

Description

<Type>PREORD</Type>

<Number>NNNNNNNNN</Number>

This attribute, if present, contains the prior Order Number within Atlas. MoversSuite now checks the <Number> element associated with PREORD for a match to any existing Atlas order in MoversSuite. If a match is found, then the MoversSuite order is updated to what is set for the <Shipment> attribute.

<Shipment>NNNNNNNNN</Shipment>

This attribute contains the current Order Number that will replace the matched PREORD number.

 

Situations where the Atlas Order Number will change and thus require updating in MoversSuite can include but are not limited to:

 

    Atlas will change their order number when the hauling mode is changed to or changed from “Local.”

 

    Atlas does include the new Order Number in when they send in a Registration Send. MoversSuite needs to interpret this and update the Order Number in MoversSuite.

 

    Update Order Number based on what comes down from Atlas if there is no revenue attached to the order.

 

    The Atlas Order Number can change when the Atlas order changes from being an Interstate move to a local or intrastate move, which necessitates a change in the Atlas assigned order number or vice versa.

 

    There are some other rare reasons this can happen when certain product lines use different Atlas order number schemas and the order switches between them; however, those are relatively rare occurrences.