Connecting Magento 2
Picqer has a direct integration with Magento 2. Follow the steps below to set up the connection.
On this page
What does the integration do?
- New orders in Magento 2 are imported in real-time to Picqer using the Magento 2 plugin
- Orders that are shipped via Picqer are automatically marked as "Shipped" in Magento 2 (including tracking codes)
- Stock changes in Picqer are updated in real-time in Magento 2
- Products from Magento are imported into Picqer, including images and current stock levels
Preparing Magento
Picqer connects to Magento 2 via the REST API. To do this, you need a username and password for a Magento user with admin rights.
We recommend creating a dedicated user for Picqer. Go to System > All Users > Add New User to create a new user. Ensure this user has the 'Administrators' role.
You can also link your shop by creating an Integration in Magento. This is required, for example, when your shop uses two-factor authentication (2FA). Follow the steps here.
Setting up the integration in Picqer
Navigate to Settings > Webshops in Picqer.
Click on 'Add New Webshop' in the top right corner.
Select 'Connect' for Magento 2.
Under the 'Connection' section, enter the homepage URL of your shop and the username and password you just created in Magento.
The default settings for sending stock changes and shipments are configured so that Picqer does not send data back to Magento. This is a safe setting for testing the connection.
Importing products
To import products, go to the webshop connection and select 'Import Products'. Depending on the number of products in your webshop, this may take a few hours the first time. This process happens in the background in Picqer, so you don't need to stay on this page.
The following product attributes will be imported:
- Product code
- Name
- Barcode
- Cost price (VVP)
- Supplier product code
- Supplier
- Weight
- Price (VAT will be determined based on your settings in Picqer)
- Linked product fields
Barcode, cost price, and supplier product code are imported if they are linked in the webshop connection settings in Picqer.
Picqer also imports:
- Stock levels: if 'Import starting stock' is enabled in Settings.
- Images: in the order they appear in Magento, excluding 'disabled' images in Magento.
Importing orders
Picqer imports new orders from your Magento shop every 15 minutes by default. You can speed this up using our Magento 2 plugin.
Orders are imported as 'expected' into Picqer. Once an order reaches the 'Processing' state (configurable), Picqer will process the order. Note that Magento uses a state and status system.
Virtual and ignored products
Virtual or ignored products are removed from orders. If an order contains only virtual or ignored products, the order will be skipped. You can see this in the Order states section.
Configurable and bundled products
In Magento 2, configurable products and bundled products can be added. Both are supported by Picqer. The price of the bundle is maintained, and the individual items are set to €0 to ensure the price matches the order in Picqer. Products with custom options are supported only to a limited extent.
Discounts
Picqer takes over discounts at product line level. Discounts at order level are not transferred because Picqer cannot add a separate discount line to an order.
Shipments
A shipment is created in the shop as soon as the picklist is completed in Picqer. The following information is passed back to Magento:
- Which products and quantities are being shipped
- Whether the shop sends a notification, based on the setting in Picqer
- Track & Trace code
- Carrier: custom
- Carrier name as in Picqer
Sending a tracking URL is not possible as Magento does not support it in the API.