CSV Import

The CSV import tool enables you to bulk import tracking information to orders from CSV files.

Preparing the CSV file

The CSV file consists of five mandatory columns, with column header names that must be followed exactly. In addition, there are two optional columns that may also be included. It is essential to ensure that all the mandatory columns are present in the file:

ATTRIBUTE	TYPE	VALUE	DESCRIPTION
order_id	string	WooCommerce Order ID (i.e 12345)	compatible with a few Custom Order Numbers plugins
tracking_provider	string	Shipping Provider Name	the name must match the provider name on the shipping providers list.
tracking_number	string	Tracking number
date_shipped	date	DD-MM-YYYY or MM-DD-YYYY	Date when the package was shipped. Optional – keep Blank to use the import date.
status_shipped	int	Do Not Change – 0 (null) Completed (Shipped)/Shipped – 1 Partially Shipped – 2	Update the order status and send the shipping confirmation email
sku*	string	Line item (product) SKU	The product or variation SKU – The SKU must exactly match and be unique per product/variation
qty*	int	Line item (product) quantity	The quantity of the product SKU that was shipped

*Please note: The Tracking Per Item feature is only available in the AST Pro version.

Please avoid using Excel when you create or edit the CSV files since it adds formatting and character encoding to the CSV files and that can cause issues with the import. We recommend using the following CSV editors:

• Google spreadsheets (Google Drive)
• Free spreadsheet app in OpenOffice

Example of CSV file:

You can download a sample CSV file:

Import the CSV file

1. Upload the CSV file from your computer
2. Choose if you would like to override the existing tracking details for the orders or to add the tracking in addition to existing tracking numbers
3. Choose the Date Format in the CSV file, you can choose between 2 formats – dd-mm-YYYY or mm-dd-YYYY
4. Click continue to start the import process, once the import completes you will get a detailed report of any issues in the import.

Upload the CSV file, choose import settings, and click continue to start the import:

The import will begin and will display the status of the imported tracking numbers:

Once the import completes you will get a detailed report of any issues in the import:

Import Tracking per item from CSV

The AST PRO allows you to Import tracking numbers per item and adds 2 columns in the CSV file, the product SKU and the quantity shipped.

For example, if we received order #12345 with 4 items:

1. T-shirt (TSHIRT) x 2
2. Blue jeans (BJEANS) x 2

Let’s assume that you ship these products in 2 boxes, each has its own tracking number, one tracking number for the T-Shirts and one for the Blue Jeans:

When you ship the T-Shirts and the Blue Jeans as a set, each set in a package with different tracking number, the CSV File should be formatted this way:

You can download a sample CSV file for an example of the correct formatting: