Inkasso.Neu - 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

Sprung zum Anfang

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 SCHULDNER array
SCHULDNER BEMERKUNG string Bemerkungen/Hinweise
SCHULDNER CEO string gesetzlicher Vertreter (bei Firmen)
SCHULDNER DUNS int D-U-N-S Nr. (optional)
SCHULDNER EMAIL array Email-Adressen (optional)
SCHULDNER FAX array Fax-Nummern (optional)
SCHULDNER FIRMENNAME string Firmenname (bei Firmen)
SCHULDNER GEBURTSDATUM string Geburtsdatum (tt.mm.yyyy) (optional)
SCHULDNER HANDY array Handy-Nummern (optional)
SCHULDNER KONTO array Bankverbindungen (optional)
SCHULDNER LAND string [Länderkode][] (2 Zeichen)
SCHULDNER NACHNAME string Nachname (bei Privatpersonen)
SCHULDNER ORT string Ort
SCHULDNER PLZ string PLZ
SCHULDNER RECHTSFORM int Rechtsform (numerisch)
SCHULDNER STRASSE string Straße
SCHULDNER TELEFON array Telefon-Nummern (optional)
SCHULDNER VORNAME string Vorname (bei Privatpersonen)
REQUEST BUCHUNG array
BUCHUNG ANSPRUCHSGRUND int Anspruchsgrund (numerisch) (nicht bei Zahlungen)
BUCHUNG BELEGDATUM string Belegdatum (tt.mm.yyyy)
BUCHUNG BELEGNUMMER string Belegnummer
BUCHUNG BETRAG double Betrag
BUCHUNG BUCHUNGSART int Buchungsart (numerisch)
BUCHUNG FAELLIGKEIT string Fälligkeitsdatum (tt.mm.yyyy) (nicht bei Zahlungen)
BUCHUNG WAEHRUNG string Währung (default: EUR)
REQUEST UNBESTRITTEN boolean Forderung unbestritten?
REQUEST GERICHTLICH boolean Forderung bereits gerichtlich?
Sprung zum Anfang

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)
  NEU struct
NEU INKASSO_ID string Inkasso-ID
Sprung zum Anfang

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.

{
  'UEBERGABE_DATUM' => '15.08.2007',
  'AMPEL' => 'R',
  'CLIENT_REF' => 'TEST',
  'STATUS' => 'VORGERICHTLICH',
  'INKASSO_AZ' => '2007-0123',
  'CHRONOLOGIE' => [
     {
       'BELEGNUMMER' => '12345/07',
       'FAELLIG' => '01.06.2007',
       'BETRAG' => 123,
       'VORGANG' => 'Warenlieferung',
       'DATUM' => '01.05.2007',
       'WAEHRUNG' => 'EUR'
     },
     {
       'NOTIZ' => 'Schuldner will nicht zahlen',
       'BETRAG' => '',
       'VORGANG' => 'Telefoninkasso',
       'DATUM' => '22.08.2007'
     }
   ],
  'NEGATIVDATEN' => {
      'HAFTBEFEHL_ANZAHL' => 0,
      'HAFTBEFEHL_AZ' => '',
      'HAFTBEFEHL_DATUM' => '',
      'INKASSO_ANZAHL' => 34,
      'INSOLVENZ_EROEFFNUNG' => '01.03.2007',
      'INKASSO_DATUM' => '12.08.2007',
      'EV_AZ' => 'EV/123',
      'INSOLVENZ_AZ' => 'INS/123',
      'EV_DATUM' => '30.09.2007',
      'INSOLVENZ_ABSCHLUSS' => '31.07.2007'
    },
  'SCHULDNER' => [
   {
     'TELEFON' => [
    '0123/4567890'
  ],
     'ORT' => 'Berlin',
     'STRASSE' => 'Strasse 1',
     'PLZ' => '12345',
     'FIRMENNAME' => 'Test AG',
     'KONTO' => [
  {
    'NUMMER' => 1234567890,
    'BLZ' => 12345678
  }
],
     'LAND' => 'DE',
     'DUNS' => 123456789,
     'VERTRETUNG' => [
       {
 'ANREDE' => 'Herr',
 'NAME1' => 'Max Mustermann'
       }
     ],
     'HANDY' => [
  '0171/00000000'
],
     'TELEFAX' => [
    '0123/456789-123'
  ]
   }
 ],
  'FORDERUNG' => {
   'GLAUEBIGERVORSCHUSS' => '40.9',
   'ZAHLUNG_AN_INKASSOBUERO' => '144.51',
   'ZAHLUNG_AN_GLAEUBIGER' => '10',
   'WAEHRUNG' => 'EUR',
   'UEBERGEB_HAUPTFORDERUNG' => '109.84',
   'HAUPTFORDERUNG' => '41.23',
   'RESTFORDERUNG' => '49.87',
   'ZINSEN' => '0.97',
   'KOSTEN' => '7.67'
 }
};
Sprung zum Anfang