integration_documentation:plugin:en:direct_integration:bigcommerce
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
integration_documentation:plugin:en:direct_integration:bigcommerce [2021/01/27 18:21] daniel |
integration_documentation:plugin:en:direct_integration:bigcommerce [2021/02/01 14:58] daniel |
||
---|---|---|---|
Line 2: | Line 2: | ||
===== Integration with BigCommerce plugin ===== | ===== Integration with BigCommerce plugin ===== | ||
- | |||
==== Download ==== | ==== Download ==== | ||
- | //Available soon at [[https://www.bigcommerce.com/apps|BigCommerce App store]]// | + | // Available soon at [[https://www.bigcommerce.com/apps|BigCommerce App store]]// |
- | | + | |
==== Installation ==== | ==== Installation ==== | ||
- | * Open the BigCommerce backend and go to ... | + | Press the **Install** button to start the installation process. |
+ | {{:integration_documentation:direct_integration:bigcommerce_install.png?direct|}} | ||
+ | In order to integrate the Findologic service to your shop it's necessary to have the permission, use the **Confirm** button to accept. | ||
- | ==== Product export ==== | + | {{:integration_documentation:direct_integration:bigcommerce_confirm.png?direct|}} |
- | <note tip>The product export is not included, it's necessary to provide an own product export via url or file.</note> | + | When the installation was successful the Findologic app configuration page is shown. |
- | For the functionality of the plugin it's essential to export the product data from the shop to Findologic. | + | Insert configuration below and press **Save** button. |
- | For this purpose, the Findologic export library [[https://github.com/findologic/libflexport|libflexport]] | + | |
- | can be used. | + | |
+ | * **Active:** Activate to enable Findologic for your shop - **required** | ||
+ | * **Shopkey:** Enter the shopkey provided by Findologic - **required** | ||
- | The library provides you with the functionality to export XML according to the [[xml_export_documentation:xml_format|xml export documentation]]. The exported XML will be validated against a predefined [[https://github.com/findologic/xml-export/blob/master/src/main/resources/findologic.xsd|XSD Schema]]. | + | {{:integration_documentation:direct_integration:bigcommerce_config.png?direct|}} |
- | + | ||
- | ==== Call export with url ==== | + | |
- | + | ||
- | <code> | + | |
- | https://<SHOP_URL>/<EXPORT_PATH>?shopkey=<SHOPKEY>&start=<NUMBER>&count=<NUMBER> | + | |
- | </code> | + | |
- | + | ||
- | * **shopkey:** <SHOPKEY> provided by Findologic | + | |
- | * **start:** <NUMBER> that should not be lower than zero | + | |
- | * **count:** <NUMBER> that should not be lower than zero | + | |
+ | ==== Product export ==== | ||
- | This export url has to be set in the Findologic Account [[https://account.findologic.com/#/app/search-navigation/import-export|Settings]], see [[customer_account:import-export|documentation]]. | + | <note tip>Please be aware that the product export isn't included with the plugin, for the functionality of the Findologic service it's necessary to **provide an own product export**.</note> |
+ | For this purpose we recommend to use the [[https://developer.bigcommerce.com/api-docs/store-management/catalog/catalog-overview|BigCommerce Catalog API]] to retrieve the product data. | ||
- | ==== Provide export file ==== | + | The Findologic export library [[https://github.com/findologic/libflexport|libflexport]] should help to get the data from the Catalog API to the right format. |
- | Please see documentation to [[csv_export_documentation:csv_format|CSV export format]] or [[xml_export_documentation:xml_format|XML export format]]. | + | Both XML or CSV are supported: |
+ | * [[xml_export_documentation:xml_format|XML export format]]. | ||
+ | * [[csv_export_documentation:csv_format|CSV export format]]. | ||
+ | The exported XML will be validated against a predefined [[https://github.com/findologic/xml-export/blob/master/src/main/resources/findologic.xsd|XSD Schema]]. | ||
If you have troubles with the export please contact us at [[support@findologic.com|support@findologic.com]]. | If you have troubles with the export please contact us at [[support@findologic.com|support@findologic.com]]. |