Infoproff API-Dokumentation - v2


Erste Schritte


Webdienst-Wsdl und Schemata befinden sich hier:

http://wsdfn.infoproff.com/v2/

Hauptfunktionen des Webdienstes:

  • SimpleSearch - Suche nach Unternehmensinformationen in verschiedenen Ländern.
  • Order - Erzeugt eine order_id und gibt Duplikate zurück. Die Duplikate werden nach folgenden Parametern ausgewählt: country, product, delivery_term and reg_code.
  • OrderCancellation - Wenn Sie eine Bestellanfrage gesendet und die order_id erhalten haben, haben Sie die Möglichkeit, diese Bestellung zu stornieren (wenn sie nicht in Produktion geht).
  • OrderConfirmation - Nachdem Sie order_id erhalten haben, müssen Sie Ihre Bestellung innerhalb von 1 Stunde bestätigen. Wenn Sie Ihre Bestellung nicht innerhalb von 1 Stunde bestätigen, wird die Bestellung automatisch storniert.
  • ChkStatus - Auftragsstatus prüfen.
  • GetReport - Erhalten Sie fertige Berichte.
  • GetClassifiersFinancialStatements - Abruf aller Finanzdokumente mit allen Elementen: row_number, row_formated_description, row_lang_key und row_order.
  • GetLegalForms - Holen Sie sich alle Rechtsformulare für alle verfügbaren Länder.
  • GetActivityClassificators - Holen Sie sich alle Codes und Beschreibungen für eine bestimmte Aktivität Klassifikator.
  • GetDictionaryStandardPhrases - Sie erhalten alle Standardphrasen mit Schlüssel und Sprache.
  • GetAvailableProducts - Erhalten Sie eine Liste der verfügbaren Produkte.
  • CreditOpinionCalculator - Der Credit Opinion Calculator hilft bei der Zuordnung der Kreditmeinung zu einem Unternehmen.

API bietet mehrere Dienste an:

  1. Online-Kreditauskünfte für die folgenden Länder: Finnland (FIN), Schweden (SWE)
  2. Offline-Berichte für die folgenden Länder: Alle Länder
  3. Kreditgutachten Taschenrechner

Wie sucht man nach einem Unternehmen?


Die Unternehmenssuche besteht aus 2 Optionen:

  1. Suche nach Firmenname,
  2. Suche nach Registrierungscode.
Liste der verfügbaren Länder: Finnland (FIN), Schweden (SWE), Norway (NOR), Denmark (DNK)
Wichtige Informationen:
Das norwegische Register erlaubt es nicht, gelöschte Firmen nach Namen zu suchen. Daher können wir keine SimpleSearch nach Namen innerhalb der gelöschten Unternehmen in Norwegen anbieten.
Field's length:
company_name varchar(512)
company_code varchar(64)

Nachstehend finden Sie ein Beispiel:


Funktion SimpleSearch

Option 2: Suche nach Registrierungscode

Funktion SimpleSearch

Wie bestelle ich eine Kreditauskunft?


Der Ablauf von der Anmeldung bis zum Erhalt des Berichts besteht aus folgenden Schritten:

  1. Der Benutzer registriert eine neue Bestellung (Funktion "Bestellung"). Das System gibt die Einzelheiten der Bestellung und die Liste der in den letzten 60 Tagen aufgegebenen Duplikate zurück und wartet auf die Bestätigung der Bestellung.
  2. Der Benutzer bestätigt einen Auftrag (Funktion "OrderConfirmation"). Das System sendet den Auftrag zur Produktion und gibt den aktuellen Produktionsstatus zurück.
  3. Der Benutzer prüft den Auftragsstatus (Funktion "ChkStatus").
  4. Wenn ein Auftrag fertig ist, kann der Benutzer den Bericht herunterladen (Funktion "GetReport").
Liste der verfügbaren Länder: Finnland (FIN), Schweden (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Nachstehend finden Sie ein Beispiel:


SCHRITT 1: Bericht bestellen

Nutzer, die den Schritt der Auftragsbestätigung für unnötig halten, können das Element "confirm_order" verwenden und den Wert "TRUE" übergeben.

In der Regel dauert es 10-20 Sekunden, um den Kreditbericht im Online-Modus zu erstellen.
Daher sollten Sie bei Online-Berichten alle 5 oder mehr Sekunden eine Überprüfung vornehmen.

Liste der verfügbaren Unternehmen für ein Testkonto:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Darüber hinaus können Sie für die Online-Berichte (delivery_term = "o") Muster verwenden, die für jedes Land erstellt wurden (Verwendung: Registrierungscode "00000000"). Diese Berichte sind kostenlos und können über ein Testkonto bestellt werden.
Funktion Order

Funktion OrderCancellation

SCHRITT 2. Auftragsbestätigung

Funktion OrderConfirmation

SCHRITT 3: Statusüberprüfung

Funktion ChkStatus

SCHRITT 4: Bericht abrufen

Liste der verfügbaren Sprachen für Online-Berichte: en (English), et (Estonian), ru (Russian), de (German)
Das Herunterladen des Online-Berichts im PDF-Format ist noch nicht möglich.
Funktion GetReport

Die folgenden Status werden für Berichte verwendet:

  • In Bearbeitung - Bericht in der Produktionsphase
  • Canceled - Stornierte Bestellung
  • Finished - Der Bericht ist fertig
  • Updated - Dem fertigen Bericht wurden Informationen hinzugefügt
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - In unserem System ist ein technischer Fehler aufgetreten. Das bedeutet, dass wir über diesen Fehler informiert sind und ihn so schnell wie möglich beheben werden. Sie werden informiert, wenn Sie die Bestellung erhalten können.

Wenn der Ausführungsstatus Finished oder Updated lautet, können Sie einen Auftrag erhalten.

Wie kann ich den Offline-Bericht herunterladen?


Sie können Offline-Berichte direkt herunterladen. Hier ist die Anleitung, wie Sie das tun müssen:

Der Antrag besteht aus 3 Teilen:

  1. Fester Bestandteil https://www.infoproff.com/en/orders/files/
  2. Ihr eindeutiger Hash, den wir als Antwort zur Verfügung stellen
  3. Und fester Teil am Ende /download

Wie erhalte ich eine Kreditmeinung?


Funktion CreditOpinionCalculator

Wie erhalte ich zusätzliche Informationen?


Funktion GetClassifiersFinancialStatements
Funktion GetActivityClassificators
Funktion GetDictionaryStandardPhrases
Funktion GetAvailableProducts

Mögliche Fehler


Diese Fehler können bei der Anfrage an unseren Webdienst auftreten.


Alle Funktionen
  • Falscher Benutzername/Kennwort oder Sie haben keine Berechtigung.
    Sie geben falsche Anmeldedaten ein oder Ihr API-Zugang ist gesperrt.

Funktion SimpleSearch
  1. Sie haben in diesem Land keine Durchsuchungserlaubnis.
    Liste der verfügbaren Länder: Finnland (FIN), Schweden (SWE)
Funktion Order
  1. Dieses Produkt ist nicht verfügbar.
    Ein solches Produkt kann nicht gefunden werden und kann auch nicht bestellt werden.
  2. Sie können keinen Bericht über ein Unternehmen mit Rechtsform bestellen: "rechts_form"
    Dieser Fehler gilt nur für: Schweden (SWE)
    In Schweden ist es nicht möglich, einen Online-Bericht (delivery_term = "o") mit den folgenden Rechtsformen zu bestellen:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Dieses Unternehmen ist nicht in der Testliste enthalten.
    Die Unternehmensregistrierungsnummer ist nicht in unserer Testliste enthalten.
    Liste der verfügbaren Unternehmen für ein Testkonto:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Geschäftsname oder Reg-Code ist erforderlich
    Bei der Bestellung von Offline-Berichten (delivery_term = "n", "f" oder "s") ist "Business Name" oder "Reg Code" erforderlich.
  5. Reg Code ist erforderlich, wenn die Lieferfrist Online ist
    Bei der Bestellung von Online-Berichten (delivery_term = "o") ist der "Reg Code" erforderlich.

Funktion GetReport
  1. Diese Sprache wird nicht unterstützt.
    Liste der verfügbaren Sprachen für Online-Berichte: en (English), et (Estonian), ru (Russian), de (German)

Funktionen GetReport ChkStatus
  1. Falsche order_id.
    Die Bestell-ID kann nicht gefunden werden. Sie erhalten die Auftrags-ID, wenn Sie die Funktion Order verwenden.

Funktion OrderCancellation
  1. Your order is already canceled.
    Sie haben nicht mehr die Erlaubnis, die Bestellung zu stornieren.

Funktion OrderConfirmation
  1. Sie haben nicht mehr die Erlaubnis, die Bestellung zu bestätigen. Die Bestätigung kann innerhalb einer Stunde nach Erhalt der "order_id" erfolgen.

SOAP (Version 3) Änderungen im Vergleich zu SOAP (Version 2)


SOAP (Version 3) Änderungen im Vergleich zu SOAP (Version 2) [Übersicht]

1) Neue Funktion: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Funktion: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- Each time you place an request we asaign a new 'search_result_id' for each company. You need to use this 'search_result_id' to place online orders.

Also you can place offline (delivery_term = 'n', 'f' or 's') orders with 'search_result_id', if you desire.

3) Funktion: Order
Identification is required!

Um eine Online-Bestellung aufzugeben, müssen Sie 'search_result_id' von der Funktion 'SimpleSearch' erhalten, und erst dann können Sie eine Online-Bestellung (delivery_term = 'o') aufgeben.

- Änderungen in der Liste der verfügbaren Länder für Online-Kreditauskünfte: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Verfügbar zum Herunterladen von Jahresabschlüssen (über Produkt: Finanzen) im Online-Modus: Estonia (EST), Sweden (SWE)

3) Funktion: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


SOAP (Version 3) Änderungen im Vergleich zu SOAP (Version 2) [WSDL and XSD]

File: report.xsd

Neue Elemente:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Neue Funktion:

- ChkFinance

Function that allows you to search for available financial statements.

NB: This function is only needed when ordering a product: finances (Financial statements) with delivery_term = 'o'.
File: order.xsd

1) OrderReportRequest has a choice:

- order_details:

Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info

NB:
* Business Name or Registration Code is required
* Only for orders with delivery_term: 'n', 'f' and 's' (credit reports in offline mode)

- order_details_by_id:

Using 'search_result_id'

NB:
* 'search_result_id' can be obtained with function: 'SimpleSearch'
* each new search generates new 'search_result_id'

2) order_details

Neues Element:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Entferntes Element:

search_block.reg_code

Neues Element:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Entfernte Elemente

- code

Neue Elemente:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form