provenance->channel; if (! $channel->isPortal() || $channel->tenant_id === null) { throw new InvalidArgumentException('Kanalereignisse kommen nur von Portalen.'); } return app(TenantContext::class)->run($channel->tenant, fn (): ?IntakeDecision => match (true) { $event instanceof IncomingBooking => $this->booking($event), $event instanceof BookingCancelledByChannel => $this->report($event, IntakeOutcome::CancellationSignal, $channel->name.' meldet über die Schnittstelle eine Stornierung'.($event->note ? ' ('.$event->note.')' : '').'. Bitte prüfen Sie die Buchung und die nächsten Schritte.'), $event instanceof BookingChangedByChannel => $this->report($event, IntakeOutcome::ChangeSignal, $channel->name.' meldet über die Schnittstelle eine Änderung'.($event->arrival && $event->departure ? ': '.$event->arrival->format('d.m.').'–'.$event->departure->format('d.m.Y') : '').($event->guests ? ', '.$event->guests.' Personen' : '').'. Die Buchung bleibt unverändert, bis Sie entscheiden.'), $event instanceof PaymentReported => $this->payment($event), $event instanceof PayoutReported => $this->payout($event), default => throw new InvalidArgumentException('Unbekanntes Kanalereignis '.$event::class.'.'), }); } /** * A booking binding at the portal: blocked like a booking e-mail – source api, reference in the identifier – and judged * by PortalIntake – the same case, never a second one; a case only when certain. */ private function booking(IncomingBooking $event): IntakeDecision { $provenance = $event->provenance; $reference = $provenance->externalReference; // The reference is the identity of the block (as for booking mails); without one it is never taken as a reference. $uid = $reference !== null ? 'api:'.$reference : 'api-event:'.$provenance->evidenceRef; $block = $provenance->channel->blockedPeriods()->withTrashed()->where('source', 'api')->where('external_uid', $uid)->first() ?? new BlockedPeriod(['property_id' => $provenance->channel->property_id, 'source' => 'api', 'reason' => $provenance->channel->name, 'external_uid' => $uid]); $block->fill(['starts_on' => $event->arrival->toDateString(), 'ends_on' => $event->departure->toDateString()]); if ($block->trashed()) { $block->restore(); } $provenance->channel->blockedPeriods()->save($block); return $this->intake->process($block->fresh(), IntakeObservation::SOURCE_API); } private function report(BookingCancelledByChannel|BookingChangedByChannel $event, IntakeOutcome $outcome, string $message): ?IntakeDecision { $case = $this->case($event); if ($case === null) { return new IntakeDecision(IntakeOutcome::Clarify, ['Keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference); } $this->intake->reportToCase($event->provenance->channel, $case, $outcome, $message, 'api:'.$event->provenance->evidenceRef, IntakeObservation::SOURCE_API); return new IntakeDecision($outcome, [$message], $case, reference: $event->provenance->externalReference); } private function payment(PaymentReported $event): ?IntakeDecision { $case = $this->case($event); if ($case === null) { return new IntakeDecision(IntakeOutcome::Clarify, ['Zahlungsmeldung keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference); } $this->amounts->handle($case, null, [], [['amount' => $event->amount, 'paid_on' => $event->paidOn->toDateString()]], $event->provenance->channel->name); return new IntakeDecision(IntakeOutcome::Link, ['Zahlung des Gastes laut Portal erfasst (kein Eingang auf unserem Konto).'], $case); } private function payout(PayoutReported $event): ?IntakeDecision { $case = $this->case($event); if ($case === null) { return new IntakeDecision(IntakeOutcome::Clarify, ['Auszahlungsmeldung keinem gebuchten Vorgang sicher zuzuordnen.'], reference: $event->provenance->externalReference); } if ($event->executed) { // Evidence level "laut Portal erledigt" – the receipt on our account is recorded by the landlord (O5). CaseLog::record($case, 'evidence', 'Auszahlung laut '.$event->provenance->channel->name.' ausgeführt: '.Money::format($event->amount).' am '.$event->paidOn->format('d.m.Y').' – Eingang auf unserem Konto noch nicht erfasst.', data: ['module' => 'portal.payout', 'level' => 'stated_by_portal', 'source' => $event->provenance->transport, 'ref' => $event->provenance->evidenceRef], actor: $event->provenance->channel->name); } else { $this->amounts->handle($case, null, [['kind' => 'payout_announced', 'amount' => $event->amount, 'due_on' => $event->paidOn->toDateString()]], [], $event->provenance->channel->name); } return new IntakeDecision(IntakeOutcome::Link, ['Auszahlung laut Portal vermerkt.'], $case); } /** * The binding case of the event: by the portal's booking reference only (no merging by dates for reports). */ private function case(ChannelEvent $event): ?Booking { $reference = $event->provenance->externalReference; $case = $reference === null ? null : $this->intake->caseByReference($event->provenance->channel, $reference); return $case !== null && $case->isBinding() ? $case : null; } }