Connecting Magento 2

Picqer has a direct integration with Magento 2. Follow the steps below to set up the connection.

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

Setting up the integration

Magento Preparation

Picqer connects to Magento 2 via the REST API. We recommend creating a separate user for Picqer in Magento with administrative rights.

Go to System > All users > Add New User

Add a new user and make sure they have the 'Administrators' User Role.

Ensure that you are logged into Magento as this user while setting up the connection.

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.

Click 'Save' at the bottom.

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.