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

Allgemeine Funktionsbeschreibung
Request - Anfrage an den XML-Server
Response - Antwort vom XML-Server
Beispiel-Antwort des XML-Servers

1. Allgemeine Funktionsbeschreibung

Zu einer gegebenen D-U-N-S Nr. können Sie mit dieser Methode die Stammdaten (Firmenname, Anschrift) ermitteln.

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.

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)
	DUNSINFO	struct
DUNSINFO	DUNS_NBR	int	D-U-N-S Nr.
DUNSINFO	PRIM_NME	string	Firmenname
DUNSINFO	TRDG_STYL	string	abweichender Firmenname (falls vorhanden)
DUNSINFO	ADR_LINE	string	Straße und Hausnummer
DUNSINFO	POST_CODE	string	PLZ
DUNSINFO	POST_TOWN	string	Ort
DUNSINFO	PRIM_GEO_AREA	string	[Bundesstaat][]
DUNSINFO	CTRY_CD	string	[Länderkode][]
DUNSINFO	TLCM_NBR	string	Telefonnummer (falls vorhanden)
DUNSINFO	BR_IND	string	[Zweigstelle][]

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',
  'POST_CODE' => '60598',
  'POST_TOWN' => 'Frankfurt',
  'PRIM_GEO_AREA' => '',
  'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
  'TLCM_NBR' => '069123456123',
  'TRDG_STYL' => ''
};

XML.ListDuns
Seite 3 von 15
XML.ProductList