This integration is for you if your orders are created in Holded: sales to shops or distributors, phone or email orders that you enter as a sales order. As soon as you create one, it reaches us to be fulfilled. And in Holded you always see how it's going: its status, the carrier, the tracking number and the real stock you have in our warehouse.
If you sell through an online store (Shopify, WooCommerce…) and only use Holded for invoicing, you don't need this integration: just connect your store.
Before you start
You must be an administrator of the Holded account.
Every Holded plan includes the API, each with a monthly call quota. We explain it below, in “The Holded API quota”.
A Holded account can only be connected to one Furgox account.
1. Create the API key in Holded
In Holded, go to Settings → API.
Click Generate new key and give it a name you recognise, e.g.
Furgox.Tick these permissions:
inventory:sales-orders.readinventory:sales-orders.writeinventory:products.readinventory:products.writeinventory:warehouses.readinventory:warehouses.writecontacts:contacts.readdevelopers:webhooks.readdevelopers:webhooks.write
Copy the key. Holded only shows it once: if you close the window without copying it, you'll have to generate another one.
2. Paste it into Furgox
In your dashboard, open Integrations, click Connect a store and choose Holded. Paste the key and click Connect Holded.
You'll see a checkbox, ticked by default: create the «Furgox» warehouse as the default warehouse. Leave it ticked if all your goods are with us: your new orders will then use that warehouse in Holded without you choosing it each time.
3. What we do when you connect
We check the key and its permissions. If one is missing, we tell you which.
We create the «Furgox» warehouse in your Holded (if you already have one with that name, we use it). That's where you'll see the real stock in our warehouse.
We register Holded notifications to learn instantly about every new or changed sales order.
We read your catalogue, with its variants, SKUs and barcodes.
What happens from now on
Orders
Every sales order you create in Holded reaches us within seconds. Pending orders created from the moment you connect are imported; drafts and older orders are not. Service lines such as shipping charges aren't picked: only products.
The delivery address is the one on the order. If the order uses the customer's address, we take it from their Holded record: their shipping address or, if there is none, their billing address.
If you prefer to review each order before it's prepared, turn on Accept the orders myself on the Holded card in your dashboard.
Status and tracking in Holded
In the order's tracking section in Holded you follow each step: being prepared, prepared, shipped, delivered, incident, returned or cancelled.
When it leaves the warehouse we write the carrier and tracking number and mark it as shipped. When it's delivered, we also record the delivery date.
Stock
The «Furgox» warehouse in your Holded shows the real units in our warehouse, as goods come in and orders go out. We only touch products that have already arrived at Furgox: anything you haven't sent us yet stays as you have it.
When an order is marked as shipped, Holded deducts stock from the order's warehouse. If the order was in another of your Holded warehouses, we give those units back, because they actually left ours.
Products
Your Holded catalogue is the reference: when you create or change a product, we see it instantly. Packs aren't imported as a product of their own: their components are picked. More in What we do with your catalogue.
The Holded API quota
Holded limits API calls by plan: about 500 a month on Starter, 2,000 on Basic, 7,500 on Standard and more on higher plans. That's why orders reach us through notifications, which don't use quota, and we only write to Holded when something changes.
Even so, each order uses about five calls: reading the order and the customer, and writing the status and the shipment. Starter covers about 100 orders a month. If you ship more, a higher plan is a good idea.
If the monthly quota runs out, we pause the sync until Holded renews it and let you know in the dashboard. Meanwhile we keep preparing the orders that have already reached us.
What we don't do
We don't create invoices or touch your accounting in Holded: your invoicing stays the same.
We don't change your Holded SKUs: each product is linked by its internal ID.
If you cancel or delete an order in Holded before we prepare it, we cancel it. If it was already prepared, we let you know so we can look at it together.
If something goes wrong
“Holded did not accept the key”
Holded responds the same way to a badly copied key as to one missing a permission. Check you pasted it whole and that every permission on the list is ticked. If in doubt, generate a new one.
“Holded won't let us receive new-order notifications”
Holded only lets one tool receive each type of notification. If you already have another one connected, we check your orders every 30 minutes instead of instantly, which uses more quota. If you no longer use that other tool, delete it in Holded's Settings → Webhooks and reconnect.
An order doesn't reach me
Check it isn't a draft and that it's pending.
Orders dated before you connected aren't imported.
If the order has no address, either on it or on the customer's record, or its products aren't in your catalogue, we let you know in the dashboard. Fix it in Holded and it comes in by itself.
I regenerated or deleted the key in Holded
The old key stops working and the card switches to Disconnected by itself. Click Reconnect and paste the new one: your existing connection is updated, without losing orders or history. More in Sync, disconnect or delete a store.
Questions about permissions or the quota? Write to us from the dashboard chat and we'll look at it with you.