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:
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.
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.
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:
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:
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:
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:
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:
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.
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.
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.
Die entsprechenden Informationen sind im Payload unterhalb des Attributes „paymentRequest“ zu finden:
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.
