Orchestrator/bahn/project-audit/data/confluence-export/pages/408659462-Austausch pathOS mit AC Preisservice Abrechnungsservice.md

Austausch pathOS mit AC (Preisservice, Abrechnungsservice,...)

Confluence Page ID: 408659462 Version: 61 Pfad: /pathOS/Kommunikationskanäle, Termine, Besprechungsnotizen pathOS/Besprechungsnotizen/Austausch pathOS mit AC (Preisservice, Abrechnungsservice,...) Labels:

---

Teilnehmer Team PathOs Team AC Zweck Dieser Abstimmungstermin dient dazu, die Arbeitsprozesse zu synchronisieren, Abhängigkeiten zu klären, die Zusammenarbeit beider Teams zu optimieren und eine Plattform für den teamübergreifenden Austausch zu schaffen. Ziel des Treffens ist es, die Projekte auf Kurs zu halten und potenzielle Hindernisse oder Risiken, die die Wertschöpfung beeinträchtigen könnten, zu adressieren.

Offene Themen

408659462description,assignee,duedate10 Basil: Fahrpläne, die manuell in die GFD-Z eingegeben werden, kommen über NSS in den BCD-Fahrplan vom Betrieb und von dort zu AC Trasse. Wie ist das mit in die GFD-Z eingegebenen Teilausfällen? Werden sie von AC als solche erkannt?

Agenda  

• Wissenstransfer bzgl. TTT Basics+Details zwischen pathOS und AC planen

Es ist zu klären, ob und wie in ujBau-Prozessen die Preisauskunft aufgerufen wird. Hypothese: Bei GPE/FPE kommt keine Preisinformation in das Trassenobjekt. Bei der netzausgelösten Änderung brauchen wir eine Preisinformation. Frage 1: Unterstützt die Schnittstelle von AC Trasse bereits den Anwendungsfall netzausgelöste Änderung? Frage 2: Wird die Preisauskunft für die NAÄ auch von der GFD-Z aus aufgerufen?

• Werden Änderungen an den Angeboten (Ablehnungen) sowie Vertragsänderungen (Änderungen und Stornierungen) 1:1 an TPN und GFD-Z weitergeleitet während TTTNeo für das Fahrplanjahr 2027?
• Änderungen an den Angeboten (Ablehnungen) sowie Vertragsänderungen (Änderungen und Stornierungen) für GelV Fahrplanjahr 2026 werden ausschließlich über TPN und GFD-Z verwaltet?

Notizen

• Wissentransfer: Übersicht PAthID, was ist das eigentlich? Objektlogik, Zusammenhänge zwischen Objekten, 1,5 h-2 h Termin, Terminwünsche: 26+27.05, 10.6-12.06.
• Pentest SST Pathos <> AC: PI 37
• GPE/FPE: GPE/FPE Strecken d.h. Baufahrpläne kommen nicht über Pathos → d.h. die Bestellung/Anfragen, die durch einen Baufahrplan betroffen sind, können nicht gegen den kürzesten Laufweg evaluiert werden, nur KomBau hat diese Daten → bisher keine Anbindung an AC d.h. GPE/FPE Fahrpläne bekommen keinen Preis Stand: 14.05.
• heutige Umsetzung AC <> GFD-Z: Baufahrpläne kommen auch über GFD-Z, Preisberechnung wird abgebildet über KLW (kürzester Laufweg)-Prozess in AC→ SST Projekt NEXT stellt klw zur Verfügung, Trigger zur Ermittlung des KLW: in Preisanfrage liegen folgende Parameter vor RF120, Betroffenheitbau vor
• TPN+GFD-Z bekommen Angebote und Vertragsänderungen weitergeleitet todo: sind die weitergeleiten Daten so "gut, wie heute", sodass während TTTNeo die alten SST (TPN, GFD-Z) als Rückfallebene

Notizen zum Testvorgehen mit AC zum Abrechnungsservice   

• Aktueller Entwicklungsstand und geplanter Timeline?
• pathOS: Happy path ist implementiert. Fehlerfälle und Systemintegrationstests stehen noch aus.
• AC: Entwicklungsscope ist noch zu klären. AC informiert zeitnah über das Umsetzungsszenario der Trassenabrechnung (Tendenz IBL Daten) -> hat Auswirkung auf Testscope. 

122 incomplete   klärt Entwicklungsscope des Abrechnungsservice und gibt Rückmeldung

• Ausarbeitung fachlicher Testszenarien. Was wollen wir genau testen?

123 complete AC (Testmanager) sendet aktuelle Testcases zum Thema Angebotserstellungsentgelt (AEE) und VÄ (Änderungen und Stornierungen) an pathOS  , Status: 14.05.2025: E-Mail mit Links zu AC Testfällen gesendet, = Testmanager, erster Ansprechpartner auf AC Seite

• Für den weiteren Austausch wird zunächst der zweiwöchige Regeltermin mittwochs 16-17 Uhr genutzt
• Genaues Testvorgehen wird auf dieser Seite Testvorgehen mit AC zum Abrechnungsservice dokumentiert, wenn die Tests starten.              

Notizen

115 incomplete Internationale Züge und verbleibende Edgecases identifizieren, um die Abrechnung in diesen speziellen Fällen sicherzustellen. (V: Basil)    

• Hier Testdaten an Patrick M. durch Basil Z.

117 incomplete Umgang mit Vertragsänderungen in PathOs (V: Martin, Christian, Patrick)  

119 incomplete In der Abrechnungs-API führt die zwingend erforderliche Struktur PlannedTrainData in PlannedJourneyLocation zu Problemen, da sie in TTT und dem internen Datenmodell nur am ersten Zuglaufpunkt erforderlich ist (um die Zugcharakteristik initial zu definieren): Korrektur innerhalb der YAML Datei notwendig (V: Patrick)

• Absprache (auch bezogen auf Zeitpunkt den Umstiegs) zwischen und   

Notizen 

109 complete Bereitstellung der Fehler Preisauskunft im Monat Januar 2025 aus dem Camunda Cockpit von pathOS (V: pathOS,   ) → das I.NVI IT Lifecycle Management Toold1143f0d-33c0-3f1c-b44b-7720150f306eO2CBS-578

112 incomplete Archivierung von Dokumenten pathOS: Welche Umgebung von pathOS ist diesbezüglich an welche Umgebung von AC angebunden? ( V: pathOS, Felix)  

• Anlegen einer Seite in Confluence durch Christian Mei.

113 incomplete Anregung von AC zur Erweiterung der API:  Flag in der API einführen um zu erkennen ob es sich um eine Stornierung handelt? Denn sonst müssten wir bei Requests mit nur neuem Vertrag jedes mal prüfen, ob es ein neuer Vertrag ist oder ob wir diesen bereits kennen und somit diesen Request in die Stornoabrechnung senden. Sicherlich würde das auch machbar sein, aber ein Hinweis auf Storno im Request wäre auf "Nummer sicher gehen"

• Archivierung von Dokumenten pathOS: Sind die Dokumente in BCM und Filero abgelegt? (V: AC, Pia, Thomas)  
• Archivierung von Dokumenten pathOS: Warum wird kein BCM-Status in AC für diese Dokumente gesetzt? (V: AC, Pia)  

Notizen

Technische Details zur bestellsystem-adapter.yml

• Nach gemeinsamer Begutachtung des Merge Requests Zwischensands, wurden die Änderungen beidseitig akzeptiert.
• Patrick ergänzt in einem zweiten Branch / Merge Request die Pflicht Attribute.
• Die Änderungen (Versionierung) der YAML werden nicht im description Feld   Dokumentiert. Perspektivisch wird die YAML mittels Arftifactory bereitgestellt, was impliziert die gewünschte Versionierung erzwingt.

Notizen  

Technische Details zur bestellsystem-adapter.yml

• Für die Leistungsabrechnung werden die Fehler Codes des Responses dahin gehend überarbeitet, dass diese keine Beispiele, sondern eine Struktur in der Open-Api Definition enthalten. Die Struktur wiederum kann auf die Beispiele verweisen.
• Seitens CIB passt   die Änderung direkt in Git an.
• Die Änderungen werden von der AC-Trasse im Merge Request gereviewt.
• Der Umgang mit der Versionsnummer wird nicht geändert. Jedoch sollen die Änderungen in der Description mit Datum festgehalten werden.
• Für den Request der Leistungsbeschreibung prüft  den Status der Pflichtfelder

Notizen  

• Entscheidung zur technischen Lösung der Freigabe von Leistungsbeschreibungen beim Angebotsversand: 

• Lieferung der Freigabe-Info per REST-Schnittstelle. Bedingung: Bei Nicht-Erreichbarkeit wird das Angebot trotzdem rausgeschickt (2-3 Retries). Wenn der Kunde z. B. auf den Link klickt und die Leistungsbeschreibungen (LB's) nicht verfügbar sind, bleibt das so. Das ist aktuell auch in TPN implementiert und als akzeptables Verhalten vorgesehen. Es gibt dann auf dem Rechnungsbahnhof die Möglichkeit zur Freigabe, da die Informationen bereits abgelegt sind. Sobald die Preisauskunft und die Links zugesendet werden, sind die Informationen abgelegt und verfügbar.

• Versand von Stornierungen:  

• Nur zur Info: Stornierung von Trassenverträgen wird auch als Response an den Kunden von pathOS gesendet

• Request von pathOS an AC beinhaltet bei Stornierungen nur im 'neuen Trassenvertrag' den Path mit den nach Stornierung verbleibenden Verkehrstagen und nicht im 'alter Trassenvertrag'.

• Ebenso erfolgt ein Versenden bei Stornierung eines Zeitraumes innerhalb einer Trasse. Auch hier wird der resultierende Trassenvertrag auf dem Attribut 'neuer Trassenvertrag' gesendet

• Anregung von AC zur Erweiterung der API:  Flag in der API einführen um zu erkennen ob es sich um eine Stornierung handelt? Denn sonst müssten wir bei Requests mit nur neuem Vertrag jedes mal prüfen, ob es ein neuer Vertrag ist oder ob wir diesen bereits kennen und somit diesen Request in die Stornoabrechnung senden. Sicherlich würde das auch machbar sein, aber ein Hinweis auf Storno im Request wäre auf "Nummer sicher gehen". Antwort Christian M: Zumindest nicht kurzfristig. Aktuell sind wir ja gerade in der Umsetzung und ich möchte ein Moving Target durch neue Yamls jetzt eigentlich vermeiden. Man könnte so eine Anpassung aber nach der initialen Umsetzung machen. 

Notizen  

Anbindung der AU von AC an die KTU von pathOS             

• Anbindung noch nicht erfolgt, soll zeitnah von pathOS umgesetzt werden, um den Kunden eine reale Preisauskunft bereitzustellen.
• Auf IFP basierende Fehler werden bis auf weiteres nicht gefixt
• Auf pathOS basierende Fehler werden gefixt (V: AC, pathOS)
• Bereitstellung der Fehler Preisauskunft im Monat Januar 2025 aus dem Camunda Cockpit von pathOS (V: pathOS,   ) → das I.NVI IT Lifecycle Management Toold1143f0d-33c0-3f1c-b44b-7720150f306eO2CBS-578
• Anbindung echter Preisservice an KTU → Wann? Freigabe von Leistungsbeschreibungen für Preisauskünfte durch pathOS an AC
• AC erwartet eine REST-Request von pathOS, API noch in Klärung (V: AC, Martin, Patrick)
• pathOS implementiert Retry (Wie lange ist noch klären, wenn die Freigabe nicht an AC abgesetzt werden kann
• AC implementiert Puffer, wenn die Freigabe nicht an den Rechnungsbahnhof abgesetzt werden kann Mockup des Services bestellsystem-adapter, Operation POST /trassenvertraege
• Entwicklung des Mockup in AC im aktuellen Sprint abgeschlossen
• Leichte Änderung der API (Schreibfehler neuerTrassenvertrag, Enum VerkehrsartKundeZusatz ergänzt um Nachtverkehr) gesendet am 05.02.25 (V: AC, Thomas)
• Bereitstellung des Mockups auf der AU von AC-Trasse geplant am 27.02.25. Für Entwicklertest vorab auf der TU ab 6.2.25) (V: AC, Christian) Archivierung von Dokumenten pathOS
• pathOS hat den AC-Service bestellsystem-adapter für die Archivierung der Dokumente angebunden, Operation POST  /vertriebsbeleg-dokumentationen:
• gesendete Anfragen sind aktuell in der Datenbank "archiv" auf der AU gespeichert
• Zu klären:
• Sind die Dokumente in BCM und Filero abgelegt? (V: AC, Pia, Thomas)
• Warum wird kein BCM-Status in AC für diese Dokumente gesetzt? (V: AC, Pia)
• Welche Umgebung von pathOS ist diesbezüglich an welche Umgebung von AC angebunden? ( V: pathOS, Felix)