Reportvorlagen basieren auf Dateien im Excel-Format. In diese Excel-Dateien werden neben Ihren Formeln und Formatierungen zusätzliche Steueranweisungen geschrieben - dabei kommt jXLS zum Einsatz, für das eine ausführliche (englische) Dokumentation verfügbar ist. Als Beispiel kann die Veranstaltungsabrechnung aus unserem Downloadbereich dienen.
Die Vorlagen können mit jedem Programm, das Dateien im xls-Format schreiben kann, erstellt werden (z.B. OpenOffice, LibreOffice, Microsoft Excel).
Ausgangspunkt sind immer abgeschlossene Veranstaltungen (events), die ausgewertet werden sollen. Im Controlling-Bereich von Billeto werden die events zusammengestellt, die dann in der Reportvorlage weiterverarbeitet werden.
Beispiele
Im Controlling-Bereich von Billeto wählen Sie die Veranstaltungen (events) aus, die an die Reportvorlage übergeben und ausgewertet werden:
<jx:forEach items="${events}" var="event">
${event.date()} | ${event.piece.title} | ${event.soldTickets() | ${event.sales()}}
</jx:forEach>Bsp.1: Wenn diese Steueranweiung in der Vorlage steht, wird in der Excel-Datei für jedes Event eine Zeile geschrieben. In den Spalten stehen das Anfangsdatum, der Titel der Veranstaltung, die Anzahl der Tickets und die Summe des Umsatzes.
Einige der von Billeto verwendbaren Parameter liefern keine Zahl oder Text, sondern eine Liste von sog. Objekten, hier z.B. die Buchungen einer Veranstaltung:
<jx:forEach items="${events}" var="event">
${event.date()} | ${event.piece.title} | ${event.soldTickets() | ${event.sales()}}
<jx:forEach items="${event.bookings()}" var="booking">
${booking.id}|${booking.customer.lastname}|${booking.tickets(event).size()}|${booking.sum()}
</jx:forEach>
</jx:forEach>Bsp. 2: Es wird wie in Bsp. 1 pro Event eine Zeile geschrieben. Unterhalb des Events werden nun zusätzlich zeilenweise die Buchungen des Events aufgelistet, in den Spalten stehen die Buchungsnummer, der Kundenname, die Anzahl der Tickets der Buchung und der Umsatz der Buchung.
Verwendbare Parameter
Event
| Parameter | Format | Beschreibung |
| event.start | Zeitstempel | Starttermin der Veranstaltung |
| event.end | Zeitstempel | Endtermin der Veranstaltung |
| event.date() | Text | Starttermin der Veranstaltung |
| event.maxSeats | Zahl | Max. der Plätze der Veranstaltung |
| event.sum() | Zahl | Umsatz der Veranstaltung (inkl. Gebühren und gebuchte Tickets) |
| event.sales() | Zahl | Tatsächlicher Ticket-Umsatz (ohne Gebühren und ohne gebuchte Tickets) |
| event.bookings() | List<Booking> | Liste der Buchungen der Veranstaltung |
| event.tickets() | List<Ticket> | Liste der Tickets der Veranstaltung (verkauft und gebucht) |
| event.soldTickets().size() | Zahl | Anzahl der verkauften Tickets der Veranstaltung |
| event.seatcategories() | List<Seatcategory> | Liste der Platzkategorien der Veranstaltung |
| event.voucherDebitGroups() | List<Vouchers gruppiert> | Gutscheineinlösungen gruppiert ausgeben |
| event.discountGroups() | List<Discounts gruppiert> | Gewährte Rabatte gruppiert ausgeben |
| event.ticketsCountByPkId(id) | List<Tickets gruppiert> | Anzahl Tickets nach Preiskategorie-ID |
| event.payments("Kontoname") | List<Einnahmen> | Summe Zahlungen pro Konto |
Booking
| Parameter | Format | Beschreibung |
| booking.id | Zahl | Buchungsnummer |
| booking.date() | Datum | Buchungsdatum |
| booking.shipment | Shipment / Text | Versandart der Buchung |
| booking.payment | Payment / Text | Zahlungsart der Buchung |
| booking.customer | Customer | Kunde der Buchung |
| booking.comment | Text | Kommentar des Kunden |
| booking.internal | Text | Interner Kommentar der Buchung |
| booking.sum() | Zahl | Umsatz der Buchung (inkl. Gebühren) |
| booking.events() | List<Event> | Liste der Veranstaltungen der Buchung |
| booking.tickets(event) | List<Ticket> | Liste der Tickets einer Veranstaltung (bei einem Schleifendurchlauf) der Buchung |
| booking.tickets() | List<Ticket> | Liste aller Tickets der Buchung |
| booking.tickets().size() | Zahl | Anzahl der Tickets der Buchung |
| booking.tickets(event).size() | Zahl | Anzahl der Tickets einer Veranstaltung (bei einem Schleifendurchlauf) der Buchung |
| booking.ticketSales() | Zahl | Umsatz der Tickets |
| booking.vouchers() | List<Voucher> | Liste aller Gutscheine der Buchung |
| booking.vouchers().size() | Zahl | Anzahl der Gutscheine der Buchung |
| booking.voucherSales() | Zahl | Umsatz der Gutscheine |
| boogking.charge("payment") | Zahl | Gebühr der Zahlungsart für diese Buchung |
| booking.charge("shipment") | Zahl | Gebühr der Versandart für diese Buchung |
| booking.products() | List<Product> | Liste der Zusatzprodukte der Buchung |
| booking.products(event) | List<Product> | Liste der Zusatzprodukte einer Veranstaltung (bei einem Schleifendurchlauf) der Buchung |
| booking.products(ticket) | List<Product> | Liste der Zusatzprodukte eines Tickets (bei einem Schleifendurchlauf) der Buchung |
Ticket
| Parameter | Format | Beschreibung |
| ticket.id | Zahl | Ticketnummer |
| ticket.row | Zahl | Reihe |
| ticket.number | Zahl | Platznummer |
| ticket.status | Text | Status: gedruckt, entwertet, storniert |
| ticket.price() | Zahl | Ticketpreis |
| ticket.pricecategoryTitle | Text | Preiskategorie |
| ticket.seatcategoryTitle | Text | Platzkategorie |
Voucher (Gutschein)
| Parameter | Format | Beschreibung |
| voucher.id | Zahl | Gutscheinnummer |
| voucher.code | Text | Einlöse-Code |
| voucher.price() | Text | Gutscheinpreis mit Währung |
| voucher.price | Zahl | Gutscheinpreis als Zahl |
| voucher.credit() | Text | Gutschein(rest)wert mit Währung |
| voucher.credit | Zahl | Gutschein(rest)wert als Zahl |
| voucher.template.title() | Text | Titel der Gutscheinvorlage |
Customer
| Parameter | Format | Beschreibung |
| customer.id | Zahl | Kundennummer |
| customer.firsname | Text | Vorname |
| customer.lastname | Text | Nachname |
| customer.email | Text | E-Mail-Adresse |
| customer.country | Text | Länderkürzel |
| customer.zip | Text | Postleitzahl |
| customer.city | Text | Stadt |
| customer.street | Text | Straße und Nr. |
| customer.phone | Text | Telefonnummer |
| customer.prefix() | Text | Herr / Frau |
| customer.title() | Text | Dr. usw. |
Venue
| Parameter | Format | Beschreibung |
| venue.title | Text | Titel des Veranstaltungsortes |
| venue.description | Text | Beschreibung des Veranstaltungsortes |
Piece
| Parameter | Format | Beschreibung |
| piece.title | Text | Titel (intern) der Veranstaltung |
| piece.title() | Text | Titel der Veranstaltung |
| piece.description() | Text | Beschreibung der Veranstaltung |
Payment
| Parameter | Format | Beschreibung |
| payment.key | Text | Titel (intern) der Zahlungsart |
| payment.title() | Text | Titel der Zahlungsart |
| payment.description() | Text | Beschreibungs der Zahlungsart |
| payment.howto() | Text | Hinweise zur Zahlungsart |
| payment.charge_flat | Zahl | Gebühr der Zahlungsart (pro Buchung) |
| payment.charge_percent | Zahl | Gebühr der Zahlungsart (Prozent der Buchungssumme) |
Shipment
| Parameter | Format | Beschreibung |
| shipment.key | Text | Titel (intern) der Versandart |
| shipment.title() | Text | Titel der Versandart |
| shipment.description() | Text | Beschreibung der Versandart |
| shipment.howto() | Text | Hinsweise zur Versandart |
| shipment.charge | Zahl | Gebühr der Versandart |
Produkt (Zusatzprodukte einer Buchung)
| Parameter | Format | Beschreibung |
| product.id | Zahl | Nummer (ID) des Produkts |
| product.title | Text | Titel des Produkts |
| product.description | Zahl | Beschreibung des Produkts |
| product.number | Zahl | bestellte Anzahl des Produkts |
| product.price | Zahl | Einzelpreis |
| product.sum | Zahl | Summe = Anzahl x Preis |
| product.type | Text | inklusive oder exklusive |