, guests?: ?int, portal_reference?: ?string, portal_total?: ?int, notes?: ?string, guest_confirmed?: bool, processing_mode?: ?ProcessingMode} $facts * * @throws ReservationException */ public function handle(Property $property, Channel $channel, CarbonImmutable $arrival, CarbonImmutable $departure, array $facts = [], ?BlockedPeriod $evidence = null): Booking { if ($channel->property_id !== $property->id) { throw new ReservationException('Der Kanal gehört nicht zu dieser Wohnung.'); } if ($departure->lessThanOrEqualTo($arrival)) { throw new ReservationException('Die Abreise muss nach der Anreise liegen.'); } $booking = DB::transaction(function () use ($property, $channel, $arrival, $departure, $facts, $evidence): Booking { Property::query()->whereKey($property->id)->lockForUpdate()->firstOrFail(); if ($evidence !== null) { $evidence = BlockedPeriod::query()->whereKey($evidence->id)->lockForUpdate()->firstOrFail(); $existing = $this->checkEvidence($evidence); if ($existing !== null) { return $existing; } } $guests = isset($facts['guests']) && (int) $facts['guests'] > 0 ? (int) $facts['guests'] : null; $guest = $evidence?->guest ?? $this->guestFrom((array) ($facts['guest'] ?? [])); $portalTotal = isset($facts['portal_total']) && $facts['portal_total'] !== '' ? (int) $facts['portal_total'] : null; $reference = filled($facts['portal_reference'] ?? null) ? trim((string) $facts['portal_reference']) : ($evidence?->ical_interpretation['fields']['booking_reference'] ?? null); $booking = $property->bookings()->create([ 'guest_id' => $guest?->id, 'status' => BookingStatus::Reserved, 'source' => 'portal', 'intake' => IntakeKind::Booking, 'origin_channel_id' => $evidence?->origin_channel_id ?? $channel->id, 'portal_reference' => $reference, 'arrival' => $arrival->toDateString(), 'departure' => $departure->toDateString(), 'guests' => $guests, 'hold_expires_at' => null, 'guest_confirmed_at' => ($facts['guest_confirmed'] ?? false) ? now() : null, 'internal_notes' => filled($facts['notes'] ?? null) ? trim((string) $facts['notes']) : null, 'processing_mode' => $facts['processing_mode'] ?? null, ...$this->price->columns($property, $arrival, $departure, $guests, $portalTotal, $channel->name), ]); if ($evidence !== null) { $evidence->forceFill([ 'is_representation' => true, 'representation_automatic' => false, 'canonical_block_id' => null, 'linked_booking_id' => $booking->id, 'export_approved' => false, 'needs_review' => false, 'reviewed_at' => now(), 'occupation_kind' => OccupationKind::Reservation, 'guest_id' => $guest?->id, 'review_note' => 'Als Vorgang übernommen; der Vorgang führt diese Belegung.', ])->save(); } $this->confirm->bind($booking); if ($evidence !== null) { app(ReconcileChannelRepresentations::class)->handle($property); } return $booking->refresh(); }); // The process core sends the documents when everything is there (automatic mode); v0.11 (E-036): the booking // stays binding, only missing administrative details of a reachable guest are asked for. app(ProcessRunner::class)->advance($booking, 'booking.taken_over'); return $booking->refresh(); } /** * A portal calendar entry can become a case once: returns the case it already belongs to, or throws when the entry * is no reservation of a portal. * * @throws ReservationException */ private function checkEvidence(BlockedPeriod $evidence): ?Booking { if (! in_array($evidence->source, ['channel', 'email', 'api'], true) || $evidence->channel_id === null) { throw new ReservationException('Übernehmen lassen sich nur Reservierungen aus einem Portalkalender.'); } if ($evidence->occupationKind() === OccupationKind::Block) { throw new ReservationException('Eine Sperrzeit ist keine Buchung. Bitte zuerst „Einordnen“ und als Portalreservierung kennzeichnen.'); } if ($evidence->is_representation && $evidence->linked_booking_id !== null) { return Booking::query()->findOrFail($evidence->linked_booking_id); } if ($evidence->is_representation) { throw new ReservationException('Dieser Eintrag ist die Spiegelung einer anderen Belegung. Der Vorgang gehört an die führende Belegung.'); } return null; } /** * The guest the portal named – only with a real name. A known e-mail address finds the existing guest without * overwriting his data; nothing is invented. * * @param array $data */ private function guestFrom(array $data): ?Guest { $data = array_map(fn ($value) => filled($value) ? trim((string) $value) : null, Arr::only($data, ['first_name', 'last_name', 'email', 'phone', 'street', 'postal_code', 'city', 'country'])); if (blank($data['first_name'] ?? null) || blank($data['last_name'] ?? null)) { return null; } $email = filled($data['email'] ?? null) ? mb_strtolower($data['email']) : null; if ($email !== null && ($known = Guest::query()->where('email', $email)->whereNull('anonymized_at')->first()) !== null) { return $known; } return Guest::query()->create([...array_filter($data, fn ($value) => $value !== null), 'email' => $email ?? '']); } }