Release 2.99.0: API/Webhook-Erweiterungen

Der Schwerpunkt der letzten beiden Releases lag auf unserer Programmierschnittstelle (API). Zuletzt ging Version 2.99.0 am 21.03.2023 live.

Dauer der Reporterstellung

Berichte (Auswertungen, Buchhaltungs-Export etc.) werden von Fakturia im Hintergrund generiert und können anschließend heruntergeladen werden. Die Generierung kann dabei einige Zeit in Anspruch nehmen. Für bessere Rückschlüsse auf die Dauer eines bestimmten Vorgangs wird nun im Downloadbereich der Reports neben dem Startdatum auch das Enddatum der Erzeugung angezeigt:

Ende-Datum bei Reports

Wording im Anschriftenfeld

Bei der Bearbeitung der Adressdaten eines Kunden (Kundencenter, Bestellseite, Backoffice) wurde die Straße mit evtl. Zusatzangaben bisher mit den Labeln „Adresse 1 – 3“ bezeichnet. Da dies teilweise zu Irritationen geführt hat, haben wir die Felder umbenannt:

Neue Bezeichner bei Adressfeldern

SelfService-Portal: Verschiedene Voreinstellungen

Eine Besonderheit bei unserem Kundencenter ist die Möglichkeit der Einbindung per Single Sign-on (SSO). Der Kunde meldet sich hierbei indirekt über eine bereits bestehende Session einer 3rd-Party Applikation in unserem SelfService-Portal an. Für diesen Integrationsweg stehen ab sofort neue Konfigurationsmöglichkeiten per URL-Parameter zur Verfügung:

  • Voreinstellung der Sprache des Kunden im Portal
  • Ausblenden des Benutzermenüs rechts oben (Zur Unterbindung der Passwort-ändern Funktion sowie des Logouts)

Nähere Details zu den einzelnen Parametern finden Sie in unserer Doku.

Kopierfunktion für Artikel

Bei der initialen Befüllung von Fakturia mit Artikeln müssen häufig bestimmte Merkmale eines bereits bestehenden Artikels übernommen werden. Um den Anlageprozess zu erleichtern, lässt sich ein bestehender Artikel nun ganz einfach als Vorlage für einen neuen Artikel kopieren:

Artikel kopieren

API: Typ beim SubscriptionItem

Wird ein Aboartikel einem Vertrag hinzugefügt, so ist dies in der Regel ein fixer Bestandteil des Vertrages. Daneben kennt Fakturia aber auch Addons, also Aboartikel, welche der Kunde jederzeit beliebig hinzubuchen und wieder ausbuchen kann. Die Deklarierung als Addon ist in der GUI in der Vertragsmaske bereits jetzt möglich, für die API fehlte diese Option aber bisher. Diese Lücke haben wir nun geschlossen:

Aboartikel über die API als Addon kennzeichnen

API: Lieferadresse bei Bestellung

Unsere Bestellseiten erlauben es neuen Kunden bereits zusätzlich zur Rechnungsadresse auch eine abweichende Lieferadresse anzugeben. Diese Möglichkeit besteht nun auch bei der Anlage einer Bestellung per API:

Lieferadresse in der API (Bestellung)

API: Bestellung freischalten

Der Bestellprozess lässt sich in Fakturia je nach Belieben automatisieren. Eine Option ist dabei, dass eine neue Bestellung sofort in einen aktiven Vertrag überführt wird, ohne dass ein manueller Eingriff, also eine Freischaltung der Bestellung, erforderlich ist. Bei komplexeren Bestellprozessen ist diese Freischaltung u.U. an ganz bestimmte Konditionen gebunden und kann erst zu einem späteren Zeitpunkt erfolgen. Um nun eine wartende Bestellung auch per API freischalten zu können, haben wir neue Endpunkte eingeführt:

Kunde bzw. Vertrag aus einer Bestellung per API anlegen

Webhooks: Mehr Transparenz

Unsere Webhooks informieren beliebige Drittsysteme über wichtige Systemereignisse. Zur besseren Nachvollziehbarkeit der Events haben wir einige Erweiterungen durchgeführt.

Zum einen lässt sich die gesendete Hook-Message nun jederzeit auch im Backoffice anzeigen:

Anzeige der Hook-Message im Backoffice

Für eine bessere Zuordnung einer Hook-Message zu einer Webhook-Konfiguration, wird in der Hook-Message nun auch die UUID der Konfiguration mitgesendet:

Referenz auf die Webhook-Konfiguration in einer Hook-Nachricht

Release 2.97.0: Artikelabhängige Rabatte u. Provisionen

Das Deployment der aktuellen Fakturia Version erfolgte am 28.02.2023 und bringt folgende Erweiterungen:

Provisionsabrechnung auf Artikelebene

Mit seiner Provisionsfunktion ermöglicht Fakturia die automatische Ausschüttung von Lifetime-Provisionen z. B. an Vertriebspartner. Bei der Einrichtung einer Provisionsregel am Vertrag konnte man bisher entscheiden, ob eine Provision für Aboartikel und/oder Einmalleistungen ausgeschüttet werden soll. Aber nicht immer möchte man pauschal einen Vertriebspartner an den Umsätzen einer Kategorie beteiligen. Deshalb besteht nun die Möglichkeit, bei einer Provisionsregel eine explizite Artikelauswahl vorzunehmen. Der Vertragspartner erhält dann lediglich für selektierte Artikel eine Provision.

Artikel einer Provisionsregel zuweisen

Artikelabhängige Rabatte

Ein ganz ähnliches Problem wie bei den Provisionen bestand auch bei der Konfiguration von Rabatten für Verträge. Auch hier ließ sich die Rabattierung lediglich über die Artikelart (Abo / Einmalleitung) einschränken. Analog zur Provisionsabrechnung ist nun auch eine Zuweisung von Artikeln zu einer Rabattkonfiguration möglich. Nur für diese konkret definierten Artikel wird der Rabatt dann künftig angewendet.

Artikelabhängige Rabatte

Bitte beachten: In beiden Fällen (Provision und Rabatte) kann zwischen den beiden Varianten „Artikelabhängig“ und „Artikeltyp“ jederzeit gewechselt werden. Eine Kombination ist jedoch nicht möglich.

Rechnungsvorschau am Vertrag

Gerade für Fakturia Neueinsteiger stellt sich häufig die Frage, was passiert eigentlich gleich, wenn ich den Vertrag aktiviere? Welche Leistungen werden abgerechnet und welchen Betrag wird die nächste Rechnung haben? Dank der neuen Rechnungsvorschau am Vertrag gibt es ab jetzt keine Unsicherheiten mehr. Die Rechnungsvorschau lässt sich über das Aktionsmenü in der Vertragsbearbeitung auch für Verträge im Status „Entwurf“ aufrufen:

Abrechnungsvorschau aufrufen

Im anschließenden Dialog erfolgt ein Preview für die nächste Abrechnung:

Abrechnungsvorschau

Zur Info: Über die Datumsauswahl im Dialog können Sie auch einen Blick noch weiter in Zukunft werfen. Wird dort ein entsprechendes Datum eingestellt, simuliert Fakuria die Abrechnung bis zu diesem Termin.

Rabatt am Vertrag bearbeiten

Damit eine Rabattkonfiguration für einen Vertrag wirksam wird, muss diese einem konkreten Vertrag ggf. mit individuellen Prozentsätzen und Laufzeiten zugewiesen werden. Ist eine solche Zuweisung erfolgt, konnten die Daten bisher aber nicht mehr bearbeitet werden. Der Rabatt musste gelöscht und neu angelegt werden. Dieser Workaround entfällt ab sofort: Für Rabatte am Vertrag steht nun eine Bearbeitungsfunktion zur Verfügung:

Rabatt am Vertrag bearbeiten

API-Preisberechnung: Übergabe von Artikeln

Eine nützliche Funktion für Eigenimplementierer des Checkout-Prozesses ist die Preisberechnung für den Warenkorb. Hierbei wird für alle Artikel der zugrundeliegenden Vertragsvorlage auf Basis der Daten des Bestellers eine Preisberechnung zur Darstellung im Checkout-Prozess (Warenkorb) durchgeführt. Um diese Berechnung einzuschränken, lassen sich jetzt auch beim Aufruf der Funktion die gewünschten Artikel mit ihrer Menge übergeben. Es dürfen aber nur Artikel aufgeführt werden, welche in der Vertragsvorlage definiert sind.

Einschränkung der Preisberechnung auf bestimmte Artikel

Optimierung bei Rabatt-Positionen

Bei der Einrichtung von Rabatten besteht die Wahlmöglichkeit der Darstellung auf der Rechnung. Entweder kann der Rabatt direkt vom Betrag der Rechnungsposition abgezogen werden, oder direkt unterhalb der Rechnungsposition wird eine extra Rabattposition mit negativem Betrag eingefügt. Im zweiten Fall wurde bisher immer der gesamte Text der ursprünglichen Rechnungsposition kopiert, was bei vielen Rechnungspositionen zu unnötigem Platzverbrauch führte. Mit der neuen Fakturia Version wird nur noch der Artikelname mit Hinweis auf den Rabatt angedruckt.

Provisionsregeln am Vertrag bearbeiten

Eine weitere Funktionslücke wurde geschlossen: Für Provisionsregeln am Vertrag steht nun eine Bearbeitungsfunktion zur Verfügung.

Bearbeitung einer Provisionsregel am Vertrag

Mit Bäumen für Bewertungen etwas Gutes tun

Themen wie Nachhaltigkeit und Klimaschutz gewinnen stetig an Bedeutung. Auch uns als IT-Dienstleister aus dem schönen Oberbayern liegen der Schutz der Natur und die Erhaltung der biologischen Vielfalt am Herzen. Durch die Nutzung erneuerbarer Energien für die Stromversorgung von Rechenzentren oder die Optimierung von IT Prozessen lassen sich Ressourcen einsparen, die Energieeffizienz steigern und der ökologische Fußabdruck minimieren. Zusätzlich kann aber auch aktiv etwas Gutes getan werden.

Seit diesem Monat arbeiten wir daher mit dem Start-up expeero zusammen, um unsere Bemühungen im Bereich Nachhaltigkeit und Klimaschutz weiter auszubauen. Und zwar ganz konkret mit dem Pflanzen von Bäumen für erhaltene Bewertungen.

Für jede abgegebene Bewertung auf expeero.com, de.trustpilot.com, google.de, appvizer.de, omr.com oder capterra.com.de lassen wir Bäume pflanzen.

Hier ist unser Profil auf expeero finden:

Expeero arbeitet mit Eden Reforestation Projects, einer international bekannten Non-Profit-Organisation, zusammen, um Bäume zu pflanzen und Wälder wiederaufzuforsten. Im Rahmen der Initiative „Bäume für den Wandel“ wird eine Baumpflanzaktion im Kijabe Forest und in der Stadt Turasha in Kenia unterstützt. Die Wiederaufforstung findet in enger Zusammenarbeit mit der lokalen Gemeinschaft statt, um nicht nur die Umwelt, sondern auch die Region vor Ort wirtschaftlich zu fördern. Informationen über das Pflanzprojekt und den Fortschritt der Aktion sind auf der Website von expeero zu finden.

Durch die Abgabe einer Bewertung entsteht eine echte „Win-win-Situation“ für alle Beteiligten:

  • Ein „win“ für das Klima
  • Ein „win“ für die lokale Bevölkerung
  • Ein „win“ für unser Unternehmen

Wer jetzt Lust bekommen hat, sich für eine gute Sache einzusetzen und aktiv etwas für den Klimaschutz zu tun, der kann am besten gleich eine Bewertung für uns abgeben unter:
https://www.expeero.com/de/luminea-it-services-gmbh/forest

Release 2.96.0: Filtermöglichkeit beim Kontenabgleich

Mit einigen nützlichen neuen Features ging am 13.02.2023 die Fakturia Version 2.96.0 live:

Filtermöglichkeit beim Kontenabgleich (finAPI)

Der Umsatzabgleich mit dem Girokonto hilft bei der schnellen automatisierten Verarbeitung von Zahlungseingängen und Rücklastschriften. Bei der erstmaligen Einrichtung werden dabei von Ihrer Hausbank über unseren Partner finAPI alle Konten der Bank ausgelesen und künftig für den Zahlungsabgleich herangezogen. Allerdings ist es nicht immer gewünscht, dass die Umsätze jedes Kontos verarbeitet werden, weil dort z. B. firmenfremde Transaktionen auflaufen. Deshalb besteht ab jetzt die Möglichkeit, vor dem Zahlungsabgleich die gewünschten Konten auszuwählen:

Kontoauswahl beim Umsatzabgleich

Empfängerwahl bei Rechnungsstorno

Wurde eine fehlerhafte Rechnung ausgestellt, lässt sich für diese über unsere Stornofunktion eine Korrekturrechnung erstellen. Bisweilen wurden für den Rechnungsempfänger der Korrekturrechnung immer die aktuellen Stammdaten des Kunden (Adresse, Ort usw.) genutzt. Problematisch kann dies jedoch sein, wenn es zwischenzeitlich eine Umfirmierung gab und der Rechnungsempfänger von der ursprünglichen Rechnung gesetzt werden soll. Diese Wahlmöglichkeit steht nun im Rahmen des Stornoprozesses zur Verfügung:

Wahl des Rechnungsempfängers für die Korrekturrechnung

API: PSP Prozess bei Eigenintegration der Checkout-Seiten

Für eine optimale Time-to-Market halten wir für den Checkout-Prozess vorgefertigte Bestellseiten bereit, die sich an die eigene CI anpassen lassen. Bei komplexeren Bestellprozessen bietet es sich an, den Checkout-Prozess selbst zu implementieren und die erforderlichen Daten per Schnittstellenaufruf an Fakturia zu übertragen. Besonders knifflig kann in diesem Fall die Integration des Bezahlanbieters (PSP) sein. Um den Aufwand auf Kundenseite auf ein Minimum zu reduzieren, haben wir unsere API-Schnittstelle für die Bestellungen erweitert.

Nähere Details finden Sie in unserer überarbeiteten Dokumentation.

Darstellung Land im Adressfeld

Das Empfängerland des Kunden auf einer Rechnung oder anderen Dokumenten wurde bisher in der Sprache des Betreibers dargestellt. Hintergrund: Eine zuverlässige Verarbeitung beim Postversand soll so sichergestellt werden. Wir haben die Logik für die Sprachermittlung nun etwas verändert:

Für Kunden mit der Sprache Englisch oder Französisch wird das Land in deren Sprache übersetzt. Befindet sich der Kunde im Inland, wird das Land nun nicht mehr angedruckt.

Release 2.95.0: SEPA-Lastschrift ohne BIC

Am 31.01.2023 haben wir eine aktualisierte Version von Fakturia auf Sandbox, Produktionssystem und den Private-Cloud Umgebungen ausgerollt. Folgende Features sind enthalten:

SEPA-Lastschriften ohne BIC

Für die Einrichtung von Lastschriften über die Hausbank war es bisher zwingend erforderlich, beim Kunden IBAN und BIC anzugeben. Diese Verpflichtung zur Angabe der BIC ist im Februar 2016 für SEPA-Zahlungen entfallen, es genügt ausschließlich die IBAN. Wir haben unser System entsprechend angepasst, so dass die BIC nicht mehr als Pflichtfeld behandelt wird.

API: Ändern von Rabatten am Vertrag

Über die REST-API lassen sich einem Vertrag Rabatte mittels Schnittstellenaufruf zuweisen. Eine nachträgliche Bearbeitung dieser Zuweisung war jedoch nicht möglich. Wir haben hierfür nun einen neuen Endpoint eingeführt:

Rabatt am Vertrag per API bearbeiten

Kundencenter: Darstellung der Leistungsübersicht

Mit Hilfe der Leistungsübersicht im Kundencenter erhält ihr Kunde einen Überblick über alle bisher abgerechneten Leistungen bzw. Artikel. Eine Besonderheit hierbei ist, dass auch bereits erbrachte, aber noch nicht abgerechnete Leistungen dort aufgeführt werden. An dieser Maske haben wir eine kleine Änderung vorgenommen: Für noch nicht abgerechnete Leistungen wird zusätzlich zur Artikelnummer der Artikelname nicht mehr ausgegeben. Erst wenn die Leistung abgerechnet wird erscheint auch der Name des Artikels. Technischer Hintergrund: Um dem Kunden immer eine Übersetzung der Texte in seiner Sprache garantieren zu können, war diese kleine Einschränkung erforderlich.

Leistungsübersicht im SelfService-Portal

Filterung unbezahlte Rechnungen

In den Übersichtsseiten für Rechnungen, Korrekturrechnungen, Gutschriften und Gutschriftskorrekturen lassen sich über eine Filtereinstellung nur die Dokumente anzeigen, die noch unbezahlt bzw. noch nicht ausgeschüttet sind. In der Ergebnisliste wurden bisher auch Dokumente aufgeführt die bereits storniert wurden. Da diese für die Auswertung nicht relevant sind, werden stornierte Dokumente ab sofort nicht mehr angezeigt.

Filterung nach unbezahlten Rechnungen

Kundencenter: Eigener HTML-Header

Um unser SelfService-Portal optimal an ihre individuelle Corporate Identity anpassen zu können, stehen in Fakturia verschiedene Einstellungsmöglichkeiten wie z. B. Custom CSS-Styles zur Verfügung. Auch der Footer des Portals kann mit einem individuellen HTML-Fragment versehen werden. Ab sofort lässt sich auch ein individueller HTML-Header in der Dokumentenverwaltung unter „Weitere Templates“ hinterlegen:

HTML-Header für das Kundencenter bearbeiten

Erweiterungen beim Lastschrifteinzug

Die Umstellung eines Kunden von der Bezahlart Überweisung auf SEPA-Lastschrift (Hausbank) war bisher mit einer Einschränkung verbunden: Nur Rechnungen, die nach der Umstellung erzeugt wurden und somit mit der Bezahlart Lastschrift markiert waren, konnten per SEPA-Lastschrift eingezogen werden. Ältere, noch offene Rechnungen, die per Überweisung fällig waren, standen beim Generierungslauf für die Lastschriften nicht zur Verfügung. Diese Rechnungen können nun mit aufgenommen werden:

Generierung von SEPA-Lastschriften

Release 2.94.0: Update Adyen Schnittstelle

Kaum ist das neue Jahr angebrochen, sind auch schon die neuesten Fakturia Features am Start:

Aktualisierung der Adyen Schnittstelle

Beim Payment-Service-Provider Adyen gab es kürzlich einen Breaking-Change, der eine Anpassung unserer Schnittstellenanbindung erforderlich gemacht hat. Die meisten Änderungen sind in Fakturia „unter der Haube“ erfolgt und haben auf Sie als Anwender keine Auswirkung. Lediglich die PSP-Konfigurationsmaske hat sich geändert:

Adyen PSP Konfiguration

Was bei der Einrichtung zu beachten ist, ist in unserem Wiki beschrieben.

Neuausstellung einer Rechnung

Immer wieder treten im Fakturierungsalltag Situationen auf, in denen eine Rechnung neu ausgestellt werden muss. Hat sich beispielsweise die Adresse des Kunden geändert und die Mitteilung erfolgt verspätet, ist eine solche Neuausstellung auf die neue Anschrift erforderlich. Die Ausführung dieses Vorgangs war bisher sehr umständlich. Mit diesem Release erledigen Sie die Neuausstellung mit wenigen Klicks:

  • Alte Rechnung stornieren
  • Adresse des Kunden ändern
  • Bei stornierter Rechnung eine Neuausstellung auslösen
Stornierte Rechnung neu ausstellen und versenden

Hinweis-Texte bei komplexen Vorgängen

Ein Subscription-Management-System wie Fakturia ist zweifelsohne nicht ganz trivial. Bei zwei Anwendungsfällen haben wir festgestellt, dass diese relativ häufig zu Problemen in der Bedienung führen. In den entsprechenden Masken haben wir deshalb nun Erklärungstexte eingefügt.

Anwendungsfall 1: Außerordentliche Kündigung eines Vertrages

Anwendungsfall 2: Kleines Upgrade/Downgrade

Hier ist es wichtig zu wissen, dass ein Upgrade/Downgrade grundsätzlich nur auf normale Leistungs-Aboartikel anwendbar ist. Ein Upgrade für Aboartikel vom Typ empfangene Leistung (Für Gutschriften) ist nicht möglich.

Release 2.92.0: Massendownload von Rechnungen

Bei Fakturia ist wieder viel passiert in den letzten Wochen. Hier die Neuigkeiten im Einzelnen:

Sammel-Download von Rechnungen & Co

Von Fakturia erzeugte Dokumente wie Rechnungen, Gutschriften, Korrekturrechnungen usw. lassen sich in den entsprechenden Übersichtsmasken direkt per Download herunterladen. Solange man nur hin und wieder einzelne Dokumente zum Download benötigt, war diese Funktionalität ausreichend. Werden gleich mehrere Dokumente auf einmal benötigt, musste man sich bisher mühsam durch alle Rechnungen klicken. Die neue Sammeldownload-Funktion macht das Leben ab sofort leichter: Die gewünschten Rechnungen werden einfach links über die Mehrfachauswahl selektiert. Über das Action-Menü unten erfolgt dann der Download aller gewählten Rechnungen als ZIP-Archiv.

Sammel-Download von Rechnungen als ZIP-Archiv

Kontoabgleich: Verbuchung von Zahlungen mit Kundennummer

Beim Umsatzabgleich über unseren Partner finAPI werden Zahlungseingänge ihrer Kunden auf dem Girokonto automatisch verbucht, sowie erkannte Rücklastschriften verarbeitet. Für die Zuordnung einer Transaktion auf dem Kontoauszug war bisher die Rechnungsnummer im Verwendungszweck maßgebend. Nur wenn diese erkannt wurde, war eine Verbuchung der Transaktion möglich. Mit der aktuellen Erweiterung ist es nun auch möglich, einen Zahlungseingang zu verbuchen, wenn ausschließlich die Kundennummer des Kunden im Verwendungszweck vorkommt. Solche Umsätze werden beim Abgleich nun erkannt und mit einem entsprechenden Matchlevel markiert. Ausgewählte Buchungen werden bei der Verarbeitung dann dem Kundenkonto in Fakturia gutgeschrieben.

Sofern Sie wünschen, dass mit einer Verbuchung auch sofort offene Rechnungen getilgt werden sollen, muss folgende Option aktiviert werden:

Zahlungseingänge mit Kundennummer verbuchen

Limit für Sammellastschriften konfigurierbar

Für die Generierung von SEPA-Sammellastschriften zur Ausführung über die Hausbank haben wir kürzlich ein Limit von 500 Lastschriften pro Durchlauf eingeführt. Dieses Limit können Sie nun bei der Generierung auch auf einen niedrigeren Wert heruntersetzen:

Lastschrift-Limit setzen

API: Validierung von Gutscheincodes

Wer den Checkout-Prozess selbst implementieren möchte und nicht auf unsere Bestellseiten zurückgreift, findet in unserer API bereits entsprechende Endpunkte um eine Bestellung per API-Request einzureichen. Hat der Kunde aber einen Gutscheincode, muss dieser idealerweise bereits vor Absenden der Bestellung auf Gültigkeit geprüft werden. Hierfür steht ab sofort ein neuer Endpunkt zur Verfügung:

Gutscheincodes über API validieren

Hinweismeldung bei gestörtem Mailversand

Für die Zustellung von Mails an ihre Kunden besteht die Möglichkeit, einen eigenen SMTP-Server zu hinterlegen. Das wird von uns auch dringend empfohlen. Nun kann es aber gerade bei Änderungen am Mailserver vorkommen, dass plötzlich keine Mails mehr verschickt werden können. Auf diesen Umstand weist ab sofort eine deutliche Hinweismeldung auf dem Dashboard hin:

Hinweismeldung gestörter Mailversand

API: Bestellung inkl. SEPA-Mandat anlegen

Ähnlich wie bei der Gutscheincode-Validierung, richtet sich diese Erweiterung an Selbstimplementierer des Checkout-Prozesses. Bestellt der Kunde per SEPA-Lastschrift, so generiert Fakturia bei Abwicklung über die Hausbank das SEPA-Lastschriftmandat automatisch. Hierbei wird auch eine Mandatsnummer vergeben. Möchten Sie diese Mandatsnummer aber selbst vorgeben, war der Prozess hierfür etwas umständlich. Ab sofort ist es möglich, bei einer Bestellung per API das gewünschte SEPA-Lastschriftmandat direkt zu übergeben:

SEPA-Mandat per API der Bestellung übergeben

Release 2.88.0: Neuer Webhook

Zwei neue Releases wurden in den letzten Wochen ausgerollt, die folgende Funktionserweiterungen enthalten:

Fehlerbehandlung beim Mailversand

Der Versand von Mails in Fakturia erfolgt über eine Warteschlange (Queue), über welche der Versandstatus nachvollziehbar wird. Dieses Mailarchiv finden Sie unter Einstellungen -> Logs / Protokolle. Treten beim Mailversand Fehler auf, so ist hier die Spalte „Versand erfolgreich“ nicht gefüllt und es findet sich eine entsprechende Fehlermeldung in den Details zu diesem Mailjob.

Mailversand-Protokoll

Bisher konnte man so aber nicht unterscheiden, ob eine Mail nur noch nicht verschickt wurde, oder ob tatsächlich ein Fehler aufgetreten ist. Ab sofort signalisiert ein Warnungs-Symbol, ob bei einem Mailjob ein Fehler aufgetreten ist und die maximal erlaubte Anzahl an wiederholten Zustellungsversuchen überschritten ist.

Signalisierung von Fehlern im Mailversand und erneute Zustellung

Wie im Screenshot ersichtlich, kann für fehlgeschlagene Mails mit dem Button „Versand nochmal probieren“ eine erneute Zustellung manuell ausgelöst werden.

Änderungen in der Sortierung

An verschiedenen Stellen im System wurde die Standardsortierung bei der Ausgabe geändert. Dies betrifft insbesondere die Dokumentenübersichten (Rechnung, Korrekturrechnung, Gutschrift, Gutschriftskorrektur). In diesen Tabellen werden die Dokumente nun per Default immer nach dem Erstellungsdatum aufsteigend sortiert. Sie finden also ganz oben immer die zuletzt erstellte Rechnung.

Auch beim FiBu-Export ergibt sich nun eine chronologische Sortierung für die Buchungssätze, in diesem Fall nach Buchungsdatum absteigend.

Neuer Webhook: PSP Event zur Bestellung

Über die Webhooks informieren wir Ihre Drittsysteme über wichtige Systemereignisse in Fakturia. Neu ist jetzt ein Webhook, der den Bestellprozess und die damit verbundene Zahlungsabwicklung über einen Payment-Service-Provider (PSP) betrifft: Der neue Webhook-Event nennt sich „Bestellung: PSP Event„. Dieser wird ausgelöst, sobald Fakturia eine Rückmeldung vom Bezahlanbieter über den Status der Bestellung erhält. Nutzen Sie z. B. Stripe, dann tritt dieser Event auf, wenn die Zahlungsdaten vom Kunden (Kreditkarte, Bankverbindung) erfolgreich entgegengenommen wurden.

Neuer Webhook-Event

Die entsprechenden Informationen sind im Payload unterhalb des Attributes „paymentRequest“ zu finden:

Erweitertes Datenmodell der Bestellung

Neue Felder im Aboartikel-Export

Beim Export für die Aboartikel werden nun zusätzlich zwei neue Spalten ausgegeben:

  • Notizfeld des Kunden
  • Notizfeld des Vertrages

Limitierung bei SEPA-Sammellastschriften

Die Generierung von SEPA-Sammellastschriften ist jetzt auf 500 Lastschriften pro Durchlauf begrenzt. Sollte es bei einem Abruf mehr als 500 offene Rechnungen geben, erhalten Sie einen deutlichen Hinweis. Bitte führen Sie dann die Erzeugung der Lastschriften im Anschluss gleich erneut aus.

Release 2.86.0: Fallweise Deaktivierung E-Mail-Versand

Mit dem aktuellen Fakturia Release 2.86.0 vom 22.09.2022 haben wir folgende Features ausgeliefert:

Fallweise Deaktivierung E-Mail-Versand

Fakturia verschickt für die verschiedensten Use-Cases E-Mails an Ihre Kunden. So z. B. auch, wenn die Zugangsdaten für den Login in das SelfService-Portal erzeugt wurden. Nicht in jedem Fall kann jedoch eine Zustellung unserer E-Mails erwünscht sein. Wird das SelfService-Portal beispielsweise direkt per SSO in den eigenen Mitgliederbereich integriert, macht der Versand der Zugangsdaten keinen Sinn, da der Kunde diese niemals benötigt.

Für genau solche Fälle haben Sie nun die Möglichkeit, bestimmte E-Mail-Templates komplett zu deaktivieren. Gehen Sie dazu in die Dokumentenverwaltung und öffnen Sie das entsprechende E-Mail-Template:

E-Mail Versand pro Template deaktivieren

Standardmäßig ist der Haken bei „Aktiviert“ gesetzt. Wenn Sie den Haken entfernen, wird für den aktuellen Use-Case keinerlei E-Mail mehr an Ihre Kunden versendet.

Textverwaltung: Änderungen zurücksetzen

Bei dieser Funktionserweiterung geht es ebenfalls um die Textverwaltung. Alle von Fakturia in der Grundeinstellung ausgelieferten Texte können von Ihnen beliebig erweitert und angepasst werden. Bisher gibt es jedoch keine Möglichkeit, um die eigenen Änderungen zu verwerfen und die Grundeinstellung wieder herzustellen. Diese Option steht mit dem aktuellen Release zur Verfügung:

Eigene Textänderungen verwerfen

ZUGFeRD: Dokumententyp Gutschrift

Das ZUGFeRD-Format steht in Fakturia schon längere Zeit für die Dokumententypen Rechnung und Rechnungskorrektur zur Verfügung. Mit diesem Update besteht nun auch die Möglichkeit, ZUGFeRD (beinhaltet auch XRechnung) für die Dokumentenarten Gutschrift und Gutschriftskorrektur zu nutzen.

Release 2.85.0: Deaktivierungsmöglichkeit Rechnungsversand

Mit dem Release 2.85.0 vom 29.08.2022 wurden neben einigen Bugfixes und Performance-Optimierungen folgende neuen Features live gesetzt:

Automatischer Rechnungsversand deaktivierbar

Fakturia ist für seinen hohen Automatisierungsgrad bekannt. Anstehende Aktionen wie z. B. der fällige Versand einer Rechnung müssen nicht extra bestätigt werden sondern werden vom System eigenständig ausgeführt. Allerdings kann es Situationen geben, in denen man vorübergehend in diese Automatisierung eingreifen möchte. Diese Möglichkeit besteht ab sofort mit zwei neuen Schaltern auf dem Dashboard:

Kontrollierter Rechnungsversand

Bei deaktiviertem Schalter wird Fakturia vorerst keine Rechnungen bzw. Gutschriften an Ihre Kunden per E-Mail versenden bzw. die Dokumente erstellen. Sie haben so die Möglichkeit, bestimmte Anpassungen am System vorzunehmen, ohne dass der Rechnungsversand „dazwischenfunkt“.

Diese Einstellungen lassen sich übrigens auch in der Maske für die Systemeinstellungen vornehmen:

Anpassungen in den Systemeinstellungen

Hinweis: Die Checkbox zur Steuerung des Mahnlaufs wurde vom Tab „Rechnung und Finanzen“ in den neuen Tabreiter „Automatisierung“ umgesiedelt.

API: Neues Feld beim Abruf von Rechnungen

Bei der Abfrage von Rechnungen über die REST-API wurde im normalen Abfragemodus bisher die Vertragsnummer nicht mitgeliefert. Dies war nur über eine Zusatzoption möglich, welche jedoch mit Performanceeinbußen verbunden war. Wir haben einige Optimierungen am Datenmodell vorgenommen, damit die Vertragsnummer nun auch beim normalen Abruf im Abfrageergebnis enthalten ist:

Vertragsnummer in der API (Rechnungen)

Erweiterung Rechnungsübersicht

Im Zuge der Performanceoptimierungen ergeben sich auch neue Filterungsmöglichkeiten in den Übersichtsseiten für Rechnungen, Rechnungskorrekturen, Gutschriften und Gutschriftskorrekturen. Hier konnte bisher nicht nach der Vertragsnummer gefiltert werden. Diese Möglichkeit besteht nun:

Vertragsnummer in der Rechnungsübersicht

Änderungen bei der Artikel-Bearbeitung

Fakturia ist sowohl multiwährungsfähig als auch mehrsprachig und unterstützt die Übersetzung von Texten in beliebig viele Sprachen. An einigen Stellen wie z. B. bei der Artikelbezeichnung erfolgt diese Übersetzung indirekt über unsere Textfragmente. Nutzt man diesen Übersetzungsweg war es bisher etwas schwierig, die Artikel bei der Artikelauswahl in Zuweisungsdialogen auseinanderzuhalten. Damit diese Identifikation möglich ist, haben wir in der Maske zur Artikelbearbeitung ein neues Feld eingeführt:

Interne Artikelbezeichnung

Das Feld für die interne Artikelbezeichnung enthält nach dem Update den Text aus dem Feld „Artikelbezeichnung“. Dieses neue Feld ist nur zur internen Identifikation gedacht und wird dem Kunden nicht angezeigt. Sie können hier also einen beliebigen Bezeichner eintragen mit dem Sie etwas anfangen können, während im Feld für den Kunden weiterhin Textfragmente zur Übersetzung zum Einsatz kommen.

Werden Artikel in Zuweisungsdialogen ausgewählt, wird in der Spalte Artikelbezeichnung ab sofort immer der interne Bezeichner dargestellt.