Documentation

Customer Portal

Chapter of the EVISYS user manual for rental operations.

On this page

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}

  1. Customer opens /customer-portal (or the link from the quote PDF).
  2. Fields: event number (order reference, e.g. JB-…) and customer number (public_code).
  3. 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:

  1. Checkbox I accept this quote.
  2. Checkbox I accept the terms and withdrawal policy. (texts from organisation PDF settings, if configured)
  3. Draw signature (pad) or upload PNG (max 1 MB)
  4. 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