Infoproff API-Dokumentation - v4

Switch-Version V4

Erste Schritte

Webdienst-Wsdl und Schemata befinden sich hier:

https://wsdfn.infoproff.com/v4/

Postman Collection (API v4) — Ready for Use:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

Web service functions:

  • SimpleSearch - Suche nach Unternehmensinformationen in verschiedenen Ländern.
  • ChkFinance - Suche nach verfügbaren Jahresabschlüssen.
  • Order - Erzeugt eine order_id und gibt Duplikate zurück. Die Duplikate werden nach folgenden Parametern ausgewählt: country, product, 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), Belgien (BEL), Niederlande (NLD), Estland (EST), Kazakhstan (KAZ), Poland (POL), Kyrgyzstan (KGZ), China (CHN), Mongolia (MNG)
  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. Search by company code.
Liste der verfügbaren Länder: Albania (ALB), Algeria (DZA), Angola (AGO), Argentina (ARG), Australia (AUS), Austria (AUT), Azerbaijan (AZE), Belarus (BLR), Belgien (BEL), Benin (BEN), Bolivia (BOL), Bosnia and Herzegovina (BIH), Botswana (BWA), Brazil (BRA), Bulgaria (BGR), Canada (CAN), Chile (CHL), China (CHN), Congo (COG), Croatia (HRV), Cyprus (CYP), Czech Republic (CZE), Denmark (DNK), Ecuador (ECU), Elfenbeinküste (CIV), Estland (EST), Ethiopia (ETH), Finnland (FIN), France (FRA), French Guiana (GUF), Gambia (GMB), Georgia (GEO), Germany (DEU), Greece (GRC), Greenland (GRL), Guadeloupe (GLP), Guinea (GIN), Guyana (GUY), Hong Kong (HKG), Hungary (HUN), Iceland (ISL), Ireland (IRL), Isle of Man (IMN), Israel (ISR), Italy (ITA), Japan (JPN), Jersey (JEY), Kazakhstan (KAZ), Kenya (KEN), Kosovo (XXK), Kyrgyzstan (KGZ), Latvia (LVA), Liechtenstein (LIE), Lithuania (LTU), Luxembourg (LUX), Madagascar (MDG), Maldives (MDV), Malta (MLT), Martinique (MTQ), Mauritius (MUS), Mayotte (MYT), Moldava (MDA), Monaco (MCO), Mongolia (MNG), Morocco (MAR), Namibia (NAM), New Zealand (NZL), Niederlande (NLD), Nigeria (NGA), Norway (NOR), Paraguay (PRY), Peru (PER), Philippines (PHL), Poland (POL), Portugal (PRT), Reunion (REU), Romania (ROU), Russia (RUS), Rwanda (RWA), Saint Martin (MAF), Samoa (WSM), San Marino (SMR), Schweden (SWE), Serbia (SRB), Seychelles (SYC), Singapore (SGP), Slovakia (SVK), Slovenia (SVN), South Africa (ZAF), Spain (ESP), Sri Lanka (LKA), Switzerland (CHE), Taiwan (TWN), Tajikistan (TJK), Tanzania (TZA), Thailand (THA), Togo (TGO), United Kingdom (GBR), Uruguay (URY), Uzbekistan (UZB), Venezuela (VEN), Zambia (ZMB), Zimbabwe (ZWE)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

Wichtige Informationen:

search_result_id can be acquired here for orders with delivery_term = "o" or delivery_term = "a".

It may take up to 20 seconds to respond to a search request in the following countries: United Kingdom, Ireland, France, Spain, Portugal, Germany, Italy, Austria, Switzerland.

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

Option 3: Search by query (by name or code)

Funktion UnifiedSearch

Wie bestelle ich eine Kreditauskunft?

List of available countries for online credit reports: Austria (AUT), Azerbaijan (AZE), Belgien (BEL), Bulgaria (BGR), China (CHN), Croatia (HRV), Czech Republic (CZE), Denmark (DNK), Estland (EST), Finnland (FIN), France (FRA), Germany (DEU), Greece (GRC), Hungary (HUN), Ireland (IRL), Italy (ITA), Kazakhstan (KAZ), Kyrgyzstan (KGZ), Latvia (LVA), Luxembourg (LUX), Malta (MLT), Moldava (MDA), Mongolia (MNG), Niederlande (NLD), Norway (NOR), Poland (POL), Portugal (PRT), Russia (RUS), Schweden (SWE), Slovakia (SVK), Slovenia (SVN), Spain (ESP), Switzerland (CHE), United Kingdom (GBR)
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)

Below you can find the example of how to order and download reports:

STEP 1: Find a company (Online/Offline Order (with search_result_id))

Funktion SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Wie sucht man nach einem Unternehmen?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Order a report (Online/Offline Order (with search_result_id))

Funktion Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 3: Order cancellation (Optional) (Online/Offline Order (with search_result_id))

Funktion OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 4: Order confirmation (Online/Offline Order (with search_result_id))

Funktion OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 5: Check order status (Online/Offline Order (with search_result_id))

Funktion ChkStatus
  • - For offline orders checking order status once every 30 minutes is acceptable frequency.
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Die folgenden Status werden für Berichte verwendet:

  • In Bearbeitung - Bericht in der Produktionsphase
  • Identification pending - Die Erstellung des Berichts ist in der Warteschleife. Erfordert zusätzliche Daten vom Kunden.
  • 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.

STEP 6: Get report (Online/Offline Order (with search_result_id))

Funktion GetReport
Liste der verfügbaren Sprachen: ar (Arabic), bg (Bulgarisch), cs (Tschechisch), da (Dänisch), de (Deutsch), el (Griechisch), en (Englisch), es (Spanisch), et (Estländisch), fi (Finnisch), fr (Französisch), he (Hebrew), hu (Ungarisch), id (Indonesisch), it (Italienisch), ja (Japanisch), ko (Koreanisch), lt (Litauisch), lv (Lettisch), nb (Norwegisch Bokmål), nl (Niederländisch), pl (Polnisch), pt (Portugiesisch), ro (Rumänisch), ru (Russisch), sk (Slowakisch), sl (Slowenisch), sr (Српски), sv (Schwedisch), th (Thai), tr (Türkisch), uk (Ukrainisch), vi (Vietnamese), zh (Chinesisch)

STEP 1: Order a report (Offline Order (without search_result_id))

Funktion Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 2: Order cancellation (Optional) (Offline Order (without search_result_id))

Funktion OrderCancellation
If you wish to cancel the order, you can use OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.

STEP 3: Order confirmation (Offline Order (without search_result_id))

Funktion OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.

STEP 4: Status Checking (Offline Order (without search_result_id))

Funktion ChkStatus
For offline orders checking order status once every 30 minutes is acceptable frequency.

Die folgenden Status werden für Berichte verwendet:

  • In Bearbeitung - Bericht in der Produktionsphase
  • Identification pending - Die Erstellung des Berichts ist in der Warteschleife. Erfordert zusätzliche Daten vom Kunden.
  • 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.

STEP 5: Get report (Offline Order (without search_result_id))

Funktion GetReport
Liste der verfügbaren Sprachen: ar (Arabic), bg (Bulgarisch), cs (Tschechisch), da (Dänisch), de (Deutsch), el (Griechisch), en (Englisch), es (Spanisch), et (Estländisch), fi (Finnisch), fr (Französisch), he (Hebrew), hu (Ungarisch), id (Indonesisch), it (Italienisch), ja (Japanisch), ko (Koreanisch), lt (Litauisch), lv (Lettisch), nb (Norwegisch Bokmål), nl (Niederländisch), pl (Polnisch), pt (Portugiesisch), ro (Rumänisch), ru (Russisch), sk (Slowakisch), sl (Slowenisch), sr (Српски), sv (Schwedisch), th (Thai), tr (Türkisch), uk (Ukrainisch), vi (Vietnamese), zh (Chinesisch)

Wie kann ich einen archivierten Kreditbericht bestellen?

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

Funktion SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: Wie sucht man nach einem Unternehmen?

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

Funktion Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

Wie bestelle ich online Finanzausweise?

STEP 1: Find a company

Funktion SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Wie sucht man nach einem Unternehmen?

The search allows you to accurately identify the company you wish to place an order for. For example, in some countries, there may be several companies with one registration number, or the same official name may belong to several companies.

STEP 2: Suche nach verfügbaren Jahresabschlüssen

Funktion ChkFinance

Diese Funktion wird nur bei der Bestellung eines Produkts benötigt: finances (Financial statements) mit delivery_term = 'o'.

Liste der verfügbaren Länder: Estland (EST), Schweden (SWE)

STEP 3: Bestellung von Jahresabschlüssen

Funktion Order
If you won't use the element confirm_order, then you will receive <last_duplicates> in the XML response, so that you can decide if you really need to place an order.

STEP 4: Order cancellation (Optional)

Funktion OrderCancellation
If you wish to cancel the order, you can use this OrderCancellation function. If the order is already in progress, then you won't be able to cancel it.
To see the examples of xml request/response, please follow the link: How to cancel the order?

STEP 5: Order confirmation

Funktion OrderConfirmation
If you didn't use the element "confirm_order", then you need to confirm your order.
To see the examples of xml request/response, please follow the link: How to confirm the order?

STEP 6: Check order status

Funktion ChkStatus
  • - For online orders checking order status once every 5 seconds is acceptable frequency.

Die folgenden Status werden für Berichte verwendet:

  • In Bearbeitung - Bericht in der Produktionsphase
  • Identification pending - Die Erstellung des Berichts ist in der Warteschleife. Erfordert zusätzliche Daten vom Kunden.
  • 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.

If the execution status is Finished or Updated, then you can get an order.

To see the examples of xml request/response, please follow the link: How to check order status?

STEP 7: Get report

Funktion GetReport
Liste der verfügbaren Sprachen: ar (Arabic), bg (Bulgarisch), cs (Tschechisch), da (Dänisch), de (Deutsch), el (Griechisch), en (Englisch), es (Spanisch), et (Estländisch), fi (Finnisch), fr (Französisch), he (Hebrew), hu (Ungarisch), id (Indonesisch), it (Italienisch), ja (Japanisch), ko (Koreanisch), lt (Litauisch), lv (Lettisch), nb (Norwegisch Bokmål), nl (Niederländisch), pl (Polnisch), pt (Portugiesisch), ro (Rumänisch), ru (Russisch), sk (Slowakisch), sl (Slowenisch), sr (Српски), sv (Schwedisch), th (Thai), tr (Türkisch), uk (Ukrainisch), vi (Vietnamese), zh (Chinesisch)
To see the examples of xml request/response, please follow the link: How to get finished order?

Wie kann man Standardberichte (in anderen Formaten als XML) herunterladen?

Types of standard product: Basic Report, Mini Report, Linkages, Registration Data Report, Full report (private person), Short report (private person), Full report (with research), Financials (bank), Short Report, Real estate ownership search, Extended report, Full Report, KYC Report, Linked persons, Credit Opinion, Financial statements.

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. And fixed part at the end /report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf&currency_position=left&preferred_currency=EUR
lang: en, et, ru, lv, ar, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, vi, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Original (kein Umtausch), EUR, USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, RUB, SEK, SGD, THB, TRY, ZAR

Wie kann ich nicht standardisierte Produkte herunterladen?

Types of non-standard product: Marketing database (special offer), Site visit - non-capital city, Extract from registry, Site visit - capital city, Due Diligence, non-standard, Shareholder document, Memorandum of Association, Certificate of incorporation.

Der Antrag besteht aus 3 Teilen:

  1. Fixed part 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

delivery_term:

  1. "o" = "Online"
  2. "n" = "Normal"
  3. "f" = "Flash"
  4. "s" = "SuperFlash"

Mögliche Fehler

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

Alle Funktionen
  • Incorrect username/password or you have no permissions.
    Sie geben falsche Anmeldedaten ein oder Ihr API-Zugang ist gesperrt.
Funktion SimpleSearch
  1. You don't have permissions to search in this country.
    Liste der verfügbaren Länder: Albania (ALB), Algeria (DZA), Angola (AGO), Argentina (ARG), Australia (AUS), Austria (AUT), Azerbaijan (AZE), Belarus (BLR), Belgien (BEL), Benin (BEN), Bolivia (BOL), Bosnia and Herzegovina (BIH), Botswana (BWA), Brazil (BRA), Bulgaria (BGR), Canada (CAN), Chile (CHL), China (CHN), Congo (COG), Croatia (HRV), Cyprus (CYP), Czech Republic (CZE), Denmark (DNK), Ecuador (ECU), Elfenbeinküste (CIV), Estland (EST), Ethiopia (ETH), Finnland (FIN), France (FRA), French Guiana (GUF), Gambia (GMB), Georgia (GEO), Germany (DEU), Greece (GRC), Greenland (GRL), Guadeloupe (GLP), Guinea (GIN), Guyana (GUY), Hong Kong (HKG), Hungary (HUN), Iceland (ISL), Ireland (IRL), Isle of Man (IMN), Israel (ISR), Italy (ITA), Japan (JPN), Jersey (JEY), Kazakhstan (KAZ), Kenya (KEN), Kosovo (XXK), Kyrgyzstan (KGZ), Latvia (LVA), Liechtenstein (LIE), Lithuania (LTU), Luxembourg (LUX), Madagascar (MDG), Maldives (MDV), Malta (MLT), Martinique (MTQ), Mauritius (MUS), Mayotte (MYT), Moldava (MDA), Monaco (MCO), Mongolia (MNG), Morocco (MAR), Namibia (NAM), New Zealand (NZL), Niederlande (NLD), Nigeria (NGA), Norway (NOR), Paraguay (PRY), Peru (PER), Philippines (PHL), Poland (POL), Portugal (PRT), Reunion (REU), Romania (ROU), Russia (RUS), Rwanda (RWA), Saint Martin (MAF), Samoa (WSM), San Marino (SMR), Schweden (SWE), Serbia (SRB), Seychelles (SYC), Singapore (SGP), Slovakia (SVK), Slovenia (SVN), South Africa (ZAF), Spain (ESP), Sri Lanka (LKA), Switzerland (CHE), Taiwan (TWN), Tajikistan (TJK), Tanzania (TZA), Thailand (THA), Togo (TGO), United Kingdom (GBR), Uruguay (URY), Uzbekistan (UZB), Venezuela (VEN), Zambia (ZMB), Zimbabwe (ZWE)
Funktion Order
  1. This product is not available.
    Ein solches Produkt kann nicht gefunden werden und kann auch nicht bestellt werden.
  2. You can't order report on company with legal form: "legal_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. When delivery term is Online, please use order_details_by_id with search_result_id.
    This error only appears if you are trying to order online report without search_result_id.
    It is important yo use order_details_by_id in OrderReportRequest
  4. Business Name or Reg Code is required
    Bei der Bestellung von Offline-Berichten (delivery_term = "n", "f" oder "s") ist "Business Name" oder "Reg Code" erforderlich.
  5. Reg Code is required when delivery term is Online
    Bei der Bestellung von Online-Berichten (delivery_term = "o") ist der "Reg Code" erforderlich.
Funktion GetReport
  1. This language is not supported.
    Liste der verfügbaren Sprachen für Online-Berichte: ar (Arabic), bg (Bulgarisch), cs (Tschechisch), da (Dänisch), de (Deutsch), el (Griechisch), en (Englisch), es (Spanisch), et (Estländisch), fi (Finnisch), fr (Französisch), he (Hebrew), hu (Ungarisch), id (Indonesisch), it (Italienisch), ja (Japanisch), ko (Koreanisch), lt (Litauisch), lv (Lettisch), nb (Norwegisch Bokmål), nl (Niederländisch), pl (Polnisch), pt (Portugiesisch), ro (Rumänisch), ru (Russisch), sk (Slowakisch), sl (Slowenisch), sr (Српски), sv (Schwedisch), th (Thai), tr (Türkisch), uk (Ukrainisch), vi (Vietnamese), zh (Chinesisch)
Funktionen GetReport ChkStatus
  1. Incorrect 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. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Änderungen von SOAP (Version 4) gegenüber SOAP (Version 3)

Neue Abschnitte

  • country_economic_overview — umfasst die folgenden Unterabschnitte: „ data_transparency_index ” (Informationen über gezahlte Steuern), „ country_development_indicators ” (Informationen über gezahlte Sozialversicherungsbeiträge), „ economic_forecast ” (Informationen über gez
  • paid_taxes — Informationen zu gezahlten Steuern.
  • tenders — Informationen zu Ausschreibungen.
  • sanctions — zum Abschnitt „ negative_information ” hinzugefügt.

Aktualisierungen bestehender Abschnitte

In den Abschnitten „ beneficiaries “, „ shareholders “, „ managers “ und „ employees_data “ wurde das folgende Element hinzugefügt:
  • source_type — Art der Datenquelle (z. B. official, mass_media, company_admin usw.).
Im Abschnitt „ relations_of_persons “ wurde ein neues Element hinzugefügt:
  • match_type
Der Abschnitt „ capital “ wurde neu strukturiert:
  • Das Element „ capital_amount “ wurde in „ issued_capital “ umbenannt.
  • Die folgenden neuen Elemente wurden hinzugefügt:
    • number_of_shares
    • share_value
    • authorized_capital
Im Abschnitt „ employees_data “:
  • Das neue Element „ group_figure “ gibt an, ob die Daten aggregierte Zahlen auf Gruppenebene enthalten (true).
  • Das Element „ source_type “ gibt den Typ der Datenquelle an.
  • Das Element „ is_estimated ” wird nun nur noch aufgenommen, wenn sein Wert „ true ” lautet.
Neuer Abschnitt „ assets_data “ – fasst zuvor vorhandene Abschnitte zusammen:
  • real_estate_data (zuvor „ property_data “), „ vehicles “ und „ machinery_and_equipment “ (zuvor „ assets “).
  • Zukünftig geplant: „ patents “ und „ biological_assets “.
Im Abschnitt „ vehicles “ wurde ein neues Feld hinzugefügt:
  • value
Im Abschnitt „ litigations “ wurden die folgenden Elemente hinzugefügt:
  • content, instance, process, authority
In „ financial_statement/positions “ und „ summary/latest_turnovers “ wurde ein neues Element hinzugefügt:
  • value_origin — beschreibt die Herkunft des Werts; beispielsweise der Wert „ estimated “ – dieser Wert wird anhand verfügbarer Daten unter Verwendung von Logik oder KI geschätzt und berechnet.
Im Abschnitt „ branches_data “ wurden die folgenden Felder hinzugefügt:
  • registration_number
  • director_name

Hinweis: Während der Stabilisierungsphase können noch geringfügige Verbesserungen und Anpassungen vorgenommen werden.

Webhooks Settings

Übersicht

Ein Webhook ist eine Möglichkeit für eine Anwendung, anderen Anwendungen Echtzeitinformationen zu liefern. Unsere Webhook-Funktion implementiert HTTP-Callbacks, die mit einer URL konfiguriert werden. Eine HTTP-POST-Nutzlast wird an diese URL im JSON-Format gesendet, sobald ein bestimmtes Ereignis eintritt. Im Rahmen unseres Projekts haben wir die Webhook-Funktion so konzipiert, dass sie bestimmte Ereignisse auslöst.

Einrichten eines Webhooks

Um einen Webhook für Ihre Anwendung einzurichten, navigieren Sie zur Seite mit den Anwendungseinstellungen und suchen Sie den Abschnitt "Webhook-Einstellungen". Geben Sie die folgenden Informationen ein:

  1. "Webhook-URL" ist die URL, unter der Ihr Server Webhook-POST-Anfragen empfangen wird.
  2. "Maximale Zustellversuche" ist die Einstellung, die die maximale Anzahl von Wiederholungsversuchen für die Zustellung eines Webhook-Ereignisses festlegt, wenn der erste Zustellversuch fehlschlägt.
  3. Mit der Einstellung "Zeitüberschreitung für Wiederholungsversuche" können Sie das Zeitintervall zwischen den Wiederholungsversuchen festlegen, wenn ein Webhook-Zustellungsversuch fehlschlägt.

Nachdem Sie diese Angaben gemacht haben, klicken Sie auf "Speichern".

Webhook-Ereignistypen

  1. Neuer Status der Bestellung

Webhook-Nutzlast

Wenn ein Ereignis eintritt, senden wir eine HTTP-POST-Anfrage an die Nutzlast-URL mit einem JSON-Body, der Informationen über das Ereignis enthält.

Hier ist eine Beispiel-Nutzlast:
Payload-Beispiel für den neuen Status des Auftrags
Mögliche Werte des Feldes "new_status":
  • "Finished" - eine Bestellung abgeschlossen ist. Eine Bestellung kann abgeholt werden;
  • "Updated" - einen Auftrag aktualisiert, Daten zu einem abgeschlossenen Auftrag hinzugefügt;
  • "Canceled" - ein Auftrag wird auf Wunsch (oder mit Zustimmung) des Kunden storniert;
  • "Rejected" - ein Auftrag abgelehnt wird. In der Regel, weil es unmöglich ist, ein Unternehmen zu identifizieren.
  • "Identification pending" - Wir benötigen weitere Informationen vom Kunden, bevor wir eine Bestellung vorbereiten können..

Absicherung Ihrer Webhooks

Es ist wichtig, zu überprüfen, ob die an die Nutzlast-URL gesendeten POST-Anfragen von unserer Anwendung stammen. Zu diesem Zweck enthält jede Webhook-Anfrage einen X-Signature-Header.

Unterschrift Beschreibung

Zum Signieren verwenden wir HMAC mit SHA512-Algorithmus.

Secret ist eine Verkettung von App ID und Secret Key aus den Webhook-Einstellungen.

Es ist möglich, dem Endpunkt eigene Get-Parameter hinzuzufügen, um den Absender zu identifizieren, falls erforderlich.

Fehlersuche

Ein Server muss innerhalb von 10 Sekunden antworten und einen 2XX HTTP-Code zurückgeben; andernfalls gilt die Webhook-Zustellung als fehlgeschlagen. Im Falle eines Fehlschlags versucht die Funktion, die Anfrage gemäß den Zustellungsrichtlinien erneut zu senden.