data
94efa59df3
- Add multi-invoice payment support (link one bank transaction to multiple invoices) - Add payment unlinking feature to correct wrong matches - Show linked payments, invoices and bank entries in transaction detail view - Allow linking already paid invoices to bank transactions - Update README with new features - Add CHANGELOG.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
80 lines
2.7 KiB
PHP
Executable file
80 lines
2.7 KiB
PHP
Executable file
<?php
|
|
|
|
namespace Fhp\Protocol;
|
|
|
|
use Fhp\Model\SEPAAccount;
|
|
use Fhp\Segment\HIUPA\HIUPAv4;
|
|
use Fhp\Segment\HIUPD\HIUPD;
|
|
|
|
/**
|
|
* Contains the "Userparameterdaten" (UPD), i.e. configuration information that was retrieved from the bank server
|
|
* during dialog initialization and that is user-specific. This library currently does not store persisted UPD, so it
|
|
* just retrieves them freshly every time.
|
|
*/
|
|
class UPD
|
|
{
|
|
/** @var HIUPAv4 The HIBPA segment received from the server, which contains most of the UPD data. */
|
|
public $hiupa;
|
|
/** @var HIUPD[] All HIUPD segments from the server, which contain *per-account* information. */
|
|
public $hiupd;
|
|
|
|
public function getVersion()
|
|
{
|
|
return $this->hiupa->updVersion;
|
|
}
|
|
|
|
/**
|
|
* @param Message $response A dialog initialization response from the server.
|
|
* @return bool True if the UPD data is contained in the response and {@link extractFromResponse()} would
|
|
* succeed.
|
|
*/
|
|
public static function containedInResponse(Message $response): bool
|
|
{
|
|
return $response->hasSegment(HIUPAv4::class);
|
|
}
|
|
|
|
/**
|
|
* @param Message $response The dialog initialization response from the server, which should contain the UPD
|
|
* data.
|
|
* @return UPD A new UPD instance with the extracted configuration data.
|
|
*/
|
|
public static function extractFromResponse(Message $response): UPD
|
|
{
|
|
$upd = new UPD();
|
|
$upd->hiupa = $response->requireSegment(HIUPAv4::class);
|
|
$upd->hiupd = $response->findSegments(HIUPD::class);
|
|
return $upd;
|
|
}
|
|
|
|
/**
|
|
* @param SEPAAccount $account An account.
|
|
* @return HIUPD|null The HIUPD segment for this account, or null if none exists for this account.
|
|
*/
|
|
public function findHiupd(SEPAAccount $account): ?HIUPD
|
|
{
|
|
foreach ($this->hiupd as $hiupd) {
|
|
if ($hiupd->matchesAccount($account)) {
|
|
return $hiupd;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* @param SEPAAccount $account The account to test the support for
|
|
* @param string $requestName The request that shall be sent to the bank.
|
|
* @return bool True if the given request can be used by the current user for the given account.
|
|
*/
|
|
public function isRequestSupportedForAccount(SEPAAccount $account, string $requestName): bool
|
|
{
|
|
$hiupd = $this->findHiupd($account);
|
|
if ($hiupd !== null) {
|
|
foreach ($hiupd->getErlaubteGeschaeftsvorfaelle() as $erlaubterGeschaeftsvorfall) {
|
|
if ($erlaubterGeschaeftsvorfall->getGeschaeftsvorfall() == $requestName) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
}
|