This following sections will guide you through the process of connecting Magento to HubLogix.
- Prepare Product Content – describes required fields for product content and the update process
- Install the HubLogix Connector and Connect Magento to HubLogix – explains how to connect HubLogix and Magento using the HubLogix Connector for Magento
- Frequently Asked Questions – includes answers to common questions for this integration
1. Prepare Product Content
Product Content and Product Inventory
- Product Content is used by retailers to list and sell products to each of the marketplaces supported by Magento. Product Content includes information such as product descriptions, images, and specifications.
- Product Inventory specifically refers to the availability (quantity) and cost of Products that are being sold.
HubLogix does not provide or manage Product Content services for clients and does not provide guidance on how to manage Product Content in Magento. Please leverage the Magento team for guidance on Product Content.
However, once product content is available in Magento, HubLogix will import your product content and automatically map products from Magento to all available inventory sources for the vendors/warehouses to which HubLogix is connected.
In order to optimize our mapping capability, customers need to configure Product Content in Magento in a specific manner as described below.
Prepare Product Content for HubLogix Inventory Integration
Please setup the following Product Content data fields in Magento for the HubLogix Inventory Integration onboarding process:
|Product Data Field||Required||Used for Mapping|
Product Data Field Notes
- SKU: Magento requires unique SKU’s. HubLogix will see SKUs, but we do not use these for product mapping, and they have no impact on how HubLogix routes orders. However, there are facilities within HubLogix that allow for rules to be driven from SKU’s when needed.
- Name: HubLogix does not use the product name information for mapping, but we do use this information to make it easier to search and manage inventory information within HubLogix.
- Brand: Brand must be populated in Magento and must be in a brand form such as “Sony” or “Sony Electronics” or “Sony – Laptops”. This value should match how your vendors are listing brand name in their inventory file.
- UPC: Both UPC and MPN should be populated in Magento to optimize our automated mapping. At a minimum, either UPC or MPN must be populated, but both fields cannot be left empty.
- MPN: Both UPC and MPN should be populated in Magento to optimize our automated mapping. At a minimum, either UPC or MPN must be populated, but both fields cannot be left empty.
Product Content Mapping Updates
- HubLogix does a full update of Magento product content every 24 hours to look for items that have been added or removed. Any changes to product content will be reflected in HubLogix during this process.
- When customers make a large update to product content in Magento, they should email firstname.lastname@example.org to request a full update so we can capture changes faster. These types of requests can be fielded once a month or less.
2. Install the HubLogix Connector and Connect Magento to HubLogix
In order to integrate HubLogix with Magento, the HubLogix connector for Magento must be installed in your Magento environment.
If you have a ticket open with HubLogix support, they can provide you with the connector file. Otherwise, you can request the file from HubLogix by emailing email@example.com with the subject line “Connecting to Magento”. Please be patient as this is a multi-step process.
Once you have the file, you will need to work with your Magento partner or have your Magento developer install the HubLogix connector into your Magento environment by following these steps:
- With FTP or SSH, access the site and find the root folder of Magento. This is usually under html. You should see index.php in the same folder as well as api.php and var folder
- Upload the HubLogix connector provided by your HubLogix Onboarding Coach
- Test the access by going to the site front-end and trying to access orderpigeon.php – example:http://www.yourdomain.com/orderpigeon.php – you should see “Session invalid. Please login and try again”.
- Login to your magento admin and go to System -> Web Services -> SOAP/XML-RPC – Roles.
- Add new role. Set role name as Full Access. You will need to enter an admin password. In Role Resources, set it to All and save role.
- Go to System -> Web Services -> SOAP/XML-RPC- Users.
- Add new user. Username should be ‘Hublogix’. Firstname should be ‘HubLogix’. Lastname should be ‘User’. Email should be ‘firstname.lastname@example.org’. Enter the admin password again. Set the API Key (and confirmation) as 0123456789. Select “Full Access” as the user role. Save the user.
- Send HubLogix support an email letting them know you’ve installed the API layer. Please also provide the API Username, password and domain.
- Your Onboarding Coach will confirm the connection which will complete the Installation process
3. Frequently Asked Questions
Q: Why does product content have to be loaded to Magento in order to start the onboarding process?
A: The core of any integration with HubLogix revolves around product inventory and the mapping of inventory from retailer to vendor/warehouse partners. Therefore, HubLogix must have access to a channel’s product inventory in order to start the integration process.
Q: Are you able to filter which products are pulled into HubLogix?
A: By default, all products are imported into HubLogix; however you can establish filtering in Magento to control which products HubLogix interacts with. For more details, please ask your Onboarding Coach.
Q: How does HubLogix know which orders to import from Magento?
A: HubLogix will import any orders created in the last 90 days with a status of unfilled and invoiced.
Q: Can you work with configurable products?
A: Yes. HubLogix can interact with both simple and configurable products in Magento.