Archiv für die Kategorie: News

Die aktuellste Fakturia Version vom 05.06.2023 bringt folgende Features und Erweiterungen:

Vertragsdokumente in der API

In der Vertragsverwaltung besteht die Möglichkeit, einem Vertrag Dokumente zuzuweisen, z. B. einen Leistungsnachweis, Einzelverbindungsnachweise etc. Diese Dokumente waren bisher nur über die GUI verfügbar. Ab sofort stehen folgende Use-Cases auch über die API bereit:

• Dokumente abrufen
• Dokument herunterladen
• Neues Dokument hochladen

Löschen von Verträgen

Solange noch keine revisionssicheren Dokumente (Rechnungen, Korrekturrechnungen etc.) in Fakturia erstellt wurden, konnten bisher nicht mehr benötigte Kunden aus dem System gelöscht werden. Diese Löschmöglichkeit besteht nun auch für Verträge, solange diese sich im Status Entwurf oder Storniert befinden. Sollten bereits noch nicht abgerechnete Leistungen für einen Vertrag erfasst worden sein, müssen diese zuvor manuell in der Leistungsübersicht entfernt werden.

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:

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.

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.

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:

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

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:

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.

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.

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:

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:

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.

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:

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

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.