Menu Close
    Searching for an experienced Akeneo Development Company ?

    BigCommerce Akeneo Connector

    BigCommerce Akeneo Connector allows you to connect your BigCommerce store with Akeneo PIM platform. With the help of this integration, you can manage your entire catalog from Akeneo.

    Using this module, you can export products, categories, product options, attributes, custom fields, multiple images, from Akeneo to BigCommerce store.

     

    Basic Requirements:

    • This module works with Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x and 5.0.x. Download Akeneo from here
    • Node and Yarn packages need to be installed.
    • This module is compatible with the Akeneo community and Enterprise(Flexibility) edition.
    • If you want to use this extension on Akeneo EE Serenity mode, please contact us.
    • For the Akeneo installation, your Akeneo server should meet these system requirements.

    Video Tutorials

    Check out the following video tutorials below:

    How to get API keys?

    IETNWLGj9JU

    How to do module configuration?

    _7gtpsxYOQE

    Exporting Simple Product from Akeneo to BigCommerce

    AI8-VB_Haj4

    Features

    • Create product categories from Akeneo.
    • Export selected attributes as custom fields from Akeneo to the BigCommerce store.
    • Send multiple images of a product including variations.
    • Mention SEO information, inventory, pricing, shipping, other details in products.
    • Option to set fixed values for all exported products.
    • With the help of UI Mapping Export Custom Field’s Default Value.
    • Export the value of the variant in the custom field.
    • Remove the 0s at the end of the number of the metric unit.
    • Import Category, Attribute, Attribute Option, Family, Product and Product Model from BigCommerce to Akeneo.
    • Able to export Metrics attribute type in the custom field.
    • When export Metrics type, added the Unit to the end of the number.
    • Ability to export multiple select field attribute type and each option separated by a comma.
    • You can add any number of credentials.
    • This module is compatible with latest Akeneo version 5.0.x
    • Choose which products to export using various filters- category, family, completeness, time conditions, locale, currency.
    • Use identifier (SKU) for exporting specific products to the BigCommerce store.

    BigCommerce API Credentials

    Before you begin, you need to obtain API credentials from BigCommerce control panel. Log in to your store then follow Advance Settings>API Accounts>Create API Account. Now enter any name for this API account then copy API Path URL.

    create api account

    After that, you need to select ‘modify‘ scope for ‘Products‘ and Information & Settings options after that click to Save.

    modify products permission

    bigcommerce_store

    Once, you click the Save button; the API credentials will be visible to you, please copy them securely. Also, a text file will be downloaded automatically containing these credentials.

    API credentials created

    Installing a module for Version 4.0.x to 5.0.x

    For installing this module in Akeneo, please follow the below steps as mentioned:

    1. Unzip the respective extension zip then merge “src” folder into akeneo project root directory.

    src_4_x-all-mod

     

    2. Goto config/Bundles.php and add line:

    app-kernal

    Webkul\BigCommerceBundle\BigCommerceBundle::class => ['all' => true],

    3- Copy the “config” folder into akeneo project root directory for routing.

    configration

    4. You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

    php bin/console ca:cl --env=prod;php bin/console bigcommerce:setup:install --env=prod

    5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    For Akeneo 5

    For Akeneo 4

    sudo service php-fpm7.3 restart

    To run the Quick export in Akeneo 5.0.x, you need to run the below command.

    Install composer dependency

    php -d memory_limit=4G /usr/local/bin/composer --prefer-dist --no-scripts require navneetbhardwaj/akeneo-quickexport-configurator;

    After that, register bundle in config/bundles.php

    Define routing to create a file in the config/routes/wk_quick_export.yml

     

    Docker Installation Command :

    For Akeneo 5

    alias docker_php='docker-compose run -u www-data --rm php php';
    alias docker_yarn='docker-compose run -u node --rm node yarn';
    docker_php bin/console cache:clear --env=prod;
    docker_php bin/console pim:installer:assets --symlink --clean --env=prod;
    docker_php bin/console d:s:u --force;
    docker_yarn run webpack;
    docker_yarn run update-extensions;
    docker_yarn run less;

    For Akeneo 4

     

    Installing Module  for Version 2.x to 3.x

    For installing this module in Akeneo, please follow the below steps as mentioned:

    1. Unzip the respective extension zip then merge “src” folder into akeneo project root directory.

    Upload Webkul src folder

    2. Goto app/AppKernel.php and add line

    in function registerProjectBundles()

    Add code in AppKernel.php file

    new Webkul\BigCommerceBundle\BigCommerceBundle(),

    3. Goto app/config/routing.yml then add these lines at the top of the file

    Add code in routing.yml file

    big_commerce:
        resource: "@BigCommerceBundle/Resources/config/routing.yml"
        prefix:   /    
    

    4. You have to navigate first to Akeneo installation directory (Ex: cd /opt/bitnami/apps/akeneo/htdocs). After SSH, you have to run the command to your Akeneo server by the terminal.

    php bin/console ca:cl --env=prod;php bin/console bigcommerce:setup:install --env=prod

    5. If you are using php-fpm. Then you need to restart the php-fpm services and apache web server.

    sudo service php-fpm7.2 restart

    Common Issues After Installation

    It might happen that even after proper installation, upon opening your Akeneo admin dashboard, you see a loading screen. In that case, do check for the following solution:

    • Webpack Installation: If you get the below error
      Webpack errorIt means that webpack is not installed in your system. Run the following command

      npm install --save-prod webpack
      npm install
      
    • Module routing.yml is not configured properly. Re-check the routing.yml file as mentioned in the 3rd step of Module Installation
    • Clear your browser cache.

    Setup Credentials in Akeneo

    After successfully installing the BigCommerce Akeneo Connector module, please log in to your Akeneo platform then navigate to BigCommerce Connector>Setup Credentials.

    BigCommerce-Connector-Configuration-1

    After that click on the Create Credentials. The following page appears, when you need to enter the following:

    • API Path
    • Client ID
    • Client Secret
    • Access Token

    credentials

    Credentials:

    You can add multiple credentials in BigCommerce Akeneo Connector. You  need to activate the credentials to export the products from Akeneo to Bigcommerce. The active credential will be visible at the time of creating an export profile.

    You can also enable the option to Quick Export the products from the Akeneo product grid.

    • Activated
    • Default for QuickExport

    BigCommerce-Connector-Configuration-1-1

    Attribute Mapping

    You need to do the attribute mapping of Akeneo attributes with BigCommerce product fields. While exporting products from Akeneo to BigCommerce, various information is sent to your e-commerce store. You can send the following product information from Akeneo:

    • Name
    • Price, Cost Price, Retail Price, Sale Price.
    • Tax Provider Tax Code
    • Product SKU
    • Weight, If weight is zero, it will become a downloadable product in the BigCommerce store.
    • Width, Height, and Depth
    • Description
    • Shipping – Free Shipping and Fixed Shipping Price
    • Multiple Images
    • Inventory Tracking – Current Stock Level and Low Stock Level
    • Brand Name
    • Product UPC/EAN Number
    • Bin Picking Number
    • Call for Pricing
    • Search Keywords
    • Visible
    • Featured Product
    • Sort Order
    • Minimum Purchase Quantity and Maximum Purchase Quantity
    • SEO – Page Title, Meta Keywords, Meta Description

    BigCommerce-Connector-Configuration-2-1

     

    Fixed Value for All Products

    On the right, you can provide a fixed attribute value of the exported products. For example, if you want all the exported products to become visible on the BigCommerce store, you can enter ‘Yes’ value for ‘Is Visible’ attribute.

    BigCommerce-Connector-Configuration-3-1

    Other Mappings

    In this section, you need to mention those Akeneo attributes which include the product images. Further, you need to specify those custom fields for BigCommerce products.

    BigCommerce-Connector-Configuration-other-maqpping

    The attribute in BigCommerce:

    videos-in-bigcommerce

    Now you can also export  Akeneo attribute to BigCommerce custom fields in these attributes are supported like text, text area, metric type, simple-select, boolean, date, number, and multi-select.

    BigCommerce-Connector-Configuration-4

     

    The attribute in BigCommerce:

    custom-field-in-bigcommerce

     

    Quick Export Currency Mapping

    In this section, you can set the default currency while exporting the product via quick export.

    BigCommerce-Connector-Configuration-5-1

     

    Other Setting

    Log setting

    Log setting is used for checking the API logs like what we have exported and imported in Akeneo. For it, You have to enable the request and response log.

    Enable API request Logs: By enabling this, we can download and check all the import jobs.

    Enable API response Logs: By enabling this, we can download and check all the export jobs.

    Other Setting

    In this, you can export metric value to the BigCommerce custom field. 

    BigCommerce-Connector-Configuration-6-1

    The attribute in BigCommerce:

    metric-unit-bigcomerce

    Creating Products in Akeneo

    After setting up the BigCommerce Akeneo Connector module, you can export your products from Akeneo. In this section, I will explain to you how to create a product in Akeneo. If you have already created or imported your products in Akeneo, you can move on to the next section and skip this part.

    To create a new product in Akeneo follow Products>Create then select Product option. select productAfter that enter, SKU then chooses a product family. select family

    Add Product Details

    Now, you need to fill in all the production information for this new product. Please note that only the mapped attributes product information will be sent from Akeneo to the BigCommerce store. So, kindly make sure all the product fields are correctly mapped with Akeneo attributes.

    fill product information

    Select Attribute

    For adding product information, select the attribute options you require. You can also create new options for the attribute. Following Attributes from Akeneo are supported for export:

    • Text
    • Text Area
    • Number
    • Date
    • Boolean
    • Select
    • Price
    • Metric
    • Image
    • Reference data select
    • Reference data multi-select
    • File

    You can mention various information about the product – name, description, SEO information, inventory, shipping, pricing, and other details.other details

    SEO Information – Mention page title, meta description, and meta keywords.seo information

    Pricing Information -Mention cost price, sale price, retail price, fixed shipping price, and normal price.

    pricing details

    Add New Option Attribute

    If an attribute option is missing for a select attribute type (simple or multi-select), you can directly add it to the Product Edit Form. Enter a Code and Label values, then click Save.

    Add attribute option

    Upload Images

    Upload multiple images of a product export them to the BigCommerce store.upload images

    Multi-Lingual Information

    Add information for other languages and store views.

    Change multi-lingual information

    Select Categories

    Now you need to select a category for the product. You can also choose more than one category for a product. If a category is not available in Akeneo, the module will automatically create a new category in the BigCommerce store.

    select category

    BigCommerce Export Job

    Once you have created or imported the products in Akeneo, you can now move forward to the export process. To do that please go to Exports>Create Export Profile then enter any code, label after that select the ‘BigCommerce Export Job‘ option.enter profile information

    After saving the profile go to the Content section and select your channel where your products will be exported. You can also choose the locales for deciding in what language you will be sending the content. Select currency according to your store.

    Export-profile-BigCommerce-Product-Export-Edit-3

    In case you have too many products in Akeneo and want to export only a few products, you can use various filters. You can filter products based on family, status, completeness, category, and time condition. Further, if you want to export only one or more products, you can do that by entering the SKU value in the identifier section.

    Export-profile-BigCommerce-Product-Export-Edit-1-1

    After that, you can select credentials the click Save button.

    Export-profile-BigCommerce-Product-Export-Edit-2-1

    Run Export Job

    Once you have saved the export profile information, you can now click the Export Now button after that wait for the execution process to get completed.

    Export-profile-BigCommerce-Product-Export-Show-1

    You can see the progress of the export process as below. Moreover, if there is any error you can also see it here.

    Export-executions-Details-3

    View Exported Products in BigCommerce

    Once the execution process is completed, you will see the Akeneo product in BigCommerce. Log in to your BigCommerce admin panel then go to the Products list.

    product list

    You can make any changes to the exported product and modify or update any information.Every product detail which is mapped between Akeneo and BigCommerce will be imported and can be seen here. If weight is not mentioned in Akeneo, it will become a downloadable product in BigCommerce automatically.

    Bigcommerce-basic-setting

    Upload multiple images of a product and send them to the export product database.

    Bigcommerce-images

    Inventory Tracking information is also exported from Akeneo.

    BigCommerce-inventory

    Custom Fields allows you to mention more information about a product. If custom fields are correctly mapped in the Akeneo Connector configuration, they will appear here as well.

    Bigcommerce-custom-field

    Storefront Details such as Search keywords, Warranty Info, Sort Order, Condition as mentioned in the Akeneo are visible in this section.

    Bigcommerce-Store-details

    Purchase quantity information and SEO information are also sent to the BigCommerce store.

    BIgcommerece-SEO-information

    Purchasability with this you can manage the product availabilty and available quantity.

    Purchasability

    Categories are also created from Akeneo. So if you have a product category in Akeneo but not there in BigCommerce, the Akeneo Connector module will automatically create categories while exporting the products.

    categories created

    Exported Products on Storefront

    Now, let’s see how exported products appear on the storefront. You can see the product name, price, SKU, UPC, purchase quantity information, custom fields information, etc. on the product page.

    product page

    Once the export job is finished in Akeneo, the exported products will be available to the customers for purchase. The customer can see the multiple images, description, warranty information, related product and much more.

    product page information

    Import Profile

    Now you can now import your product catalog data from Bigcommerce to Akeneo. There are various job profiles available for importing Category, Attribute, Attribute Option, Family, Product and Product Model  from Bigcommerce to Akeneo.

    Import-profiles-management-2

    To do the import go to Imports>Create Import Profile, enter a code and label. Following job profiles are available:

    Import-profiles-management-3

    Once you have selected the import job profile.

    Import-profiles-management-4

    After that from the Content section, you can select the channel and locales for import product data. 

    Import-profile-BigCommerce-Product-Import-Edit

    Setup Credentials – In case you are managing multiple Magento stores, you can provide separate API credentials for each Magento store individually.

    Import-profile-BigCommerce-Product-Import-Edit-1

    Once everything is set up correctly, you just need to click the Import Now button then the import execution process will start. 

    Import-executions-Details-1

    Support

    Thank you for reading this documentation. In case you find anything missing or not explained correctly, or you have any customization needs, reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.

    Please explore our Akeneo Development Services and Quality Akeneo Extensions.

     

    Current Product Version - 4.0.0

    Supported Framework Version - Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x

    Blog Version - Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, and 3.1.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x, 3.2.x, 4.0.x, 5.0.x
    • Version Akeneo 2.0.x, 2.1.x, 2.2.x, 2.3.x, 3.0.x, 3.1.x and 3.2.x
    . . .
    Discuss on Helpdesk

    Leave a Comment

    Your email address will not be published. Required fields are marked*


    2 comments

  • megha
    Does this work with variants in Bigcommerce and Akeneo?
    • Adarsh Shukla (Moderator)
      Hello Megha,
      Yes, it works with variant products in BigCommerce and Akeneo. For more details, you can create a ticket here: https://webkul.uvdesk.com/en/
  • Back to Top

    Table of Content

    Hide Index