Content ElementsShopping Cart Upload

Shopping Cart Upload

Sana Commerce 9.3
Your connector

Add Shopping Cart Upload to a Web Page

The Shopping Cart Upload content element can be added to the web pages (flexi-pages, product and product list pages) and system pages of the Sana web store. For example, you can create a separate flexi-page with the Shopping Cart Upload content element and add it to your web store navigation.

The table below provides description of the Shopping Cart Upload content element settings.

Field Description
Name Enter the name of the Shopping Cart Upload content element. It is shown on the web page in the Sana web store.
Description Enter description. For example, this can be a short instruction on how to import products using a CSV file.

If you support different units of measure and your customers are allowed to select a unit of measure for products, then you can also add short explanation of how to use units of measure when importing products to the shopping cart using CSV. See example on the screenshot above and below you can read more details about units of measure.
Template File Select a CSV template. It should be created beforehand. It can also contain a few demo records, for example product and product variants IDs, quantity and UOM. Customers will be able to download the CSV template from a page, fill it in with the necessary data, and then import it to the shopping cart.

The CSV template will help customers to fill it in with data correctly and to avoid issues with products import because of the wrong data.

You can use the CSV template which is already available in the add-on package. When the add-on is installed, you can find the CSV template in the Sana Commerce frontend directory: \content\files\content\CartUpload.

Maximum file size (MB) Enter the maximum size of the CSV file in MB.
Empty the shopping cart before upload This option defines whether all products, if there are any, should be removed from the shopping cart before importing products from the CSV file. If this option is disabled and there are products in the shopping cart, those from the CSV file will be imported in addition to those which are already present in the basket.
Redirect to cart This option defines whether a customer should stay on the same page when products are imported to the shopping cart or should be redirected to the basket automatically.

Import products with units of measure

If you use units of measure, then customers must enter a unit of measure ID in the CSV file for all products they import to the shopping cart. As unit of measure names are shown to the customers in the web store, but not IDs, thus you can also add unit of measure IDs to the shopping cart upload description to help your customers fill in the CSV file.

To help you, you can copy the HTML code below and paste it to the Description field. Before you paste the HTML code, you must first switch to the Code View mode in the editor. Note that the description below is just an example.

<p>Importing products from a single file is the fastest way to add products in bulk to the shopping cart and place an order.</p>
<p>To import products to a shopping cart:</p>
  <li>Download the CSV template using the link below.</li>
  <li>Fill the CSV file with all the required data, like product IDs, quantity, UOM, and product variant IDs.</li>
  <li> In case you need to specify the product unit of measure, see the table below. This table will help you to match the unit of measure with the correct unit of measure ID.
    <table cellpadding="4">
          <th>UOM ID&nbsp;&nbsp;&nbsp;</th>
          <td>gram (gram)</td>
          <td>KG (kilogram)</td>
  <li>Upload the CSV file.</li>

When you paste the HTML code, you can switch back to the normal view in the editor and change the description. You can provide the list of units of measure and their IDs which are used in your web store, so that your customers know what unit of measure IDs to enter in the CSV file. You can find unit of measure IDs in your ERP system. If you do not have access to it, you can ask the person who is responsible for data management in the ERP system your Sana web store connected to or if you are a web store administrator, you can open Sana Admin and go to: Tools > ERP connection > Debug ERP requests, and execute the "GetUnitsOfMeasure" request to see the units of measure IDs from the ERP system.

Content ElementsShopping Cart Upload