Here's how you manage lesson cards in StalliQ: Go to Admin → Riding School → Card types. Create card types with a horse type (School horse / Own horse / Both), assign cards to members and manage validity, balance, card sales and cancellations. Multiple matching card types can be linked to each riding lesson - when booking, StalliQ automatically filters by horse type and remaining balance. Sales feed into the finance overview; cancellations and refunds are recorded cleanly for accounting purposes as negative offsetting entries.
How do I create a card type?
Go to Admin → Riding School → Card types and tap "Add Type":
- Name - e.g. "10-card group lessons school horse", "5-card private lesson own horse", "Monthly subscription Both"
- For which horses - School horse (only for bookings with a school horse), Own horse (only for own horses) or Both (universal). Determines which booking pickers the card appears in
- Number of lessons - How many units the card contains (e.g. 10)
- Validity period (days) - Optional: After how many days the card expires (empty = unlimited)
- Price - Optional: Sale price of the card
- Monthly subscription - Toggle: When enabled, the quota is automatically topped up to the full count on the chosen day of the month. Ideal for monthly flat rates (e.g. "4 lessons per month" that automatically renew on the 1st of each month). Subscriptions behave differently from normal lesson cards when booking and in the display - see the section "How does a monthly subscription work?"
Tap "Save". The card type is immediately available to assign and to link to riding lessons.
How do I link card types to riding lessons?
When creating or editing a riding lesson under Admin → Riding School → Schedule (see Schedule) you'll find the list "Accepted cards" - tap each type you want to allow (multi-select). Important: A lesson with only cards that don't have the School horse horse type allows only own-horse bookings - and vice versa. Also allow matching cash prices if both payment methods should work.
How do I assign a lesson card to a member?
In the stable, open the Members tab and tap the member. Tap the "Lesson card" quick action at the top (or tap an existing card in the "Lesson cards" section). In the window that opens, choose "Assign new lesson card":
- Choose card type - Select the desired type from the list
- Count (optional) - Override the default count if needed
- Payment method - For paid cards: Cash, Transfer, EC Card or Other
Tap "Assign lesson card". The member sees the card immediately in their stable tab under "My Lesson Cards". The sale appears in the finance overview with a sequential receipt number.
How do I cancel a card sale?
If a sale turns out to be a mistake (e.g. wrong card type, wrong member), open the entry in the finance overview (Statistics → Finance tab) and select "Cancel":
- Enter a mandatory reason (free text, e.g. "Wrong card type, replaced with the correct card")
- Confirm
StalliQ removes the issued units from the member's account and creates a negative offsetting entry in the finance overview. The original sale stays visible, marked as "cancelled". The receipt number sequence remains gapless.
Caution: If units have already been used (remaining balance < original count), StalliQ throws "Card partially used". You then have to undo the affected bookings first (set attendance to "Excused") before you can cancel the card.
How do I extend the validity?
At present you extend validity stable-wide via "Extend all cards": Go to Admin → Riding School → Card types and tap the "Extend all cards" button. Choose the number of days (quick select: 7, 14, 30 days). This extends the validity of all active lesson cards in the stable at once - e.g. during a Christmas break or stable holiday.
There is no separate extend action in an individual card's detail view, only "Adjust" (credit or deduct units).
How do I adjust the balance?
If a deduction needs to be corrected, open the member's card and tap "Adjust". You can credit or deduct units. Every adjustment is logged in the audit log. For manual changes, the member automatically receives a push notification.
How do I reset a negative balance?
Members can also have booked into a negative balance (e.g. "-2 in the red"). A list of all cards in minus can be found under Admin → Receivables in the "Cards in minus" tab. Once it's clear how these units were settled (e.g. paid extra in cash), tap "Reset to 0" on the affected card there. Only a confirmation appears ("The card balance will be reset to 0. Marks the lesson as paid in cash.") - you don't have to type a reason. The balance jumps to 0; the reset is recorded internally as paid in cash.
How do I see the usage?
Per member you see:
- Progress bar - Visual: Green (above 30%), Yellow (below 30%), Red (negative)
- Remaining balance - e.g. "8 of 10 left"
- Reservations - e.g. "2 reserved" when bookings for future lessons have already selected this card
- Expiry date - Or "Valid indefinitely"
- Active / Expired - Expired cards are greyed out
Aggregated display: If a member has several cards of the same type (e.g. because they bought a "10-card" twice), StalliQ does not show them as several identical cards but as one card with a total balance (e.g. "14 of 20 left") and staggered expiry (the nearest expiry date is shown first). This keeps the member and card view tidy. Important to understand: the number in the progress bar sums the balance of all combined cards.
How does a monthly subscription work?
A monthly subscription behaves differently from a normal lesson card:
- Period-based display - Instead of an absolute remaining balance, the subscription shows the usage for the current month, e.g. "2 of 4 this month · renews on the 1st". Unused units are not carried over - on each refill day the month starts again at the full count.
- No expiry date - Subscriptions do not expire. Instead of "Expiry date" or "Valid indefinitely", the renewal date is shown ("renews on [day]").
- Overbooking block - A subscription member cannot book into a negative balance. Once the monthly quota is used up, StalliQ rejects a further subscription booking - unlike normal lesson cards, which allow a negative balance. If you've also set a cash price for the riding lesson in question, the student can switch to cash; otherwise the booking is blocked until the subscription renews.
So the negative balance ("Cards in minus", see above) applies exclusively to normal lesson cards - by design, it can never occur with subscriptions.
How does the billing overview work?
If you've set a price on card types, StalliQ records the payment method (Cash, Transfer, EC Card or Other) with each card assignment and automatically creates a receipt number. You'll find the full finance overview in the Stable statistics under the Finance tab:
- Total revenue - Sum of all sold lesson cards and cash lessons in the selected period (refunds + cancellations are offset)
- Cards sold - Number of assigned cards
- Breakdown by payment method - How much by Cash, Transfer, EC Card
- Sales list - Each sale with receipt number, date, member name, amount, card type and payment method. Refunds appear in red with a minus + reason; cancellations with 0 € + badge
- PDF and CSV export - Export the revenue overview as PDF or CSV
Small business regulation (§19 UStG): If, as a small business, you don't show VAT, enable the option under Admin → Settings → "Small business (§19 UStG)". The tax rate is then set to 0% and the note "No VAT shown pursuant to §19 UStG" appears on the receipts.
Every top-up purchase is its own tranche: Important for clean accounting - each paid top-up purchase remains, for accounting purposes, a separate, full transaction with its own price, its own tax, its own payment method and its own sequential receipt number. Even when the member sees several purchases of the same type as one aggregated card (see above), the finance overview shows a separate line with its own receipt number for each top-up. This keeps the receipt number sequence gapless and every transaction individually traceable - and when cancelling, exactly that one tranche (receipt number) is offset, not the aggregated overall card.
How do I see a member's booking history?
Tap a member's lesson card. The detail screen shows the complete transaction history:
- Lesson attended - Which lesson, when, automatic deduction
- Absent - Absent without excuse, with deduction
- Late cancellation - Deduction despite cancellation
- Credit - Added by you, with a note
- Debit - Deducted by you, with a note
- Card purchased - Purchase date, amount, payment method, receipt number
- Extended - Validity extended
- Expired - Card expired
- Subscription refill - Monthly subscription automatically topped up
Each transaction shows the date, reason, amount (+/-) and who carried out the action. For manual changes, the member receives a push notification.
Frequently asked questions
Can members in StalliQ keep booking with a negative balance?
Yes. StalliQ allows negative balances - the member can keep booking lessons even when the quota is used up. You see the negative balance in the members overview and in the admin list "Cards in minus" under Admin → Receivables.
How does the deduction for lesson cards work in StalliQ?
Automatically, based on attendance recording. Deduction for: present, absent without excuse, late cancellation. No deduction for: excused absence. When you change the status (e.g. from "Absent" to "Excused"), the deduction is automatically undone.
Can I link lesson cards to specific riding lessons in StalliQ?
Yes. For each riding lesson you specifically choose, in the "Accepted cards" field, which card types are valid. For example, you can allow a "10-card group lessons" only for group lessons and offer a separate "5-card private" for private lessons.
Can a single riding lesson accept multiple card types?
Yes, several cards at the same time. When booking, StalliQ filters by the card's horse type (school horse or own horse) and shows only matching cards with remaining balance in the picker. This way you can serve school-horse riders and own-horse riders with different cards in the same lesson.
What happens when I delete a card type?
Already issued cards remain and continue to be used. The type only disappears from the selection list for new sales and for lesson configuration. Riding lessons that accepted this type continue to check the card normally.
Do managed persons have their own lesson cards?
No. There are no separate card pools per managed person (e.g. a member's child). Cards always belong to the member themselves. When a member books a managed person into a riding lesson, the unit is deducted from the member's card - not from a separate account for the managed person. So if several managed persons take lessons, they share the balance of the member's card. If you need separate billing per person, create standalone member accounts for them.