Monitoring.GetChanges - 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

Sobald zu Ihren ausgelösten Monitoringaufträgen die entsprechenden Nachmeldungen vorliegen, können Sie über GetChanges dieses Veränderungen bzw. Meldungen abrufen. Zum einem erhalten Sie detailliert den entsprechenden Nachtrag und zu welchem Unternehmen dieser Nachtrag gehört, zum anderem werden diese Nachträge auch direkt in die Auskünfte (Global Business Check, Global Business Check plus) eingearbeitet, so dass Sie und Ihre Kunden permanent aktuelle Auskünfte kostenfrei einsehen können. Voraussetzung für dieser Art der Auskunftsaktualisierung ist jedoch, dass Sie bzw. Ihre Kunden eine entsprechende Auskunft hierzu abgerufen haben.

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	ALL_CHANGES	boolean	alle Nachmeldungen (auch bereits "gelesene") anzeigen?
REQUEST	ALL_USERS	boolean	Nachmeldungen aller User einer Kunden-ID anzeigen?
REQUEST	ALL_CUSTOMERS	boolean	Nachmeldungen aller Kunden (eines Partners) anzeigen? Dazu muß ALL_USERS ebenfalls gesetzt sein.
REQUEST	MONITORING_ID	int	Wenn angegeben: Nur Nachmeldungen dieses Monitoring-Auftrags anzeigen.
REQUEST	NO_MARK_READ	boolean	Nicht als "gelesen" markieren?

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)
	GETCHANGES	array
GETCHANGES	CHANGES	array
GETCHANGES / CHANGES	DATE	date	Datum der Nachmeldung
GETCHANGES / CHANGES	FIELD	string	Feldname
GETCHANGES / CHANGES	VALUES	array
GETCHANGES	CTRY_CD	string	[Länderkode][] (2 Zeichen)
GETCHANGES	CUSTOMER_ID	int	Kunden-ID
GETCHANGES	CUST_REF	string	Aktenzeichen
GETCHANGES	DUNS_NBR	int	D-U-N-S Nr.
GETCHANGES	MONITORING_ID	int	Monitoring-ID (wurde bei [Monitoring.New][] übermittelt
GETCHANGES	POST_TOWN	string	Ort
GETCHANGES	PRIM_NME	string	Firmenname
GETCHANGES	USER_ID	int	User-ID

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.

[
  {
    'CHANGES' => [
   {
     'DATE' => '20070209T10:21:59',
     'FIELD' => 'STMT_DT',
     'VALUES' => [
   '20051231'
 ]
   },
   {
     'DATE' => '20070209T10:21:59',
     'FIELD' => 'ITNG_ASET',
     'VALUES' => [
   '14208000'
 ]
   },
   {
     'DATE' => '20070209T10:21:59',
     'FIELD' => 'NET_WRTH',
     'VALUES' => [
   '3214890'
 ]
   },
   {
     'DATE' => '20070209T10:21:59',
     'FIELD' => 'SLS',
     'VALUES' => [
   '36848490'
 ]
   },
   {
     'DATE' => '20070209T10:21:59',
     'FIELD' => 'INCM_STMT_DT',
     'VALUES' => [
   '20051231'
 ]
   }
 ],
    'CTRY_CD' => 'DE',
    'CUSTOMER_ID' => '10000',
    'CUST_REF' => 'QC-Monitoring-Test',
    'DUNS_NBR' => '340690770',
    'MONITORING_ID' => '1037',
    'POST_TOWN' => 'Darmstadt',
    'PRIM_NME' => 'D&B Deutschland GmbH',
    'USER_ID' => '216011'
  },
  {
    'CHANGES' => [
   {
     'DATE' => '20070927T13:32:44',
     'FIELD' => 'TOT_PMT',
     'VALUES' => [
   '45'
 ]
   },
   {
     'DATE' => '20070927T13:32:44',
     'FIELD' => 'SCR',
     'VALUES' => [
   '1576'
 ]
   },
   {
     'DATE' => '20070927T13:32:44',
     'FIELD' => 'NATL_PCTL',
     'VALUES' => [
   '100'
 ]
   },
   {
     'DATE' => '20071001T02:22:03',
     'FIELD' => 'TOT_PMT',
     'VALUES' => [
   '43'
 ]
   },
   {
     'DATE' => '20071016T09:35:12',
     'FIELD' => 'TOT_PMT',
     'VALUES' => [
   '42'
 ]
   }
 ],
    'CTRY_CD' => 'DE',
    'CUSTOMER_ID' => '10000',
    'CUST_REF' => 'QC-Monitoring-Test',
    'DUNS_NBR' => '317273787',
    'MONITORING_ID' => '1649',
    'POST_TOWN' => 'Frankfurt am Main',
    'PRIM_NME' => 'Frankfurter Maschinenbau Aktiengesellschaft',
    'USER_ID' => '216011'
  }
];

Monitoring.New
Seite 15 von 15