22
SOAP Web-Service -Ergänzung- Beschreibung der mediafinanz accumio-Schnittstelle (Version 2.0.0 vom 16.10.2009) 1 mediafinanz AG Weiße Breite 5 49084 Osnabrück

SOAP Web-Service -Ergänzung- file1 Einleitung Die mediafinanz accumio-Schnittstelle ermöglicht den automatisierten Zugriff auf die Funktionen und Dienstleistungen der accumio finance

  • Upload
    others

  • View
    4

  • Download
    0

Embed Size (px)

Citation preview

SOAP Web-Service-Ergänzung-

Beschreibung der

mediafinanz accumio-Schnittstelle

(Version 2.0.0 vom 16.10.2009)

1

mediafinanz AGWeiße Breite 549084 Osnabrück

Inhaltsverzeichnis1 Einleitung ......................................................................................................................32 Voraussetzungen ..........................................................................................................3

2.1 mediafinanz SOAP-Dokumentation ................................................................32.2 Mandanten-Account ........................................................................................32.3 Nutzungsbedingungen ....................................................................................3

3 WSDL .............................................................................................................................34 Funktionen ....................................................................................................................4

4.1 getCCCBasicScore() ......................................................................................44.2 getCCCDetailScore() ......................................................................................44.3 getCCCDetailPlusScore() ...............................................................................54.4 getBusinessSpecialCompanyList() .................................................................54.5 getBusinessSpecialScore() ............................................................................6

5 Datentypen ....................................................................................................................75.1 Auth .................................................................................................................75.2 AccumioBusinessSuspect ..............................................................................85.3 AccumioBusinessResult .................................................................................85.4 AccumioCCCScoreResult .............................................................................105.5 AccumioCCCSuspect ...................................................................................115.6 AccumioCompanyListResult .........................................................................125.7 ArrayOfCompanyItem ...................................................................................125.8 ArrayOfError ..................................................................................................135.9 ArrayOfNegativeEntry ...................................................................................135.10 CompanyItem ...............................................................................................135.11 Money ...........................................................................................................135.12 NegativeEntry ...............................................................................................13

6 Anlagen .......................................................................................................................146.1 Ausprägungen von 'justification' ...................................................................146.2 Ausprägungen der Einverständniserklärung ................................................156.3 Ausprägungen der Adressverifizierung ........................................................166.4 Ausprägungen der soziodemographischen Informationen ...........................166.5 Ausprägungen des Parameters 'product' .....................................................176.6 Ausprägungen der Negativmerkmale ...........................................................176.7 Ausprägungen für den Safe Consumer Score .............................................196.8 Ausprägungen zur Auffälligkeit .....................................................................20

7 Fehler-Codes ..............................................................................................................217.1 Fehler in den Funktionen ..............................................................................21

8 Kontaktdaten für Rückfragen ...................................................................................22

2

1 EinleitungDie mediafinanz accumio-Schnittstelle ermöglicht den automatisierten Zugriff auf die Funktionen und Dienstleistungen der accumio finance services GmbH. Durch die Anbindung unserer Schnittstelle können diese Funktionen direkt aus Ihrer Anwendung heraus genutzt werden.

2 Voraussetzungen

2.1 mediafinanz SOAP-DokumentationDiese Dokumentation beschreibt lediglich die Ergänzung der mediafinanz SOAP-Schnittstelle um die Produkte der accumio finance services GmbH und baut auf die vorhandene Dokumentation der mediafinanz SOAP-Schnittstelle auf. Bitte befassen Sie sich daher auch mit der Dokumentation der mediafinanz SOAP-Schnittstelle. Sie können diese in unserem Mandanten-Online-System herunterladen.

2.2 Mandanten-AccountUm die Schnittstelle nutzen zu können, benötigt Ihr Kunde einen freigeschalteten mediafinanz Mandanten-Account.

2.3 NutzungsbedingungenUm die mediafinanz SOAP-Schnittstelle in Ihr Softwareprodukt integrieren zu können, ist Ihre Zustimmung zu den Nutzungsbedingungen erforderlich. Hierbei geht es vornehmlich um Ihre Bereitschaft, Ihre Applikation zeitnah an Änderungen und Erweiterungen der Schnittstelle anzupassen.

3 WSDLDer mediafinanz Web-Service wird vollständig durch ein WSDL-Dokument (Web-Service Description Language) spezifiziert, welches im Mittelpunkt dieser Dokumentation steht. Um die Funktionsweise des Web-Services nachvollziehen zu können, ist eine intensive Auseinandersetzung mit dem WSDL-Dokument empfehlenswert. Es kann unter folgender URL im Stil Rpc/Encoded abgerufen werden:https://soap.mediafinanz.de/accumio200.wsdl

Eine kompatible WSDL-Datei im Stil Document/Literal finden Sie unterhttps://soap.mediafinanz.de/accumioLiteral200.wsdl

3

4 FunktionenGrundsätzlich erhalten Sie zu jedem Funktionsaufruf den angegebenen Rückgabewert. Im Fehlerfall wird jedoch stattdessen ein SOAP-Fault ausgelöst, der einen Fehler-Code und eine Kurzbeschreibung enthält. SOAP-Faults können von SOAP-Bibliotheken üblicherweise als Exceptions weitergereicht werden.

4.1 getCCCBasicScore()Beschreibung Führt eine Bonitätsauskunft (accumio Produkt CCC Basic inklusive „Safe Consumer Score“) durch.

Rückgabetyp AccumioCCCScoreResultParameter Nr. Typ Name Anmerkung

1 Auth auth Authentifizierungs-Parameter

2 AccumioCCCSuspect suspect Die Anzufragende Person

3 string justification Berechtigtes Interesse für die Auskunft. Die möglichen Ausprägungen entnehmen Sie bitte 6.1

4 integer consentDeclaration Einwilligungserklärung der angefragten Person. Die möglichen Ausprägungen entnehmen Sie bitte 6.2

4.2 getCCCDetailScore()Beschreibung Führt eine Bonitätsauskunft (accumio Produkt CCC Detail inklusive „Safe Consumer Score“) durch.

Rückgabetyp AccumioCCCScoreResultParameter Nr. Typ Name Anmerkung

1 Auth auth Authentifizierungs-Parameter

2 AccumioCCCSuspect suspect Die Anzufragende Person

3 string justification Berechtigtes Interesse für die Auskunft. Die möglichen

4

Ausprägungen entnehmen Sie bitte 6.14 integer consentDeclaration Einwilligungserklärung der angefragten Person. Die

möglichen Ausprägungen entnehmen Sie bitte 6.2

4.3 getCCCDetailPlusScore()Beschreibung Führt eine Bonitätsauskunft (accumio Produkt CCC Detail Plus inklusive „Safe Consumer Score“) durch.

Rückgabetyp AccumioCCCScoreResultParameter Nr. Typ Name Anmerkung

1 Auth auth Authentifizierungs-Parameter

2 AccumioBusinessSuspect

suspect Die Anzufragende Person

3 string justification Berechtigtes Interesse für die Auskunft. Die möglichen Ausprägungen entnehmen Sie bitte 6.1

4 integer consentDeclaration Einwilligungserklärung der angefragten Person. Die möglichen Ausprägungen entnehmen Sie bitte 6.2

4.4 getBusinessSpecialCompanyList()Beschreibung Diese Funktion stellt die erste Stufe der accumio business Produkte dar. Ein Aufruf dieser Funktion liefert eine Liste

mit Firmen zurück, welche mit der angefragten Firma übereinstimmen könnten. Jeder Firmeneintrag enthält eine objectId und einen objectIdType. Mit Hilfe dieser Identifier kann in der Funktion getBusinessSpecialScore() die angefragte Firma genau identifiziert werden.

Rückgabetyp AccumioCompanyListResultParameter Nr. Typ Name Anmerkung

1 Auth auth Authentifizierungs-Parameter

2 string product Produktkennung:

5

Gibt an, für welches Produkt diese Anfrage ausgeführt wird.• A1: Produkt business special• A2: Produkt business detail

3 AccumioBusinessSuspect

suspect Zu identifizierende Firma

4 string justification Berechtigtes Interesse für die Auskunft. Die möglichen Ausprägungen entnehmen Sie bitte 6.1

5 integer consentDeclaration Einwilligungserklärung der angefragten Person. Die möglichen Ausprägungen entnehmen Sie bitte 6.2

4.5 getBusinessSpecialScore()Beschreibung Führt ein accumio business Produkt aus (business special, business detail). Im Vorfeld muss die Funktion

getBusinessSpecialCompanyList() ausgeführt werden. Mit dieser Funktion kann auch das Ergebnis des Produktes business special detail abgefragt werden.

Rückgabetyp AccumioBusinessResultParameter Nr. Typ Name Anmerkung

1 Auth auth Authentifizierungs-Parameter

2 string jobIdentifier Eindeutiger Identifier Ihres Auftrages aus der Funktion getBusinessSpecialCompanyList()

3 string objectId ID der ausgewählten Firma aus der Funktion getBusinessSpecialCompanyList()

4 string objectIdType Typ der objectId aus der Funktion getBusinessSpecialCompanyList()

6

5 Datentypen

5.1 AuthAuthentifizierungs-Parameter. Dieser Datentyp besteht im Normalfall aus drei Elementen:

Typ Name Anmerkunginteger clientId Mandanten-ID (Kunden-Nr.) bei mediafinanzstring licenceKey Anfrage-Lizenzschlüssel, mit dem der Request autorisiert wird. Er wird wie

folgt aus dem Applikations-Lizenzschlüssel der verwendeten Applikation und dem Mandanten-Lizenzschlüssel gebildet:

- Der Mandanten-Lizenzschlüssel (ML) wird an den Applikations-Lizenzschlüssel (AL) angefügt

- Aus der so entstandenen 64 Zeichen langen Zeichenkette wird ein MD5-Hash gebildet. Das Ergebnis der Hash-Funktion ist der 32-stellige licenceKey, mit dem der Request autorisiert werden kann.

licenceKey := MD5(AL + ML)boolean sandbox Gibt an, ob die Anfrage im Sandbox- oder im Produktiv-Modus ausgeführt

werden soll (siehe mediafinanz SOAP-Dokumentation)

Falls mit mediafinanz eine gesonderte Kooperationsvereinbarung getroffen wurde, besteht der Auth-Parameter aus vier Elementen:

Typ Name Anmerkunginteger partnerId Die von mediafinanz für den Kooperationspartner vergebene Partner-ID.string clientId Die Kunden-Nummer, unter welcher der Mandant in der Datenbank des

Kooperationspartners geführt wird (Partner-Kunden-ID)string licenceKey Anfrage-Lizenzschlüssel, mit dem der Request autorisiert wird. Er wird wie

folgt aus dem Partner-Kunden-ID und dem Partner-Lizenzschlüssel gebildet:

7

- Der Partner-Lizenzschlüssel (PL) wird an die Partner-Kunden-ID (PKID) angefügt

- Aus der so entstandenen Zeichenkette wird ein MD5-Hash gebildet. Das Ergebnis der Hash-Funktion ist der 32-stellige licenceKey, mit dem der Request autorisiert werden kann.

licenceKey := MD5(PKID + PL)boolean sandbox Gibt an, ob die Anfrage im Sandbox- oder im Produktiv-Modus ausgeführt

werden soll (siehe mediafinanz SOAP-Dokumentation)

5.2 AccumioBusinessSuspectDieser Datentyp beschreibt die Firma, welche in einem accumio business Produkt angefragt wird.

Typ Name Anmerkungstring company Anzufragende Firma[string] co Optional. C/o der Firma[string] street Optional.[string] houseNumber Optional.[string] poBox Optional. Postfach.string postcode Postleitzahl[string] phonenumber Optional. Telefonnummer. [string] mobilePhonenumber Optional. Handynummer.[string] emailAddress Optional. E-Mail Adresse der Firma

5.3 AccumioBusinessResultErgebnis einer accumio business Auskunft, welche von der Funktion getBusinessSpecialScore() zurückgegeben wird. Das Ergebnis einer Auskunft kann unterschiedliche Ausprägungen haben. Das Endergebnis einer business special Auskunft enthält den Schlüssel scoreResult, welcher aus folgenden Teilen besteht:

8

Typ Name Anmerkungstring statusCode Von accumio zurückgelieferter Statuscodestring boCheckNumber Von accumio zurückgelieferte, eindeutige IDString Company Firmennamestruct address Adresse der Firma[string] └ co Optional. C/o der Firma[string] └ street Optional. Straße[string] └ houseNumber Optional. Hausnummerstring └ postcode Postleitzahl[string] └poBox Optional. Postfachstring └ city Stadtstring └ country Land[string] emailAddress Optional. E-Mail Adresse[string] phonenumber Optional. Telefonnummer[string] mobilePhonenumer Optional. Handynummerinteger classificationCode Ergebnis der Prüfung, ein Wert zwischen 0 und 4:

• 0: Eine Einschätzung des angefragten Unternehmens ist nicht möglich• 1: Das Unternehmen verfügt über eine sehr gute Bonität • 2: Die Bonität des Unternehmens liegt im normalen Bereich• 3: Die Bonität des Unternehmens wird sehr kritisch beurteilt• 4: Von einer Geschäftsbeziehung mit dem Unternehmen auf

debitorischer Basis wird wegen unzureichender Bonität abgeratenstring classificationText Erklärender Text zum classificationCode[string] addressInformation Nur bei dem Produkt business special detail. Die aktuelle Adresse der Firma

als Zeichenkette.[string] information Nur bei dem Produkt business special detail. Zusätzliche Informationen zur

Firma (Handelregister-Nummer, Kapital, etc.) in einer Zeichenkette.

9

Während die Antwort bei dem Produkt business special in Echtzeit zurückgeliefert wird, erfolgt bei dem Produkt business special detail die Bearbeitung verzögert. Mit der Funktion getBusinessSpecialScore() kann abgefragt werden, ob ein Ergebnis zur Anfrage vorliegt. Sollte noch kein Ergebnis vorliegen, so enthält das Ergebnis den Schlüssel statusResult, welches folgende Elemente enthält:

Typ Name Anmerkungstring status Status der Bearbeitungstring jobIdentifier ID für Ihren Auftrag bei mediafinanz. Diese ID kann zum Aufruf der Funktion

getBusinessSpecialScore() benutzt werden.string objectId ID der angefragten Firma. Diese ID kann zum Aufruf der Funktion

getBusinessSpecialScore() benutzt werden.string objectIdType Typ der Firmen ID. Dieser Parameter kann zum Aufruf der Funktion

getBusinessSpecialScore() benutzt werden.

5.4 AccumioCCCScoreResultErgebnis einer Privatpersonen Auskunft, bestehend aus dem Schlüssel scoreResult mit folgenden Elementen:

Typ Name Anmerkungstring statusCode Von accumio zurückgelieferter Statuscodestring boCheckNumber Von accumio zurückgelieferte, eindeutige ID[string] sex Optional. Geschlecht der Person: m = männlich, f = weiblich, @ = unbekannt[string] firstname Optional. Vorname[string] lastname Optional. Nachname[string] dateOfBirth Optional. Geburtsdatum[string] phonenumber Optional. Telefonnummer[string] mobilePhonenumber Optional. Handynummer[string] emailAddress Optional. E-Mail Adresse

10

[string] nationality Optional. Nationalitätstruct address Adresse der Person[string] └ co Optional. C/o[string] └ street Optional. Straße[string] └ houseNumber Optional. Hausnummerstring └ postcode Postleitzahl[string] └ poBox Optional. Postfachstring └ city Stadtstring └ country Land[integer] └ originCode Nur bei CCC detail plus. Code der Adressherkunft, siehe 6.3[string] └ originText Nur bei CCC detail plus. Beschreibender Text zum originCode[struct] sociodemographic Optional. Informationen zum Mikro- und Soziodemographischen Umfeld.[string] └ code Code zum Umfeld, siehe 6.4[string] └ text Beschreibung zum Umfeld.[struct] consumerscore Optional. Consumer Score zur Einschätzung des Risikos von Personen zu

denen keine Negativdaten vorliegen.[string] └ class Risikoklasse. Siehe 6.7[string] └ value RisikoScore. Siehe 6.7struct evidence Informationen über Auffälligkeiten zur Person.[string] └ code Code zur Auffälligkeit, siehe 6.8[string] └ text Text zur Auffälligkeit, siehe 6.8[ArrayOfNegativeEntry]

negativeEntryList Optional. Liste mit Negativdaten zur Person.

5.5 AccumioCCCSuspectPerson einer Privatpersonenauskunft

11

Typ Name Anmerkung[string] sex Optional. Geschlecht der Person, m = männlich, f = weiblich, @ = unbekannt[string] firstname Optional. Vornamestring lastname Nachname[string] co Optional. C/o [string] street Optional. Straße[string] houseNumber Optional. Hausnummer[string] poBox Optional. Postfachstring postcode Postleitzahlstring city Stadt[date] dateOfBirth Optional. Geburtsdatum[string] phonenumber Optional. Telefonnummer[string] mobilePhonenumber Optional. Handynummer[string] emailAddress Optional. E-Mail Adresse[string] nationality Optional. Nationalität

5.6 AccumioCompanyListResultErgebnis der Funktion getBusinessSpecialCompanyList(). Besteht im Normalfall aus dem Schlüssel companyListResult mit den Elementen:

Typ Name AnmerkungArrayOfCompanyItem

companyList Array mit den zur Anfrage passenden Firmen.

string subject ID dieses Auftrages, welche später in der Funktion getBusinessSpecialScore() benötigt wird.

5.7 ArrayOfCompanyItem

12

Array mit Elementen vom Typ CompanyItem.

5.8 ArrayOfErrorDieser Datentyp wird verwendet, wenn mehrere Fehler auf einmal zurückgemeldet werden müssen, z.B. weil einige Pflichtfelder nicht befüllt wurden. Der Datentyp kann beliebig viele Fehler-Strings aufnehmen. Üblicherweise konvertiert die von Ihnen verwendete SOAP-Bibliothek dieses Element in ein Array.

5.9 ArrayOfNegativeEntryArray mit Elementen vom Typ NegativeEntry

5.10 CompanyItemEine von der Funtion getBusinessSpecialCompanyList() zurückgelieferte Firma.

Typ Name Anmerkungdecimal similarity Ähnlichkeit zur angefragten Firma als Zahl zwischen 0 und 100boolean definiteHit Gibt zurück, ob es sich um einen definitiven Treffer handeltstring objectIdType Art der objectIdstring objectId Eindeutige ID zur Firma. Diese ID wird beim Aufruf der Funktion

getBusinessSpecialScore() benötigt.

5.11 MoneyMit diesem Datentypen werden Geldbeträge repräsentiert. Er basiert auf dem elementaren decimal-Datentyp mit der Beschränkung, dass nur 2 Nachkommastellen zulässig sind.

5.12 NegativeEntryEin Negativeintrag zu einer Privatperson.

13

Typ Name Anmerkungstruct type Informationen zur Art des Eintragsstring └ code Code zum Negativeintrag. Siehe 6.6string └ text Erklärender Text zum Negativeintrag. Siehe 6.6struct register Informationen zum Register in dem der Eintrag steht.string └ code Code des Registereintrages.string └ text Text des Registereintrages.[string] └ postcode Optional. Postleitzahl des Registers[string] └ city Optional. Stadt des Registers[string] └ number Optional. Registernummer[string] └ numberType Optional. Art der Registernummer[string] └ numberText Optional. Zusätzliche Beschreibung der Registernummer[string] source Optional. Quelle des Eintrags[Money] value Optional. Betrag des Eintrags[date] date Optional. Datum des Eintrags.[boolean] settled Optional. Kennzeichen der Erledigung für den Eintrag

6 Anlagen

6.1 Ausprägungen von 'justification'Das Feld justification, welches in der Anfrage einer Bonitätsauskunft gesetzt sein muss beinhaltet den Grund für eine Anfrage bei accumio. Folgende Gründe sind zulässig:

Wert BedeutungABD Anfrage zur Bonitätsprüfung vor Abschluss eines Dienstsvertrages

14

ABF Anfrage zur Bonitätsprüfung vor Übernahme bzw. vor Kauf einer Forderung

ABI Anfrage zur Bonitätsprüfung im Zusammenhang mit der Einleitung

bzw. Durchführung von Inkassomaßnahmen

ABK Anfrage zur Bonitätsprüfung vor Abschluss eines Kaufvertrages

ABL Anfrage zur Bonitätsprüfung vor Abschluss eines Leasingvertrages

ABV Anfrage zur Bonitätsprüfung vor Abschluss eines Versicherungsvertrages

ABW Anfrage zur Bonitätsprüfung vor Abschluss eines Werkvertrages

BBS Bonitätsprüfung vor Abschluss eines Bausparvertrages

BER Bonitätsprüfung aufgrund eines Ermittlungsauftrages

BFT Bonitätsprüfung vor Eröffnung bzw. Einrichtung eines

Telekommunikationskontos

BKA Bonitätsprüfung aufgrund eines Kredit- bzw. Kundenkartenantrages

BKE Bonitätsprüfung vor Kontoeröffnung

BKV Bonitätsprüfung vor Kreditvergabe

BMG Anfrage zur Bonitätsprüfung vor Abschluss bzw. Prüfung eines gewerblichen

Mietverhältnisses (Immobilien)

BMV Anfrage zur Bonitätsprüfung vor Abschluss eines Mietvertrages (Immobilien)

6.2 Ausprägungen der EinverständniserklärungFolgende Werte für die Einverständniserklärung sind gültig. Bitte beachten Sie, dass die angefragte Person stets über Ihre Anfrage informiert wird.

code Bedeutung0 Liegt nicht vor

15

1 Mündliche Zustimmung

10 Schriftliche Zustimmung (d.h. Liegt nachweislich vor)

99 wurde nicht nachgefragt / Zustimmung verweigert

6.3 Ausprägungen der Adressverifizierung

originCode originTextAV01 Die angefragte Person ist an der von Ihnen angegebenen Anschrift bekannt.AV02 Die angefragte Person ist an der zurückgemeldeten korrigierten Adresse bekannt.AV03 Der Nachname der angefragten Person ist an der von Ihnen angegebenen Anschrift bekannt, den angegebenen

Vornamen konnten wir jedoch nicht zuordnen.

AV04 Der Nachname der angefragten Person ist an der zurückgemeldeten korrigierten Adresse bekannt, den angegebenen Vornamen konnten wir jedoch nicht zuordnen.

AV05 Die angefragte Person ist umgezogen. Sie ist jetzt unter der zurückgemeldeten Anschrift bekannt.

AV06 Die angefragte Person ist an der von Ihnen angegebenen Anschrift unbekannt, aber die angegebene Anschrift ist postalisch korrekt.

AV07 Die angefragte Person ist an der von Ihnen angegebenen Anschrift unbekannt. Die angegebene Anschrift ist jedoch in der zurückgemeldeten korrigierten Form postalisch korrekt.

AV08 Die angegebene Adresse ist uns nicht bekannt. Bitte überprüfen Sie die von Ihnen eingegebenen Daten!

AV99 Nicht definiertes Ergebnis!

6.4 Ausprägungen der soziodemographischen Informationen

16

Code TextBK01 Das mikrogeographische und soziodemographische Umfeld eignet sich weniger gut für den Absatz

höherwertiger Produkte.

BK02 Das mikrogeographische und soziodemographische Umfeld eignet sich gut für den Absatz höherwertiger Produkte.

BK03 Das mikrogeographische und soziodemographische Umfeld eignet sich sehr gut für den Absatz höherwertiger Produkte.

BK99 Eine Bewertung des mikrogeographischen und soziodemographischen Umfeldes wurde nicht durchgeführt.

6.5 Ausprägungen des Parameters 'product'Bereits beim Aufruf von getBusinessSpecialCompanyList() muss ein Business Produkt ausgewählt werden. Folgende Produktcodes sind hierfür zulässig:

Produktcode Produkt A1 BusinessSpecialA2 BusinessSpecialDetail

BusinessSpecial:Dieses Produkt führt eine Bontitätsprüfung über die zuvor ausgewählte Firma durch. Die Bonitätsauskunft besteht aus einer Klassifizierung zwischen 0 und 4, sowie einem beschreibenden Text.

BusinessSpecialDetail:Dieses Produkt führt eine detaillierte Firmenauskunft durch. Bei der ersten Ausführung der Anfrage wird zunächst nur eine Auftragsbestätigung zurückgegeben. Sobald ein Ergebnis vorliegt, kann es durch einen erneuten Aufruf der Funktion abgerufen werden.

6.6 Ausprägungen der Negativmerkmale

17

Code BeschreibungNM01 KonkursNM02 Eidesstattliche VersicherungNM03 HaftanordnungNM04 InsolvenzverfahrenNM05 InkassoNM06 Inkasso-ÜberwachungsverfahrenEV Eidesstattliche VersicherungEEV Ergänzung der EVHA Besondere Anschriften / GemeinschaftsunterkunftHB Haftbefehl zur Erzwingung der EVHV Vollstreckung des Haftbefehls zur Erzwingung der EVIBE Eröffnung des Insolvenzverfahrens / BeschlussIBA Abweisung bzw. Einstellung des Insolvenzverfahrens mangels Masse (§26 Abs. 2 InsO)

IRV Versagung der RestschuldbefreiungIVS Anordnung von vorläufigen Sicherungsmaßnahmen im Insolvenzverfahren

IVA Aufhebung von vorläufigen Sicherungsmaßnahmen im Insolvenzverfahren

VER VerstorbenWEV Wiederholte EVFRP Fruchtlose PfändungIUB Inkasso ÜberwachungsverfahrenIWP Aufhebung des Insolvenzverfahrens / Beginn der Wohlverhaltensperiode

18

LP Lohn- oder sonstige ForderungspfändungTR Ratenzahlen nach Forderungs-TitulierungUBV Unbekannt verzogenUF Uneinbringliche, titulierte ForderungZWA Zwangsvollstreckung in das bewegliche VermögenZWI Zwangsvollstreckung in das unbewegliche VermögenAE Adress- bzw. Schuldneraufenthaltsermittlung (außergerichtliches Inkasso-Mahnverfahren)

AM Fortlauf des außergerichtlichen Inkasso-Mahnverfahrens nach Teil- bzw. bei Ratenzahlung

IE Einstellung des gerichtlichen Inkasso-Mahnverfahrens wegen Aussichtslosigkeit

IM Inkasso-Mahnverfahren eingeleitetIMB Laufendes InkassoverfahrenIRB Erteilung der RestschuldbefreiungMB Mahnbescheid bzw. Mahnbescheids-AntragVB Vollstreckungsbescheid bzw. Vollstreckungsbescheids-Antrag

VV Außergerichtliches Vergleichsverfahren

6.7 Ausprägungen für den Safe Consumer ScoreClass ValueRK09 <= 390RK08 391 - 450RK07 451 - 510RK06 511 - 560RK05 561 - 630RK04 631 - 680

19

RK03 681 - 720RK02 721 - 780RK01 >= 781RK99 0

6.8 Ausprägungen zur AuffälligkeitCode BeschreibungHE01 Zur Person liegen keine Auffälligkeiten vor HE02 Zur Person liegen Auffälligkeiten vor HE03 Zur Person liegen Hinweise vor HE99 Die Person ist unbekannt

20

7 Fehler-CodesDie folgende Liste enthält eine Beschreibung der Fehlermeldungen, die beim Aufruf der dokumentierten Funktionen auftreten können. Die hier erläuterten Fehler-Codes beziehen sich lediglich auf die in diesem Dokument beschriebenen Funktionen. Bitte beachten Sie daher auch das Kapitel „Fehler-Codes“ in der Dokumentation der mediafinanz SOAP-Schnittstelle, welches sich unter anderem auch mit Fehlern der Authentifizierung beschäftigt.

7.1 Fehler in den Funktionen

Code Meldung-301 Invalid job identifier

Bei einigen Bonitätsprodukten sind mehr als eine Anfrage erforderlich, um eine Auskunft zu erhalten. Die für den zweiten Funktionsaufruf verwendete Id ist ungültig.

Code Meldung-302 Invalid job identifier

Bei einigen Bonitätsprodukten sind mehr als eine Anfrage erforderlich, um eine Auskunft zu erhalten. Die für den zweiten Funktionsaufruf verwendete Id ist ungültig.

Code Meldung-303 Invalid product descriptor

Bei einigen Bonitätsprodukten ist die Angabe einer Produkt-Id erforderlich. Die angegebene Produkt-Id ist ungültig.

Code Meldung-703 Variable Fehlermeldung

Das angegebene Bonitätsprodukt wurde für den Mandanten vorübergehend gesperrt. Die näheren Gründe hierfür entnehmen Sie bitte der Fehlermeldung.

8 Kontaktdaten für RückfragenBei Fragen zur Schnittstelle wenden Sie sich bitte an:

21

mediafinanz AG

IT-Abteilung

Tel: +49 (0)541 2029-110

Fax: +49 (0)541 2029-101

E-Mail: [email protected]

22