Only a Global Admin can open Sales Channels. PrestaShop connects with one static Webservice Key: you create it in your PrestaShop back office and enter it once in Sugibana Flow. There is no sign-in screen and no expiry.
Connecting PrestaShop: 1. Enable Webservice (PrestaShop back office) → 2. Create the key (with the permissions below) → 3. Enter URL and key (Connect PrestaShop) → 4. Validate (Validate Connection) → 5. Order sync, stock push (switches in Features).
What must I check before I start?
- Your store address must start with https://. An http:// address is rejected.
- PrestaShop has no test mode. Connect your real shop, or a separate dev shop you can safely change.
- A shop connects to one Sugibana account only. If it says shop already connected, disconnect it in the other account first, or contact support.
How do I enable the Webservice?
- In your PrestaShop back office, open Advanced Parameters → Webservice.
- Switch the Webservice on if it is off.
How do I create the webservice key?
- On the same page, click Add new webservice key and generate a key.
- Tick the permissions below, then save. Copy the key; you will not see it in Sugibana Flow again.
| Resource | Tick | Needed for |
|---|---|---|
products | GET | Required. Reading products. |
stock_availables | GET and PUT | Required. Reading and pushing stock. |
orders | GET | Required. Importing orders. |
order_details | GET | Required. Order lines. |
addresses | GET | Recommended. Shipping address on each order. |
configurations | GET | Recommended. Reads your shop's time zone. Without it Sugibana Flow uses your browser's time zone. |
Validate Connection checks only the four required resources. Orders also read customers, countries and currencies; add GET on customers, countries and currencies so the buyer's email, country and currency come through. A missing one does not stop the import.
The key is a password. Do not paste it in emails or chats. Sugibana Flow does not store it in plaintext and never shows it again.
How do I enter the shop URL and key in Flow?
- Open the Sales Channels page and click PrestaShop in the list (it reads Not connected; Connect on its row does the same). The drawer opens with Ways to connect: the Webservice key option, whose form is already open.
- Enter Store URL (for example
https://myshop.example.com) and Webservice Key.
Screenshot: The PrestaShop drawer while PrestaShop is Not connected: the Webservice key option with its form already open, showing the Store URL and Webservice Key fields and the Connect PrestaShop button.
- Click Connect PrestaShop. It checks the shop for up to 15 seconds and saves only if the shop is reachable and does not reject the key.
- In the Account section, click Validate Connection. A green Connection validated successfully means it works.
How do I know it works?
Validate Connection lists each missing permission as a chip, for example stock_availables:PUT missing. Fix the key in PrestaShop (Advanced Parameters → Webservice), then click Validate Connection again. When all chips are gone the Account section shows Active.
These messages appear under the form when you click Connect PrestaShop:
| Message | Cause and fix |
|---|---|
| The shop rejected this webservice key (HTTP 401). Check the key is correct and enabled in PrestaShop → Advanced Parameters → Webservice. | The key is wrong, disabled, or was regenerated in PrestaShop. Copy it again. |
| Could not connect to the shop. Check that the store is online and reachable from the internet. | The shop is down or did not answer in time. |
| The shop's HTTPS certificate was rejected. Install a valid certificate on the store. | Fix the certificate on your shop. |
| The shop address could not be reached from our servers. Check the store URL. | Wrong or private address. |
| The store URL is not a valid address. | Retype the URL. |
| PrestaShop store URL must use HTTPS | Use the https:// address. |
| This shop is already connected to another Sugibana account. | Disconnect it there first, or contact support. |
Missing permissions appears only after Validate Connection, not on Connect.
How do I turn on order sync and stock push?
Both toggles are in the Features section of the connected PrestaShop drawer and work independently. Features also has the Ship-confirm switch ("Ship-confirm: send tracking & mark shipped on PrestaShop"; it stays off and reads "Coming soon — Sugibana switches this on per channel." until Sugibana switches it on for this channel) and Access health: OK · checked …, Not verified or Access lost: … per feature, the last with an Open the case link. Account, Channel-specific · PrestaShop and Danger zone start closed; click a section to open it.
Screenshot: The connected PrestaShop drawer with Features and Account open: Order sync, Order import range and Stock push, the Photo pull and Order import switches, Ship-confirm reading Coming soon, Access health, and under Account the Connected badge, the store address and the Update connection and Validate Connection buttons.
- Order sync: switch on. New orders usually arrive every few minutes, depending on your plan. While it is off, orders placed meanwhile are caught up when you switch it back on. Order import range sets how far back orders are imported.
- Stock push: switch on to send your Available quantity to PrestaShop after every stock change, for SKUs linked to this shop. If it shows Activation pending, the toggle is locked until stock push is enabled for PrestaShop on the platform.
A PrestaShop product is matched to a Sugibana SKU by its reference, which must equal the SKU code. Fill in the reference on every PrestaShop product first. SKU Readiness in the Status section shows which SKUs are BLOCKED and why; Recompute All re-checks them.
PrestaShop order states map to Sugibana Flow as: Awaiting payment is Pending; Payment accepted and Processing are Unshipped; Shipped and Delivered are Shipped; Cancelled and Refunded are Cancelled. Any other state is Unshipped if the order is paid, otherwise Pending.
Why do orders not appear or stock not change?
- Orders missing: check Order sync is on, the Account section shows Active, and the order is inside the Order import range. Then click Validate Connection.
- Stock unchanged: stock push must be on and not Activation pending, the SKU must be linked to its PrestaShop product, and its readiness must not be BLOCKED. Otherwise open a case from the Cases page.
Can I import products or prices from PrestaShop?
In the Channel-specific · PrestaShop section of the connected drawer, Import from PrestaShop pulls your catalogue into the reviewed SKU import (filter, review, apply). Pull prices from PrestaShop copies current shop prices into mapped SKUs; it also runs nightly.
How do I change the key or disconnect?
- Update connection (in the Account section): enter the new Store URL and New Webservice Key, click Update Connection, then confirm Replace credentials in the Replace connection credentials? dialog. The shop is checked again (up to 15 seconds) and the old key is not kept. A wrong key stops order sync and stock push until you connect again with a valid one.
- Disconnect: click Disconnect in the Danger zone section.
For everything else about channel connections, see Adding a sales channel and keeping its connection healthy.