HikaShop Custom Fields Import

| HikaShop

The HikaShop Custom Fields Import explains how to setup and import Custom Fields for HikaShop.

Read more ...

HikaShop Shipping Rates Import

| HikaShop

This tutorial explains how to run the HikaShop shipping rates import to import shipping methods and shipping prices into Hikashop.

Read more ...

Import of HikaShop Variants using RO CSVI

| HikaShop

This document explains on how to import variants of HikaShop Product using Characteristics.

HikaShop Brands Import

| HikaShop


Importing Brands into HikaShop is same as importing category into HikaShop except that category_type field value will be set to manufacturer.

category_path is a required field in brands import. Without this CSVI will not know if a record has to be added or updated. If the given category_path matches in the database records, the record will be updated else a new record will be inserted. So for updating we need to make sure the given category_path is correct. category_type value should be always manufacturer as HikaShop organises manufacturer as its category.

Creating the template

A template can be created by following these steps:

  1. Go to Components -> CSVI Pro -> Templates
  2. Click New
  3. Give the template a name, say for example Hikashop Brands import
  4. Set Action to Import
  5. Set Component to HikaShop
  6. Set Operation to Category
  7. Click Next: Select Source
  8. Source is set default to Load from your computer. No need for change.
  9. Click Next: Select options
  10. The default values are OK, change if needed.
  11. Click Next: Select fields
  12. Nothing needed here as we set to Use column headers as configuration in step 10.
  13. Click Next: Finalize
  14. All done here
  15. Click Close to return to the list of templates or Edit if you want to fine-tune the template further.

Hikashop brand create template

Adding the template fields

Template fields can be added by following these steps:

  1. Go to Components -> CSVI Pro -> Templates
  2. Click on Template fields
  3. In the Search Tools select your template
  4. Click on New to add a single field or click on Quick Add to add multiple fields.

Quick Add

The Quick Add Option allows you to quickly add multiple fields to a template. It is not possible to set any settings per field here but that can be done after the fields have been added to the template.

Hikashop brand template fields

Required fields

  • category_path
  • category_type


These fields make up the criteria to determine if the record is going to be updated or added. If all the criteria fields match an existing record, the record will be updated. If not all the criteria fields match, the record will be added.


  • category_path

Creating the import file

As in the example file, the fields we are trying to import are listed below, more fields can be added according to the requirement. Check the fields tab to know on the available fields for this import operation.

  • category_name
  • category_description
  • category_path
  • category_type (the value will be manufacturer)
  • category_published

Run the import

The import can be run by following these steps:

  1. Go to Components -> CSVI Pro -> Import
  2. Select the template created earlier with name Hikashop Brands import
  3. Click Select file
  4. Select the file to import
  5. Click Preview
  6. You now see a preview of the file as to how CSVI sees the file
  7. Click Start import
  8. The import is run
  9. The Log details page will be shown with information regarding the import if the Enable logging is enabled in the template

Hikashop brands import process


"Lenovo";"Lenovo electronic products";"manufacturer/Lenovo";"manufacturer";"1"
"Apple";"Apple electronic products";"manufacturer/Apple";"manufacturer";"1"

Example file


Further reading

Import result can be seen in the HikaShop categories page.

hikashop brands importresult 

Read more ...

Export HikaShop order after an order is created

| HikaShop

This document explains how to export an order immediately after an order has been created in HikaShop. 

Required fields

The following is needed to export an order after it has been created in HikaShop:

  • A HikaShop order export template must exist in RO CSVI
  • The HikaShop RO CSVI Export plugin must be installed, active and the HikaShop order export template selected
  • A Mass Action trigger for "After an order is created" needs to be created

HikaShop order export template

The first step is to create a HikaShop order export template in CSVI. Follow these steps:

  1. Go to Components -> RO CSVI
  2. Click on Templates -> Templates
  3. Click on New to create the new template
  4. Give the template a name
  5. Set the Enabled field to Yes
  6. Set the Enable front-end/cron field to Yes
  7. Set a Secret key, this is needed to run all automated import/export
  8. Set the Operations to:
    HikaShop Order operations
  9. Fill in the rest of the template settings per your needs
  10. Save the template settings
  11. Go to Templates -> Fields
  12. Add the needed fields to your order export template

The destination of an export can be set to multiple locations:

  • Download
  • Save on server
  • Save on FTP server
  • Email

It will be good to know that the Download option cannot be used here because of the way the system works. It will not be much use either as you don't want the customer to get an export of the order.

 HikaShop CSVI Export plugin

This plugin is needed because this picks up the trigger by HikaShop and calls RO CSVI to run the export. The plugin can be downloaded from the Download -> CSVI Extensions page.

After the plugin is downloaded it needs to be installed and configured following these steps:

  1. Go to Extensions -> Manage
  2. Install the HikaShop CSVI export plugin
  3. Once the installation is finished, go to Extensions -> Plugins
  4. Filter the list on csvi export
  5. Click on the HikaShop CSVI Export name to edit the plugin
  6. Select the HikaShop order template created earlier from the list
    HikaShop RO CSVI Export plugin settings
  7. Enter the secret key that was set in the template in step 7
  8. Set the Status to Enabled
  9. Optionally set also if you want to use the order ID as filename
  10. Optionally set a file extension
  11. Save the plugin settings

Mass Action trigger

To ensure that an export is run after an order is created in HikaShop, a mass action needs to be created.

  1. Go to Components -> HikaShop
  2. Click on System -> Mass actions
  3. Click on New to create a new mass action rule
  4. Fill in the details as below. The name can be anything you like.
    Mass action after an order is created
  5. The other settings on the page are not needed.
  6. Save the Mass action

Ready for use

Now that everything is configured, the system is ready for use. The procedure that is being followed is this:

  1. Customer places an order in HikaShop
  2. HikaShop triggers the mass action "After on order is created"
  3. The trigger is picked up by the HikaShop CSVI Export plugin
  4. The plugin will trigger the RO CSVI template selected in the plugin
  5. The template will export the order placed by the customer

Read more ...