Forderungssachen importieren - kVASy: Unterschied zwischen den Versionen

Aktuelle Version vom 7. Mai 2018, 16:54 Uhr

Hauptseite > Mahnverfahren > Forderungssachen importieren > Forderungssachen importieren - kVASy

RA MICRO ZV Datenimportmodul Schnittstellenbeschreibung kVASy® Standard

Mit dieser Schnittstelle können Daten der kVASy® Standard Inkasso Schnittstelle der Firma SIV AG eingelesen werden. Es sollen Forderungen aus Abrechnungen über Strom, Gas, Wasser (monatliche Abschlagzahlungen, Jahresrechnungen) beigetrieben werden.
Mit der Schnittstelle werden Akten, Adressen und Forderungskonten angelegt.

Allgemeine Voraussetzungen

Innerhalb einer Datei werden mehrere Vorgänge übergeben. Es werden immer neue Akten angelegt. Die Aktennummer wird automatisch vergeben.
Pro Vorgang wird immer nur ein Gegner mitgeteilt. Bei mehreren Forderungen wird der Gegner je Zeile / Forderung wiederholt. Die Kundennummer bleibt hierbei identisch. Mit wechselnder Kundennummer wird ein neuer Vorgang mitgeteilt. Es werden nur natürliche Personen als Gegner mitgeteilt.
In der Datei wird kein Auftraggeber mitgeteilt. Die Adressnummer des Auftraggebers ist einmalig in den Einstellungen des Importmoduls einzutragen.
Der 1. Teil der Aktenkurzbezeichnung entspricht dem Namen des Mandanten aus den Einstellungen. Der 2. Teil entspricht dem Namen des Gegners.

Aufbau der Datei

Es wird eine Excel-Datei im CSV-Format übergeben. Trennzeichen der Datenfelder ist das Semikolon. Innerhalb der Dateien eines Feldes darf das Semikolon nicht verwendet werden.
Alle Daten zu einem Vorgang werden zur gleichen Kundennummer mitgeteilt. Erst, wenn sich die Kundennummer ändert, handelt es sich um einen neuen Vorgang.

Dateibeschreibung

Mahnverfahren Forderungssachen Importieren kVASy 1.png

Datenverarbeitung in RA-MICRO

Aktendaten

Die Aktenkurzbezeichnung wird mit Name Mandant / Name Gegner gebildet.

Im Betreff Mandant wird Kunden-Nr.: [Spalte A] gespeichert.
Im Betreff Gegner wird gespeichert:

Zeile Kunden-Nr.: [Spalte A]
Zeile Bezeichnung der Forderung, z. B. Rechnung 32473454 vom 10.12.2009, bei mehreren Forderungen wird ein Zeitraum angegeben

Hauptforderung

Zinsdaten werden nicht übergeben. Der Zinssatz ist einmalig in den Einstellungen für alle Hauptforderungen festzulegen.
Zinsbeginn der Forderungen ist das Fälligkeitsdatum zzgl. 1 Tag.

Buchungsdatum, Rechnungsdatum und Datum Zinsbeginn ist das Fälligkeitsdatum +1 Tag, Spalte T.
Die Katalognummer ist für alle Forderungen Nr. 42.

Die Forderungsbezeichnung lautet damit:

42 Rechnung Rg.Nr. [Spalte S] vom [Spalte T]

Kürzel zu Forderungen

In der Spalte S Rechnungsnummer werden vor der Ziffer Buchstabengruppen (Belegnummerierung, Rechnungsnummer Teil 1) mitgeteilt. Diese haben u. a. folgende Bedeutung:

Mahnverfahren Forderungssachen Importieren kVASy 2.png

Da die Kürzel und deren Bedeutung individuell festgelegt werden können, muss einmalig in RA-MICRO eine Zuordnung erfolgen. Im Menü Extras / Zuordnung Rechnungsnummer Teil 1 ist festzulegen, welche Kürzel es gibt, welche Bedeutung sie haben und wie die Forderung gebucht und verzinst werden soll.

Besonderheiten

Zu den Gegneradressen wird die Spalte Anrede (Spalte B) teilweise leer mitgeteilt. Beim Import wird in diesem Fall kein Anredeschlüssel vorgeschlagen. Dieser muss beim Einlesen der Daten vom Anwender selbst eingetragen werden. In den Einstellungen sollte somit Adressen einzeln prüfen gewählt werden.

Vorname und Name werden vollständig in der Spalte Name1 (Spalte C) mitgeteilt. Beim Einlesen wir der Inhalt nach einem Leerzeichen durchsucht und in Nachname und Vorname aufgeteilt. Sofern Adresszusätze enthalten sind, werden diese in der Spalte Name2 (Spalte D) mitgeteilt und so übernommen. Bei Einlesen der Daten können die Vorschläge ggf. korrigiert werden.

Randbedingungen

Name der Importdatei: ??.csv
Dateiformat Importdatei: csv-Datei im ANSI-Format

Alle Spalten sind zu übergeben und zu füllen. Anderenfalls kann die Datei nicht verarbeitet werden.
Maximal mögliche Anzahl von Datensätzen in einer Importdatei: beliebig

@@ Zeile 1: / Zeile 1: @@
 [[Hauptseite]] > [[:Category:Mahnverfahren|Mahnverfahren]] > [[Forderungssachen importieren]] > [[Forderungssachen importieren - kVASy]]
 ==RA MICRO ZV Datenimportmodul Schnittstellenbeschreibung kVASy® Standard==
-''Stand Oktober 2014 - Testdateien: import1.tst, import12.tst''
 <br>
-===Allgemeine Hinweise===
-Die Daten werden in einer Datei mit fester Satzlänge übergeben. Die Satzlänge beträgt 200 Zeichen.
-Der Name der Datei ist frei wählbar und wird einmalig unter RA-MICRO gespeichert (Parameter). Die Datei hat immer denselben Namen. Die Daten werden im ASCII-Code übergeben. Satzendezeichen kann EOL sein. Nicht benötigte Sätze werden in der Datei nicht mit übergeben.
+<div style="height:6px;font-size:6px;">&nbsp;</div>
+Mit dieser Schnittstelle können Daten der kVASy® Standard Inkasso Schnittstelle der Firma SIV AG eingelesen werden. Es sollen Forderungen aus Abrechnungen über Strom, Gas, Wasser (monatliche Abschlagzahlungen, Jahresrechnungen) beigetrieben werden.
+<br>Mit der Schnittstelle werden Akten, Adressen und Forderungskonten angelegt.
+===Allgemeine Voraussetzungen===
+Innerhalb einer Datei werden mehrere Vorgänge übergeben. Es werden immer neue Akten angelegt. Die Aktennummer wird automatisch vergeben.<br>Pro Vorgang wird immer nur ein Gegner mitgeteilt. Bei mehreren Forderungen wird der Gegner je Zeile / Forderung wiederholt. Die Kundennummer bleibt hierbei identisch.
+Mit wechselnder Kundennummer wird ein neuer Vorgang mitgeteilt.
+Es werden nur natürliche Personen als Gegner mitgeteilt.
+<br>In der Datei wird kein Auftraggeber mitgeteilt.
+Die Adressnummer des Auftraggebers ist einmalig in den Einstellungen des Importmoduls einzutragen.
+<br>Der 1. Teil der Aktenkurzbezeichnung entspricht dem Namen des Mandanten aus den Einstellungen. Der 2. Teil entspricht dem Namen des Gegners.
+===Aufbau der Datei===
+Es wird eine Excel-Datei im CSV-Format übergeben. Trennzeichen der Datenfelder ist das Semikolon. Innerhalb der Dateien eines Feldes darf das Semikolon nicht verwendet werden.
+<br>Alle Daten zu einem Vorgang werden zur gleichen Kundennummer mitgeteilt. Erst, wenn sich die Kundennummer ändert, handelt es sich um einen neuen Vorgang.
-Numerische Felder (N) werden rechtsbündig mit führenden Nullen und ohne Dezimaltrenner übergeben. Die letzten beiden Stellen werden bei Geldbeträgen als Nachkommastellen interpretiert. Beim Zinssatz der Hauptforderung werden die letzten drei Stellen als Nachkommastellen übernommen. Alphanumerische Daten (A) werden linksbündig übergeben, nicht benötigte Stellen werden mit Leerzeichen (Blank) aufgefüllt.
+===Dateibeschreibung===
-Zu einem neuen Vorgang gehören Adress- und Buchungsdaten. Jeder Vorgang wird in der Datei durch einen Kennsatz eingeleitet. Es können je Vorgang mehrere Adress- und Buchungssätze übergeben werden (maximal 9 Antragsteller und 9 Schuldner). Ein neuer Kennsatz markiert einen neuen Vorgang.
+[[Datei:Mahnverfahren_Forderungssachen_Importieren_kVASy_1.png|link=]]
-Im Kennsatz befindet sich u. a. das Währungskennzeichen. Alle Beträge zu diesem Vorgang (Forderungen, Gutschriften, Kosten) werden in der im Kennsatz angegebenen Währung mitgeteilt.
+===Datenverarbeitung in RA-MICRO===
-Es besteht die Möglichkeit, Forderungen und Gutschriften in ein Forderungskonto zu buchen, das in einem früheren Datenimportvorgang angelegt wurde. Hierbei werden nur der Kennsatz (mit demselben Geschäftszeichen wie in dem Datenimportvorgang, in dem die zugehörige Akte angelegt wurde) und die weiteren Forderungen bzw. geleisteten Zahlungen mitgeteilt. Adressdaten brauchen nicht erneut mitgeteilt zu werden.
+=====<u>Aktendaten</u>=====
-Möchte der Mandant die Aktennummer, die der Vorgang unter RA-MICRO erhalten soll, bereits vorgeben, so ist die gewünschte Aktennummer im Feld “Aktennummer” im Kennsatz einzutragen. Die Aktenkurzbezeichnung, der Sachbearbeiter und das Referat können ebenfalls vorgegeben werden.
+Die Aktenkurzbezeichnung wird mit Name Mandant / Name Gegner gebildet.
-Soll der Name eines Beteiligten im Betreff gespeichert werden, so muss im entsprechenden Adressdatensatz das Kennzeichen Betreff ein “X” enthalten. (Beispiel: Eine Versicherung möchte Geld eintreiben, im “Betreff Mandant” soll der Name des Geschädigten verzeichnet sein.) Wenn die Adresse dieses Beteiligten unter RA-MICRO nicht gespeichert werden soll, so ist das Kennzeichen “X” für Adresse nicht speichern zu setzen.
+Im Betreff Mandant wird Kunden-Nr.: [Spalte A] gespeichert.
-Soll ein Beteiligter als Aktenbeteiligter gespeichert werden, so muss dies im Adressdatensatz angegeben werden (Kennzeichen “Aktenbeteiligter”=”X”). Diese Adresse wird nicht in die Forderungskonto Stammdaten übernommen.
+<br>Im Betreff Gegner wird gespeichert:
+#Zeile Kunden-Nr.: [Spalte A]
+#Zeile Bezeichnung der Forderung, z. B. Rechnung 32473454 vom 10.12.2009, bei mehreren Forderungen wird ein Zeitraum angegeben
-Mit den Daten können Adressänderungen zu Adressen, die bereits unter RA-MICRO angelegt wurden, mitgeteilt werden. Die Adressänderungssätze müssen am Beginn der Datei stehen (da hier kein Kennsatz erforderlich ist), erst danach folgen die neu anzulegenden Vorgänge. Voraussetzung ist, dass die zu ändernde Adresse nicht von Hand, sondern während eines früheren Importvorgangs unter RA-MICRO angelegt wurde. Bei der Anlage der Adresse muss ein eindeutiges Kennzeichen für die Adresse  mitgeteilt worden sein (z.B. die Adressnummer in dem Programm, aus dem heraus die Adresse exportiert wurde). Dieses Kennzeichen ist mit der Adressänderung als Beziehungsgröße erneut mitzuteilen.
+=====<u>Hauptforderung</u>=====
+Zinsdaten werden nicht übergeben. Der Zinssatz ist einmalig in den Einstellungen für alle Hauptforderungen festzulegen. <br>Zinsbeginn der Forderungen ist das Fälligkeitsdatum zzgl. 1 Tag.
-===Aufbau der Datei===
+Buchungsdatum, Rechnungsdatum und Datum Zinsbeginn ist das Fälligkeitsdatum +1 Tag, Spalte T.
+<br>Die Katalognummer ist für alle Forderungen Nr. 42.
+Die Forderungsbezeichnung lautet damit:
+Rechnung Rg.Nr. [Spalte S] vom [Spalte T]
+=====<u>Kürzel zu Forderungen</u>=====
+In der Spalte S Rechnungsnummer werden vor der Ziffer Buchstabengruppen (Belegnummerierung, Rechnungsnummer Teil 1) mitgeteilt. Diese haben u. a. folgende Bedeutung:
+[[Datei:Mahnverfahren_Forderungssachen_Importieren_kVASy_2.png|link=]]
+Da die Kürzel und deren Bedeutung individuell festgelegt werden können, muss einmalig in RA-MICRO eine Zuordnung erfolgen. Im Menü Extras / Zuordnung Rechnungsnummer Teil 1 ist festzulegen, welche Kürzel es gibt, welche Bedeutung sie haben und wie die Forderung gebucht und verzinst werden soll.
+===Besonderheiten===
+Zu den Gegneradressen wird die Spalte Anrede (Spalte B) teilweise leer mitgeteilt. Beim Import wird in diesem Fall kein Anredeschlüssel vorgeschlagen. Dieser muss beim Einlesen der Daten vom Anwender selbst eingetragen werden.
+In den Einstellungen sollte somit Adressen einzeln prüfen gewählt werden.
+Vorname und Name werden vollständig in der Spalte Name1 (Spalte C) mitgeteilt. Beim Einlesen wir der Inhalt nach einem Leerzeichen durchsucht und in Nachname und Vorname aufgeteilt. Sofern Adresszusätze enthalten sind, werden diese in der Spalte Name2 (Spalte D) mitgeteilt und so übernommen. Bei Einlesen der Daten können die Vorschläge ggf. korrigiert werden.
+===Randbedingungen===
+Name der Importdatei: ??.csv
+<br>Dateiformat Importdatei: csv-Datei im ANSI-Format
+Alle Spalten sind zu übergeben und zu füllen. Anderenfalls kann die Datei nicht verarbeitet werden.
+<br>Maximal mögliche Anzahl von Datensätzen in einer Importdatei: beliebig
 [[Category:Mahnverfahren]]