Investigation.New - 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

Sollte das System einmal nicht das gewünschte Unternehmen finden können, können Sie hierüber eine entsprechende Recherche auslösen. Die Gründe für das nicht eindeutige identifizieren eines Unternehmens sind sehr vielfältig. Zum einem kann es sich um ein recht junges Unternehmen handeln, dessen Daten noch nicht auf der Datenbank eingespielt wurden oder es handelt sich um ein sehr kleines Unternehmen, auf Grund dessen Rechtsform kein automatisches einspielen auf der Datenbank erfolgt. Ein weiterer Grund für die fehlende Identifizierung eines Unternehmens liegt auch im abweichenden Firmennamen der Suchanfrage mit dem auf der Datenbank gespeicherten Firmenname. Sollten also die gelieferten Treffer nicht Ihrer Suchanfrage entsprechen so können Sie oder Ihr Kunde uns mit einer entsprechenden Recherche beauftragen. Ihnen stehen dabei die beiden Produkte "Global Business Check plus" und der Standardbericht zur Verfügung. Zudem können Sie je nach Dringlichkeit zwischen der Normal- und der Eilrecherche wählen. Bitte beachten Sie dabei dass die Auswahl der Eilrecherche jedoch mit einem entsprechenden Aufschlag verbunden ist.

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. (falls vorhanden)
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	CEO_NME	string	gesetzlicher Vertreter (falls vorhanden)
REQUEST	ADR_LINE	string	Straße und Hausnummer
REQUEST	POST_CODE	string	PLZ
REQUEST	POST_TOWN	string	Ort
REQUEST	TLCM_NBR	string	Telefon-Nummer (falls vorhanden)
REQUEST	BUS_REGN_NBR	string	Handelsregister-Daten (Amtsgericht, Register-Typ und -Nummer; falls vorhanden)
REQUEST	PRODUCT	string	Produkt: BUSINESSCHECK+ oder STANDARDBERICHT
REQUEST	PRIORITY	boolean	Eilrecherche?
REQUEST	LANGUAGE	string	[Sprache][] (z. B. GE)
REQUEST	COMMENT	string	Hinweise / Kommentare (z. B. Homepage; falls vorhanden)

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)
	NEW	struct
NEW	TICKET_ID	string	neu angelegte Ticket-Nr.

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.

{
  'TICKET_ID' => 'TEST_REPORT-123456-12345'
};