Odoo Picqer Connector

Odoo and Connecta

• Odoo 18 or Odoo 19 with Connecta installed and a valid Connecta licence.
• The Odoo apps Sales and Inventory (sale_stock) and Automation Rules (base_automation). The app installs a shipping method, Picqer delivery.
• Your Odoo must be reachable from the internet, because Picqer sends shipments and stock changes to Odoo through webhooks. Odoo.sh works; a server of your own needs a public web address.

Picqer

• A Picqer account of your own, or a fulfilment partner (3PL) that works with Picqer.
• The Picqer address (base URL) of that account, for example https://yourcompany.picqer.com. For 3PLs the app knows the address; see 3PL templates and Picqer addresses.
• A Picqer API key. With a 3PL, the 3PL creates it for you. With your own account you create it in Picqer under Settings > API keys.

Products

• Every product that should go to Picqer needs an Internal Reference (SKU) in Odoo. The Internal Reference becomes the product code in Picqer. Products without an Internal Reference are not sent, and neither are services or archived products.
• Colli products follow a fixed SKU pattern; see Colli.

When you need more than one connection

• You work with two or more 3PLs, for example one for consumer orders and one for business orders.
• You use your own Picqer for your own warehouse and a 3PL for another part of your assortment.

How Odoo decides which connection is used

• Orders go to the connection whose warehouse mapping contains the source location of the delivery. See Orders to Picqer for the exact rules.
• Stock that Picqer reports is booked on the Odoo location that is mapped for that connection and Picqer warehouse.
• Products that you create or change in Odoo go to every connection where they belong: with Only products with a putaway rule on, only to the connections with a putaway rule for the product (or its product category) in their warehouse, and with a Product filter, only if the product matches it. Send products to Picqer sends the products of the connection chosen in the panel by the same rules. See Multi-warehouse and putaway rules.

Add a connection

1. Open the settings panel and click + at the top.
2. Give the connection a name on the Instance Settings tab.
3. Follow Set up your first connection for this connection.

The default connection

The first connection, called Default on new installations, is also the connection of installations that used the app before multiple connections existed. You can rename it, for example after your 3PL.

Fields

• 3PL (fulfilment partner): who handles the fulfilment for this connection: your 3PL, or Eigen Picqer-account (own Picqer account).
• Picqer base URL: the address of the Picqer account, for example https://yourcompany.picqer.com. With a 3PL, the address of your 3PL (see the Help column).
• Picqer API key: required. The key from your 3PL, or from Settings > API keys in your own Picqer.

Help column

The Help column on the right lists the Picqer address of every 3PL and answers the most common questions.

What happens when you save

• The app checks whether the address matches the chosen 3PL and shows an alert under Connecta > Start > Recent alerts if it does not, or if the address is empty.
• The app registers or removes the webhooks for this connection, based on the Features on the Settings tab.

When products are sent

• When you create or change a product in Odoo. The product goes to every connection where it belongs (see Which products).
• When a putaway rule is created or changed: the product of that rule, or the products of its product category, go to the connection whose warehouse contains the rule, if Only products with a putaway rule is on for that connection.
• When you click Send products to Picqer on the Settings tab: all products of the connection chosen in the panel at once.

Which products

• Only products with an Internal Reference (SKU). The Internal Reference is the product code in Picqer; the app uses it to find the product. Services and archived products are not sent.
• With Only products with a putaway rule on: only products with a putaway rule in the Odoo warehouse of the connection (its Warehouse on the Warehouses tab), for the product itself or for its product category. A putaway rule without product and category counts for all products.
• With a Product filter: only products that match the filter.
• Without these settings every product with an Internal Reference goes to the connection.

Which fields

Product code (Internal Reference), name, price (Sales Price), barcode, weight (converted from kilograms to grams), description, HS code, country of origin, delivery time (Customer Lead Time), minimum purchase quantity (from the reordering rules), active, and the product image.

Products that are already in Picqer

When the app updates a product that already exists in Picqer, it replaces the images in Picqer with the current Odoo image; if the product has no image in Odoo, the images in Picqer are removed. It also sets the Odoo stock of the product to the free stock in Picqer, in the same way as the stock updates: per Picqer warehouse on the location that is mapped for this connection, added up when several Picqer warehouses are mapped to one location. Picqer warehouses without a mapped location are skipped.

When a product fails

If Picqer does not accept a product or does not answer, the app skips that product and continues with the next one. Afterwards one alert under Connecta > Start > Recent alerts, Picqer: products not (fully) sent to Picqer, lists the products that failed and what failed: looking up, updating or creating the product, or its image. The details are in the Connecta logs. Solve the cause and click Send products to Picqer again, or change the product.

Not in scope

• Archiving or deleting products in Picqer.
• Creating or changing products in Odoo from Picqer: Odoo is always the source.

Setting up the Picqer app takes six steps. The pages in this section explain them. 1. Check the requirements: Odoo apps, a Picqer account or 3PL, an API key and SKUs on your products. 2. Install the app and open the settings from Connecta. 3. Fill in the connection: 3PL, Picqer address and API key. 4. Choose the features you want on the Settings tab. 5. Set up the warehouses: choose the Odoo warehouse, save, and map the Picqer warehouses. 6. Send your products to Picqer and test with one order.

After setup

The app runs on its own. Product changes in Odoo go to Picqer, orders go to Picqer when the delivery is validated, and shipments and stock come back from Picqer.

Install

1. In Odoo, open Connecta > Marketplace > Browse Apps.
2. Open Picqer and install it.

Open the settings

Open Connecta > Start. Under My Apps, click Open Settings on the Picqer card. The settings panel opens.

Choose the connection

At the top of the panel you choose the connection you are working on. With + you add a new connection, for example for a second 3PL. Everything you set in the panel applies only to the connection chosen at the top.

The four tabs

• Instance Settings: the name of the connection (managed by Connecta).
• Connection: 3PL, Picqer address and API key.
• Settings: webhooks, product options (putaway rules, product filter, colli), Auto-fulfilment, Create orders as concept and the order mapping.
• Warehouses: the Odoo warehouse of the connection, fetching the Picqer warehouses and mapping them to Odoo locations.

Saving

Click Save Settings to save. The Warehouse field on the Warehouses tab is required, so fill it in before you save; if it is empty, the panel says so and marks the Warehouses tab red. After saving, the app checks the Picqer address and registers or removes the webhooks in Picqer for this connection.

Dutch and German

Each explanation in the panel has a Nederlands and a Deutsch section you can expand, and every help text (the i icon) is available in English, Dutch and German.

Every 3PL that works with Picqer has its own Picqer address. Choose the 3PL in the field 3PL (fulfilment partner) and enter its address under Picqer base URL.

Addresses of the 3PLs

• SiPack: https://sipack.picqer.com
• VASCO-fulfilment: https://vasco-fulfilment.picqer.com
• 4Fill: https://4fill.picqer.com
• BVG Fulfilment: https://bvg-fulfilment.picqer.com
• Cenfil Fulfilment: https://cenfil.picqer.com
• Faber Fulfilment: https://faber-fulfilment.picqer.com
• Fulfilment Achterhoek: https://fulfilment-achterhoek.picqer.com
• Fulfilnetic: https://fulfilnetic.picqer.com
• Goods Fulfilment Services: https://goods-fulfilment.picqer.com
• HEGO Fulfilment: https://hego-fulfilment.picqer.com
• Innostock (Hoorn): https://innostock-hoorn.picqer.com
• Menq Fulfilment: https://menq.picqer.com
• PackNed e-Fulfillment: https://packned.picqer.com
• Pakkettenfabriek: https://pakkettenfabriek.picqer.com
• Today's Logistics: https://todays.picqer.com
• TRL Fulfilment: https://trl-fulfilment.picqer.com
• Verzendbazen: https://verzendbazen.picqer.com
• WEAF Fulfilmentservices: https://weaf.picqer.com
• XXL-Pakket: https://xxl-pakket.picqer.com

Your own Picqer account

Choose Eigen Picqer-account (own Picqer account) and enter your own address, for example https://yourcompany.picqer.com.

Address check

After saving, the app compares the Picqer address with the address of the chosen 3PL. If they do not match, or the connection has no address yet, an alert appears under Connecta > Start > Recent alerts. Enter the correct address and save again.

Your 3PL is not in the list

Choose Eigen Picqer-account and ask your 3PL for its Picqer address. The address check is then skipped.

Are the addresses up to date?

The addresses were checked in October 2026. A 3PL can change its Picqer address; if in doubt, ask your 3PL to confirm it.

Features

Choose which messages Picqer sends to Odoo for this connection. After saving, the app registers or removes these webhooks in Picqer. - Receive stock from Picqer: Picqer reports stock changes of synchronised products; Odoo updates its stock. - Receive shipments from Picqer: Picqer reports shipped parcels, including track & trace, on the related Odoo delivery.

Products

• Only products with a putaway rule: off: products go to Picqer without looking at putaway rules. On: only products with a putaway rule in the Odoo warehouse of this connection (the Warehouse on the Warehouses tab) go to Picqer: a rule for the product or for its product category. This applies to Send products to Picqer, to product changes in Odoo and to changed putaway rules.
• Product filter: optional. An Odoo filter on products for this connection, for example only products published on the website; the editor shows how many products match. Only matching products go to Picqer, with the button and with product changes. Together with Only products with a putaway rule, a product must meet both. Empty: no filter. Products that are already in Picqer are not removed.
• Colli as composition: off by default. On: colli products (the base SKU followed by -C and a quantity) become virtual compositions in Picqer.
• Send products to Picqer: button. Sends the products of this connection with an Internal Reference to Picqer, by the rules above. For products that are already in Picqer, Odoo takes over their free stock from Picqer. Use it after setting up a new connection.

Orders

• Auto-fulfilment: on (default): orders go to Picqer as soon as the delivery is validated. Off: orders wait in Odoo until someone clicks Send to Shipper on the delivery.
• Create orders as concept: off (default): every order is processed in Picqer straight away, so Picqer or your 3PL starts picking and shipping. On: the order is created in Picqer with the status concept and stays there until someone processes it in Picqer. Use this while testing a connection. The chatter of the delivery then shows Picqer: order left as concept.

Order mapping

Open mapping opens the mapping that decides which Odoo fields end up in the order in Picqer. You can add fields, for example a custom field with a delivery instruction.

When an order is sent

An order goes to Picqer for every delivery with the shipping method Picqer delivery: - with Auto-fulfilment on: as soon as the delivery is validated, also when another integration (such as a webshop connector) validates it automatically; - with Auto-fulfilment off: when someone clicks Send to Shipper on the validated delivery.

One order per delivery

Each delivery becomes one order in Picqer. A backorder gets its own order.

Which connection receives the order

1. The connection whose warehouse mapping contains the source location of the delivery.
2. Otherwise a parent location, and then the warehouse of the source location. The closest mapping wins.
3. If a location is mapped in more than one connection, the connection whose Warehouse (Warehouses tab) is the warehouse of the delivery wins, and otherwise the default connection.
4. Without any mapping: the connection whose Warehouse (Warehouses tab) is the warehouse of the delivery, and otherwise the default connection.

One delivery, one connection

A delivery always goes to one connection. To split an order over two 3PLs, let Odoo create separate deliveries per warehouse.

What is sent

• The delivery reference (for example WH/OUT/00012) as the order reference.
• The customer's name and e-mail address, the delivery address and the invoice address.
• The products with their quantities, by product code.
• The order is created in Picqer and then processed, so Picqer or the 3PL starts picking (status processing). With Create orders as concept on, it stays in Picqer as concept until someone processes it in Picqer.

Extra fields

With Open mapping on the Settings tab you can add Odoo fields to the order.

How you see it in Odoo

The chatter of the delivery shows what happened: - After a successful order: Sent to Picqer: order …, connection …. - With Create orders as concept on, also: Picqer: order left as concept. - If Picqer refused the order or could not be reached: Picqer: order not created. No order was processed. The reason is in the Connecta flow log; solve the cause and click Send to Shipper to send the order again.

Follow these steps for every Picqer account or 3PL you connect.

1. Choose the connection

On a new installation there is one connection. For another 3PL or account, click + at the top of the panel and give the connection a recognisable name, for example the name of the 3PL.

2. Connection tab

• 3PL (fulfilment partner): choose your 3PL, or Eigen Picqer-account (own Picqer account) if you use your own Picqer.
• Picqer base URL: the address of the Picqer account. The Help column on the right lists the address of every 3PL.
• Picqer API key: the key from your 3PL or from your own Picqer.

3. Settings tab

• Turn on Receive stock from Picqer and Receive shipments from Picqer if you want stock and track & trace in Odoo.
• Leave Auto-fulfilment on for hands-free orders, or turn it off to release orders manually.
• Turn on Only products with a putaway rule if only the products with a putaway rule in the warehouse of this connection should go to Picqer: with the button and with every product change. Rules for a product and rules for its product category both count.
• Optional: set a Product filter if only part of your products should go to this connection, for example only products published on the website.
• Turn on Colli as composition if you sell colli products.

4. Warehouses tab

• Under Step 1, choose the Odoo Warehouse of this connection. This field is required.
• Click Save Settings. The app checks the Picqer address and registers the webhooks in Picqer.
• Click Fetch warehouses, then Map warehouses, and choose the Odoo location for each Picqer warehouse.

5. Send your products

On the Settings tab, under Products, click Send products to Picqer. All products of this connection with an Internal Reference go to Picqer, except services and archived products; with Only products with a putaway rule or a Product filter, only the products that match. For products that are already in Picqer, Odoo takes over their free stock from Picqer on the mapped locations.

6. Test with one order

• Optional: turn on Create orders as concept on the Settings tab and save. The test order then stays as concept in Picqer and is not picked or shipped.
• Create a sales order with shipping method Picqer delivery that ships from the warehouse of this connection. Confirm it and validate the delivery (or click Send to Shipper if Auto-fulfilment is off).
• The order appears in Picqer, and the chatter of the delivery shows Sent to Picqer: order ….
• After the test, turn Create orders as concept off again and save, and process or delete the test order in Picqer.

Something does not work?

See Troubleshooting and FAQ.

A connection is one Picqer account, usually the account of a fulfilment partner (3PL). You can have as many connections as you need, for example one per 3PL plus your own Picqer for your own warehouse.

What each connection has

• its own Picqer address and API key;
• its own settings (webhooks, product options and product filter, warehouse, Auto-fulfilment, Create orders as concept);
• its own mapping of Picqer warehouses to Odoo locations;
• its own link records between Odoo and Picqer (products, orders);
• its own logs, except for incoming webhooks (see Limitations).

Connections and Connecta instances

Technically a connection is a Connecta instance on the Picqer channel. The pages in this section explain how connections work, which 3PL addresses the app knows, and where you get the API key.

The app talks to Picqer with an API key. Each connection has its own key.

Working with a 3PL

The 3PL creates the key for you in its own Picqer account. That key is limited to your data, so it only sees your products, orders and stock. Ask your 3PL for a key for the Picqer API. Picqer shows a key only once, so the 3PL has to pass it on right away.

Your own Picqer account

Create the key yourself in Picqer under Settings > API keys.

Entering the key

Enter the key on the Connection tab under Picqer API key and click Save Settings. Treat the key like a password: anyone with the key can read and change data in that Picqer account.

Changing the key

Enter the new key and save. The app uses the new key from then on; the webhooks keep working.

Map the Picqer warehouses of this connection to your Odoo locations. You do this per connection: choose the connection at the top first. 1. Step 1: Odoo warehouse. Choose the Warehouse of this connection and click Save Settings. This field is required. It routes orders when the mapping does not decide (no mapped location, or a location that is mapped in more than one connection), and it is the warehouse that Only products with a putaway rule looks at. 2. Step 2: Fetch warehouses. The app fetches the warehouses of this connection from Picqer and prepares them in the mapping table. Fetching again adds new warehouses and keeps the mappings you already made. 3. Step 3: Map warehouses. Choose the Odoo location for each Picqer warehouse. You can map several Picqer warehouses to the same location, and leave warehouses that you do not use empty.

What the mapping is used for

• Stock: Picqer reports stock per Picqer warehouse. The app books it on the mapped Odoo location. Picqer warehouses without a mapped location are skipped.
• Orders: a delivery goes to the connection whose mapping contains its source location, a parent location or its warehouse. Without such a mapping it goes to the connection whose Odoo warehouse (step 1) is the warehouse of the delivery.

Questions

• Numbers instead of names? The mapping table shows the warehouse number from Picqer (idwarehouse). Open a line to see the warehouse name in its status message (Picqer-magazijn: …).
• New warehouse in Picqer? Click Fetch warehouses again and map the new warehouse.
• Inactive warehouses? Fetch warehouses also fetches inactive Picqer warehouses. Leave them unmapped.
• Same Picqer warehouse number in two connections? That is fine: each connection has its own mapping.

With Auto-fulfilment you choose per connection whether orders go to the 3PL automatically, or wait in Odoo until someone releases them.

On (hands-free, default)

• When the order goes to Picqer: as soon as the delivery is validated.
• What the user does: nothing.
• What you see in Odoo: the order is in Picqer, and track & trace comes back.

Off (manual)

• When the order goes to Picqer: when a user clicks Send to Shipper on the validated delivery.
• What the user does: check the delivery and release it.
• What you see in Odoo: a message in the chatter of the delivery: Auto-fulfilment: not sent to Picqer.

Releasing a held order

1. Open the validated delivery.
2. Click Send to Shipper. The order goes to Picqer and the chatter shows Sent to Picqer: order ….

Good to know

• The setting applies per connection. One 3PL can run hands-free while another runs manually.
• When an order is held, Odoo itself also writes Shipment sent to carrier in the chatter. The message from the app explains that the order is not in Picqer yet.
• Releasing works per delivery; Odoo's Send to Shipper button does not work on a selection of deliveries.
• Existing installations keep Auto-fulfilment on, so their behaviour does not change.

Open the panel through Connecta > Start > My Apps > Picqer > Open Settings. Choose the connection at the top first: every value you set applies to that connection only. The pages in this section describe each tab.

Instance Settings

• Name of the connection.

Connection

• Connection to Picqer: 3PL (fulfilment partner), Picqer base URL, Picqer API key.
• Help: the Picqer addresses of all 3PLs, and where to find the API key.

Settings

• Features: Receive stock from Picqer, Receive shipments from Picqer.
• Products: Only products with a putaway rule, Product filter, Colli as composition, Send products to Picqer.
• Orders: Auto-fulfilment, Create orders as concept.
• Order mapping: Open mapping.

Warehouses

• Map warehouses: Step 1, Odoo warehouse; Step 2, Fetch warehouses; Step 3, Map warehouses.

In Odoo, Send to Shipper stays visible on a delivery until a tracking number is filled in. Without protection, every extra click would create another order in Picqer. The app prevents that.

How it works

• After a successful order the app adds a note to the delivery: Sent to Picqer: order …, connection ….
• If someone clicks Send to Shipper again, the app sends nothing and writes in the chatter: Already sent to Picqer (order …, connection …); not sent again.
• The check covers all connections, so a delivery is never sent to two 3PLs.

Sending an order again on purpose

If the order was cancelled in Picqer and has to be sent again: 1. On the delivery, log a note with the text Picqer: resend. Picqer: opnieuw versturen and Picqer: erneut senden work as well. The note only counts if it is newer than the last Sent to Picqer note. 2. Click Send to Shipper.

Deliveries from before version 2.0.0

Deliveries that were sent before version 2.0.0 have no Sent to Picqer note. For those, the first click on Send to Shipper after the update still sends the order, even if it is already in Picqer. Do not click Send to Shipper on these deliveries unless the order really has to go to Picqer.

This section describes what the app does with each type of data, when it happens, and how you can see the result in Odoo. - Products to Picqer: which products go to which connection, and which fields are sent. - Orders to Picqer: when an order is sent and to which connection. - Auto-fulfilment: hands-free or manual release, per connection. - Duplicate order protection: how the app prevents a second order for the same delivery. - Shipments and track & trace and Stock updates: what Picqer reports back. - Colli: products sold per case as virtual compositions. - Multi-warehouse and putaway rules: how locations, connections and putaway rules work together.

With Receive shipments from Picqer on, Picqer reports every shipped parcel to Odoo through a webhook. The app fills in the tracking number, the tracking link and the weight of the shipment on the related delivery. - Once the tracking number is filled in, Odoo no longer shows Send to Shipper on the delivery. - Turn the feature on or off per connection on the Settings tab and click Save Settings; the app registers or removes the webhook in Picqer. - The webhook address contains the connection, so a shipment always lands on the right connection. - Webhooks that were registered by an older version of the app keep working. The next time you save the panel, they are replaced by the current address.

With Receive stock from Picqer on, Picqer reports stock changes to Odoo through a webhook. - Picqer reports stock per Picqer warehouse. The app books the free stock on the Odoo location that is mapped to that warehouse for the connection that sends the update. - If several Picqer warehouses of one connection are mapped to one Odoo location, their stock is added up. - Stock is not added up across connections. If two connections use the same Odoo location, each update overwrites the figure of the other connection, so give each connection its own location. - A Picqer warehouse without a mapped location is skipped. Map it on the Warehouses tab. - The product is found by its product code, which is the Internal Reference in Odoo. - Only products that track inventory get stock. - Turn the feature on or off per connection on the Settings tab and click Save Settings.

Stock when products are updated

When the app updates a product that already exists in Picqer (see Products to Picqer), it also sets the Odoo stock of that product to the free stock in Picqer, in the same way as described above.

The app works in English, Dutch and German.

Which language you see

• Messages from the app in the chatter (Auto-fulfilment, Sent to Picqer, Already sent, order left as concept, order not created): the language of the Odoo user who validates or releases the delivery.
• Alerts from the address check: the language of the Odoo user who saves the panel.
• Alerts from Send products to Picqer (products not (fully) sent to Picqer): the language of the Odoo user who clicks the button.
• Settings panel: English, with expandable Nederlands and Deutsch explanations, and help texts in all three languages.
• Shipping method: Picqer delivery. You can give it a Dutch or German name with Odoo's translation feature, for example Picqer-levering or Picqer-Lieferung.
• Connecta screens (Start, Marketplace, alerts): English.
• Users with another language get English.

Still in Dutch

In version 2.2.0 a few texts are still in Dutch: the alerts of the Colli feature, the error message of Fetch warehouses, the warehouse names in the mapping table (Picqer-magazijn: …) and the 3PL option Eigen Picqer-account.

The resend note

The resend note works in every language: Picqer: resend, Picqer: opnieuw versturen and Picqer: erneut senden all count, whatever the language of the user.

A colli product is a product that you sell per case, while Picqer keeps the stock of the single unit. The app makes such a product a virtual composition in Picqer, so its stock comes from the base product.

SKU pattern

The Internal Reference of a colli product is the base SKU, followed by -C and the number of units: ABC123-C6 is a case of 6 × ABC123. Only an uppercase C counts.

Turn it on

Turn on Colli as composition on the Settings tab, per connection. It is off by default.

When the app processes a colli product

When a colli product is created, or when its Internal Reference or unit of measure changes. The app processes it about one minute later. Colli products that already existed when you turned the feature on are processed at their next change.

What the app does

1. It derives the base SKU and the quantity from the Internal Reference.
2. It looks up both products in Picqer.
3. It makes the colli product a virtual composition, if it is not one yet.
4. It makes sure the composition has exactly one part: the base product with the right quantity. Other parts are removed.

When the app skips a product

The app skips a product and reports why in an alert if: - the quantity is less than 2, or the base SKU is itself a colli product; - there is no active Odoo product, or more than one, with the base SKU; - the colli product or the base product is not in Picqer yet; - the unit of measure of the colli product is a larger unit (such as a case) whose size differs from the number in the SKU; - Picqer does not accept the change.

Both products must be in Picqer first

If the colli product or the base product is missing in Picqer, click Send products to Picqer. Then let the app process the colli product again by changing its Internal Reference or unit of measure; you can change it back afterwards.

How to update

Open Connecta > Marketplace > My Purchases and click Update on the Picqer app. If automatic updates are on for your installation, Connecta installs new versions by itself; it checks every 12 hours.

From version 1.x to 2.x

Version 2.0.0 introduced multiple connections. Your existing setup keeps working: - Your current Picqer account, settings and links become the default connection. Nothing is converted. - Auto-fulfilment is on, so orders keep going to Picqer automatically. - Webhooks registered by the old version keep working.

After updating from 1.x

1. Open the settings panel and click Save Settings once. The app registers the webhooks on the current address and checks the Picqer address.
2. Optional: rename the default connection, for example after your 3PL, and add connections for other 3PLs.

Product changes right after the update

Until the app has run once after the update, product changes in Odoo are not sent to Picqer. The app runs when you save the panel, when an order is sent to Picqer, or when Picqer reports stock or a shipment. Saving the panel right after the update avoids this gap.

Deliveries sent before the update

These deliveries have no Sent to Picqer note; see Duplicate order protection.

From 2.0.0 to 2.1.0

No action needed. If you update straight to 2.2.0, see the next section for the webhook check.

From 2.1.0 to 2.2.0

After updating, open the settings panel of each connection, click Save Settings once and check in Picqer under Settings > Webhooks that the stock and shipment webhooks of that connection are there, as 2.0.0 up to 2.1.0 could leave a connection without them. What you may notice: - The Warehouse field moved from the Settings tab to the Warehouses tab. Its value is kept. - With Only products with a putaway rule on, a changed product now only goes to the connections where it belongs, and categories in putaway rules count. - Send products to Picqer now also works without putaway rules: it sends all products with an Internal Reference, except services and archived products. - After a product update Odoo takes over the free stock from Picqer, the same figure as the stock updates. - A failed order gets the note Picqer: order not created on the delivery instead of an error message.

Three settings decide which 3PL handles what: - the Warehouse (Warehouses tab) links an Odoo warehouse to a connection; - the warehouse mapping links Odoo locations to the Picqer warehouses of a connection; - with Only products with a putaway rule on, the putaway rules decide which products go to a connection: only products with a putaway rule in the warehouse of that connection, with the button and with every product change.

Example

A company sells to consumers through 3PL A and to businesses through 3PL B. In Odoo it has a warehouse for each 3PL: 3PL A with stock location A/Stock, and 3PL B with stock location B/Stock. 1. In connection A, on the Warehouses tab, set Warehouse to 3PL A and map the Picqer warehouse of 3PL A to A/Stock. In connection B, set Warehouse to 3PL B and map the Picqer warehouse of 3PL B to B/Stock. 2. Create putaway rules that put the consumer products in A/Stock and the business products in B/Stock. 3. Turn on Only products with a putaway rule in both connections and click Send products to Picqer in each connection.

Result

• Each 3PL only receives its own products, also when you change a product.
• Orders that ship from A/Stock go to 3PL A, orders from B/Stock to 3PL B.
• Stock from each 3PL is booked on its own location.

Good to know

• With Only products with a putaway rule off, every product goes to the connection.
• A rule for a product category counts for all products in that category and its subcategories.
• When a putaway rule changes, the app sends the product of that rule (or the products of its category) to the connection whose warehouse contains the rule.
• A Product filter per connection narrows the selection further, for example to products published on the website.
• One delivery always goes to one connection.

Where do I see what happened?

• Connecta > Start shows Recent errors and Recent alerts.
• Connecta > Dashboard shows the activity and errors of the app.
• The chatter of a delivery shows whether its order was sent, held or already sent.

An order did not reach Picqer

• Check the shipping method of the sales order: it must be Picqer delivery.
• Is Auto-fulfilment off for this connection? Then the chatter says Auto-fulfilment: not sent to Picqer. Click Send to Shipper.
• Does the chatter say Already sent to Picqer? Then the order was sent before. To send it again, see Duplicate order protection.
• Does the chatter say Picqer: order not created? Picqer refused the order or could not be reached. The reason is under Connecta > Start (Recent errors) or in the flow log. Solve it and click Send to Shipper.
• Is the order in the wrong 3PL? Check the warehouse mapping and the Warehouse (Warehouses tab) of the connections; see Orders to Picqer.

The order stays as concept in Picqer

Create orders as concept is on for this connection. Process the order in Picqer. To have new orders processed straight away, turn the setting off on the Settings tab and save.

A product is not in Picqer

• The product needs an Internal Reference. Services and archived products are not sent.
• With Only products with a putaway rule on, only products with a putaway rule in the warehouse of that connection go to Picqer, also when you change a product.
• Check the Product filter of the connection: only matching products go to Picqer.
• Click Send products to Picqer to send the products again.

Alert: products not (fully) sent to Picqer

The alert lists the products of one connection that could not be sent and what failed; the other products were processed. Check the product and the connection (address and API key), then click Send products to Picqer again or change the product. If the alert starts with Settings of this connection, the putaway setting has no warehouse or the product filter is not valid: correct it on the Settings or Warehouses tab.

Stock is not updated

• Is Receive stock from Picqer on, and did you save the panel afterwards?
• Is the Picqer warehouse mapped to an Odoo location on the Warehouses tab?
• Does the product code in Picqer match the Internal Reference in Odoo?
• Does the product track inventory in Odoo?

No track & trace on the delivery

Turn on Receive shipments from Picqer and save the panel.

Alert: check the Picqer address of this connection

The Picqer address does not match the chosen 3PL, or is empty. Enter the address from the Help column on the Connection tab and save again. If your 3PL is not in the list, choose Eigen Picqer-account.

Error: connector settings are incomplete

The connection has no Picqer address or API key. Fill in both on the Connection tab and save.

Fetch warehouses gives an error

Check the Picqer address and the API key of this connection and try again.

A colli product is not a composition in Picqer

Check that Colli as composition is on and that both the colli product and the base product are in Picqer. The alert of the app tells you which check failed; see Colli.

The app sends products and orders to Picqer and receives shipments and stock from Picqer. The following is not part of the app: - Cancellations: cancelling a delivery in Odoo does not cancel the order in Picqer. Cancel it in Picqer as well. - Returns: there is no return flow between Picqer and Odoo. - Purchase orders and receipts: they stay in Odoo or in Picqer. - One order over several 3PLs: not possible, because a delivery goes to one connection. Odoo can split the order into deliveries per warehouse. - Products from Picqer to Odoo: Odoo is always the source. Products are not created or changed in Odoo from Picqer. - Archiving or deleting products in Picqer: not done by the app. - Releasing several held deliveries at once: not possible with Odoo's Send to Shipper button; release them one by one.

Odoo 19

• Odoo 19: the unit-of-measure check of colli products is skipped for now; colli products are still created from the SKU.
• Product filter: in Odoo 19 a filter with a date expression (for example today) is treated as invalid; filters with fixed values work.

Also good to know

• Picqer sometimes answers OK to a change it did not apply. The app checks this for the most important changes, not for all of them.
• Logs of incoming webhooks (shipments, stock) are shown on the default connection, also when the message belongs to another connection.

2.2.0 (October 2026)

• Fix: webhooks. Saving the settings now registers the Picqer webhooks for stock and shipments correctly again. Versions 2.0.0 up to now could leave a connection without webhooks, so Picqer stopped sending stock and shipments. The existing webhooks of a kind are only replaced after the new one is registered; if that fails they stay and an alert tells you. After updating, save the settings of each connection once and check in Picqer that the webhooks exist.
• Multilingual (English, Dutch, German). The settings panel is in English with Dutch and German explanations under each section and in every help text. Messages and alerts on deliveries follow the language of the Odoo user.
• Products per connection. With Only products with a putaway rule on, a product only goes to the connections with a putaway rule for the product or its product category in their warehouse, also when you change a product. A changed putaway rule only sends the product (or category) of that rule, to the connection of its warehouse.
• Product filter per connection, for example only products published on the website.
• Send products to Picqer also works without putaway rules: it sends all products with an Internal Reference, except services and archived products.
• A product that Picqer does not accept no longer stops the others: the rest is sent, and one alert lists the products that failed.
• After a product update Odoo takes over the free stock from Picqer, added up per mapped location, the same as the stock updates.
• Orders are only processed in Picqer after they were created successfully. A failed order gets the note Picqer: order not created on the delivery instead of an error.
• Create orders as concept per connection: the order stays as concept in Picqer, for example while testing.
• The Warehouse field moved to the Warehouses tab, as step 1.
• New connections start with a time-out of 10 seconds and one retry for Picqer calls (was 3 seconds and two retries), which makes duplicate Picqer orders after a slow answer less likely. Existing connections keep their own setting.
• Corrected help texts in the settings panel.

2.0.0 (October 2026)

• Multiple Picqer accounts per Odoo database: your own Picqer and/or one or more 3PLs, each with its own settings.
• 3PL templates for SiPack, VASCO-fulfilment and 17 other fulfilment partners, with an address check after saving.
• Multi-warehouse: map Odoo locations to the Picqer warehouses of each connection; orders and stock go to the right connection.
• Auto-fulfilment per connection: hands-free (default) or manual release with Send to Shipper.
• Duplicate order protection.
• Colli as virtual compositions.
• Putaway rules per connection.
• Redesigned settings panel and corrected webhook address; existing webhooks keep working.
• After updating from 1.x: open the settings panel and save once.

1.x (until March 2026)

One Picqer account per database: products, orders with custom field mapping and the customer's e-mail address, shipments and stock.