Skip to content

Selling a package and settling sessions

A package is a set number of visits for a given class type. The client buys a package, receives credits, and a visit is used at check-in, at a no-show or at a late cancellation — not at booking.

Packages → New package: name, class type, number of visits, price and validity period. A package is a template — you sell it many times, to different clients.

RouteWhenPayment
POS sale (front desk)the client pays at the counteryes, with a fiscal receipt
Grant from the panelsettled outside the system, a correction, a goodwill gestureno, no receipt

In the panel: client profile → Add credits. You choose From a package (which takes the parameters from the definition) or Manually (class type, number of visits, validity).

A subscription is a package billed cyclically rather than once. The client pays for a period, not for a pool of credits bought up front.

A session type belongs to one subscription only

Section titled “A session type belongs to one subscription only”

A session type assigned to a subscription package cannot be used in any other package. Trying to add it elsewhere shows a message naming the package that already holds it.

This is not housekeeping. When the same session type belongs to two packages, the system has no way to decide which package a visit should be taken from when the session is settled — it takes the one expiring soonest, which is not necessarily the one the client had in mind.

The subscription governs its session type’s settings

Section titled “The subscription governs its session type’s settings”

Once a type is assigned to a subscription, some of its settings stop being editable in the session-type editor — you change them in the package editor instead. The type editor then shows which package governs them and links straight to it.

SettingWho decides
Client can reschedule sessionstoggle in the package
Clients can book on their ownalways off, enforced by the package
Name, colour, duration, capacitythe session-type editor, as before

In a subscription the time is set by the trainer or the front desk. Saving the package turns off “Clients can book on their own” for the selected session types, and it cannot be turned back on from the other side.

The “Client can reschedule sessions” toggle applies only within the package’s billing period. The client cannot move a session beyond the paid period — they would have to pay for the next one first.

A booking, a class sign-up and a place on the waiting list only hold a visit — they take nothing. The system decides which visit each booking holds: nearest dates first, within the visit’s validity. A visit is used only when it has actually been consumed:

EventThe visit
booking, sign-up, waiting list, promotion from the waiting list, leaving in timenot used
check-inused
a session closes with a client who was booked but not checked inused as a no-show
a session closes with a client on the waiting listnot used
cancelling or leaving after the deadlinethe visit is lost
the club cancels, or an unconfirmed booking expiresnot used; visits already checked in are returned
undoing a check-inthe visit returns and the booking holds it again
reverting a closed session’s statusvisits used as no-shows return

When you cancel after the free cancellation window the staff app asks what happens to the visit: “The free cancellation window has passed ({hours} h). What happens to the client’s visit?” with Visit is lost or Return the visit.

In the staff app the client card has a Visits section; in the panel the client preview has a Credits section. Both show the same things:

  • for each package: 10 left (3 booked) with the hint “7 free to book” or “All booked”, plus “Valid until …” or “Expires in N days”. “Left” is unused visits; the bracket is what future bookings hold. The client sees only “X left”, without the bracket;
  • Bookings without credit (n) — the nearest three, the rest as “and N more”;
  • debt rows at the top, if there are any (see below);
  • a last row, Credit history ›.

A trainer who is not assigned to the client does not see this section. If the balance cannot be loaded the section says “Couldn’t load visits.”, never shows zero, and the rest of the card keeps working.

A booking is without credit when, on the day of the class, the client has no free valid visit left for that type — the first visits cover the nearest dates, later ones stay uncovered. A session with such a booking carries a NO CREDIT badge (on session lists in the staff app, in the panel calendar and on the Front Desk tile). Within 48 hours of the session the badge is amber and urgent; further out it is quiet, because a series can stay uncovered for weeks. The badge disappears by itself once the client buys a package — there is no “clear” button.

A client cannot book themselves into a date with no free visit, but staff can. The app and the panel then warn you: “No free visit” — “{client} has no free visit for “{type}” on this date. It will be saved without credit — unless the client buys a package first, check-in leaves a visit to settle.” You choose Save anyway (when rescheduling: Reschedule anyway) or back out. Recurring series skip this question — their uncovered dates show in the badges.

When you check in a client with no valid visit for the type, you see “No valid visit”: the balance will go below zero, and the first visit of that type will cover it — bought or freed by a cancelled booking. If the client already owes something, a line “Outstanding: −n” sits below the text. You confirm the check-in anyway (in the panel the “Check in anyway” button) — the client still gets onto the floor.

Debt shows as a negative balance: a Balance: −1 row at the top of the visits section, with the hint “The client’s next “{type}” visit — from a new package or a cancelled booking — covers this first.” (a debt that nothing can match reads “The club settles this with the client.”).

Debt is not only paid by a purchase. The first matching visit pays it, immediately:

  • buying or granting a package of that type — the package pays the debt first, so a client owing 1 who buys a package of 2 ends up with debt 0 and a package with 1 left;
  • a visit freed by a cancellation, removal or refund — a booking that held a visit is cancelled, and that visit goes to the debt.

Older debts are paid first. A package of another type does not touch a debt, and a debt from a visit with no booking (walk-in) is paid only by a visit from an Open Gym pass (new or freed). Rescheduling, undoing a check-in and expiry pay nothing off. The client gets an Outstanding visit covered notification, and the history gets an entry with the same name.

The Credit history section (staff app: client card → Visits → Credit history ›; panel: client preview, below Credits; Front Desk: the Clients panel) lists every operation on the client’s visits, newest first. Club management, staff assigned to the client and the front desk can see it. An entry has a title, the session, the time, the person who did it (“· name”) and an amount if it changes the balance; otherwise “balance unchanged”. On an uncovered session the hold entry carries a NO CREDIT badge, and a debt shows “Outstanding: −n”.

EntryWhat it means
Visit helda booking holds a visit; balance unchanged
Booking cancelled, Removed from session, Booking declined, Booking not confirmed, Session deleted, Booking endedthe booking ended, the visit is free again
Session movedthe hold and release of one session in one row
Check-ina visit used; with no cover it creates a debt
No-showa visit taken when the session closed
Late cancellationthe visit was lost
Outstanding visit coveredwhere the visit came from (“From: …”, “Refund for: …”, “From package: …”) and “N visits toward: {type}”; no amount
Visits addeda grant or a purchased package
Visit returned, Check-in undonea visit came back
Visits expired, Package switched off, Package restoreda change of validity
Sale reverseda sale was withdrawn, its visits taken off
Other changean operation we cannot name

Layout: a run of three or more entries from one series on one day folds into a row “… · N sessions” (with “NO CREDIT · n” for staff). The list loads older entries and ends with “That’s everything.”; in the panel and Front Desk the Show more button does it. If the coverage check fails, a line “Couldn’t check booking coverage.” sits above the list — a missing badge then does not mean “covered”. No access: “You don’t have access to this client’s history.”

In the panel the Credit packages button opens the list of clients’ credit packages (administrator and manager): active, inactive, used and expired. The details of each show who granted it, from which package, when it expires, which events it was assigned to and the full history of its movements. It is a list of packages, not of operations — operations live in the Credit history section.

Credits are never deleted — they can be activated and deactivated. Used and expired credits are read-only; a used visit returns to the pool when you undo the check-in or cancel a checked-in session.