How to Import International Consignments

How to Import International Consignments

The Import Consignments feature allows you to import any delimited, XML or JSON file containing consignment or order information.

How to Navigate to the Import Consignments screen 

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


  • Or you can also use the link here. 

Import Consignments Process 

MachShip can facilitate the mapping of a consignment file which you can internally produce in any XML, Delimited or JSON format. If you cannot produce a file or are happy to utilize the MachShip generic version, 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 nameTypeLengthWidthHeightWeightIs InternationalInternational From CityInternational From PostcodeInternational From ProvinceFrom Country CodeInternational To CityInternational To PostcodeInternational To ProvinceTo Country CodeContent DescriptionContent Ref1Content Ref2Content Ref3Content QuantityContent Dollar ValueContent CI Marks and NumbersContent Harmonized CodeContent Part NumberContent PurposeContent Country of Manufacture
  FEDEX_INT  Pickup location name        Test To Location    123 testing street   Test spec123132111 CartonCarton1010105YES     123456 USATest Item Description   10250    USA

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 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.

    • Domestic: 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, you will need to provide at least the address line 1 and a suburb postcode combination from the from and to locations. This is for domestic Australian addresses 
    • Reference 1 and Reference 2: Set reference field 1 and reference field 2. Just so you know, 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 Name - this is a free text field
      • Item Type - i.e Skid, Pallet, Carton or any other valid MachShip item type
      • LengthWidthHeight (cm)
      • Weight (kg)

International Specific Fields:

  • Is International (Required) - This is a boolean that advises the system that we are importing an International consignment - default for this is no.
  • International From City, From Postcode, From Province, International To City, International To Province, International to Postcode
    Users will populate either one of these selected fields. At a minimum MachShip will need one city or province and Postcode. 
  • International From Country Code, International To Country Code
    Here you will need to provide the 3 Alpha code identifier of the country for the Import / Export order
  • Customs Information - Item Contents

    Description - 
    The description of the goods being imported / exported

    Reference 1, Reference 2, Reference 3, CL Marks and Numbers, Part Number - 
    These fields will all identify either the object or the invoice/order 

    Quantity - 
    Quantity of the physical goods being shipped - note this will be different to the item quantity above, if it was 5 t-shirts packed in a carton then the quantity is 5

    Harmonized Code - 
    The global customs identifier for the class of goods being shipped

    Purpose - 
    This must describe the reason for sending the goods. Needs to match up with a known classification reason i.e sale, gift, return etc. 

    Country of Manufacture - 
    Will identify where the product was manufactured. You will need to select this from the drop-down of allowable MachShip values. 

    Unit Dollar Value -  This is the commercial dollar value of the goods in AUD - you would put in the value of one of the items and MachShip will then multiply out for the total

An example for export on the carrier Australia Post for 5 Tshirts manufacturers in Australia with a value of $1 being sent to New Lyn, 640 in New Zealand from Bonbeach Australia. 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 nameTypeLengthWidthHeightWeightIs InternationalInternational From CityInternational From PostcodeInternational From ProvinceFrom Country CodeInternational To CityInternational To PostcodeInternational To ProvinceTo Country CodeContent DescriptionContent Ref1Content Ref2Content Ref3Content QuantityContent Dollar ValueContent CI Marks and NumbersContent Harmonized CodeContent Part NumberContent PurposeContent Country of Manufacture
  AustPost  Pickup location name    123 testing  street Bonbeach3196Test To Location New Zealand    123 Testing Street   Test Special InstructionsTesting Reference 1Example Reference1 CartonCarton1010105YES     640New LynNZLT-Shirts   55    AUS
  • 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
      • 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.

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

      • 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 import International locations

      Saved Company Locations in MachShip allow for quick data entry when creating consignments. Below is how a user can import International addresses into MachShip system. How to create the Location Import CSV file The location import csv file template ...
    • How to Create an International Consignment in MachShip

      If you'd like to bypass the Quotes process and create an International consignment directly, you'll need to fill in all the required fields on the create consignment screen. Below is a sample demo video on how to create an International consignment ...
    • How to Create an International Consignment via the MachShip API

      Creating consignments is at the core of MachShip's functionality. Consignments describe everything related to a job that needs to travel, including the pick-up location, delivery location and the individual items themselves. On top of this, a ...
    • How to Create an International Quote in MachShip

      Quoting in MachShip is the simplest and quickest method in which to obtain a price and an ETA for your transport movement. How to navigate to create a Quote The Create Quote page is accessed via Create/Manage and Create Quote. Alternatively, the page ...
    • How to Generate an International price via API

      One of MachShip's primary functions is to dynamically generate prices and routes based on the items that are being sent. When pricing, MachShip will describe every despatch option and price that is available for a given combination of: Pickup suburb ...