EVENTS: Kursrechnung an Abacus übermitteln

[codez]

blocked by #1002

In diesem Ticket wird die technische Grundlage gelegt, um Kursrechnungen an Abacus zu schicken.

Course Invoice

Analog zur MembershipInvoice braucht es eine Klasse Invoices::Abacus::CourseInvoice, welche eine Kursrechnung für Abacus vorbereitet.

Zur Initialisierung der Klasse wird eine Event::Participation eines Kurses übergeben.

Eine Kursrechnung hat immer nur eine Position (Invoices::Abacus::InvoicePosition):

• name: "{participation.price_category} - {participation.event.kind.level}" (entsprechend mit I18n)
• grouping: gleich wie name
• amount: participation.price
• count: 1
• article_number: Group.root.sac_membership_configs.active(participation.event.dates.order(:start_at).first.start_at).course_fee_article_number
• cost_center: participation.event.kind.cost_center.code
• cost_unit: participation.event.kind.cost_unit.code

Als additional_user_fields werden folgende Felder gesetzt:

• user_field8: Kursnummer
• user_field9: Kursname
• user_field10: Kursdaten, falls mehrere kommasepariert, ohne Wochentag und Zeit. z.B. "16.05.2024 - 29.05.2024"

Die Methode invoice? gibt false zurück, falls der Betrag der Position null ist.

CreateCourseInvoiceJob

Der bestehende Invoices::Abacus::CreateInvoiceJob erhält zwei neue Subklassen: CreateMembershipInvoiceJob und CreateCourseInvoiceJob. Die neue Basisklasse nimmt im initialize nur noch das Argument external_invoice und erhält eine leere Template Methode invoice_data, welche überall anstelle von membership_invoice aufgerufen wird. In CreateMembershipInvoiceJob entspricht die Implementation von invoice_data der jetztigen membership_invoice Methode. Die assign_error Methode wird in der Basisklasse ebenfalls vereinfacht, eine Methode invoice_error_key extrahiert, welche in CreateMembershipInvoiceJob mit der jetzigen Implementation überschrieben wird. Bisherige Verwendungen von CreateInvoiceJob müssen auf CreateMembershipInvoiceJob umgestellt werden.

Der neue CreateCourseInvoiceJob erstellt in invoice_data eine Instanz von Invoices::Abacus::CourseInvoice mit der Teilnahme aus dem external_invoice.link. Der restliche Ablauf bleibt identisch.

ExternalInvoice::Course

Auf der Klasse ExternalInvoice::Course wird eine klassenseitige Methode invoice_participation(participation) erstellt, welche folgendes macht:

• Neue Instanz erzeugen mit den folgenden Attributen:
  • person: participation.person
  • issued_at: Date.current
  • sent_at: Date.current
  • state: :draft
  • total: participation.price
  • link: participation
  • year: participation.event.dates.order(:started_at).first.started_at.year
• Invoices::Abacus::CreateCourseInvoiceJob enqueuen mit der neu erstellten External Invoice

Falls der Preis auf der Participation leer ist, wird keine External Invoice erzeugt und auch kein Job enqueued.

ToDo

• [ ] Domainklasse erstellen oder anpassen
• [ ] Specs schreiben
• [ ] Mit angemessener Rolle "durchklicken"

[tobiasstern]

Etwas was glaube ich bei meiner Besprechung mit Pascal vergessen ging ist der Anzeige-Titel in der Rechnungsübersicht. Dort werden ja aktuell die Mitgliedschaftsrechnungen so angezeigt (vgl. Bild):

Hat Pascal in diesem Ticket hier spezifiziert, wie der Titel sein soll für Kursrechnungen?

Falls nicht bitte wie folgt umsetzen: Titel: {Kursname} ({Kursnummer}) Beispiel: "Lawinen Ski + Snowboard (2025-0524)"