'Mein Creditmanager' - Mann kann Ihnen eine deutsche Bonitätsauskunft, eine Firmenauskunft, eine Personenauskunft und ein weltweite Wirtschaftsauskunft liefern Welteweite Firmenauskünfte mit Negativdaten, Zahlungserfahrunge und Handelsregisterdaten

DnB.QuickCheck - 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

Eine sehr einfache Prüfung Ihres Geschäftspartners auf dessen Kreditwürdigkeit erhalten Sie mit dem Datenelement DnB.QuickCheck. Es hilft Ihnen Kreditrisiken zu senken und Erfolgsaussichten in der Zusammenarbeit mit einem Geschäftspartner richtig einzuschätzen. Der QuickCheck liefert Ihnen die Unternehmensidentifikation, eine Zusammenfassung der vorliegenden Zahlungserfahrungen, Angaben zu öffentlichen Firmenberichten und das D&B Rating.

Sprung zum Anfang

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 DUNS_NBR int D-U-N-S Nr.
REQUEST CTRY_CD string [Länderkode][] (2 Zeichen)
REQUEST PRIM_GEO_AREA string [Bundesstaat][] (nur bei USA und Kanada erforderlich)
Sprung zum Anfang

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)
  QUICKCHECK struct
QUICKCHECK DUNS_NBR int
QUICKCHECK ENQ_DUNS int
QUICKCHECK OUT_BUS_IND string Y/N
QUICKCHECK PRIM_NME string
QUICKCHECK TRDG_STYL array
QUICKCHECK ADR_LINE array
QUICKCHECK POST_TOWN string
QUICKCHECK NON_POST_TOWN string
QUICKCHECK PRIM_GEO_AREA string
QUICKCHECK SCDY_GEO_AREA string
QUICKCHECK POST_CODE string
QUICKCHECK CTRY_CD string
QUICKCHECK TLCM_NBR string
QUICKCHECK FAX_NBR string
QUICKCHECK INTL_DLNG_CD int
QUICKCHECK BUS_REGN_NBR_TYPE_CD string
QUICKCHECK BUS_REGN_NBR string
QUICKCHECK CRCY_CD string
QUICKCHECK CEO_NME string
QUICKCHECK CEO_TITL string
QUICKCHECK PRIN_NME string
QUICKCHECK PRIN_TTL string
QUICKCHECK LGL_FORM string
QUICKCHECK PAYD_SCR int
QUICKCHECK PAYD_NORM int
QUICKCHECK HIST_IND string
QUICKCHECK TOT_EMPL int
QUICKCHECK TOT_EMPL_TEXT string
QUICKCHECK TOT_EMPL_IND string A/B
QUICKCHECK TOT_EMPL_ESTD_IND string Y/N
QUICKCHECK TOT_EMPL_MIN_IND string A/B/C
QUICKCHECK EMPL_AT_PRIM_ADR string
QUICKCHECK EMPL_AT_PRIM_ADR_TEXT string
QUICKCHECK EMPL_AT_PRIM_ADR_ESTD_IND string Y/N
QUICKCHECK EMPL_AT_PRIM_ADR_MIN_IND string A/B/C
QUICKCHECK CURR_CNTL_YR int
QUICKCHECK STRT_YR int
QUICKCHECK INCN_YR int
QUICKCHECK PRIM_SIC_TYPE_CD string 1972/1977/1987
QUICKCHECK PRIM_SIC string
QUICKCHECK LCL_ACTV_CD_TYPE string 4/5
QUICKCHECK LCL_ACTV_CD int
QUICKCHECK FINL_EMBT_IND string Y/N
QUICKCHECK CRIM_IND string Y/N
QUICKCHECK SUIT_JDGT_IND string Y/N
QUICKCHECK CLM_IND string Y/N
QUICKCHECK SCRD_FLNG_IND string Y/N
QUICKCHECK FINL_LGL_EVNT_IND string Y/N
QUICKCHECK DSTR_IND string Y/N
QUICKCHECK OPRG_SPEC_EVNT_IND string Y/N
QUICKCHECK OTHR_SPEC_EVNT_INT string Y/N
QUICKCHECK DNB_RATG string
QUICKCHECK MAX_CR int
QUICKCHECK MAX_CR_CRCY_CD string
QUICKCHECK STMT_DT int
QUICKCHECK STMT_CRCY_CD string
QUICKCHECK NET_WRTH double
QUICKCHECK STMT_FROM_DT int
QUICKCHECK STMT_TO_DT int
QUICKCHECK INCM_STMT_DT int
QUICKCHECK ITNG_ASET double
QUICKCHECK SLS double
QUICKCHECK ANN_SALE_VOL double
QUICKCHECK ANN_SALE_VOL_TEXT string
QUICKCHECK ANN_SALE_ESTD_IND string 1/2/3/4/5
QUICKCHECK ANN_SALE_CONS_IND string Y/N
QUICKCHECK ANN_SALE_CRCY_CD string
QUICKCHECK TANG_NET_WRTH double
QUICKCHECK TANG_NET_WRTH_TEXT string
QUICKCHECK TANG_NET_WRTH_ESTD_IND string 1/2
QUICKCHECK TANG_NET_WRTH_CRCY_CD string
Sprung zum Anfang

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.

{
  'ADR_LINE' => [
  'Darmstädter Landstr. 802'
],
  'BUS_REGN_NBR' => '60313B90003',
  'BUS_REGN_NBR_TYPE_CD' => 'Q8',
  'CEO_NME' => 'Prof. Dr. Dr. Karl Werner Gerardy-Köhle',
  'CEO_TITL' => 'Chief Executive Officer',
  'CLM_IND' => 'N',
  'CRCY_CD' => 'EUR',
  'CRIM_IND' => 'N',
  'CTRY_CD' => 'DE',
  'DNB_RATG' => '2A1',
  'DSTR_IND' => 'N',
  'DUNS_NBR' => '317273787',
  'ENQ_DUNS' => '317273787',
  'FAX_NBR' => '069/2631587',
  'FINL_EMBT_IND' => 'N',
  'FINL_LGL_EVNT_IND' => 'N',
  'INCM_STMT_DT' => '20071130',
  'INCN_YR' => '1952',
  'INTL_DLNG_CD' => '49',
  'ITNG_ASET' => '550000',
  'LCL_ACTV_CD' => '2951',
  'LCL_ACTV_CD_TYPE' => '4',
  'LGL_FORM' => 'LSC/3087',
  'MAX_CR' => '2250000',
  'NET_WRTH' => '5490000',
  'OPRG_SPEC_EVNT_IND' => 'Y',
  'OUT_BUS_IND' => 'N',
  'PAYD_NORM' => '80',
  'PAYD_SCR' => '87',
  'POST_CODE' => '60598',
  'POST_TOWN' => 'FRANKFURT',
  'PRIM_GEO_AREA' => 'HESSEN',
  'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
  'PRIM_SIC' => '3542',
  'PRIM_SIC_TYPE_CD' => '1987',
  'SCRD_FLNG_IND' => 'N',
  'SLS' => '41000000',
  'STMT_DT' => '20071130',
  'STRT_YR' => '1931',
  'SUIT_JDGT_IND' => 'N',
  'TLCM_NBR' => '069/123456123',
  'TOT_EMPL' => '240',
  'TOT_EMPL_IND' => 'A',
  'TRDG_STYL' => [
   'Maschinenbau Frankfurter',
   'Maschinenbau AG',
   'FMA Frankfurter Maschinenbau'
 ]
};
Sprung zum Anfang

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