Upload multiple orders with a CSV

You can upload bulk order data directly into Shippit using a CSV (comma separated values) file. This is especially useful if you have a highly customised or bespoke workflow that doesn't integrate directly with the Shippit platform. This can help to save you time, and minimises the need for manual data entry, helping to reduce errors.

You can download this sample CSV file to use as a starting point.

The Integrations page in the Shippit Settings, showing the CSV upload screen

This article guides you through the various formats and fields to use for a successful CSV upload. For general information and best practices about using CSV, see the understanding CSV and FTP article. For instructions about using an FTP server, see the uploading from FTP article.

CSV file format

All valid CSV files are supported, with values comma separated. For each row in your CSV file, an order is created. Make sure your uploaded CSV does not have duplicate columns with the same header. If you import a file with duplicate headers, it could return an error, or you might find that the first column is uploaded, but all subsequent columns are ignored.

Fields

Field name	Example	Details	Required?
`order_id`	`0123456789`	Any internal reference number for the order from your source system.	Optional
`retailer_invoice`	`INV-12345`	The invoice number for the order from your source system.	Optional
`validate`	`yes` or `no`	If set to `yes`, address validation must pass before the order is accepted.	Optional
`suppress_communications`	`yes` or `no`	If set to `yes`, tracking updates are not sent to the recipient for this order	Optional
`delivery_instructions`	`Leave at front door`	Any delivery instructions to provide to the carrier	Optional
`authority_to_leave`	`Yes`	Whether or not the package has authority to be left at the recipient's address	Optional
`courier_type`	`standard`	The carrier service level to use for this order	Optional
`courier_allocation`	`acme_express`	The carrier string to allocate this order to	Optional
`collection_point_id`	`123`	If using a collection point, the ID of the collection point to deliver to	Optional
`collection_point_name`	`Melbourne Central`	If using a collection point, the name of the collection point to deliver to	Optional
`delivery_date`	`2025-10-08`	For on demand and priority orders, the delivery date selected by the recipient	Optional
`delivery_window`	`13:00-16:00`	For on demand and priority orders, the delivery window selected by the recipient	Optional
`currency`	`AUD`	The currency to use for all amounts in this order	Optional
`shipping_amount`	`12.99`	The amount charged for shipping costs	Optional
`cash_on_delivery_amount`	`122.99`	The amount to be collected by the carrier before delivery can be completed	Optional
`tax_amount`	`22.99`	The amount of tax charged on this order	Optional
`delivery_company`	`ACE Enterprises`	The name of the company to deliver the package to	Optional
`delivery_address`	`123 Main St`	The first line of the address to deliver the package to	Required
`delivery_suburb`	`Mascot`	The suburb to deliver the package to	Required
`delivery_district_city`	`Sydney`	The district or city to deliver the package to	Required
`delivery_state`	`NSW`	The state to deliver the package to	Optional
`delivery_postcode`	`2000`	The postcode of the suburb or city to deliver the package to	Required
`receiver_name`	`Jane Doe`	The full name of the person receiving the package	Optional
`receiver_contact_number`	`+61412345678`	A phone number for the person receiving the package	Optional
`receiver_language_code`	`EN`	The two-letter language code to use in communications with the receiving the package	Optional
`user_firstname`	`Alex`	The first name of the person placing the order, which might be different to the package receiver.	Optional
`user_lastname`	`Adams`	The surname of the person placing the order, which might be different to the package receiver.	Optional
`user_email`	`[email protected]`	The email address of the person placing the order, which might be different to the package receiver.	Optional
`customs_duties_amount`	`22.99`	For international orders, the amount of duties charged on this order	Optional
`customs_export_reason`	`Permanent`	For international orders, the reason the goods are being exported. For a list of valid export reasons, see the Developer Guide.	Optional
`customs_incoterm`	`DDU`	For international orders, the incoterm to apply to this order. For a list of valid incoterms, see the Developer Guide.	Optional
`customs_tax_id_type`	`IOSS`	For international orders, the tax ID type to apply to this order. For a list of valid tax IDs, see the Developer Guide.	Optional
`customs_tax_id_country_code`	`AU`	For international orders, the two-letter country code associated with the tax ID for this order.	Optional
`customs_tax_id_number`	`AE1001`	For international orders, the number of the tax ID for this order.	Optional
`customs_recipient_id`	`PASS123456`	For international orders, the number of the ID for the recipient of this order.	Optional
`customs_receiver_freight_charge_amount`	`22.99`	For international orders, the amount being charged for freight on this order.	Optional
`customs_documents_require_printing`	`yes` or `no`	For international orders, if set to `yes`, the customs documents need to be printed out on paper.	Optional
`cross_border_provider`	`zonos`	For international orders, the name of the cross-border provider facilitating the shipment, such as Zonos or Global-e.	Optional
`cross_border_order_reference`	`123456789`	For international orders that use a cross-border provider, the reference number used by that provider.	Optional
`line_item_id`	`1234`	An internal reference used to identify the product being shipped, such as the order ID.	Optional
`sku`	`cm-ceramic-black`	The SKU of the product being shipped	Optional
`title`	`Cotton T-Shirt`	The name of the product being shipped	Optional
`weight`	`0.7`	The charged weight of the package, in kilograms	Optional
`length`	`7`	The length of the package, in centimetres	Optional
`width`	`3`	The width of the package, in centimetres	Optional
`depth`	`11`	The depth of the package, in centimetres	Optional
`quantity`	`2`	The total number of the product ordered	Optional
`quantity_packed`	`1`	The total number of the product being shipped	Optional
`price`	`99.99`	The retail price of the product being shipped	Optional
`cost_price`	`77.99`	The cost price of the product being shipped	Optional
`retail_price`	`88.99`	The retail price of the product being shipped	Optional
`location`	`W1-E16`	The warehouse location of the product being shipped	Optional
`dangerous_goods_code`	`PI966` or `UN3481`	The dangerous goods code of the product being shipped	Optional
`dangerous_goods_text`	`Lithium ion batteries`	The text description of any dangerous goods being shipped	Optional
`origin_country_code`	`CN`	For international orders, the two-letter country code for the country of origin of the product being shipped.	Optional
`tariff_code`	`61091000`	For international orders, the tariff or HS code of the product being shipped	Optional
`mid_code`	`AUHM123`	For international orders, the MID code of the product being shipped	Optional

⚠️ IMPORTANT: It is possible to use a CSV file that contains column names that do not exactly match these. In that case, make sure you map the columns appropriately when you upload the file.

Upload a CSV file to your Shippit account

When you have created your CSV file, you can upload it to your Shippit account and see your order in the New Orders page.

💡NOTE: Always use the template as your starting point. This ensures all required fields are present and correctly ordered. For more information on best practices for CSV uploads, see the understanding CSV uploads article.

Uploading a CSV file

Log in to your Shippit account, and navigate to Settings → Integrations.
In the Select an integration section, click CSV/FTP.
Check Upload via the Web Interface and click Continue.
Click Upload orders CSV file
Click Choose file and navigate to the CSV file you have stored on your local system. Click Upload orders to upload the chosen file.

When your orders have been imported, they are available for confirmation and labelling in the New Orders page.

CSV template

You can download this sample CSV file to use as a starting point:

orders-sample-connect.csv

Orders with multiple parcels

Upload multiple CSV files automatically using an FTP server

New Orders page

Understanding tracking statuses

Understanding CSV and FTP uploads