Archiv für die Kategorie: News

Neue Features und kleinere Bugfixes bringt das aktuelle Fakturia Release vom 16.10.2023:

Provisionsabrechnung: Gutschrift bei Zahlungseingang

Mittels unserer Funktion zur Provisionsausschüttung lassen sich ganz einfach Lifetime-Provisionen z. B. an Vertriebspartner abrechnen. Die Wertstellung der Provision erfolgte dabei bisher immer zum Zeitpunkt der Rechnungserstellung (Rechnung an den vermittelten Kunden). Dieser Prozess mag für den Vertriebspartner attraktiv sein, bedeutet jedoch ein Problem für den Betreiber des Partnerprogramms, sofern die Rechnung an den Kunden länger unbezahlt bleibt. Aus diesem Grund besteht nun bei der Verwaltung der Provisionen am Vertrag die Möglichkeit, den Zeitpunkt der Wertstellung vorzugeben:

• Provisionsausschüttung bei Erstellung der Rechnung
• Provisionsausschüttung bei Bezahlung der Rechnung

API: Kunde mit beliebigem KndNr-Prefix anlegen

Fakturia führt interne Zähler der Nummernkreise für alle Hauptobjekte wie z. B. Kunden, Rechnungen, Bestellungen usw. Pro Objekt lässt sich dabei in der Nummernkreisverwaltung jeweils ein Prefix einstellen, welches direkt vor die Nummer gesetzt wird. Ein Prefix kann im Laufe der Zeit auch geändert werden.

Bei der Anlage von neuen Kunden über die API durfte bisher bei Vorgabe einer festen Kundennummer inkl. Prefix (z. B. K5050) immer nur das Prefix genutzt werden, welches auch in der Nummernkreisverwaltung gerade vorgegeben wurde. Diese Einschränkung wurde nun aufgelockert: Erlaubt sind ab sofort Kundennummern mit beliebigem Prefix. Voraussetzung ist jedoch, dass in Fakturia noch kein Kunde mit genau dieser Kundenummer existiert.

Webhooks: Historie bei Änderungen am Kunden

Unsere Webhooks ermöglichen die Benachrichtigung von Drittsystem beim Auftreten bestimmter Ereignisse, z. B. Kunde angelegt, Vertrag geändert etc. Beim Event „Kunde geändert“ wird dabei derzeit immer der bereits abgeänderte Kundenstammsatz im Payload des Webhooks versendet. Somit ist es auf Empfängerseite schwierig festzustellen, welche Attribute des Kunden nun konkret geändert wurden. Um dies zu erleichtern senden wir im Payload nun auch immer den Zustand des Kunden vor der Änderung mit. Neben dem „customer“ ist deshalb ab jetzt auch der „oldCustomer“ im Webhook-Event zu finden.

API: Weitere Suchoption bei Verträgen

Die Fakturia-API bietet ein Endpunkt zum Abrufen von Verträgen im System. Um die Ergebnismenge einzuschränken lässt sich nun neben der Kundenummer auch der interne Bezeichner des Vertrages als Suchkriterium heranziehen:

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.