- How do I install horstoeko/zugferd-laravel in a Laravel application?
- Install it with Composer using composer require horstoeko/zugferd-laravel, then publish its configuration file if you need to customize defaults. The package registers a service provider and facade, so you can resolve the client through dependency injection or the facade in your invoice-generation code. Check the README for the exact publish command and any required upstream dependency configuration.
- Does this package support ZUGFeRD, Factur-X and XRechnung invoices?
- Yes. It is a Laravel integration layer over horstoeko/zugferd, which handles ZUGFeRD 2.x, Factur-X and XRechnung profile and XML serialization concerns. The wrapper itself mainly provides the service provider, facade and configuration. Confirm that the pinned upstream release supports your exact target profile and schema version, such as XRechnung 3.x or Factur-X EN 16931.
- Can horstoeko/zugferd-laravel create PDF/A-3 files with embedded XML?
- The integration exposes the upstream library's ability to generate invoice artifacts, including PDF/A-3 output with embedded XML where supported. PDF/A-3 embedding depends on a capable PDF writer, correct XMP metadata and font embedding, so validate real output with a tool such as veraPDF. If you already generate PDFs, check whether the upstream path embeds into existing PDFs or produces the PDF itself before committing to an integration design.
- What is the difference between horstoeko/zugferd-laravel and horstoeko/zugferd?
- horstoeko/zugferd-laravel is a thin Laravel wrapper that adds a service provider, facade and configuration file. Almost all domain logic, including profile handling, XML serialization, PDF/A-3 embedding and validation, lives in the upstream horstoeko/zugferd library. If the wrapper lags Laravel releases you can usually bypass it and call the upstream library directly, because the facade is not load-bearing.
- Which Laravel and PHP versions does this package support?
- The provided context does not list an exact Laravel and PHP version matrix, so check the package composer.json and README for current constraints. Because the package is a thin wrapper, your practical compatibility is determined by both the wrapper's service provider and the upstream horstoeko/zugferd requirements. Verify support for your target stack, such as Laravel 11 or 12 and PHP 8.2 or newer, before adoption.
- Does it validate invoices against XSD and Schematron rules?
- The upstream horstoeko/zugferd library handles schema validation and standards-related serialization, but you must confirm what runs inline versus what requires external tooling. XSD plus Schematron, and for XRechnung the KoSIT validator, are the reliable acceptance gates for production. Treat the package as an invoice serialization library and add external validation where your target profile demands it.
- How do I configure profiles, seller data and buyer data per tenant?
- The Laravel package ships with a configuration file, which is typically global, so per-tenant behavior needs deliberate handling. You can resolve or rebuild the client per tenant with runtime configuration, or call the upstream library directly with tenant-specific settings. Confirm how the facade caches configuration before relying on it for multi-tenant invoice generation.
- Can I use this package inside queued jobs and long-running workers?
- Yes, but resolve the client and configuration carefully inside each job rather than assuming the facade always reflects fresh tenant settings. Long-running workers can hold stale config if values are cached at container resolution time. For safety, set or inject the required profile and metadata per job, then generate and store the XML or PDF/A-3 artifact.
- Is horstoeko/zugferd-laravel suitable for production e-invoicing compliance?
- It is suitable as an invoice serialization component, not as a complete e-invoicing platform. You remain responsible for document numbering, delivery, archiving, retention, profile selection and reliable acceptance validation. Because German and French e-invoicing requirements are deadline-bound and rejection is a business interruption, add golden-file tests, veraPDF checks and a fork policy for the upstream dependency.
- What are the alternatives to horstoeko/zugferd-laravel?
- The closest alternative is using horstoeko/zugferd directly and writing your own small Laravel service binding, which avoids wrapper lag risk. Other options include dedicated e-invoicing services or libraries that cover ZUGFeRD, Factur-X or XRechnung generation and validation. Choose based on the exact profiles you must support, PDF/A-3 fidelity, validation depth and long-term maintenance.