Logo

Automatically import orders via CSV using File Monitor

Learn how to use the File Monitor to automatically import orders from CSV files.

3 min readUpdated April 7, 2025

When using Starshipit in your browser, you can bulk upload orders directly into your account. The File Monitor takes this further by watching a folder on your computer and automatically importing CSV files into Starshipit as orders. To find the supported file template, go to CSV File Setup in Starshipit.

Set up the File Monitor

  1. Open the Starshipit Desktop App on your computer.
  2. In the menu bar, click CSV File Monitor > Settings.
  3. Tick Enable CSV File Monitor.
  4. Beside Directory to watch, click Browse to instruct the File Monitor where to find CSV files to upload from.
  5. Beside Directory where successful files are moved, click Browse to instruct the File Monitor where to move files to once they have been successfully uploaded.
  6. Beside Directory where files with errors are moved, click Browse to tell the File Monitor where to move files to if they have returned errors during upload.
  7. Tick Enable Writeback of Tracking Numbers.
    This will retrieve tracking numbers for printed unmanifested orders and place in the specified folder every 5 minutes.
  8. Beside Directory to writeback tracking numbers, click Browse to tell the File Monitor where to move files for tracking numbers.
  9. Click Save then Close.
Info

Once the auto-import setting is enabled, the Print App will monitor the folder you specified to read CSV files in real time. The app will then push it to Starshipit over the API using HTTPS.

Upload orders with File Monitor

Once set up, you can begin uploading orders into the print app. To upload orders:

  1. Ensure that the app is running on your computer.
  2. Open the folder you selected as the folder to read CSV files from.
  3. Copy paste in (or drag and drop) the CSV file which contains the information for the orders you'd like to upload, into the folder you've selected as the f****older to read CSV files from.
  4. Once added, StarshipIt will automatically begin uploading the orders.
  5. Imported orders will appear in the New tab of the Print App and also be available in the New tab of the Starshipit web app.

If all orders are imported successfully, the CSV file will be moved to the folder you selected during setup in Step 4. It will also have _IMPORTED added to the end of the file name.

If any orders cannot be successfully imported, the CSV file will be moved to the folder you selected during setup in Step 5. It will also have _ERROR added to the end of the file name.

Troubleshooting

File Monitor creates a log of all order imports which can be found by going to Tools > Open Log Folder.

To see why an order failed to upload, go to Tools > click Open Log Folder > click to open the importLog file.

Was this article helpful?

Related Articles