Standard-Schnittstellenbeschreibung für den Datei-Upload von Melderegisteranfragen und den Datei-Download von Melderegister-Ergebnissen.

Inhalt:
1. Allgemeines
2. Datei Upload (Beschreibung CSV Format)
3. Datei Download
3.1 Beschreibung CSV Format
3.2 Antwort-Code

1. Allgemeines

Dateiformate: Regis24 überläßt Kunden die freie Wahl des Dateiformats. Um individuelle Formate zu vereinbaren, müssen Sie ein registrierter Kunde sein. Schicken Sie uns in diesem Fall eine E-Mail.
Sonst verwenden Sie bitte das Regis24 CSV-Standard-Format. CSV-Dateien lassen sich aus nahezu allen gängigen Anwendungen erstellen bzw. exportieren (z.B. Microsoft Access, Excel, OpenOffice oder Lotus 1-2-3).

Zeichensatz: Textdatei in gängigen Formaten (ISO8859-1, ISO8859-15, ANSI oder UTF-8, in Großbuchstaben und/oder Kleinbuchstaben, mit Umlauten). CSV mit Semikolon oder Komma als Trennzeichen und Anführungszeichen als Feldbegrenzer ("wert1";"wert2";"wert3"). Für maschinen-generierte Dateien beachten Sie bitte, dass Zeilenenden mit NewLine und CarriageReturn Zeichen ( ) markiert werden müssen - Microsoft Excel und OpenOffice fügen diese Zeichen automatisch ein.

Komprimierung: Um die Dateien bei der Übertragung möglichst klein zu halten, sind die gängigen Methoden der Komprimierung wie z.B. ZIP, gzip oder RAR einsetzbar.

Datenübertragung: Generelle Richtlinien (Details nach individuellen Vereinbarungen)
Die Datenübertragung basiert auf Standardprotokollen:

HTTPS
SCP und SFTP
E-Mail (SMTP)

Die Verschlüsselung geschieht auf Protokollebene (außer E-Mail):

HTTPS: SSL/TLS (RSA, RC4, RC5 oder 3DES), 128bit
SCP und SFTP: RSA, RC4, RC5 oder 3DES
E-Mail: PGP

Authentifizierung: Um die Identität unserer Services zu garantieren, verwenden wir 128bit SSL (Version 3) Zertifikate, ausgestellt von einer authorisierten CA.
Autorisierung: Abhängig von der gewählten Art der Datenübertragung:

HTTPS: SSL-gesichert durch das Front-End (E-Mail, Passwort)
SFTP: SSL-gesichert durch die FTP-Verbindung (Benutzername, Passwort)
SCP: DES oder RSA - verschlüsseltes Protokoll (Benutzername, Passwort)
E-Mail: durch vorheriges Übertragen des Public Key

2. Datei-Upload (Beschreibung CSV-Format):

Datei-Format: CSV Format

Besonderheiten: Die Struktur der einzelnen Spalten kann individuell vom Kunden bestimmt werden. Damit eine eindeutige Zuordnung der Felder erfolgen kann, muss eine Kopfzeile mit der jeweiligen Spaltenbezeichnung (siehe Tabelle) verwendet werden. Die mit p gekennzeichneten Pflicht-Spalten sind zur Bearbeitung unbedingt erforderlich. Die mit o gekennzeichneten Spalten können, falls vorhanden, mitgeliefert werden und den Ermittlungserfolg fördern. In den einzelnen Datenfeldern sollten bei der Eingabe keine Semikolon (;) oder Anführungszeichen (") verwendet werden, damit es nicht zu einer Fehlinterpretation kommt.
Falls Sie ein individuelles Datenformat benötigen, richten wir Ihnen ein entsprechendes Template ein. Kontaktieren Sie hierführ bitte unseren technischen Support (support@regis24.de).

Vorlage: Als Vorlage kann die Musterdatei Anfragemuster.csv verwendet werden (siehe unten).:

Feld Nr.	Pflicht (p) Option (o)	Bezeichnung Kopfzeile	Struktur	Länge (max.)	Bemerkung
1	o¹	Aktenzeichen	string	255	Eindeutiges Aktenzeichen des Kunden
2	p⁴	Anfrageart	integer	11	1=Einfache Melderegisterauskunft 8=Gewerberegisterauskunft mit Privatanschrift des gesetzlichen Vertreters
3	o	Geschlecht	string	1	Schlüssel: m: männlich, w oder f: weiblich
4	o	Titel	string	32	Akademischer Titel (z.B. 'Dr.', 'Prof', 'Prof. Dr.', 'Dr.h.c.', 'Dr.E.h.', 'Dr.e.h.', 'D.', 'Dr.Dr.'
5	p²	Vorname	string	255	Ein oder mehrere Vornamen
6	p^2,3	Nachname	string	255	Nachname (ohne Namenszusätze)
7	o	Namensbestandteil	string	32	Namenszusätze wie 'van', 'de', 'Freiherr von', etc.
8	p^5,6	Strasse	string	255
9	p⁵	Hausnummer	string	8	z.B. "34"
10	o	Hausnummer_Zusatz	string	8	z.B. "B"
11	o	Adressierungs_Zusatz	string	255	z.B. "Hinterhaus" oder "c/o ..."
12	p⁷	Postleitzahl	integer	14
13	p⁷	Gemeinde	string	255	Bezeichnung der Stadt oder Gemeinde
14	o	Ortsteil	string	255	Orts- bzw. Stadtteil
15	o	Postfach	integer	5
16	o⁶	Geburtsdatum	date	10	"JJJJ-MM-TT", "TTMMJJJJ" oder "TT.MM.JJJJ"; Fehlende Angaben werden jeweils durch Null ersetzt.
17	o	Zusatzangaben	string	511	Weitere Angaben zur gesuchten Person z.B. "Geburtsname", "frühere Anschrift"
18	o⁸	"Kundenfeld"	string	255	In diesen Feldern können Sie beliebige Angaben machen, die Ihnen ohne Bearbeitung bei der Ausgabe zurückgeliefert werden (z.B. Sachbearbeiter, Wiedervorlagedatum, etc.) Die Bezeichnung der Kopfzeile ist frei wählbar.
...	o⁸	weitere Kundenfelder	string	255

¹ Das Feld "Aktenzeichen" enthält Ihr eindeutiges Bearbeitungszeichen. Es kann aus einer beliebigen Folge von Buchstaben und Zahlen bestehen. Der Vorgang wird nicht zugelassen und unbearbeitet zurückgegeben falls sich bereits ein Vorgang mit gleichem Aktenzeichen in Bearbeitung befindet.
² Ist es Ihnen nicht möglich Vor- und Familiennamen zu trennen, können Sie diese im Datenfeld "Name" im Format "Familienname, Vorname" (wichtig: durch Komma getrennt), oder "Vorname Familienname" anfragen. Das Datenfeld "Vorname" darf in diesem Fall nicht gefüllt sein.
³ Ist es Ihnen nicht möglich den Namensbestandteil zu trennen, können Sie diesen im Datenfeld "Nachname" im Format "Namensbestandteil Nachname" eintragen. Das Datenfeld "Namensbestandteil" darf in diesem Fall nicht gefüllt sein.
⁴ Wenn nicht befüllt wird die Anfrage als Standard Melderegisterauskunft gewertet.
⁵ Ist es Ihnen nicht möglich Straße, Hausnummer und Hausnummer_Zusatz zu trennen, können Sie diese im Datenfeld "Straße" eintragen. Die Datenfelder "Hausnummer" und "Hausnummer_Zusatz" dürfen in diesem Fall nicht gefüllt sein.
⁶ Alternativ zu Straße und Hausnummer kann auch das Geburtsdatum angegeben werden.
⁷ Entweder die PLZ oder die Gemeinde angeben; in Fällen die nicht eindeutig auf den Wohnort rückschliessen lassen, hilft Ihnen die Suchmaschine von Regis24 bei der Bestimmung der richtigen Attribute
⁸ Optional können bis zu 15 Kundenvermerk-Felder durchgeschleust werden.

3. Datei-Download

3.1 Beschreibung CSV Format

Feld Nr.	Bezeichnung Kopfzeile	Struktur	Länge (max.)	Bemerkung
1	Aktenzeichen	string	255	Eindeutiges Aktenzeichen des Kunden
2	Antwortcode	string	3	Siehe Antwortcode (unten)
3	Anfragedatum	date	10	JJJJ-MM-TT
4	Ergebnisdatum	date	10	JJJJ-MM-TT
5	Auftragsnummer	integer	11	Eindeutige Auftrags-Nummer von Regis24
6	Anfragekennziffer	integer	11	Eindeutige Anfrage-Nummer von Regis24
7	Nettopreis	float	10,2
8	Umsatzsteuer	float	10,2
9	Bruttopreis	float	10,2
10	Auskunft_Geschlecht	string	1	Schlüssel: m: männlich, w oder f: weiblich
11	Auskunft_Titel	string	32	Akademischer Titel (z.B. 'Dr.', 'Prof', 'Prof. Dr.', 'Dr.h.c.', 'Dr.E.h.', 'Dr.e.h.', 'D.', 'Dr.Dr.'
12	Auskunft_Vorname	string	255
13	Auskunft_Nachname	string	255
14	Auskunft_Namensbestandteil	string	32	Namenszusätze wie 'van', 'de', 'Freiherr von', etc.
15	Auskunft_Strasse	string	255
16	Auskunft_Hausnummer	integer	8
17	Auskunft_Hausnummer_Zusatz	string	255
18	Auskunft_Adressierungszusatz	string	255	z.B. "c/o wohnhaft bei", "Stockwerk", "Wohnungsnummer", "Seitenflügel", "Hinterhaus"
19	Auskunft_PLZ	string	14
20	Auskunft_Gemeinde	string	255	Bezeichnung der Stadt oder Gemeinde
21	Auskunft_Ortsteil	string	255	Orts- bzw. Stadtteil
22	Auskunft_Postfach	integer	11
23	Auskunft_Geburtsdatum	date	10	JJJJ-MM-TT
24	Auskunft_Zusatzangaben	string	511	z.B. Telefonbucheintrag
25	Anfrage_Geschlecht	Siehe Anfragestruktur Diese Datenfelder entsprechen denen, die Regis24 zur Recherche übermittelt wurden. Die Daten wurden ggf. durch Plausibilitätsprüfungen leicht in ihrer Schreibweise geändert bzw. normiert. (z.B. postalische Prüfung)
26	Anfrage_Titel
27	Anfrage_Vorname
28	Anfrage_Nachname
29	Anfrage_Namensbestandteil
30	Anfrage_Strasse
31	Anfrage_Hausnummer
32	Anfrage_Hausnummer_Zusatz
33	Anfrage_Adressierungszusatz
34	Anfrage_PLZ
35	Anfrage_Gemeinde
36	Anfrage_Ortsteil
37	Anfrage_Postfach
38	Anfrage_Geburtsdatum
39	Anfrage_Zusatzangaben
40	Anfrage_Kundenvermerk_1
...	Anfrage_Kundenvermerk_2 - 14	Optional vorhanden, falls weiteren Kundenfelder geliefert wurden.

Die Ergebnisse der Meldeamtsanfrage werden neben dem Ermittlungsbericht als CSV-Datei zur Verfügung gestellt. Für Großkunden können auch Lockbox/Festlängen oder proprietäre Formate individuell vereinbart werden.

Zeichensatz: ISO8859-15 mit Gross-/Kleinbuchstaben und Umlauten
Datei-Format: CSV Format mit Kopfzeile
Dateiname: Ergebnis_EMA_JJJJMMTT_(Code).csv

3.2 Antwortcode

Eine ausführliche Beschreibung unserer Antwort-Codes finden Sie hier

Sie können sich folgende Musterdateien hier ansehen oder herunterladen:
-> Schnittstellenbeschreibung
-> Standard Anfragemuster (CSV)
-> Ergebniscodes

Flexible technische Integration

Flexible technische Integration

Login

Infomaterial