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

Konnten Sie das gesuchte Unternehmen zweifelsfrei ermitteln, prüft das System in XML.ProductList, welche Produkte zu welchem Preis in welcher Sprache verfügbar sind. Welche Produkte abrufbar sind, liegt zum einem daran, für welche dieser Produkte Sie freigeschaltet sind und zum anderem für welches Land eine Bonitätsprüfung erfolgen soll, da leider nicht in allen Ländern alle Produkte verfügbar sind. Über die XML Schnittstelle stehen Ihnen dabei die Möglichkeiten offen, ob Sie Datenelemente oder direkte Reports abrufen wollen. Die Datenelemente haben dabei den Vorteil, dass diese einzelnen Elemente direkt in weitere Hausinterne Systeme implementiert werden können, wobei Sie bei den Reports vorgefertigte Textauskünfte erhalten, die nicht mehr in Zusatzsysteme integrierbar sind.

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)

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)
	PRODUCTLIST	array
PRODUCTLIST	INDT_CD	boolean	1 - Auskunft ist aktuell und kann abgerufen werden, 0 - Auskunft ist veraltet, es wird eine Recherche empfohlen
PRODUCTLIST	LANGUAGE	array	verfügbare [Sprachen][Sprache] (bei Datenelementen nur EN)
PRODUCTLIST	PRICE_EURO	double	Zeigt den Preis in EUR an, den die Auskunft bei Abruf kosten würde
PRODUCTLIST	PRODUCT	string	Folgende Produkt sind abrufbar: QUICK-CHECK, BUSINESSCHECK, BUSINESSCHECK+, KURZBERICHT, STANDARDBERICHT, VOLLBERICHT

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.

[
  {
    'INDT_CD' => '1',
    'LANGUAGE' => [
      'BD',
      'BF',
      'DU',
      'EN',
      'FR',
      'GE',
      'IT',
      'PO',
      'SP'
    ],
    'PRICE_EURO' => '19.00',
    'PRODUCT' => 'KURZBERICHT'
  },
  {
    'INDT_CD' => 1,
    'LANGUAGE' => [
      'GE'
    ],
    'PRICE_EURO' => '17.50',
    'PRODUCT' => 'BUSINESSCHECK'
  },
  {
    'INDT_CD' => 1,
    'LANGUAGE' => [
      'GE'
    ],
    'PRICE_EURO' => '19.00',
    'PRODUCT' => 'BUSINESSCHECK+'
  },
  {
    'INDT_CD' => '1',
    'LANGUAGE' => [
      'BD',
      'BF',
      'DU',
      'EN',
      'FR',
      'GE',
      'IT',
      'PO',
      'SP'
    ],
    'PRICE_EURO' => '29.00',
    'PRODUCT' => 'STANDARDBERICHT'
  },
  {
    'INDT_CD' => '1',
    'LANGUAGE' => [
      'BD',
      'BF',
      'DU',
      'EN',
      'FR',
      'GE',
      'IT',
      'PO',
      'SP'
    ],
    'PRICE_EURO' => '49.00',
    'PRODUCT' => 'VOLLBERICHT'
  },
  {
    'INDT_CD' => '1',
    'LANGUAGE' => [
      'EN'
    ],
    'PRICE_EURO' => '19.00',
    'PRODUCT' => 'QUICKCHECK'
  }
];

XML.DunsInfo
Seite 4 von 15
XML.Data