How to Export and Import Orders in Gridbox Store App Using a CSV File?

With the built-in CSV Order Import and Export tool, you can migrate orders from third-party eCommerce platforms to Gridbox Store App. This tutorial will show you how to import or export orders using the CSV file.


Attention!

We strongly recommend creating a store backup before importing a CSV file.

Gridbox CSV File Format. Standards and Requirements

Sample CSV File: Download CSV.

Attention!

The column names in the CSV file are the data synchronisation identifier. The column data will not be imported if you change the column name.

Column

Description

Required

ID

Order ID. Must be unique. If the value is empty, the order ID will be assigned automatically.

Yes

Date

The date must be entered in the format: year – month – day (YMD). For example:

  • 2023-10-26
  • 2023-07-19

Yes

Status

Order status.

Optional

SKU

Product SKU.

Optional

Title

Product title. If this value is empty, the product will be named Product_ID.

Yes

Product Type

Product, Option, Variation, Extra Options, Digital Product, Subscription.

Optional

Option

Product options. Values must be separated by a slash "/". For example:

  • Size / S
  • Size / M
  • Color / Blue
  • Color / Black

Optional

Variation

Product variations. Values must be separated by a slash "/". For example:

  • S / Blue
  • S / Black
  • M / Blue
  • M / Black

Optional

Extra Options

Extra product options. Values must be separated by a slash "/". For example:

  • Color / Blue
  • Color / Black

Optional

Min. Qty

Minimum quantity of products that can be ordered. The field supports only the numeric format without separators. For example:

  • 1
  • 5
  • 10

Optional

Price

Product price. The field doesn't include any currency symbols. For example:

  • 10
  • 15.55

Optional

Payment Method

The name of the payment method.

Optional

Shipping Method

The name of the shipping method.

Optional

Branch

Branch shipping.

Optional

Coupon Code

Coupon code that provides a discount.

Optional

User

Username.

Optional

Email

Store email from Contact Info of Store Settings.

Optional

First Name

First name of the customer.

Optional

Subtotal

Cart subtotal. The field doesn't include any currency symbols. For example:

  • 10
  • 15.55

Optional

Discount

Discount amount. The field doesn't include any currency symbols. For example:

  • 0.75
  • 10
  • 15.55

Optional

Shipping Price

Shipping price. The field doesn't include any currency symbols. For example:

  • 10
  • 15.55

Optional

Tax

The value of the tax rate. The field doesn't include any currency symbols. For example:

  • 10
  • 15.55

Optional

Total

Cart total. The field doesn't include any currency symbols. For example:

  • 0.75
  • 10
  • 15.55

Optional

NOTE! If you enter a value for Option or Extra Option that does not exist, the field will be blank. Therefore, previously create Options and Extra Options that you need in the Gridbox Store App.

Import CSV File

1. In the Gridbox dashboard, mouse over the icon Store App ➝ Orders.

2. Click the button Import/Export CSV.

Importing Gridbox CSV File

Importing Gridbox CSV File is a method for uploading a previously exported Gridbox CSV file. This method is suitable for bulk creation or editing of existing Gridbox orders.

1. Choose Gridbox CSV File from the dropdown list.

2. Select a CSV file.

3. Click on the checkbox in the fields as needed:

  • Create store backup before import
  • Overwrite products with the same ID

4. Click the button Import.

Importing 3rd Party CSV File (Matching Fields)

Importing 3rd Party CSV File is a method for uploading a CSV file from 3rd-party eCommerce extensions and platforms to the Gridbox Store App. To import a 3rd-party CSV file, you need to match the fields of your file with the existing fields in the Gridbox Store App.

1. Choose Match Fields from the dropdown list.

2. Select a CSV file.

3. Click on the checkbox in the fields as needed:

  • Create store backup before import
  • Overwrite products with the same ID

4. Click the button Next.

5. Match fields from the uploaded CSV file and click the button Next.

Exporting CSV File

1. In the Gridbox dashboard, mouse over the icon Store App ➝ Orders.

2. Click the button Import/Export CSV ➝ tab Export.

3. Uncheck the fields that are not used in the CSV file.

4. Click the button Export.

Exporting Certain Orders

To export some orders, select the orders click the Import/Export CSV button repeat steps above.

Exporting Orders by Date Range

Select the date range select all orders click the Import/Export CSV button repeat steps above.