Action: Bosch eBike Connect (Gazelle) — catalog, sell-out and stock

🔒 Requires administrator. This action accesses an external integration directly and is only visible in SyncTool when you are logged in as an administrator.

SyncTool can connect your Sapera shop to the Bosch eBike Connect portal (used among others for Gazelle and other Bosch-affiliated bike brands). There are three independent actions, typically run on a schedule.

The two reporting actions (sell-out and stock level) only work with products from one specific supplier — the supplier in Sapera that represents the manufacturer. You point to it with the SupplierIdentifier parameter. Products from other suppliers are left untouched.

Export product catalog

Direction: from Bosch to a file — not to Bosch. The action fetches the product overview from eBike Connect and writes it to a CSV file at the path you set in ExportPath.

• What is fetched: All products available to your company in eBike Connect — including components and spare parts. Data is fetched page by page (100 at a time) until there are no more.

• The file is overwritten on every run (the first page recreates the file, the rest is appended).

• Limited by your CompanyCode and optionally CustomerNumber.

• Note: the action does not send anything to Bosch — it pulls data out of the portal.

Report sell-out

Direction: from Sapera to Bosch. Changes only. The action reports your new sales to Bosch, so the manufacturer can see what has actually been sold out of the shop.

• Only changes since last time: SyncTool remembers how far it got last time (the id of the last reported stock entry is stored) and continues from there on the next run. The very first run includes sales from the last 24 hours.

• What is included: only outgoing entries (sales/consumption) on products whose supplier is the configured Bosch supplier. Entries on all other products are skipped.

• For each sale, the supplier's item number, the quantity sold and — for serial-numbered items — the frame/serial number are sent.

• Sales are grouped per voucher (sales document).

Report stock level

Direction: from Sapera to Bosch. All items — a full snapshot. The action reports your current stock level to Bosch, so the manufacturer has up-to-date availability.

• Which items: all items where the configured Bosch supplier is the main supplier and which are in stock (stock count at least 1). So it is not only changes — the entire stock is sent every time.

• The report overwrites the current stock at Bosch (idempotent), so it is completely safe to run again.

• For each item, the supplier's item number, the current stock count, any frame numbers for serial-numbered items, stock condition "new" and today's date are sent.

• Robustness: each item is retried up to 3 times on failure, and a single item that cannot be reported does not stop the rest. The per-call timeout is set with RequestTimeoutMinutes (eBike Connect can be slow at times).

Connection parameters

All three actions share the same connection details to eBike Connect:

Action-specific only:

See also the overview SyncTool – actions.

Want to know more?

Read more in these related articles: