Release 2.103.0: Rücknahme Kündigung
Mit dem aktuellen Release 2.103.0 vom 17.05.2023 wurden folgende neuen Features live gesetzt:
Kündigung zurücknehmen
Wird in Fakturia eine Kündigung durchgeführt, wechselt der Vertrag zunächst in den Status „gekündigt“ und bei erreichen des finalen Endedatums in den Status „beendet“. Bisher war eine Kündigung im System unumkehrbar, d.h. hat sich ein Kunde doch noch für eine Fortführung des Vertrages entschieden, musste ein neuer Vertrag erstellt werden. Ab sofort ist es möglich, eine Kündigung wieder zurückzunehmen – und zwar solange, solange sich der Vertrag noch im Status „gekündigt“ befindet.
Unbedingt beachtet werden muss hierbei aber, dass evtl. bei der Kündigung erzeugte Rechnungskorrekturen nicht wieder rückabgewickelt werden. Für eine entsprechende Korrektur müssen Sie selbst sorgen.
Preisanzeige in der Bestellbestätigungs-Mail
Für mehr Transparenz gegenüber den Endkunden haben wir die Bestätigungsmail, welche nach einer Bestellung mittels Signup-Pages versendet wird, um die Anzeige der Preise erweitert. Bisher wurden hier nur die gebuchten Artikel aufgeführt. Achtung: Wenn Sie die Textvorlage für die Bestätigungsmail verändert haben, müssen Sie hier ggf. den Text zurücksetzen, damit die Preisanzeige wirksam wird.
Bearbeitbarkeit Dokumente am Vertrag
An den Verträgen besteht die Möglichkeit, beliebige Dokumente (PDF etc.) anzuhängen. Während dem Upload lassen sich hier auch einige Einstellungen pro Dokument (z. B. Soll es per Mail versendet werden) vornehmen. Leider konnte man diese Einstellungen im nachhinein nicht mehr ändern. Diese Bearbeitbarkeit ist mit dem neuen Release nun gegeben.
API: Neue Filtermöglichkeit bei Preisberechnung
Der API-Endpunkt https://api.sandbox.fakturia.de/documentation/#/Contracts/contractPrices hilft bei der Preisberechnung für Ihre externen Systeme. Hier wurden in der Vergangenheit auch Aboartikel aufgeführt, welche längst ausgebucht (Upgrade/Downgrade) bzw. ausgelaufen sind. Um nur noch Preise (und Summen) für aktive Artikel zu erhalten, kann nun über den Status eines Aboartikels gefiltert werden:
Erweiterung Vertragsübersicht am Kunden
Im Tab „Verträge“ eines Kunden werden alle Kundenverträge aufgeführt. Bei sehr vielen (Abo-) Verträgen ist häufig nicht klar, um welches gebuchte Produkt es hier geht. Als Hilfestellung zeigen wir nun in der Vertragsübersicht zumindest die ersten beiden Aboartikel als Preview an.
Anpassungen an den PDF-Layouts
Bei sechsstelligen Rechnungssummen kam es bisher in unseren Dokumentenvorlagen (Rechnung, Korrekturrechnung etc.) zu etwas unschönen Umbrüchen zwischen dem Betrag und dem Währungssymbol. Wir haben daher das Layout etwas optimiert und die Schriftgrößen minimal reduziert.
Release 2.101.0: Absicherung Webhooks
Zwei neue Versionen von Fakturia wurden in den letzten Wochen ausgeliefert. Folgende Features und Erweiterungen sind enthalten:
Absicherung der Webhooks
Mittels unserer Webhooks lassen sich Drittsysteme automatisiert über Ereignisse in Fakturia informieren. Technisch wird dabei ein Http-Request aus unserem Rechenzentrum gegen einen Ihrer Server durchgeführt. Theoretisch könnte aber auch jeder andere Server im Internet einen solchen Event vortäuschen, wenn er Detailkenntnisse über unsere Schnittstelle besitzt. Aus diesem Grund besteht ab sofort die Möglichkeit, die Authentizität eines Webhook-Requests zuverlässig zu validieren.
Hierfür steht ein neuer Endpunkt in unserer API zur Verfügung:
Für eine Validierung führen Sie folgende Schritte durch:
- Vom empfangenen Webhook die UUID auslesen (alle anderen Daten ignorieren)
- Mit der UUID den oben genannten API-Endpunkt abrufen
- Das empfangene Ergebnis verarbeiten
Über diesen Ansatz ist sichergestellt, dass der unmodifizierte Webhook bei Ihnen ankommt.
Filterung Aboartikel
Unter dem Tabreiter „Abo verwalten“ in der Vertragsverwaltung befinden sich sämtliche gebuchten Aboartikel eines Vertrages. In der Tabelle werden aber auch Artikel dargestellt, die z.B. durch ein Upgrade/Downgrade längst inaktiv geworden sind. Um die Übersicht nicht zu verlieren, lassen sich die Aboartikel nun nach folgenden Kriterien filtern:
- Status des Aboartikels
- Artikelnr.
- Bezeichnung des Artikels
- Zusatztext des Aboartikels
API: Erweiterte Preiskalkulation
Der Prices-Endpunkt liefert die aktuell gültigen Preise aller Aboartikel eines Vertrages. Um für Preisberechnungen auch den Preis zu einem beliebigen Zeitpunkt in der Zukunft oder Vergangenheit abrufen zu können, besteht nun die Möglichkeit, das Datum für den Berechnungszeitpunkt zu übergeben:
Ergänzung beim Test-Webhook
Der Test-Webhook dient der technischen Überprüfung der Anbindung an Ihre Systeme. Das Format entspricht dabei exakt dem Schema eines echten Webhooks. Mit dem aktuellen Release wurde eine kleine Ergänzung bei den Testdaten vorgenommen: Ab sofort wird auch die UUID des Attributs „webhookConfig“ befüllt.
API: Zuweisung Provisionsregel zum Vertrag
Die Zuweisung eines Provisionsempfängers zu einem Vertrag war bisher nur über die GUI möglich. Dieser Schritt lässt sich jetzt auch über die API durchführen:
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:
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:
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:
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:
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:
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:
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:
Für eine bessere Zuordnung einer Hook-Message zu einer Webhook-Konfiguration, wird in der Hook-Message nun auch die UUID der Konfiguration mitgesendet:
