Skip to content

Incorporating the bank operation reference for unique identification#287

Merged
guillaume-sainthillier merged 5 commits intosilarhi:6.xfrom
TheoB-dev:feature/account-servicer-reference
Mar 17, 2025
Merged

Incorporating the bank operation reference for unique identification#287
guillaume-sainthillier merged 5 commits intosilarhi:6.xfrom
TheoB-dev:feature/account-servicer-reference

Conversation

@TheoB-dev
Copy link
Contributor

First of all, thank you for your excellent work on this project!

This PR adds support for handling the operation reference from the CFONB120 files (positions 105–120 of a type 04 line). This field corresponds to the Account Servicer Reference as defined in the ISO20022 standard.

After discussing the terminology, I opted to name the new field bankOperationReference. I found that the term "Account Servicer Reference" may be unclear for users, and "bankOperationReference" better conveys that it is the reference provided by the bank to uniquely identify the operation.

This change is essential for our reconciliation process of bank transfers, as we also process messages following the ISO20022 standard. In our scenario, the only way to uniquely identify an operation for the same bank is through this reference.

I have updated the related tests to ensure that the new field is correctly parsed and accessible.

Thank you again for the project, and I look forward to your feedback!

use function strlen;

/** @internal */
class RegexMatch

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why these changes in this class?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indeed, that change wasn't necessary. I've just rolled it back.

@guillaume-sainthillier
Copy link
Member

Thank you for PR! Do you have any documentation piece about this part which was not documented before?

@TheoB-dev
Copy link
Contributor Author

The field is documented in the PDF included in the project (CFONB - Structure) under "Référence de l'opération." You can also find it here: https://www.cfonb.org/fichiers/20130612113947_7_4_Releve_de_Compte_sur_support_informatique_2004_07.pdf, on page 7 under the name "Zone référence" (non-mandatory alphanumeric type).
Please let me know if you would like me to document this new field in the project (e.g., via comments or otherwise).

@guillaume-sainthillier guillaume-sainthillier merged commit a616fd4 into silarhi:6.x Mar 17, 2025
10 checks passed
@guillaume-sainthillier
Copy link
Member

Nice catch! Thank you :)

@TheoB-dev TheoB-dev deleted the feature/account-servicer-reference branch March 17, 2025 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants