Merge pull request #278 from sprain/deprecate-combined-address

Deprecate combined address

Author: sprain

README.md

@@ -81,7 +81,7 @@ approximately 10% of current installations of the corresponding dependency.
 ## Official resources
 The repository contains the official specifications the library is based on:
 
-- [Swiss Implementation Guidelines QR-bill](docs/specs/ig-qr-bill-en-v2.2.pdf)
+- [Swiss Implementation Guidelines QR-bill](docs/specs/ig-qr-bill-v2.3-en.pdf)
 - [Technical information about the QR-IID and QR-IBAN](docs/specs/qr-iid_qr-iban-en.pdf)
 - [Style Guide QR-bill](docs/specs/style-guide-en.pdf)
 - [Validation Tool](https://validation.iso-payments.ch/gp/qrrechnung/validation/)

docs/specs/ig-qr-bill-delta-guide-v2.3-en.pdf

@@ -19,10 +19,12 @@
 // Add creditor information
 // Who will receive the payment and to which bank account?
 $qrBill->setCreditor(
-    QrBill\DataGroup\Element\CombinedAddress::create(
+    QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Robert Schneider AG',
-        'Rue du Lac 1268',
-        '2501 Biel',
+        'Rue du Lac',
+        '1268',
+        '2501',
+        'Biel',
         'CH'
     )
 );
@@ -35,9 +37,6 @@
 
 // Add debtor information
 // Who has to pay the invoice? This part is optional.
-//
-// Note how you can use two different styles of addresses: CombinedAddress or StructuredAddress.
-// They are interchangeable for creditor as well as debtor.
 $qrBill->setUltimateDebtor(
     QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Pia-Maria Rutschmann-Schnyder',

docs/specs/ig-qr-bill-v2.3-en.pdf

@@ -15,10 +15,12 @@
 // Add creditor information
 // Who will receive the payment and to which bank account?
 $qrBill->setCreditor(
-    QrBill\DataGroup\Element\CombinedAddress::create(
+    QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Robert Schneider AG',
-        'Rue du Lac 1268',
-        '2501 Biel',
+        'Rue du Lac',
+        '1268',
+        '2501',
+        'Biel',
         'CH'
     )
 );

example/example.php

@@ -12,10 +12,12 @@
 // Add creditor information
 // Who will receive the payment and to which bank account?
 $qrBill->setCreditor(
-    QrBill\DataGroup\Element\CombinedAddress::create(
+    QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Robert Schneider AG',
-        'Rue du Lac 1268',
-        '2501 Biel',
+        'Rue du Lac',
+        '1268',
+        '2501',
+        'Biel',
         'CH'
     )
 );
@@ -28,9 +30,6 @@
 
 // Add debtor information
 // Who has to pay the invoice? This part is optional.
-//
-// Notice how you can use two different styles of addresses: CombinedAddress or StructuredAddress.
-// They are interchangeable for creditor as well as debtor.
 $qrBill->setUltimateDebtor(
     QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Pia-Maria Rutschmann-Schnyder',

example/example_minimal.php

@@ -16,10 +16,12 @@
 
 // Add creditor information
 $qrBill->setCreditor(
-    QrBill\DataGroup\Element\CombinedAddress::create(
+    QrBill\DataGroup\Element\StructuredAddress::createWithStreet(
         'Robert Schneider AG',
-        'Rue du Lac 1268',
-        '2501 Biel',
+        'Rue du Lac',
+        '1268',
+        '2501',
+        'Biel',
         'CH'
     )
 );

example/example_scor.php

@@ -10,6 +10,11 @@
 use Symfony\Component\Validator\Constraints as Assert;
 use Symfony\Component\Validator\Mapping\ClassMetadata;
 
+/**
+ * @deprecated The CombinedAdress is no longer supported by v2.3 of the QR bill specifications, valid from 21 November 2025.
+ * This class will be removed in a future major version of this library. Use StructuredAddress instead.
+ * For UltimateDebtor, you can also choose to set no data at all.
+ */
 class CombinedAddress extends Address implements AddressInterface, SelfValidatableInterface, QrCodeableInterface
 {
     use SelfValidatableTrait;