How to set up the MachShip Printing Application to import Consignments via Folder Polling

How to set up the MachShip Printing Application to import Consignments via Folder Polling

The MachShip Printing Application is a locally installed application designed to allow the automated printing of item, consignment, and manifest paperwork. 

Though originally designed to enable users to print labels in an efficient manner, the MachShip Printing Application can also be configured to import consignments into MachShip by watching and consuming files which are dropped into a local folder - this is known as Folder Polling.

To configure the MachShip Printing Application to folder poll you will need to follow the video explainer below. This is a two-part video in part one we explain how to set up the import within the MachShip platform - this covers steps 1-5  below:

Part two covers off on how you can install, configure and test the MachShip Application for automated import via folder polling. This covers off steps 6 and 7 in the article below:

1. Navigate to the MachShip App Settings

To do this select Admin and Other Options.

Then select MachShip App Settings in the Advanced menu. 


This will take you through to the MachShip app settings grid showing all current active MachShip app settings your company has set up. 

2. Select Add MachShip App Settings

This will take you through to the Create MachShip App Settings page.

3. Set up the MachShip App Settings

You will need to provide MachShip with:

  • Name - This is a free text field.
  • Description -  This is used to outline what task this particular setup is designed to complete.
  • Company - The company this task needs to be completed for. It should be the highest company in the tree if it is completing tasks for multiple companies.
  • Email Addresses - These email addresses will be notified if there are any errors or warnings related to the files which are imported. The warnings will be raised under circumstances such as a user attempting to import the same files twice. If this is left blank then the email (used by the system) against the company page will be used as a default. 
  • Import Type
    Select what type of import needs to be completed:
    • Import with fallback
    • Import without fallback
    • Order

The form will look like the below:

4. Select Save MachShip App Settings

You will be navigated back to the Manage MachShip App Settings grid and the settings set up will be shown.

4. Select Edit MachShip App Settings

The final step will involve setting the consignment import format. To do this select the drop-down cog on your setting and select Edit App Settings

5. Assign the Consignment Importer

As there is the potential to have customised consignment import types, these are outlined in the Workflow documentation at the following link. You will need to have assigned a company to your MachShip App Settings before you can assign the consignment importer. Once on the edit screen, select the import type from the drop-down. 

Once complete select Save MachShip App Settings.

6. Assign the MachShip App Settings token to the MachShip Printing Application

Once you have saved the settings you will be returned to the MachShip App Settings grid. The setup will have been assigned a token which will be shown in the grid as below:

Take this token and open the app, select the Setting tab.

Enter the token in the field provided.

If the token is valid the page will appear as below:

7. Choose the Polling Folder location for the MachShip App to import files from

To assign the Polling Folder select Choose File and pick the desired location. 

The application will show as below:

Once this has been set up the MachShip Printing Application will begin to monitor and poll the files from the folder. Once the files are placed into the Polling Folder they will be sent to MachShip and imported in. Should the file have any errors, then they will be placed in an error folder created in the Polling Folder. If the file is successfully imported they will be placed in a success folder created in the Polling Folder. 

This will appear as below:

    • Related Articles

    • How to create Pending Consignments via Folder Polling

      The MachShip Printing Application is a locally installed application designed to allow the automated printing of item, consignment, and manifest paperwork. The installation and set up instructions are outlined here. Though originally designed to ...
    • How to import Consignments

      The Import Consignments feature allows you to import any delimited, XML or JSON file containing consignment or order information. How to Navigate to Import Consignments screen To get to the Import Consignments screen, from the top menu Create/Manage, ...
    • How to create a Pending Consignment via Import

      If you wish to create a placeholder for a future consignment, you can add a Pending Consignment. One of the ways in which a user can create a Pending Consignment in MachShip is via the import method. How to navigate to Import Pending Consignments ...
    • How to create Consignments via the Batch Consignment method

      The Batch Consignment creation method is best used when you want to create a series of consignments with the same shipping items, from the same pickup location to a set of different delivery locations, with the same Carrier and on the same Service. ...
    • How to create a Consignment via the Create Consignment screen

      If you wish to bypass the Quotes process and create a consignment directly, you will need to fill in all the required fields on the create consignment screen. Below sample demo video on how to create a consignment in MachShip: How to Navigate to ...