XML.ListDuns - 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

XML.ListDuns stellt das Gegenstück zu [XML.SearchDuns][] dar, wenn das Unternehmen nicht direkt ermittelt werden konnte. XML.ListDuns zeigt Ihnen mögliche Unternehmen auf die Ihrer Suchanfrage am ehesten entsprechen. Dabei kann es aber auch vorkommen, dass Ihr gesuchtes Unternehmen in XML.ListDuns aufgelistet wird, ohne dass ein Direkttreffer erfolgte. Die Ursache liegt meist in der unterschiedlichen Schreibweise des Firmennamens, welcher teilweise anders auf der Datenbank eingespielt wurde oder das Unternehmen Ihnen diesen unvollständig übermittelt hat, oder auch an abweichenden Firmenanschriften. Die gefundenen Treffer in XML.ListDuns werden Ihnen in absteigender Reihenfolge anzeigt, so dass die an oberster Stelle stehenden Unternehmen noch eher Ihrer Suchanfrage entsprechen als diese, die einen geringeren Trefferprozentsatz erhielten.

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	CTRY_CD	string	[Länderkode][] (2 Zeichen)
REQUEST	PRIM_GEO_AREA	string	[Bundesstaat][] (nur bei USA und Kanada erforderlich)
REQUEST	PRIM_NME	string	Firmenname
REQUEST	ADR_LINE	string	Straße und Hausnummer (oder Postfach)
REQUEST	POST_CODE	string	PLZ
REQUEST	POST_TOWN	string	Ort
REQUEST	TLCM_NBR	string	Telefonnummer (nicht erforderlich)

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)
	LISTDUNS	array
LISTDUNS	ADR_LINE	string	Straße und Hausnummer
LISTDUNS	BR_IND	string	[Zweigstelle][]
LISTDUNS	CTRY_CD	string	[Länderkode][]
LISTDUNS	DUNS_NBR	int	D-U-N-S Nr. (neunstellige Zahl)
LISTDUNS	MTCH_HAUSNR	double	Übereinstimmung Hausnummer
LISTDUNS	MTCH_NAME	double	Übereinstimmung Firmenname
LISTDUNS	MTCH_ORT	double	Übereinstimmung Ortsname
LISTDUNS	MTCH_PLZ	double	Übereinstimmung PLZ
LISTDUNS	MTCH_STRASSE	double	Übereinstimmung Straße
LISTDUNS	MTCH_SUMME	double	Übereinstimmung insgesamt (gewichtet)
LISTDUNS	POST_CODE	string	PLZ
LISTDUNS	POST_TOWN	string	Ort
LISTDUNS	PRIM_GEO_AREA	string	[Bundesstaat][]
LISTDUNS	PRIM_NME	string	Firmenname
LISTDUNS	TLCM_NBR	string	Telefonnummer (falls vorhanden)
LISTDUNS	TRDG_STYL	string	abweichender Firmenname (falls vorhanden)

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',
    'BR_IND' => 'H',
    'CTRY_CD' => 'DE',
    'DUNS_NBR' => '317273787',
    'MTCH_HAUSNR' => '0.00',
    'MTCH_NAME' => '100.00',
    'MTCH_ORT' => '0.00',
    'MTCH_PLZ' => '0.00',
    'MTCH_STRASSE' => '0.00',
    'MTCH_SUMME' => '100.00',
    'POST_CODE' => '60598',
    'POST_TOWN' => 'Frankfurt',
    'PRIM_GEO_AREA' => '',
    'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
    'TLCM_NBR' => '69123456123',
    'TRDG_STYL' => ''
  },
  {
    'ADR_LINE' => 'Füchte 20',
    'BR_IND' => 'B',
    'CTRY_CD' => 'DE',
    'DUNS_NBR' => '333378466',
    'MTCH_HAUSNR' => '0.00',
    'MTCH_NAME' => '100.00',
    'MTCH_ORT' => '0.00',
    'MTCH_PLZ' => '0.00',
    'MTCH_STRASSE' => '0.00',
    'MTCH_SUMME' => '98.00',
    'POST_CODE' => '48599',
    'POST_TOWN' => 'Gronau',
    'PRIM_GEO_AREA' => '',
    'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
    'TLCM_NBR' => '',
    'TRDG_STYL' => ''
  },
  {
    'ADR_LINE' => 'Sternstr. 5',
    'BR_IND' => 'B',
    'CTRY_CD' => 'DE',
    'DUNS_NBR' => '333758113',
    'MTCH_HAUSNR' => '0.00',
    'MTCH_NAME' => '100.00',
    'MTCH_ORT' => '0.00',
    'MTCH_PLZ' => '0.00',
    'MTCH_STRASSE' => '0.00',
    'MTCH_SUMME' => '98.00',
    'POST_CODE' => '20357',
    'POST_TOWN' => 'Hamburg',
    'PRIM_GEO_AREA' => '',
    'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
    'TLCM_NBR' => '',
    'TRDG_STYL' => ''
  },
  {
    'ADR_LINE' => 'Havelstr.',
    'BR_IND' => 'B',
    'CTRY_CD' => 'DE',
    'DUNS_NBR' => '327304440',
    'MTCH_HAUSNR' => '0.00',
    'MTCH_NAME' => '100.00',
    'MTCH_ORT' => '0.00',
    'MTCH_PLZ' => '0.00',
    'MTCH_STRASSE' => '0.00',
    'MTCH_SUMME' => '98.00',
    'POST_CODE' => '64295',
    'POST_TOWN' => 'Darmstadt',
    'PRIM_GEO_AREA' => '',
    'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
    'TLCM_NBR' => '',
    'TRDG_STYL' => ''
  },
  {
    'ADR_LINE' => 'Lehmkuhlenweg 33',
    'BR_IND' => 'S',
    'CTRY_CD' => 'DE',
    'DUNS_NBR' => '319572079',
    'MTCH_HAUSNR' => '0.00',
    'MTCH_NAME' => '0.00',
    'MTCH_ORT' => '0.00',
    'MTCH_PLZ' => '0.00',
    'MTCH_STRASSE' => '0.00',
    'MTCH_SUMME' => '0.00',
    'POST_CODE' => '31224',
    'POST_TOWN' => 'Peine',
    'PRIM_GEO_AREA' => '',
    'PRIM_NME' => 'Peiner Maschinenbau Franke GmbH',
    'TLCM_NBR' => '517153333',
    'TRDG_STYL' => 'Franke Maschinenbau'
  }
];

• 
• 
• XML.Person
• Seite 2 von 15
• XML.DunsInfo
• 
• 

• .. / 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