Sales
Purpose {#purpose}
The Sales module lets you sell equipment, bulk items and products permanently — parallel to rental orders, with its own shop, status flow and documents.
Navigation: Sidebar Sales → /app/sales
Module: Only visible when the platform module Sales (sales) is enabled for the tenant.
Permissions: sales.read, sales.create, sales.update, sales.documents, sales.finance, sales.pricing, sales.view_prices
Create a sale {#create-a-sale}
-
Sales → New sale →
/app/sales/new -
Choose buyer:
- CRM contact — search an existing customer (or New opens customer create in a new tab)
- Manual buyer — billing address without a CRM record (walk-ins)
- Optional separate shipping address — or “shipping same as billing”
-
Save & continue to shop →
/app/sales/:id/shop
The sale reference is assigned automatically on save.
Sales shop {#sales-shop}
At /app/sales/:id/shop you add lines — similar to the rental shop, but at sale price:
- Equipment / tracked units
- Bulk items
- Catalog products
Permission: sales.update
Status flow {#status-flow}
| Status | Meaning |
|---|---|
| Inquiry / draft | Still being prepared |
| Quote | Quote sent |
| Confirmed | Buyer accepted |
| Invoiced | Invoice issued |
| Completed / paid | Closed |
| Cancelled | Sale cancelled |
Guided next steps on the sale detail page:
- Mark as quote
- Confirm
- Issue invoice
- Mark as shipped — writes off stock / reduces product inventory
- Record payment (Billing tab)
Shipping and payment can happen in either order. “Shipped” is tracked via logistics status, not as a sale status field.
List tabs: Open (draft through invoiced) / Completed (paid, cancelled).
Sale detail {#sale-detail}
/app/sales/:id — Overview, lines, documents, billing tabs.
More menu (needs sales.documents):
- Generate quote PDF
- Generate delivery note PDF (from Confirmed onwards)
- Cancel sale (only from inquiry / quote / confirmed)
Documents and customer portal {#documents-and-customer-portal}
Sale quotes can include the same customer portal CTA as rental quotes — when the customer portal module is enabled. Details: Customer Portal.
Viewing prices {#viewing-prices}
Without sales.view_prices, the money column on the sales list is hidden. Discounts need sales.pricing; invoicing/payments need sales.finance.
Common issues {#common-issues}
| Problem | Solution |
|---|---|
| Sales menu missing |
Enable module sales; role needs sales.read |
| Shop won’t save |
Check sales.update |
| No delivery note |
Status at least Confirmed; sales.documents |
Last updated: November 2026