Zum Hauptinhalt springen

23.0.5 - eInvoice Hotfix

Problem, welches mit diesem Hotfix gelöst wird​

Mit diesem Hotfix wird das XML-Handling für eInvoices in das System integriert. Dadurch wird die Verarbeitung von XML-basierten Rechnungen optimiert. Zusätzlich können die Archivierungsfunktionen des Maildaemon in Version 24 nun optional aktiviert werden, was erweiterte Optionen zur Organisation und Sicherung von E-Mails ermöglicht.

Darüber hinaus wurde ein Fehler bei der Zuordnung von Mail-IDs behoben, der bei der Nutzung von Capture aufgetreten ist.

Manuell auszuführende Schritte​

Voraussetzungen​

  • OUSP Postman muss in der Version 23.0.5 installiert sein.
  • Info: Ein Update einer v23.0.X auf v23.0.5 ist unkompliziert über den Import der ousp-postman-update.xml aus dem v23.0.5 - Installationspaket möglich.
  • Library Version 22.0.1 wird vorausgesetzt.

Patch-Anleitung​

Installation und Durchführung des Patches​

  1. XML-Backup der Portalscripte anfertigen.

  2. JSLogLevel auf DEBUG stellen und übernehmen (via Toolbox).

  3. ouspPostman_de-ServerLocale (DocumentsManager → Monitoring → Globale Eigenschaften) muss angepasst werden:

    • Ändern:
    filetype.ouspPostman_Mailbox.htArchivierung=Archivierung der Postman-Mappen
    • Hinzufügen am Ende des ouspPostman_Mailbox-Blocks:
    filetype.ouspPostman_Mailbox.htTestmode=Testmodus
    filetype.ouspPostman_Mailbox.withTestmode=Testmodus aktivieren
    filetype.ouspPostman_Mailbox.testmodeProcessingLimit=Anzahl E-Mails im Testmodus
    filetype.ouspPostman_Mailbox.htMailArchiving=E-Mail-Archivierung auf dem Mailserver
    filetype.ouspPostman_Mailbox.withMailArchiving=E-Mails archivieren?
    filetype.ouspPostman_Mailbox.archiveFolderName=Name des Archivordners auf dem Mailserver

  4. Bestehende Portalscripte überschreiben: i. Inhalte im Zip → ou.sp.Postman.patchEInvoice.zip: ZIP-Datei

    • ou.sp.Postman.lib.
    • ou.sp.Postman.workflow.sendsignal.workflowstart.

  5. Neues Portalscript anlegen:

    • Datei: ou.sp.Postman.patchEInvoice.

Modifizierbare Einstellungen im Patch​

  1. MODIFY_EXISTING_FILES:

    • Typ: boolean, Standard: true.
    • Bei Aktivierung werden die Änderungen auf existierende Mappen angewendet.

  2. ADD_XML_FOR_MAILBOX_WHERE_PDF_ENABLED:

    • Typ: boolean, Standard: true.
    • Fügt .XML als erlaubten Dateityp hinzu, wenn .PDF aktiviert ist (nur wirksam, wenn MODIFY_EXISTING_FILES auf true gesetzt ist).

  3. ENABLE_MAILDAEMON_24_ARCHIVING:

    • Typ: boolean, Standard: false.
    • Aktiviert die neuen Felder für Archivierungsfunktionen und Testmodus.
    • Achtung: Diese Einstellung benötigt Maildaemon v24.
    • Hinweis: Soll als Vorbereitung für ein Update auf MAD v24 dienen. Die neuen Einstellungen dürfen erst nach dem MAD v24-Update gesetzt werden.

Ausführung des Scripts​

  • Das Script ou.sp.Postman.patchEInvoice muss im DocumentsManager ausgeführt werden.
  • Warnung: Bei länger laufenden Scripten in VSCode kann es zu Verbindungsabbrüchen kommen und der Output verloren gehen.
  • Hinweis: Falls am Ende die Fehlermeldung "Version konnte nicht gesetzt werden" erscheint, fehlen dem Benutzer die Berechtigungen. Das Script in diesem Fall mit oucadmin ausführen.

Nachbereitung​

  1. Ausgabe und Logs prüfen:

    • Nach der Ausführung von ou.sp.Postman.patchEInvoice die Script-Ausgabe und das Server-Log auf Fehler überprüfen.

  2. Prüfen der Mailboxen: i. Wenn MODIFY_EXISTING_FILES und ADD_XML_FOR_MAILBOX_WHERE_PDF_ENABLED aktiviert waren:

    • Sicherstellen, dass in den Postfächern (ouspPostman_Mailbox) für eInvoices PDF und XML hinterlegt sind.
    • Achtung: Existierende ouspPostman_Mailbox-Mappen bearbeiten und speichern, da die XML nicht automatisch in der JSON gespeichert wird.

  3. Einstellung "Anlagen vereinzeln": i. Wenn erwartet wird, dass Lieferanten sowohl XML als auch PDF (z. B. Sicht-PDF für das XML) mitsenden:

    • In der verknüpften Extraktionsregel die Einstellung "Anlagen vereinzeln" auf "Nein" setzen.
    Andernfalls können Dubletten im System landen.

  4. Entfernen alter Felder:

    • Den Mappentyp ouspPostman_Extract im DocumentsManager als editiert markieren und übernehmen.
    • "Mappen ändern" ausführen, damit das veraltete Feld hasEInvoiceDocument verschwindet.

  5. Manuelle Anpassungen (falls notwendig): i. Wenn MODIFY_EXISTING_FILES deaktiviert war:

    • Entfernen Sie das veraltete Feld hasEInvoiceDocument aus allen Extraktionsregel-Mappen.
    • Fügen Sie XML als erlaubten Dateityp in den gewünschten Mailbox-Mappen hinzu.

  6. Rücksetzen des Portalscripts:

    • Das Portalscript ou.sp.Postman.patchEInvoice kann entfernt werden.
    • Das System mit dem Asset-Tag "OUSP Postman 23.0.5-eInvoice" versehen.

  7. Log-Level zurücksetzen:

    • Ggf. JSLogLevel wieder erhöhen.