XML.Person - Web-Dokumentation

Sollten nicht alle Ihre Fragen auf dieser Webseite beantwortet werden, so wenden Sie sich bitte an unsere IT-Abteilung unter der kostenlosen Hotline: 0800 / 11 44 111.

Inhaltsverzeichnis

1. Allgemeine Funktionsbeschreibung
2. Request - Anfrage an den XML-Server
3. Response - Antwort vom XML-Server
4. Beispiel-Antwort des XML-Servers

1. Allgemeine Funktionsbeschreibung

Mit Übergabe des Vornamen, Namen, Geburtsdatum (optional) und der kompletten Wohnanschrift prüfen Sie Ihre Kunden bei unserem Partner InFoScore oder Bürgel auf vorliegende Negativmerkmale. Der Datenbestand hält für Sie ca. 40 Millionen Informationen zu mehr als 7,3 Millionen Privatpersonen bereit. Diese Daten werden aktuell aus den Schuldnerverzeichnissen der Amtsgerichte, sonstigen (Verbraucher-) Insolvenzdatenquellen eingepflegt sowie aus den Einmeldungen angeschlossener Inkassounternehmen. Sie erhalten auf Grund der breiten Datenbasis ein Optimum an Sicherheit für Ihre Bonitätsabfragen. Neben einer Prüfung der angefragten Person auf Negativmerkmale erfolgt zusätzlich eine Adressverifizierung durch die Deutsche Post AG. Eine "Kreuzprüfung" des Vor- und Nachnamens verhindert zusätzlich ein verfälschtes Ergebnis falls der Kunde einmal seine Daten verkehrt eingeben sollte.

2. Request - Anfrage an den XML-Server

struct/array	Feldname	Datentyp	Beschreibung
	SIGNON	struct	allgemeine Angaben (zur Identifizierung des Anfragenden)
SIGNON	USER_ID	int	User-ID von handelsauskunft.com (z. B. 210234)
SIGNON	PASSWORD	string	Passwort zur User-ID (Änderung im Kundenbereich der Webseite möglich)
SIGNON	SESSION_ID	string	Kann alternativ zu USER_ID und PASSWORD angegeben werden, wird von [Session.Login][] vergeben
SIGNON	CUSTOMER_DUNS	int	D-U-N-S Nr. des Kunden, für den die Auskunft abgerufen wird (siehe Vertrag)
	REQUEST	struct	Anfrage-spezifische Angaben (die ersten 3 Felder sind allerdings bei allen Anfragen enthalten)
REQUEST	CLIENT_REF	string	Aktenzeichen (beliebiger Inhalt), wird unverändert wieder zurückgegeben
REQUEST	VERSION	string	Version der XML-Schnittstelle, muß derzeit "0.1" sein
REQUEST	REASON	string	[Anfragegrund][]
REQUEST	TEST	boolean	Kostenlose Testdaten werden bei "TEST = 1" zurück geliefert. Bei "TEST = 0" oder wenn "TEST" fehlt, dann werden immer Echt-Daten abgerufen!
REQUEST	SEX	int	Geschlecht der Person (0 = nicht bekannt, 1 = männlich, 2 = weiblich)
REQUEST	BIRTHDAY	string	Geburtsdatum (nicht erforderlich), Format: tt.mm.jjjj
REQUEST	FIRST_NME	string	Vorname
REQUEST	LAST_NME	string	Nachname
REQUEST	ADR_LINE	string	Straße und Hausnummer
REQUEST	CTRY_CD	string	[Länderkode][] (2 Zeichen), derzeit nur DE, AT und CH möglich
REQUEST	POST_CODE	string	PLZ
REQUEST	POST_TOWN	string	Ort
REQUEST	TYPE	string	Produkttyp (ESCORE oder CONCHECK)

3. Response - Antwort vom XML-Server

struct/array	Feldname	Datentyp	Beschreibung
	RESPONSE	struct	allgemeine Angaben (Aktenzeichen und Preis)
RESPONSE	CLIENT_REF	string	Wiederholung des Aktenzeichen
RESPONSE	SERVER_REF	string	Aktenzeichen auf Serverseite (bitte bei Rückfragen angeben)
RESPONSE	PRICE_UNITS	double	Preis der Auskunft in Einheiten
RESPONSE	PRICE_EURO	double	Preis der Auskunft in Euro (Netto-Betrag)
	PERSON	struct
PERSON	TYPE	string	Produkttyp (ESCORE)
PERSON	BIRTHDAY	string	Geburtsdatum, Format: tt.mm.jjjj
PERSON	FIRST_NME	string	Vorname (evtl. korrigiert)
PERSON	FIRST_NME_OLD	string	Vorname (ursprünglich angefragt; nur bei Korrektur gefüllt)
PERSON	LAST_NME	string	Nachname (evtl. korrigiert)
PERSON	LAST_NME_OLD	string	Nachname (ursprünglich angefragt; nur bei Korrektur gefüllt)
PERSON	ADR_LINE	string	Straße und Hausnummer (evtl. korrigiert)
PERSON	ADR_LINE_OLD	string	Straße und Hausnummer (ursprünglich angefragt; nur bei Korrektur gefüllt)
PERSON	POST_CODE	string	PLZ (evtl. korrigiert)
PERSON	POST_CODE_OLD	string	PLZ (ursprünglich angefragt; nur bei Korrektur gefüllt)
PERSON	POST_TOWN	string	Ort (evtl. korrigiert)
PERSON	POST_TOWN_OLD	string	Ort (ursprünglich angefragt; nur bei Korrektur gefüllt)
PERSON	ADDR_FEAT_ID	string	[Adressverifizierung][###TODO###] durch die Deutsche Post Direkt GmbH
PERSON	ADDR_FEAT_TEXT	string	Adressverifizierung durch die Deutsche Post Direkt GmbH
PERSON	RSK_AMPEL	string	Risiko-Farbe analog einer Ampel, "R" für Rot, "Y" für Gelb, "G" für Grün
PERSON	RSK_AMPEL_TEXT	string	Risiko-Farbe analog einer Ampel (rot, gelb, gruen)
PERSON	ICD_H_ANZ	int	Anzahl von harten Negativmerkmalen
PERSON	ICD_H_IND	string	Kennzeichen des höchsten [harten Negativmerkmals][###TODO###]
PERSON	ICD_H_DAT	string	Datum des höchsten harten Negativmerkmals
PERSON	ICD_M_ANZ	int	Anzahl von mittleren Negativmerkmalen
PERSON	ICD_M_IND	string	Kennzeichen des höchsten [mittleren Negativmerkmals][###TODO###]
PERSON	ICD_M_DAT	string	Datum des höchsten mittleres Negativmerkmals
PERSON	ICD_W_ANZ	int	Anzahl von weichen Negativmerkmalen
PERSON	ICD_W_IND	string	Kennzeichen des höchsten [weichen Negativmerkmals][###TODO###]
PERSON	ICD_W_DAT	string	Datum des höchsten weichen Negativmerkmals
PERSON	ICD_S_ANZ	int	Anzahl von sonstigen Negativmerkmalen
PERSON	ICD_S_IND	string	Kennzeichen des höchsten [sonstigen Negativmerkmals][###TODO###]
PERSON	ICD_S_DAT	string	Datum des höchsten sonstigen Negativmerkmals
PERSON	SUIT_JDGT_IND	string	Gibt an, ob offene Verfahren, Urteile, Petitionen oder Zahlungsbemerkungen vorliegen.
PERSON	SUIT_JDGT_TEXT	string	Liefert einen vorformatierten Text mit Negativdaten (ausgeschrieben).
PERSON	SUIT_JDGT	array	alle harten, mittleren, weichen und sonstigen Negativmerkmale
SUIT_JDGT	AMOUNT	double	Forderungshöhe in EUR (wenn bekannt)
SUIT_JDGT	CLOSED	string	Datum der Erledigung (falls vorhanden), Format jjjjmmtt
SUIT_JDGT	CODE	string	Kürzel des Negativmerkmals
SUIT_JDGT	COURT_NME	string	Name des Amtsgerichts
SUIT_JDGT	COURT_POST_CODE	string	Postleitzahl des Amtsgerichts
SUIT_JDGT	DATE	string	Datum des Ereignisses (falls vorhanden), Format jjjjmmtt
SUIT_JDGT	REF	string	Aktenzeichen (falls vorhanden)
SUIT_JDGT	TEXT	string	Negativmerkmal (ausgeschrieben)

4. Beispiel-Antwort des XML-Servers

Anfolgendes Beispiel erhalten Sie, wenn Sie bei der Anfage an den XML-Server das Parameter: TEST = 1 setzen. Die Nachfolgende Ausgabe wurde mit dem Modul: Dumper erzeugt und zeigt die Struktur der Antwort auf.

{
  'ADDR_FEAT_ID' => undef,
  'ADDR_FEAT_TEXT' => undef,
  'ADR_LINE' => 'Musterstr. 8',
  'ADR_LINE_OLD' => 'Müsterstr. 8',
  'BIRTHDAY' => '23.10.1980',
  'FIRST_NME' => 'Hans',
  'FIRST_NME_OLD' => undef,
  'ICD_H_ANZ' => 5,
  'ICD_H_DAT' => 20060713,
  'ICD_H_IND' => 'EV',
  'ICD_M_ANZ' => 2,
  'ICD_M_DAT' => 20060406,
  'ICD_M_IND' => 'VB',
  'ICD_S_ANZ' => 0,
  'ICD_S_DAT' => '',
  'ICD_S_IND' => '',
  'ICD_W_ANZ' => 1,
  'ICD_W_DAT' => 20060126,
  'ICD_W_IND' => 'IA',
  'LAST_NME' => 'Rat',
  'LAST_NME_OLD' => '',
  'POST_CODE' => '99999',
  'POST_CODE_OLD' => undef,
  'POST_TOWN' => 'Musterhausen',
  'POST_TOWN_OLD' => undef,
  'RSK_AMPEL' => 'R',
  'RSK_AMPEL_TEXT' => 'rot',
  'SUIT_JDGT' => [
    {
      'AMOUNT' => '56.67',
      'CODE' => 'UF',
      'DATE' => 20061027,
      'REF' => 'S12345678912',
      'TEXT' => 'uneinbringliche, titulierte Forderung'
    },
    {
      'CODE' => 'EV',
      'COURT_NME' => 'MUSTERHAUSEN',
      'COURT_POST_CODE' => '99999',
      'DATE' => 20060713,
      'REF' => '404M1234567',
      'TEXT' => 'Eidesstattliche Versicherung'
    },
    {
      'CODE' => 'HB',
      'COURT_NME' => 'MUSTERHAUSEN',
      'COURT_POST_CODE' => '99999',
      'DATE' => 20060713,
      'REF' => '403M345678',
      'TEXT' => 'Haftbefehl zur Erzwingung der Eidesstattlichen Versicherung'
    },
    {
      'AMOUNT' => '3289.10',
      'CODE' => 'VB',
      'DATE' => 20060406,
      'REF' => 'S2345678345',
      'TEXT' => 'Vollstreckungsbescheid bzw. Vollstreckungsbescheids-Antrag'
    },
    {
      'CODE' => 'HB',
      'COURT_NME' => 'MUSTERHAUSEN',
      'COURT_POST_CODE' => '99999',
      'DATE' => 20060309,
      'REF' => '403M4567890',
      'TEXT' => 'Haftbefehl zur Erzwingung der Eidesstattlichen Versicherung'
    },
    {
      'CODE' => 'HB',
      'COURT_NME' => 'MUSTERHAUSEN',
      'COURT_POST_CODE' => '99999',
      'DATE' => 20060309,
      'REF' => '403M56789012',
      'TEXT' => 'Haftbefehl zur Erzwingung der Eidesstattlichen Versicherung'
    },
    {
      'AMOUNT' => '100.27',
      'CLOSED' => 20060712,
      'CODE' => 'IA',
      'DATE' => 20060126,
      'REF' => 'S9876543212',
      'TEXT' => 'Inkasso-Mahnverfahren eingeleitet'
    },
    {
      'CODE' => 'HB',
      'COURT_NME' => 'MUSTERHAUSEN',
      'COURT_POST_CODE' => '99999',
      'DATE' => 20050718,
      'REF' => '404M9876543',
      'TEXT' => 'Haftbefehl zur Erzwingung der Eidesstattlichen Versicherung'
    },
    {
      'CODE' => '1HA',
      'DATE' => 20040923
    }
  ],
  'SUIT_JDGT_IND' => 'Y',
  'TYPE' => 'ESCORE'
};

• 
• 
•  
• Seite 1 von 15
• XML.ListDuns
• 
• 

• .. / Unternehmen
• Wir über uns
• Firmenauskünfte
• Antiterrorismus
• Mein Creditmanager
• XML-Schnittstelle
• • XML.Person
  • XML.ListDuns
  • XML.DunsInfo
  • XML.ProductList
  • XML.Data
  • XML.DataImage
  • XML.Report
  • DnB.QuickCheck
  • Investigation.New
  • Investigation.List
  • Investigation.GetData
  • Investigation.GetReport
  • Investigation.GetSpecial
  • Monitoring.New
  • Monitoring.GetChanges
• Newsletter
• Kunde werden

Innungsfachbetrieb mit Unternehmerkarte? Klicken Sie hier, um sich anzumelden ...

Loginbereich

User- ID

Passwort

Zugangsdaten vergessen?

• Unternehmen
• Produkte
• Preise
• Neukunde