Customer Portal
Purpose {#purpose}
The customer portal is self-service for your clients: view order status, download documents and device manuals, and accept quotes online — including signature and terms.
Public URL (tenant host): /customer-portal
Module: Only active when the platform module Customer portal (customer_portal) is enabled. Without the module the route returns 404.
What customers see {#what-customers-see}
| Area | Content |
|---|---|
| Login | Event / order reference + customer number |
| Order list | All orders for this customer |
| Order detail | Status timeline, schedule, service overview, contact |
| Documents | Quote, order confirmation, delivery note, proforma, invoice |
| Manuals | PDFs of booked items (see device-manuals) |
Cancellations are not available in the portal — only by email or phone (stated in the UI).
The portal always uses a light theme (independent of the staff app dark mode).
Customer login {#customer-login}
-
Customer opens
/customer-portal(or the link from the quote PDF). -
Fields: event number (order reference, e.g.
JB-…) and customer number (public_code). - Continue — on success they land on the order list or the order.
Deep link from the quote: /customer-portal/o/:token — prefills the event number.
After 5 failed attempts from the same IP for the same reference, a 15-minute lock applies.
There is no customer password — authentication is reference + customer number.
Accept a quote online {#accept-a-quote-online}
Only shown when the order is in status Quote and no active acceptance exists:
- Checkbox I accept this quote.
- Checkbox I accept the terms and withdrawal policy. (texts from organisation PDF settings, if configured)
- Draw signature (pad) or upload PNG (max 1 MB)
- Confirm
Afterwards:
- Order status becomes Confirmed
-
Signed quote and order confirmation are generated (quote filename suffix
_unterz) - Acceptance is logged with IP, user agent and a hash of the terms text
Documents in the portal {#documents-in-the-portal}
Only these document kinds are visible: quote, order confirmation, delivery note, proforma invoice, invoice. A signed quote is labelled as such.
Device manuals {#device-manuals}
Manuals uploaded on an item appear automatically for orders that include that item — no extra visibility toggle. See device-manuals.
Portal price visibility {#portal-price-visibility}
Per customer (not venue) when editing the customer → Portal prices:
| Option | Effect |
|---|---|
| Hidden | No amounts |
| Net only | Net amounts |
| Gross only | Gross amounts (default) |
| Net and gross | Both |
Sending the portal link {#sending-the-portal-link}
There is no separate “send portal link” button. The link is embedded automatically in quote PDFs (rental orders and sales) when the module is active:
Customer portal: accept quote & open documents
Already accepted / signed quote copies no longer show the CTA.
Enabling the module (platform) {#enabling-the-module-platform}
Platform owners only: /platform/organizations/:id → Modules → checkbox Customer portal.
Disabled modules are hidden in the app and blocked on the Device API.
Common issues {#common-issues}
| Problem | Solution |
|---|---|
| Portal page 404 |
Enable module customer_portal |
| Login fails | Check reference and customer number; wait out lock |
| No accept button | Order must be status Quote |
| No prices shown | Check Portal prices on the customer |
| Manuals missing | Upload PDF on the item; item must be on the order |
Last updated: November 2026