Unlike Shopify or WooCommerce, PrestaShop has no authorisation screen. The connection uses a Webservice API key you create in your back office and paste into Furgox. No code to touch and nothing to install.
Before you start
You need to log in to your store's back office as an administrator.
Have your store address handy. If PrestaShop is installed in a subdirectory, include it (
mystore.com/shop).URL rewriting must be enabled on your server: the PrestaShop webservice needs it in order to answer.
1. Turn on your store's webservice
In the back office, go to Advanced Parameters → Webservice. Further down, in the configuration, set Enable PrestaShop's webservice to Yes and save. If it was already on, go to the next step.
2. Create a key for Furgox
Click Add new webservice key (depending on your PrestaShop version and language, the button may be named slightly differently). On the form:
Click Generate so PrestaShop creates the key, and copy it: you'll need it in step 4.
In Key description write
Furgox, so you recognise it later.Leave Enable webservice key set to Yes.
3. Tick the permissions
In the Permissions table on that same screen, tick the whole row —View (GET), Modify (PUT) and Add (POST)— for these resources, and save:
products, combinations, stock_availables, orders, order_states, order_histories, order_carriers, customers, addresses, countries
What we use each group for:
Products and stock: read your catalogue and combinations, write the Furgox SKU and update available units.
Orders and statuses: import paid orders and keep their status up to date.
Customers and addresses: know where each order has to go.
Order carriers: write the tracking number when the parcel leaves the warehouse.
We recommend ticking these too, although they're not essential: states, currencies, product_option_values, configurations. With them we read the province of each address, the currency of your orders, the names of your combination options (size, colour…) and your store's name and time zone.
When you connect we check that the key can access each resource and tell you which ones are missing. What we can't check at that point is write access: if you leave out PUT or POST, the connection works but the error shows up later, when publishing stock or writing tracking. Tick the whole row.
4. Paste the key into Furgox
In your panel, open Integrations, click Connect a store, choose PrestaShop and fill in Your store URL and Webservice API key with the key you copied. Click Connect with PrestaShop.
Connecting takes a little longer than on other platforms because we read your catalogue and orders right then. On large stores it can take a minute: don't close the tab.
5. Done: your store is connected
What happens from now on
Products
We import your products and combinations with their reference, barcode and photo. When you include a product in its first inbound it gets its Furgox SKU, which we also write into your PrestaShop. If several combinations share the same reference, we give each one its own code so we can tell them apart in the warehouse. More in What we do with your catalogue.
Orders
PrestaShop can't notify us by itself about what happens in your store, so we poll it every 15 seconds. We import paid orders. Those not yet paid are held and come in on their own as soon as your store confirms payment; cancelled ones or those with a payment error are discarded.
If you'd rather review each order before it's prepared, turn on Accept the orders myself on the store card.
Stock
We publish the real warehouse units to PrestaShop as goods arrive and orders go out.
Shipping
PrestaShop does have native tracking: we write the tracking number on the order's carrier —the same one your customer sees in their account and in the email— and then move the order to Shipped.
Get orders instantly (optional)
If you want orders to appear straight away, without waiting for the next poll, you can install our Furgox Sync module:
In Integrations, on your PrestaShop store card, click Download the module and copy the Module key shown just below.
In your back office, go to Modules → Module Manager → Upload a module and upload the
furgoxsync.zipfile.Click Configure and paste the module key. The panel address is already filled in.
It's optional: without the module everything works the same, just with a few seconds' delay. And even if you install it, we keep polling your store as a safety net.
If something goes wrong
“The key isn't valid or has been deactivated”
Check that you copied it in full (32 characters) and that its status is Yes under Advanced Parameters → Webservice.
“Your store's webservice is switched off”
Go back to step 1: you still need to set Enable PrestaShop's webservice to Yes.
“We can't find the API at that address”
Check the URL. If PrestaShop lives in a subdirectory, include it. If your store is in maintenance mode, your IP must be on the allowed list for the API to answer.
“The key is missing permissions”
We tell you exactly which resources are missing. Go back to the key in your back office, tick those whole rows and click Connect with PrestaShop again.
Stock or tracking doesn't reach my store
It's almost always because the key lacks write access (PUT or POST) on some resource. Check in your back office that the rows from step 3 are complete.
I've deleted or regenerated the key in PrestaShop
We stop syncing and, a few minutes after your store starts rejecting our key, the card turns to Disconnected on its own. Create a new key and click Reconnect on the card, or go to Connect a store → PrestaShop with the same URL: the store you already had is updated, with no orders or history lost. What each button on the card does is explained in Sync, disconnect or delete a store.
Got stuck halfway? Write to us from your panel chat and we'll finish it with you.