HP-2883: Implement Business Central bills import service

[VadymHrechukha]

Summary by CodeRabbit

New Features

• Billing records can now include and retrieve source information for better bill origin tracking
• Added support for external payment transaction identifiers to enhance reconciliation and transaction management capabilities
• Expanded billing data model with additional accessor methods for source and transaction details

[coderabbitai]

📝 Walkthrough

Walkthrough

Two new value object classes (BillSource and BillTxn) are introduced to represent bill sources and external transaction identifiers. The Bill class is extended with corresponding properties and getter methods, and the BillInterface is updated with new accessor method declarations.

Changes

Cohort / File(s)	Summary
Bill Enhancement src/bill/Bill.php, src/bill/BillInterface.php	Extended Bill with $source and $txn properties, added corresponding public getters, updated constructor to accept these optional parameters, and extended interface with method declarations.
New Value Objects src/bill/BillSource.php, src/bill/BillTxn.php	Introduced BillSource class with id and name fields; introduced BillTxn class with value field and static factory method fromString().

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A bill now knows its source so bright,
And transactions dance in the light,
New fields hop along with grace,
Finding their proper place!
Hop-hop-hop, the billing's right! 🌿

🚥 Pre-merge checks | ✅ 1 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Title check	⚠️ Warning	The PR title references a Jira ticket (HP-2883) and mentions implementing a Business Central bills import service, but the actual changes only add data structure classes (BillSource, BillTxn) and extend existing Bill/BillInterface with new properties and methods. The changes do not appear to implement the import service itself.	Update the PR title to reflect the actual changes, such as 'Add BillSource and BillTxn value objects to Bill class' or 'Extend Bill with source and transaction identifiers' to accurately describe the implementation changes.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

Important

Action Needed: IP Allowlist Update

If your organization protects your Git platform with IP whitelisting, please add the new CodeRabbit IP address to your allowlist:

• ✨ 136.113.208.247/32 (new)
• 34.170.211.100/32
• 35.222.179.152/32

Reviews will stop working after February 8, 2026 if the new IP is not added to your allowlist.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}