Zum Inhalt springen
Ab 01.01.2027: E-Rechnungspflicht für Unternehmen über 800.000 € Umsatz. So stellst du deine PHP- oder Laravel-App um

API reference

Quittio\Country

quittio/country-de#

Quittio\Country\DE

Quittio\Country\DE\Builder

  • GermanInvoiceGerman special cases of an invoice, reached with the builder macro de():
  • GermanInvoiceMacrosRegisters the builder macro de() of the German pack, which leads to the German special cases (GermanInvoice):

Quittio\Country\DE\Dunning

  • BaseRatesBase rates (section 247 BGB) of the application in addition to the table shipped with Quittio, e.g. rates published after the release or fetched with BundesbankBaseRates. DefaultInterest uses table() unless it is given a table of its own. In Laravel the GermanyServiceProvider registers the configured and the fetched rates.
  • BaseRateTableBasiszinssatz according to section 247 BGB, published by the Deutsche Bundesbank and changed on 1 January and 1 July. Rates after the last entry are added with withRate(), BaseRates::register() or, in Laravel, the configuration quittio.countries.de.base_rates and the command quittio:base-rate:update (BundesbankBaseRates).
  • BundesbankBaseRatesFetches the base rate according to section 247 BGB from the statistics API of the Deutsche Bundesbank (time series BBIN1.M.DE.BBK.BBKBAS2.EUR.ME, formerly SU0115). The series has a value per month; the rate changes on 1 January and 1 July, so the values of January and July are the table entries. A new rate appears once the Bundesbank has published the value of that month.
  • DefaultInterestDefault interest according to section 288 BGB: base rate plus 9 points (business) or 5 points (consumer), split at every change of the base rate. Points, flat rate and day count basis come from the dunning law, by default CountryDE::germanDunningLaw(); the calculation is that of Quittio\Core\Dunning\DefaultInterest. The base rates are those shipped with Quittio plus the rates registered with BaseRates (configured or fetched from the Bundesbank), unless a table is given.

Quittio\Country\DE\Formats

  • GermanFormatRuleFormats that German law prescribes:
  • XRechnungFormatsThe XRechnung formats of the German pack: XRechnung in CII (default) and in UBL, each with the profiles XRechnung, XRechnung extension and XRechnung CVD.

Quittio\Country\DE\Laravel

  • GermanyServiceProviderLaravel integration of the German country pack (discovered automatically): the base rates of quittio.countries.de.base_rates and of the file written by quittio:base-rate:update are registered with BaseRates, so that DefaultInterest uses them.

Quittio\Country\DE\Layouts

  • Din5008DIN 5008 business letter layouts: the address field of 85 × 45 mm starts 27 mm (form A) or 45 mm (form B) from the top edge and 20 mm from the left edge. In both forms it holds the Zusatz- und Vermerkzone (17.7 mm, five lines filled from the bottom; without further notes its last line is the Rücksendeangabe) and the Anschriftzone (27.3 mm, six lines), which starts 44.7 mm (A) or 62.7 mm (B) from the top edge. Fold marks at 87/192 mm (A) or 105/210 mm (B), punch mark at 148.5 mm.

Quittio\Country\DE\Profiles\XRechnung

  • XRechnung30XRechnung 3.0 (German CIUS of EN 16931), syntax CII or UBL.
  • XRechnung30CvdXRechnung CVD 0.9: XRechnung 3.0 for the procurement of road vehicles under the Clean Vehicles Directive (EU) 2019/1161. It requires the contract (BT-12) and tender or lot reference (BT-17) and at least one line that states the vehicle category as item classification (BT-158, scheme CVD) and the vehicle type as item attribute "cva" (BT-160, BT-161), see BR-DE-CVD-01 to 06-b. Choose it explicitly with ->profile('xrechnung-cvd'); the automatic format choice never does.
  • XRechnung30ExtensionXRechnung 3.0 extension: adds sub invoice lines (UBL only) and third party payments. Choose it explicitly with ->profile('xrechnung-extension'): neither the automatic format choice nor the profile xrechnung switch to it when extension data is used; with xrechnung such data is reported as an error.

Quittio\Country\DE\Rules

  • BmfErrorClass enumError classes of the BMF letter of 15 October 2025.
  • UstgRulesMandatory invoice information according to the German VAT act: section 14 (4) and 14a UStG, section 33 UStDV for small amount invoices and section 34a UStDV for small business invoices.
  • XRechnungRulesBusiness rules of the CIUS XRechnung 3.0 (BR-DE-…), its extension (BR-DEX-…) and XRechnung CVD (BR-DE-CVD-…), checked on the data model.

Quittio\Country\DE\Support

  • FlagsMeta flags (InvoiceData::$meta->flags) understood by the German country pack.
  • LeitwegIdLeitweg-ID of public buyers in Germany (BT-10 for XRechnung): coarse address (2–12 digits), optional fine address (up to 30 characters) and check digits according to ISO 7064 Mod 97-10.
  • TaxNumberGerman tax number (Steuernummer, BT-32) as described in "Prüfung der Steuer- und Steueridentifikationsnummer" of the Bayerisches Landesamt für Steuern (ELSTER, as of 2 September 2026): the 13-digit ELSTER format FFFF0BBBUUUUP (NRW: FFFF0BBBBUUUP), the 12-digit federal format without the 0, and the notation of the federal states on tax notices (e.g. 181/815/08155 in Bavaria, 133/8150/8159 in NRW).

Quittio\Country\DE\Tax

  • CustomVatPresetAd-hoc preset of the German pack, e.g. from VatPreset::exempt(). Like the VatPreset cases, its text defaults to German when the invoice has no locale; other locales without a text fall back to English.
  • TaxTablesGerman tax values that changed over time, each valid from its date on.
  • VatPreset enumTax presets for Germany.

Quittio\Country\DE\Texts

  • LegalTextsMandatory and informational texts for German invoices.

quittio/country-at#

Quittio\Country\AT

Quittio\Country\AT\Dunning

  • BaseRateTableBasiszinssatz of the Oesterreichische Nationalbank for default interest between businesses (section 456 UGB): the rate on the first day of a half-year applies to the whole half-year. Rates after the last entry are added with withRate().
  • DefaultInterestAustrian default interest: the base rate of the OeNB plus 9.2 points between businesses (section 456 UGB), split at every change of the base rate, and 4 % for consumers (section 1000 (1) ABGB). The calculation is that of Quittio\Core\Dunning\DefaultInterest.

Quittio\Country\AT\EbInterface

  • EbInterfaceReaderReads ebInterface 6.0 and 6.1 invoices into the data model; CountryAT::readers() registers it, so that Quittio::read() and validateFile() accept them. The mapping is that of EbInterfaceWriter in reverse; the result has the syntax "ebinterface" and no profile.
  • EbInterfaceWriterWrites a calculated invoice as ebInterface 6.1, the Austrian XML invoice format of AUSTRIAPRO that e-Rechnung.gv.at accepts besides UBL.

Quittio\Country\AT\Formats

  • AustrianFormatRuleFormats for Austrian public buyers: a buyer with an Austrian organisation number (electronic address scheme 9915, e.g. "b" for the federal government on Peppol) receives UBL in the CIUS of e-Rechnung.gv.at (CIUS-AT-GOV).

Quittio\Country\AT\Profiles

  • CiusAtGovCIUS-AT-GOV 1.1.0, the CIUS of e-Rechnung.gv.at for invoices to the Austrian federal government: the rules of CIUS-AT-NAT and its own, syntax CII or UBL.
  • CiusAtNatCIUS-AT-NAT 1.0.0, the Austrian national CIUS of EN 16931 with the statutory rules, syntax CII or UBL.

Quittio\Country\AT\Rules

  • CiusAtRulesRules of the Austrian CIUS of EN 16931: CIUS-AT-NAT 1.0.0 (statutory rules, AT-NAT-…) and CIUS-AT-GOV 1.1.0 (rules of e-Rechnung.gv.at for the federal government, AT-GOV-…), as published by the BRZ for the BMF (e-rechnung.gv.at/go/cius_at_nat, /go/cius_at_gov).
  • UstgRulesMandatory invoice information according to the Austrian VAT act (section 11 UStG 1994), with the simplified invoice of section 11 (6) UStG up to 400 EUR and for small businesses.

Quittio\Country\AT\Tax

  • CustomVatPresetAd-hoc preset of the Austrian pack, e.g. from VatPreset::exempt(). Like the VatPreset cases, its text defaults to German when the invoice has no locale; other locales without a text fall back to English.
  • TaxTablesAustrian tax values, each valid from its date on.
  • VatPreset enumTax presets for Austria (UStG 1994).

Quittio\Country\AT\Texts

  • LegalTextsMandatory and informational texts for Austrian invoices.

quittio/country-be#

Quittio\Country\BE

Quittio\Country\BE\Dunning

  • ReferenceRateTableThe reference rate of the late payment law of 2 August 2002: the main refinancing rate of the ECB on the first day of the half-year, which with the 8 points of the law gives the published rate rounded up to the next half point. The table holds the rates the points are added to, so that the sum is the rate published by the FPS Finance (e.g. 2.50 + 8 = 10.50 % for 2026).

Quittio\Country\BE\Formats

  • BelgianFormatRuleSince 1 January 2026 invoices between businesses established in Belgium are structured e-invoices, by default Peppol BIS Billing 3.0 (law of 6 February 2024): domestic invoices to businesses get the format "peppol". Not for consumers and not for businesses that only perform exempt supplies without input tax deduction (Art. 44 VAT Code).

Quittio\Country\BE\Rules

  • VatCodeRulesMentions of a Belgian invoice: Art. 53 § 2 of the VAT Code and Art. 5 of Royal Decree No. 1, and the use of languages in the Dutch, French and German language regions.

Quittio\Country\BE\Support

  • EnterpriseNumberThe Belgian enterprise number (ondernemingsnummer, numéro d'entreprise) of the Crossroads Bank for Enterprises: ten digits, the last two 97 minus the first eight modulo 97. The VAT number is "BE" and the enterprise number; Peppol uses it with scheme 0208.
  • LanguageRegionThe language region of a Belgian address by its post code: the Dutch language region (Flanders), the French language region (Wallonia without the German-speaking municipalities), the German language region and the bilingual region Brussels-Capital.

Quittio\Country\BE\Tax

  • CustomVatPresetAd-hoc preset of the Belgian pack, e.g. from VatPreset::exempt(). Like the VatPreset cases, its text defaults to Dutch when the invoice has no locale; other locales without a text fall back to English.
  • TaxTablesBelgian VAT rates (Royal Decree No. 20), each valid from its date on.
  • VatPreset enumTax presets for Belgium (VAT Code, Royal Decree No. 20 on the rates).

quittio/country-ch#

Quittio\Country\CH

Quittio\Country\CH\QrBill

  • CreditorReferenceThe Creditor Reference of ISO 11649: "RF", two check digits (modulo 97-10) and up to 21 letters and digits. It goes with an ordinary IBAN in the Swiss QR bill.
  • QrReferenceThe QR reference of the Swiss QR bill: 27 digits, the last a check digit after modulo 10 recursive (Swiss Implementation Guidelines QR-bill, annex B). It goes with a QR-IBAN only.
  • SwissCrossThe Swiss cross printed in the middle of the Swiss QR Code (7 × 7 mm, guidelines 6.4.2): a black square with a white border and the white cross, as PNG (PDF/A allows no SVG of mPDF).
  • SwissQrBillGeneratorThe Swiss QR bill: the Swiss QR Code (Swiss Payments Code "SPC", version 0200) and its payment part with receipt, after the Swiss Implementation Guidelines QR-bill 2.3 of SIX.

Quittio\Country\CH\Rounding

  • CashRoundingRounding of the amount due to 5 Rappen, as usual in Switzerland: the difference is the rounding amount (BT-114), never a change of the VAT or the line amounts.

Quittio\Country\CH\Rules

  • MwstgRulesElements of an invoice according to the Swiss VAT act (Art. 26 (2) MWSTG), with the till receipt of Art. 57 MWSTV up to CHF 400 that needs no recipient.

Quittio\Country\CH\Tax

  • CustomVatPresetAd-hoc preset of the Swiss pack, e.g. from VatPreset::exempt(). Like the VatPreset cases, its text defaults to German when the invoice has no locale; other locales without a text fall back to English.
  • TaxTablesSwiss VAT rates (Art. 25 MWSTG), each valid from its date on.
  • VatPreset enumTax presets for Switzerland (MWSTG).

quittio/country-fr#

Quittio\Country\FR

  • CountryFRCountry pack for France (metropolitan France and Monaco).

Quittio\Country\FR\Dunning

  • EcbRateTableThe rate of the main refinancing operations of the ECB on the first day of the half-year, the reference of the late payment penalties between businesses (art. L441-10 Code de commerce: ECB rate plus 10 points, e.g. 12.40 % in the second half of 2026).

Quittio\Country\FR\Formats

  • FrenchFormatRuleInvoices between businesses established in France are e-invoices in Factur-X, UBL or CII, exchanged through an approved platform (plateforme agréée): large and mid-sized businesses issue them from 1 September 2026, all from 1 September 2027; all receive them from 2026. Domestic invoices to businesses get Factur-X (the format "zugferd", profile EN 16931). Sending through a platform is not part of this pack.

Quittio\Country\FR\Rules

  • FrenchRulesMentions of a French invoice: art. 242 nonies A of annex II to the CGI (with the mentions of the e-invoicing reform from 1 September 2026) and art. L441-9 of the Code de commerce for invoices between businesses.

Quittio\Country\FR\Support

  • SirenSIREN (nine digits) and SIRET (fourteen digits) of the French business register, both with a Luhn check digit; SIRET numbers of La Poste (SIREN 356000000) use a sum of digits instead.

Quittio\Country\FR\Tax

  • CustomVatPresetAd-hoc preset of the French pack, e.g. from VatPreset::exempt(). Like the VatPreset cases, its text defaults to French when the invoice has no locale; other locales without a text fall back to English.
  • VatPreset enumTax presets for metropolitan France (CGI, from 1 January 2027 recodified in the CIBS; the references to the CGI remain accepted until 30 June 2028). exemptionReason() cites the CGI, exemptionReasonOn() the CIBS for invoices issued from 1 January 2027.

Quittio\Country\FR\Texts

  • LegalTextsLegal mentions of French invoices, from the pack's language files (resources/lang/{locale}/legal.php).

Die Open-Core-Pakete stehen unter der MIT-Lizenz. Die rechtlichen Formulierungen der Länderpakete sind mit einer Steuerberatung abzustimmen.