Feature/swiss qr bill invoices #214
Conversation
- Add Dockerfile with PHP 8.3-FPM, optimized for Laravel - Add docker-compose.yml with full stack (PHP, Nginx, MySQL, Redis, Queue Worker) - Include Nginx and PHP configuration files - Support for wkhtmltopdf for PDF generation - Multi-container setup with proper dependencies and networking - Easy local development setup with 'docker compose up'
…ation
- Add dual mode support: IBAN (manual) vs QR-IBAN (automatic reference)
- Implement comprehensive IBAN validation based on selected mode
- Add QR payment slip positioning at bottom of invoice page 2
- Fix QR reference generation to use only numeric values
- Add invoice-specific custom message field for IBAN mode
- Simplify UI by removing complex fields (unstructured_message, bill_information)
- Add reference pattern with placeholders: {invoice_id}, {invoice_number}, {account_number}, {date_y/m/d}
- Implement proper country code resolution for Swiss QR Bill addresses
- Add info modals with examples and validation explanations
Features:
✅ Two QR Bill modes: IBAN (per-invoice details) and QR-IBAN (auto-reference)
✅ Smart IBAN validation (QR-IBAN 30000-31999 vs normal IBAN)
✅ Payment slip correctly positioned at page bottom
✅ Numeric-only QR reference generation with configurable patterns
✅ Invoice custom message support for IBAN mode
✅ Clean, user-friendly interface without technical complexity
- Update QrBillBuilder to accept Document instead of Invoice for universal support
- Add RecurringInvoice QR payment slip route and controller method
- Implement intelligent field handling for different document types
- Add date resolution for RecurringInvoice (start_date) vs Invoice (date)
- Maintain backward compatibility with existing Invoice implementations
✅ Both Invoice and RecurringInvoice now fully support Swiss QR Bills
✅ Separate routes: /documents/invoice/{id}/qr-payment-slip and /documents/recurring_invoice/{id}/qr-payment-slip
✅ Graceful handling of document-specific fields (payment_reference, qr_custom_message only for Invoices)
|
Can you please explain in detail how this feature benefits everyone? I'm not too familiar with Swiss QR bills. |
Switzerland has introduced the QR-bill as the de facto standard invoicing system (see swiss SME portal press release). It does not benefit everyone. However, I see why it would be amazing to have a standardized way to implement regional standards (e.g. regional standards for charts of accounts, payroll and HR features, tax stuff). Maybe it would be an idea to think about a modular system through laravel-modules for instance? As is, I agree that the PR does not make sense, @andrewdwallo. Fascinatingly, I forked the repo a few weeks before the PR and just implemented the QR-bill option there. Not sure if that's the optimal way to go though. |
Features Swiss QR bill slips