In den nächsten Wochen wird kivitendo in der Version 3.3 veröffentlicht. Der Fokus der Veröffentlichung liegt auf dem Kontoauszugs-Import, der hier im Wiki sehr gut beschrieben ist: http://redmine.kivitendo-premium.de/projects/forum/wiki/Bankerweiterung

Inspiriert ist diese Erweiterung aus einem Kundenprojekt, welches dort 2013 initiiert wurde. Sie hat folgende Eckpunkte:

• Kontoauszüge importieren (für MT940 wird aqbanking-cli benötigt)
• anhand der Kontoauszüge Zahlungen verbuchen
• die FiBu-Buchungen auf die Bankkonten mit den importieren Auszügen abgleichen

Aktuell haben wir die Volksbank und die Sparkasse hiermit getestet.

Wer es vorab ausprobieren möchte, bitte exakt die Anweisung befolgen. Der Import erfolgt in 2 Schritten:

1. Konvertierung MT940 → CSV (per Linux-Programm aqbanking)
2. Import CSV → kivitendo (deswegen hier das Importprofil entsprechend auf aqbanking abstimmen (Amerikanisches Zahlenformat etc).

Hier die wichtigste Info auf den Punkt (steht aber auch genauso im Wiki):

1. Das Bankkonto (IBAN / BIC) muss ohne Leerzeichen erfasst sein.
2. Das Profil MT940 ist Case sensitiv (alles groß schreiben)
3. Import-Profil genau wie in der Doku erfassen
4. Debugging-Abschnitt beachten

Details der weiteren Features gibt es wie immer im Changelog und an dieser Stelle auch nochmal der Status von heute:

Bankerweiterung und Skontobehandlung

Bei der Bankerweiterung kann man

• Kontoauszüge importieren (für MT940 wird aqbanking-cli benötigt)
• anhand der Kontoauszüge Zahlungen verbuchen
• die FiBu-Buchungen auf die Bankkonten mit den importieren Auszügen
• abgleichen

__Es wurde ein neues Recht “Bankbewegungen” eingeführt.

Beim Verbuchen der Zahlungen werden Rechnungsvorschläge gemacht, die anhand
eines internen Punktesystems bewertet werden.

Es wurde eine Skontobehandlung bei der Zahlung der Rechnungen implementiert,
und zwar nach der Bruttomethode. D.h. es wird der skontierte Betrag auf
erhaltene oder gewährte Skonti gebucht. Allerdings gibt es hier keine
Steuerautomatik, d.h. man muss am Monatsende die Salden noch manuell umbuchen.

Die zu buchenden Skontokonten müssen unter System → Steuern konfiguriert
werden.

Die Skontobehandlung wurde beim Verbuchen der Skontobelege und beim
SEPA-Einzug bzw. der SEPA-Überweisung implementiert.
Beim Bezahlen von Rechnungen kann man auswählen ob man die Zahlung

• ohne Skonto
• mit Skonto laut Zahlungsbedingungen
• die Differenz als Skonto

buchen möchte. Es wird je nach Zahlungsbetrag und Zahlungsdatum ein sinnvoller
Vorschlag gemacht.

Kleinere neue Features und Detailverbesserungen:

• Briefe werden auch im WebDAV archiviert. Ferner bessere Fehlerbehandlung und
  E-Mail-Funktion aktiviert.

• Mehrfachauswahl und Mengeneingabe für Artikel:
  Wenn in den Belegmasken die Artikeleingabe nicht eindeutig ist, erscheint
  eine Maske zur Artikelauswahl. Hierzu kann jetzt in den Benutzereinstellungen
  eingestellt werden, dass in dieser Maske mehrere Artikel mit Mengen ausgewählt
  werden können.

• Stammdaten → Berichte → Waren: Nach Shopartikel filtern und anzeigen können.

• Auftrags-/Angebotsbericht: Erfassungszeit als letzte Sortierung verwenden,
  damit die Einträge nach Eingabezeitpunkt sortiert sind, wenn es
  gleichrangige Einträge in der aktuellen Sortierung gibt.

• Bei Eingabe nicht eindeutiger Artikel in den Belegmasken bleibt jetzt auch die
  Mengeneingabe über die Auswahlmaske hinweg bestehen. Damit kann man die Menge
  auch schon vorher eingeben: Nicht eindeutiger Artikel, TAB, TAB, Menge, ENTER

• In den Berichten zu Aufträgen, VK-Lieferscheinen, Warenstammdaten, Kunden-/
  Lieferntenstammdaten kann das Erfassungsdatum angezeigt und danach gefiltert
  werden.

• Filtern/Anzeigen von benutzerdefinierten Variablen bei Kunden-/Lieferanten in
  den Berichten Angebot/Aufträge und Verkaufsrechnungen

• Filtern nach Kunden-/Lieferantentyp bei Lieferschein-Berichten.

• Preisgruppe bei Stammdaten → Berichte → Kunden anzeigen lassen können.

Bugfixes:

• Bugfix #54 Fehlermeldung im Mahnlauf bei automatischer Rechnung über Mahngebühren
• Bugfix #50 Kundentyp-Rabatt wird falsch übernommen

So schick die Datenbankabfragen per Rose sind, will man doch ab und an schauen, was da im Hintergrund auf Datenbankebene passiert, also welche SQL-Queries eigentlich generiert werden.

Während man beim alten Code in der kivitendo.conf unter [debug] per
global_level = QUERY
noch alle SQL-Abfragen in der Logdatei protokollieren konnte, muß man bei Rose nun
dbix_log4perl = 1
einstellen, um die von Rose generierten Queries zu sehen. Das produziert dort auch immer unheimlich viel Ouput.

In der Console kann man bei Manager-Methoden einen debug-Parameter übergeben, wo das generierte SQL ebenfalls angezeigt wird:
my $invoices = SL::DB::Manager::Invoice->get_all( where => [ id => 962 ], debug => 1);
SELECT
t1.amount,
t1.cp_id,
t1.currency_id,
< ... snip ... >
t1.type
FROM
ar t1
WHERE
t1.id = ? (962)


Man kann aber auch das Logging explizit für alle Anfragen in der console Session (oder sogar beim Entwickeln von Test-Skripts) anstellen:

$Rose::DB::Object::Manager::Debug = 1;
$Rose::DB::Object::Debug = 1;

Ab dann sieht man direkt in der console, welche SQL-Abfragen im Hintergrund passieren, z.B. bei der Benutzung eines Filters:
SL::DB::Manager::Invoice->get_all(where => [ SL::DB::Manager::Invoice->type_filter('invoice') ]);

SELECT
t1.amount,
t1.cp_id,
t1.currency_id,
< … snip … >
t1.type
FROM
ar t1
WHERE
(
(
t1.storno = ? OR
t1.storno IS NULL
) AND
t1.amount >= ? AND
t1.invoice = ?
) (0, 0, 1)

Ein paar Beispiele zum selber Ausprobieren:

Schnell schauen, welche Abfragen mit with_objects oder require_objects generiert werden:

Alle Artikel, mit LEFT OUTER JOIN auf die Tabelle partsgroup
my $parts = SL::DB::Manager::Part->get_all( with_objects => [ 'partsgroup' ] );

Nur die Waren, die eine Warengruppe haben:
my $parts = SL::DB::Manager::Part->get_all( require_objects => [ 'partsgroup' ] );

Oder der Unterschied in der Abfrage, ob man einen Artikel per
my $part = SL::DB::Part->new( id => 962 )->load;
oder per
my $part = SL::DB::Manager::Part->find_by( id => 962 );
ausliest.