Invoicing¶
HellaBooking integrates with two Hungarian-compatible invoicing services to generate legally compliant invoices for payments.
Navigation¶
Klub konfiguracio (Club Configuration) -> Szamlazasi fiok (Invoice Account) at /Club/InvoiceAccount.
Supported Invoice Engines¶
| ID | Engine | Integration Project | Description |
|---|---|---|---|
| 1 | Szamlazz.hu | Szamlazz.NET/ |
Hungarian invoicing with NAV (tax authority) reporting |
| 2 | Billingo | Billingo/ |
Cloud-based invoicing service |
Demo environment
The demo system has 2 invoice accounts configured.
Invoice Account Configuration¶
Each account is stored in the InvoiceAccount table:
| Field | Description |
|---|---|
| Name | Display name of the account |
| InvoiceAccountType_ID | Engine type (1 = Szamlazz.hu, 2 = Billingo) |
| ApiKey | API authentication key |
| Prefix | Invoice number prefix |
| ProviderBank | Bank name for payment details |
| ProviderBankAccount | Bank account number |
| EmailReplyTo | Reply-to address on invoice emails |
| DocumentBlock | Document block identifier (engine-specific) |
| DeadlineDays | Payment deadline in days |
| VATRate | VAT percentage |
| VATCode | VAT category code |
| IsCompanyInvoiceAllowed | Whether company invoicing (cegnev) is supported |
| IsMultiLanguage | Whether invoices can be generated in multiple languages |
| IsDefault | Whether this is the default account |
| IsDeleted | Soft-delete flag |
User-Level Invoice Preferences¶
- User.InvoiceAccount_ID -- per-user default invoice account preference.
- UserInvoiceAccount table -- links users to specific invoice accounts when multiple are available.
- PreferredInvoiceAccount = USER -- the system respects the user's own preference.
Automatic Invoicing¶
The system can generate invoices automatically on a scheduled basis.
| Parameter | Value | Description |
|---|---|---|
| AutomaticInvoiceDay | (empty) | Day of month for auto-invoicing. Empty = disabled |
| AutomaticInvoicePaymentType | [4, 5] | Payment types included: Rent(4) and Trainer(5) |
| AutomaticInvoiceEmailList | (configured) | Notification recipients when auto-invoicing runs |
flowchart TD
A[Scheduled trigger on AutomaticInvoiceDay] --> B{Day configured?}
B -->|No| C[Skip]
B -->|Yes| D[Query payments with type in AutomaticInvoicePaymentType]
D --> E[Filter: PaymentStatus = Created or Billed]
E --> F[Generate invoices via configured engine]
F --> G[Send notification to AutomaticInvoiceEmailList]Enabling automatic invoicing
Set AutomaticInvoiceDay to a day number (e.g., 1 for the first of each month) in Admin muveletek -> Rendszer beallitasok (Admin Operations -> System Settings). Only Rent and Trainer payment types are processed by default.
Company Invoicing¶
When IsCompanyInvoiceAllowed is enabled on an invoice account, customers can request invoices issued to their company name and tax number instead of their personal details.
Multi-Language Invoices¶
When IsMultiLanguage is enabled, invoices can be generated in the customer's preferred language, useful for clubs with international clientele.