Import a File: Create a New Store & Map
How to add a CSV store, map a CSV file, and import orders
In This Article
The ability to import your orders from a spreadsheet that has been saved as a Comma Separated Value (CSV) file gives you the flexibility to import and fulfill orders from your own data source or database, sales channels not directly connected to Postsale, or lists of orders provided to you by a third party. In this article, we will:
- Explore how importing from a CSV file adds flexibility and saves time.
- Look at the advantages of including shipment information such as carrier, service, dimensions, and weight in your import file.
- Select your CSV file.
- Map the columns in your CSV file to the fields in Postsale.
- Save your map in a CSV store so that you can reuse it again for future order imports.
- How to import your orders
Before We Begin
This article assumes you are importing a CSV file for the first time. Please see this article if you have already imported a CSV file and wish to reuse a mapping file you already created.
Things You Will Need
Let’s make sure that you have everything you need to get started:
- When following the steps below, be sure that you have the CSV file containing your order records.
- Check out our Format Your File for Success help article. In the article we assist you with creating and formatting your CSV file to ensure that it imports successfully.
Sample CSV Files
To make creating your import file as easy as possible, the Check out our Format Your File for Success help article includes sample CSV files that you can use as a template for your own import files. The sample files contain:
- Column headings matching the corresponding data fields in Postsale. This makes it easy to map the correct fields in your file to the fields in Postsale.
- Sample order and shipment data that shows how your data should be formatted for a successful import.
Now that you have everything you need, let’s begin.
Step By Step
Real-World Example
We have been asked by St. Louis Dog Savers to ship a promotional T-shirt and a bumper sticker to their top 500 donors.
- They supplied us with a list of all the Ship To addresses and line item information.
- They also let us know that they want the shipments to be shipped with USPS Ground Advantage and specified the weight and dimensions of the package.
So, we created a CSV file containing all this information so that we can import all 500 orders and the shipment details into Postsale. Now, we need to add a CSV store to Postsale and create the file map so that we can import the orders.
Quick Tip Video
Here's a Quick Tip video that quickly covers the steps outlined in the rest of this help article.
1 - Select Your CSV File
The first step is to select the CSV file that contains the orders and shipment information you wish to import.
- Click Import in the Order Actions Menu.

- Select your CSV file using one of the following methods:
-
Drag and drop your file from your computer into the drag and drop interface.

- Click in the drag and drop interface. Then, navigate to your file and select it.
-
Drag and drop your file from your computer into the drag and drop interface.
The file you selected will be shown in the Import Orders pop-up. You are now ready to set up your store and create your map.

2 - Create Your Store & New Map
The next step is to create a new map and CSV store. The map tells Postsale how to import the data from your file and into what fields the data should be imported to in Postsale.
Since the file map is saved and associated with the store, you can import additional CSV files for the same order source in the future without the need to remap the file. In addition, all imported orders for the same order source are associated with the store, making it easy to keep orders organized.
Store Name & Settings
- Enter a name for your CSV Store into the Store Name field.

- Expand New Store Settings. Then, verify that you wish for Postsale to perform the following actions automatically:
Snippet: Store Setup Automation Settings
-
When an order is first imported
- Set the order's status to [select the status from the drop-down menu]
Enable this option to specify what the local status of the order should be set to when order's are imported for the first time. With this option disabled, the order's local status will be blank when imported.
- Set the order's status to [select the status from the drop-down menu]
-
When a shipment is processed
- Set the order's status to ‘Shipped’
With this option enabled, Postsale will set the order's status to ‘Shipped’ when a label is created for the order.
- Set the order's status to ‘Shipped’
-
When a shipment is voided
- Set the order's status to ‘Voided’
With this option enabled, Postsale will set the order's status to ‘Voided’ when a shipment is voided for the order.
- Set the order's status to ‘Voided’
Helpful Tips Prior to Mapping
Before you begin mapping your file, here are a few tips that may prove helpful during the process:
- The mapping screen breaks the data down into separate categories (Order, Address, Items, Charges, and so on). When you expand a category, only the fields in Postsale that relate to that category are shown. This helps to organize and simplify the mapping process.
- The categories of the mapping screen are broken into two columns:
- The fields in Postsale
- The columns in your source file, selectable from the drop-down menu
- The currently selected field name is highlighted to help you keep track of which field is currently being mapped.
- The fields in your CSV file that have been mapped and the fields that have not yet been mapped are clearly identified for you.
- Fields in your CSV file can be mapped to multiple fields in Postsale.
Map Your File
You're now ready to begin mapping your file. Expand and map each of the following sections:
Remember, since the file map is saved you will be able to quickly import additional CSV files for the same order source in the future without the need to remap the file.
Order Section
The Orders section defines general order information:
Importing New vs. Updating Existing Orders
Postsale updates existing orders by matching the Order Number and the Source fields in your imported file to the Order Number and Source associated with the orders in Postsale. If Postsale finds a match, then the order is updated with the information contained in your file. Otherwise, when no match is found, a new order is created.
We recommend that the Source and Number fields are mapped.
-
Source: Identifies the sales channel/order source for the order.
When mapped, the Source and Number fields are used together to uniquely identify an order in Postsale. -
Number: The order number/ID of the order. Used to uniquely identify orders in Postsale.
If the Number field is unmapped or if no order number is imported, Postsale will auto generate sequential order numbers for you. - Status: Identifies the status of the order. (shipped, not shipped, backordered, etc.)
- Requested Shipping: Identifies the shipping method requested by your customer.
-
Date: The date the order was placed.
Address Section
The Ship To and Bill To addresses are mapped together by default. Check the Map Bill To and Ship To Separately option to map them independently.
Mapping Name Fields
You only need to map either the Name field or the First Name and Last Name fields. However, you can map both if needed.
- Map the Name field if the first and last names are in the same field in your source file
- Map the First Name and Last Name fields if the names are in separate fields in your file

Items Section
Use the Items category to map the details of the items on your orders. There are two line item strategies available.
- All items are on a single row in your source file
- Items are on multiple rows in your file
Follow the steps below for the strategy that matches how your file is configured.
All Line items are on a Single Row
Select Single Row from the Item Strategy drop-down menu if all items for a single order are listed on a single row in your source file. 
Then, create the map for the maximum number of line items on a single order.
For example: Using our scenario, we would map for 2 line items since we will be shipping a T-shirt and a bumper sticker with each order for STL Dog Saver. Here’s how:
-
Click the Add button.
-
Map the fields on the Item Map pop-up. Then, click Save.
-
Repeat steps 1 and 2 for each line item.
Line Items are on Separate Rows
Select Multiple from the Item Strategy drop-down menu if the order’s items are listed on separate rows of your source file. 
Then, map the fields in the Items category. 
Include the Order Source and Order Number
When line items are on multiple rows, each row in the source file must include the Order Source and Order Number in addition to the item information so that Postsale knows to which order the items belong when imported.
Charges Section
Use the Charges section to map additional order charges, such as Tax, Shipping, Discount, Insurance, or Other charges.
-
Click the Add button.

-
Map the following fields:
- Description: Map to the field in your file that describes the additional charge on the order.
-
Amount: The amount of the additional charge.
- Select the type of charge from the Type drop-down menu.
-
Click Save.
Add as many charges as needed for the orders in your file.
Payment Section
Use the Payment section to map the payments for orders in your source file.
-
Map the Name and Amount fields.
- Name: Map to the column in your file that contains the payment type. (PayPal, Credit Card, etc.)
-
Amount: Map to the column containing the amount of the payments.
-
Click the Add button to map additional payment details such as the last four digits of a credit card number, the credit card security code, etc.
Notes Section
Use the Notes section to map to notes related to the orders in your source file. Add a map for each note associated to your orders.
For example: If you have a thank you message to your customers and an internal note for each order, you will add two note mappings.
- Click the Add button.
-
Map the Date and Content fields.
- When the Date field is unmapped, Postsale assigns the current import date.
-
Click Save.
Shipment Section
The Shipment section gives you the ability to map the shipment details for each order in your source file to the appropriate shipment fields in Postsale so that a shipment is automatically created for each order when your file is imported.
This has several, powerful advantages:
- It saves time. You won't need to create a shipment for each order after the import is complete.
- You can preview and select rates for each shipment as soon as your file is imported.
- Imported orders can be batch processed right away since each order is already configured with valid shipment details.
Real World Example
Using the example from the beginning of this article, let's assume that St. Louis Dog Saver specified the following shipment details for their Dog Saver T-shirt promotion:
- Carrier: USPS
- Service: USPS Ground Advantage
- Package dimensions:
- Length 12"
- Width 8"
- Height 2"
- Weight: 1.25 pounds
We added this information to the CSV file so that a shipment with the specified shipment details will be created for each order when imported.
Available Shipment Fields
Format Your CSV File for Success
The shipment data contained in your CSV file must be entered and formatted correctly in your CSV file in order for Postsale to import the data successfully. Review our Format Your CSV File for Success help article for details.
Fields marked with an asterisk (*) in the table below must be formatted correctly in your CSV file.
Table: Available Shipment Fields
The following shipment fields are available:
| POSTSALE FIELD | DESCRIPTION |
|---|---|
| Carrier* | The shipping carrier to use for the shipment. (USPS, UPS, FedEx, etc.) |
| Service* | The shipping service to use for the shipment. (UPS Ground, USPS Ground Advantage, FedEx Ground, etc.) |
| Apply Insurance |
Specifies if you want to apply Shipment Protection to the shipment.
|
| Insurance Amount | Specifies the amount of insurance to apply to the shipment when Apply Insurance is set to Yes. |
| Confirmation |
Determines if you wish for a shipment confirmation to be applied to the shipment.
|
| Residential |
Specifies if the Ship To address is residential.
|
| Package Type* | Defines the type of package being used for the shipment. |
| Length* | Specifies the length of the package |
| Width* | Specifies the width of the package |
| Height* | Specifies the height of the package |
| Dimensional Unit |
Defines the unit of measure to use for the dimensions.
|
| Weight* | Defines the weight of the shipment. |
| Weight Unit |
Defines the unit of measure to use for the weight.
|
Now that the mapping is completed, you are ready to import your orders and shipment information.
3 - Import Your Orders & Shipment Information
- Click Import Orders.

- Monitor the status of your import by viewing Notifications.

Once the import is complete, the Import Complete notification will list the number of new orders that were imported and the number of orders already in Postsale that were updated.
Click the magnifying glass icon to quickly view the orders included in the import.
4 - Update Your Store Settings & Map
When needed, you can update your store settings and map. Here's how:
Procedure: Settings > Store Settings
- Go to Settings.

- Select Store Settings.
- Select your new CSV file store from the list of stores.
Available Options
-
Store Logo: Click Logo to brand your store with a store logo.
- Postsale supports JPEG and PNG files with a recommended size of 3 MB or less.
- Larger image files will be reduced to the maximum file size of 3 megabytes when uploaded.
- The image will be uploaded and become the logo for this CSV store.
- The logo will automatically display in Postsale templates that include a logo, such as the Invoice with Logo template.
- Learn about editing an image in Postsale

-
Store Name: Click the Edit button to change the name of the store.

-
Add Store Address: Add a unique store address for this store. This is useful when you need to use a specific Ship From address for shipments for this store. Learn how to set the Default Ship From/Origin Address for your shipments.

- Edit the Map: Click Edit Map to update the file mapping for this store.

- Automation Settings: Specify if the order's status should be updated when a shipment is processed or voided.

Frequently Asked Questions
How does importing from a CSV file benefit me?
Having the ability to import from a CSV file gives you the ability to:
- Import order data exported from any sales channel or order source.
- Import Ship To addresses, order details, and shipment information provided to you by a third-party.
Can I include shipment details in my CSV file?
Yes. By including shipment details (carrier, service, package type, weight, dimensions, etc.) Postsale will automatically create a shipment for you and display your shipping rates. This saves time and effort by not having to create shipments or enter shipment details for each order.
I will be importing orders from multiple sources. The CSV files are formatted differently for each source. Can I create more than one CSV store in Postsale?
Yes. You can create as many CSV stores as you need. Each store allows you to create and save a unique map for the specific CSV file format used to import orders for the order source.




