How to Import Test Consignments

How to Import Test Consignments

If your user is in Test Mode or has been Enabled to see Test Consignments you will be able to generate Test Consignments via the Import Consignments Option. 

How to Navigate to Import Consignments screen 

  • To get to the Import Consignments screen, from the top menu Create/Manage, click Import Consignments under the Consignments section. 

  • Or you can alternatively use the link here. 

Import Consignments Process 

MachShip can facilitate the mapping of a consignment file which you are able to internally produce in any of XML, Delimited or JSON formats. If you are unable to produce a file or are happy to utilize the MachShip generic version then please provide a file in the following format. 

Despatch DateDespatch TimeCarrierAccountServiceFrom Location NameFrom Location AbbreviationFrom ContactFrom PhoneFrom EmailFrom Address Line 1From Address Line 2From SuburbFrom PostcodeTo Location NameTo Location AbbreviationTo ContactTo PhoneTo EmailTo Address Line 1To Address Line 2To SuburbTo PostcodeSpecial InstructionsReference 1Reference 2QuantityItem SKUItem nameTypeLengthWidthHeightWeight
                                  
  • Add CSV Files (required fields only apply when attempting to create a consignment. If you are importing orders (pending consignments) then you can provide as much or as little data as desired) 

    • Despatch Date and Despatch Time (Not Required): If not provided then the current date will be utilised. 

    • Carrier, Account, Service (Not Required): If you wish to consign with a particular Carrier, Account or Service set them here. If not, MachShip will create the consignment via either the lowest cost or fastest ETA model. These will be the abbreviations stored in MachShip rather than the names. For example: TNT Road Express the carrier is TNT and the service is 76.

    • From/To Location Name or From/To Location Abbreviation (one is required): You can either fill in the location name or its abbreviation. If it is a saved location, all the address info fields can be left blank. For a new one, Address Line 1 and Suburb are required.

    • From/To Address Line 1 (required), Address Line 2, Suburb (required), Postcode (required), Contact, Phone or Email.  (Note: Required fields are only if not using saved location): If you are not using a saved location then you will need to provide at least the address line 1 as well as a suburb postcode combination from the from and to locations. 

    • Reference 1 and Reference 2: Set reference field 1 and reference field 2. Please note that the Generic Consignment Import workflow will consolidate the file by From and To Locations as well as reference 1 and reference 2. 

    • Items(Required): As stated above, the Generic Consignment Import workflow will consolidate rows based on the same from/to location details and reference 1 and reference 2. As such, each row will be one line item.

      You will be required to set:    

      • Quantity: Quantity for each line item. 

      • Item SKU or Item Name: If you decide to use a saved item, enter the SKU or Name, it will use the dimensions from the saved item.

        If not using a saved item then you will need to provide:

      • Item Type - i.e Skid, Pallet, Carton or any other valid MachShip item type
      • LengthWidthHeight (cm)
      • Weight (kg)

An example of the file import would be as follows:

Despatch DateDespatch TimeCarrierAccountServiceFrom Location NameFrom Location AbbreviationFrom ContactFrom PhoneFrom EmailFrom Address Line 1From Address Line 2From SuburbFrom PostcodeTo Location NameTo Location AbbreviationTo ContactTo PhoneTo EmailTo Address Line 1To Address Line 2To SuburbTo PostcodeSpecial InstructionsReference 1Reference 2QuantityItem SKUItem nameTypeLengthWidthHeightWeight
     Test Sending Location Test Sender61422 123 123test@test.com123 test street Melbourne3000Tim Test Tim Testington  123 Test Street Sydney2000Enter Through Front Gate1231234564562 Big CartonCarton25256020
     Test Sending Location Test Sender61422 123 123test@test.com123 test street Melbourne3000Tim Test Tim Testington  123 Test Street Sydney2000Enter Through Front Gate1231234564562 Small CartonCarton2525153
  • Import Consignments
    • Select Add Files and select the relevant file to be uploaded.


    • Then Select Upload


      The file will then appear in the import files grid as below:

    • Import Type
      • TEST MODE - Import With Fallback: The import preview screen will show any errors, any consignments with errors will come through as Pending Consignments everything else will import as a consignment.

      • TEST MODE - Import Without Fallback: The import preview screen will show any errors and you are not able to proceed further.

      • TEST MODE - Order: All the items will be imported as pending consignments. 

  • File FormatFor each uploaded file, you can select the import file format, the default one is “GENERIC CONSIGNMENT IMPORTER V2”. Otherwise, select the relevant workflow you require. 

You need to select any file on the list that you want to import and click on Import Consignments button to start the process.

Once selected the Import Consignment Modal will appear. This will validate the file and then request you to select the Route Selection Option. Once complete, select Import Consignments. 

Once the import is complete MachShip will provide you with a list of successfully imported consignments or pending consignments and their relevant PC or MS numbers. 


    • Related Articles

    • How to Delete Test Consignments

      The three types of Test Consignments which have been created are: Test Pending Consignments Test Unmanifested Consignments Test Manifested Consignment How to Delete a Test Pending or Test Unmanifested Consignment The deletion of Test Pending or Test ...
    • How to Stop a User from seeing Test Consignments

      If there is a user who does not need to see Test Consignments then you simply need to set that edit that users Test Mode type to be Disabled From Seeing Test Consignments. Navigate to Admin and select View Users To find the user you are looking to ...
    • How To Set A User In Test Mode

      Setting a user in Test Mode enables a user to access the MachShip's sand-boxed testing environment. This will access live quoting but will not push out any data to transport providers. This is useful when testing out integrations or training team ...
    • What is a Test Mode and How is it Shown

      In order to enable a user to fully test the consignment creation workflow from end to end, Machship has created the ability to set a User or a Carrier Account into Test Mode. What is Test Mode Test Mode is the MachShip sandboxed setup which will ...
    • How to Create and Manifest a Test Consignment

      To Create a Test Consignment via the Create Consignment Screen ensure that either you have your User in Test Mode , or that you have access to Test Carrier Accounts. How to Navigate to Create a New Consignment To get to the Create Consignment screen, ...