Documentation de l'API d'Infoproff - v4

Version du commutateur V4

Pour commencer

Les schémas et le wsdl du service web se trouvent ici:

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 - Recherchez des informations sur les entreprises dans différents pays.
  • ChkFinance - Rechercher les états financiers disponibles.
  • Order - Crée un order_id et renvoie les doublons. Les doublons sont sélectionnés par les paramètres suivants : country, product, reg_code.
  • OrderCancellation - Si vous avez envoyé une demande de commande et reçu le site order_id, vous avez la possibilité d'annuler cette commande (si elle n'est pas entrée en production).
  • OrderConfirmation - Après avoir obtenu order_id, vous devrez confirmer votre commande dans un délai d'une heure. Si vous ne confirmez pas votre commande dans l'heure qui suit, la commande sera automatiquement annulée.
  • ChkStatus - Vérifiez l'état de la commande.
  • GetReport - Obtenez des rapports finis.
  • GetClassifiersFinancialStatements - Obtenez tous les documents financiers avec tous les éléments : row_number, row_formated_description, row_lang_key et row_order.
  • GetLegalForms - Obtenez tous les formulaires légaux pour tous les pays disponibles.
  • GetActivityClassificators - Obtenez tous les codes et descriptions pour le classificateur d'activité spécifique.
  • GetDictionaryStandardPhrases - Obtenez toutes les phrases standard avec les clés et la langue.
  • GetAvailableProducts - Obtenez une liste des produits disponibles.
  • CreditOpinionCalculator - Le calculateur d'opinion de crédit permet d'attribuer une opinion de crédit à une entreprise.

L'API fournit plusieurs services :

  1. Rapports de crédit en ligne pour les pays suivants : République de Finlande (FIN), Royaume de Suède (SWE), Royaume de Belgique (BEL), Royaume des Pays-Bas (NLD), République d'Estonie (EST), République du Kazakhstan (KAZ), République de Pologne (POL), République du Kirghizistan (KGZ), République populaire de Chine (CHN), Mongolie (MNG)
  2. Rapports hors ligne pour les pays suivants : Tous les pays
  3. Calculateur d'avis de crédit

Comment rechercher une entreprise ?

La recherche d'entreprise comprend 2 options:

  1. Recherche par nom de société,
  2. Search by company code.
Liste des pays disponibles: Bosnie-Herzégovine (BIH), Canada (CAN), Collectivité de Saint Martin (MAF), Commonwealth d'Australie (AUS), Confédération suisse (CHE), Côte d'Ivoire (CIV), Fédération de Russie (RUS), Grand-Duché de Luxembourg (LUX), Groenland (GRL), Guadeloupe (GLP), Guyane française (GUF), Géorgie (GEO), Hong Kong (HKG), Irlande (IRL), Japon (JPN), Kosovo (XXK), Le bailliage de Jersey (JEY), Martinique (MTQ), Mayotte (MYT), Mongolie (MNG), Nouvelle-Zélande (NZL), Principauté de Monaco (MCO), Principauté du Liechtenstein (LIE), Roumanie (ROU), Royaume d'Espagne (ESP), Royaume de Belgique (BEL), Royaume de Norvège (NOR), Royaume de Suède (SWE), Royaume de Thaïlande (THA), Royaume des Pays-Bas (NLD), Royaume du Danemark (DNK), Royaume du Maroc (MAR), Royaume-Uni de Grande-Bretagne et d'Irlande du Nord (GBR), République algérienne démocratique et populaire (DZA), République argentine (ARG), République bolivarienne du Venezuela (VEN), République coopérative de Guyane (GUY), République d'Afrique du Sud (ZAF), République d'Albanie (ALB), République d'Angola (AGO), République d'Autriche (AUT), République d'Azerbaïdjan (AZE), République d'Estonie (EST), République d'Islande (ISL), République d'Ouzbékistan (UZB), République de Bulgarie (BGR), République de Chine (TWN), République de Chypre (CYP), République de Croatie (HRV), République de Finlande (FIN), République de Gambie (GMB), République de Guinée (GIN), République de Hongrie (HUN), République de Lettonie (LVA), République de Lituanie (LTU), République de Madagascar (MDG), République de Malte (MLT), République de Maurice (MUS), République de Moldavie (MDA), République de Namibie (NAM), République de Pologne (POL), République de Saint-Marin (SMR), République de Serbie (SRB), République de Singapour (SGP), République de Slovénie (SVN), République de Zambie (ZMB), République de l'Équateur (ECU), République des Maldives (MDV), République des Philippines (PHL), République des Seychelles (SYC), République du Belarus (BLR), République du Botswana (BWA), République du Bénin (BEN), République du Chili (CHL), République du Congo (COG), République du Kazakhstan (KAZ), République du Kenya (KEN), République du Kirghizistan (KGZ), République du Paraguay (PRY), République du Pérou (PER), République du Rwanda (RWA), République du Tadjikistan (TJK), République du Zimbabwe (ZWE), République française (FRA), République fédérale d'Allemagne (DEU), République fédérale du Nigeria (NGA), République fédérale démocratique d'Éthiopie (ETH), République fédérative du Brésil (BRA), République hellénique (GRC), République italienne (ITA), République orientale de l'Uruguay (URY), République populaire de Chine (CHN), République portugaise (PRT), République slovaque (SVK), République socialiste démocratique de Sri Lanka (LKA), République tchèque (CZE), République togolaise (TGO), République-Unie de Tanzanie (TZA), Réunion (REU), État d'Israël (ISR), État indépendant de Samoa (WSM), État plurinational de Bolivie (BOL), Île de Man (IMN)

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.

Informations importantes:

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.

Le registre norvégien ne permet pas de rechercher les sociétés supprimées par nom. Par conséquent, nous ne pouvons pas fournir une adresse SimpleSearch par noms dans les entreprises supprimées en Norvège.

Field's length:
company_name varchar(512)
company_code varchar(64)

Vous trouverez ci-dessous l'exemple:

Fonction SimpleSearch

Option 2 : Recherche par code d'enregistrement

Fonction SimpleSearch

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

Fonction UnifiedSearch

Comment commander un dossier de crédit ?

List of available countries for online credit reports: Confédération suisse (CHE), Fédération de Russie (RUS), Grand-Duché de Luxembourg (LUX), Irlande (IRL), Mongolie (MNG), Royaume d'Espagne (ESP), Royaume de Belgique (BEL), Royaume de Norvège (NOR), Royaume de Suède (SWE), Royaume des Pays-Bas (NLD), Royaume du Danemark (DNK), Royaume-Uni de Grande-Bretagne et d'Irlande du Nord (GBR), République d'Autriche (AUT), République d'Azerbaïdjan (AZE), République d'Estonie (EST), République de Bulgarie (BGR), République de Croatie (HRV), République de Finlande (FIN), République de Hongrie (HUN), République de Lettonie (LVA), République de Malte (MLT), République de Moldavie (MDA), République de Pologne (POL), République de Slovénie (SVN), République du Kazakhstan (KAZ), République du Kirghizistan (KGZ), République française (FRA), République fédérale d'Allemagne (DEU), République hellénique (GRC), République italienne (ITA), République populaire de Chine (CHN), République portugaise (PRT), République slovaque (SVK), République tchèque (CZE)
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))

Fonction SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Comment rechercher une entreprise ?

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))

Fonction 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))

Fonction 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))

Fonction 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))

Fonction 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.

Les statuts suivants sont utilisés pour les rapports:

  • En cours - Rapport au stade de la production
  • Identification pending - Préparation du rapport en attente. Nécessite des données supplémentaires de la part du client.
  • Canceled - Commande annulée
  • Finished - Le rapport est prêt
  • Updated - Des informations ont été ajoutées au rapport final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Une erreur technique s'est produite dans notre système. Cela signifie que nous sommes informés de cette erreur et que nous la corrigerons dès que possible. Vous serez informé quand vous pourrez recevoir la commande.

Si le statut d'exécution est Finished ou Updated, alors vous pouvez obtenir un ordre.

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

Fonction GetReport
Liste des langues disponibles: ar (Arabic), bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), he (Hebrew), hu (Hongrois), id (Indonésien), it (Italien), ja (Japonais), ko (Coréen), lt (Lituanien), lv (Letton), nb (Norvégien Bokmål), nl (Néerlandais), pl (Polonais), pt (Portugais), ro (Roumain), ru (Russe), sk (Slovaque), sl (Slovène), sr (Српски), sv (Suédois), th (Thai), tr (Turc), uk (Ukrainien), vi (Vietnamese), zh (Chinois)

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

Fonction 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))

Fonction 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))

Fonction 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))

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

Les statuts suivants sont utilisés pour les rapports:

  • En cours - Rapport au stade de la production
  • Identification pending - Préparation du rapport en attente. Nécessite des données supplémentaires de la part du client.
  • Canceled - Commande annulée
  • Finished - Le rapport est prêt
  • Updated - Des informations ont été ajoutées au rapport final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Une erreur technique s'est produite dans notre système. Cela signifie que nous sommes informés de cette erreur et que nous la corrigerons dès que possible. Vous serez informé quand vous pourrez recevoir la commande.

Si le statut d'exécution est Finished ou Updated, alors vous pouvez obtenir un ordre.

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

Fonction GetReport
Liste des langues disponibles: ar (Arabic), bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), he (Hebrew), hu (Hongrois), id (Indonésien), it (Italien), ja (Japonais), ko (Coréen), lt (Lituanien), lv (Letton), nb (Norvégien Bokmål), nl (Néerlandais), pl (Polonais), pt (Portugais), ro (Roumain), ru (Russe), sk (Slovaque), sl (Slovène), sr (Српски), sv (Suédois), th (Thai), tr (Turc), uk (Ukrainien), vi (Vietnamese), zh (Chinois)

Comment commander un dossier de crédit archivé ?

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

Fonction 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: Comment rechercher une entreprise ?

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

Fonction 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.

Comment commander des états financiers en ligne ?

STEP 1: Find a company

Fonction SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Comment rechercher une entreprise ?

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: Recherche d'états financiers disponibles

Fonction ChkFinance

Cette fonction est uniquement nécessaire lors de la commande d'un produit : finances (Financial statements) avec delivery_term = 'o'.

Liste des pays disponibles: République d'Estonie (EST), Royaume de Suède (SWE)

STEP 3: Commander des états financiers

Fonction 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)

Fonction 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

Fonction 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

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

Les statuts suivants sont utilisés pour les rapports:

  • En cours - Rapport au stade de la production
  • Identification pending - Préparation du rapport en attente. Nécessite des données supplémentaires de la part du client.
  • Canceled - Commande annulée
  • Finished - Le rapport est prêt
  • Updated - Des informations ont été ajoutées au rapport final
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Une erreur technique s'est produite dans notre système. Cela signifie que nous sommes informés de cette erreur et que nous la corrigerons dès que possible. Vous serez informé quand vous pourrez recevoir la commande.

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

Fonction GetReport
Liste des langues disponibles: ar (Arabic), bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), he (Hebrew), hu (Hongrois), id (Indonésien), it (Italien), ja (Japonais), ko (Coréen), lt (Lituanien), lv (Letton), nb (Norvégien Bokmål), nl (Néerlandais), pl (Polonais), pt (Portugais), ro (Roumain), ru (Russe), sk (Slovaque), sl (Slovène), sr (Српски), sv (Suédois), th (Thai), tr (Turc), uk (Ukrainien), vi (Vietnamese), zh (Chinois)
To see the examples of xml request/response, please follow the link: How to get finished order?

Comment télécharger des rapports standard (dans des formats autres que XML) ?

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.

La demande se compose de 3 parties :

  1. Partie fixe https://www.infoproff.com/en/orders/files/
  2. Votre code d'accès unique, que nous fournissons en réponse à votre demande
  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 (pas d'échange), 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

Comment télécharger des produits non standard ?

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.

La demande se compose de 3 parties :

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Votre code d'accès unique, que nous fournissons en réponse à votre demande
  3. Et la partie fixe à la fin /download

Comment obtenir un avis de crédit ?

Fonction CreditOpinionCalculator

Comment obtenir des informations supplémentaires ?

Fonction GetClassifiersFinancialStatements
Fonction GetActivityClassificators
Fonction GetDictionaryStandardPhrases
Fonction GetAvailableProducts

delivery_term:

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

Erreurs possibles

Ces erreurs peuvent se produire lors de l'envoi d'une demande à notre service web..

Toutes les fonctions
  • Incorrect username/password or you have no permissions.
    Vous avez saisi des informations d'identification erronées ou votre accès à l'API est bloqué.
Fonction SimpleSearch
  1. You don't have permissions to search in this country.
    Liste des pays disponibles: Bosnie-Herzégovine (BIH), Canada (CAN), Collectivité de Saint Martin (MAF), Commonwealth d'Australie (AUS), Confédération suisse (CHE), Côte d'Ivoire (CIV), Fédération de Russie (RUS), Grand-Duché de Luxembourg (LUX), Groenland (GRL), Guadeloupe (GLP), Guyane française (GUF), Géorgie (GEO), Hong Kong (HKG), Irlande (IRL), Japon (JPN), Kosovo (XXK), Le bailliage de Jersey (JEY), Martinique (MTQ), Mayotte (MYT), Mongolie (MNG), Nouvelle-Zélande (NZL), Principauté de Monaco (MCO), Principauté du Liechtenstein (LIE), Roumanie (ROU), Royaume d'Espagne (ESP), Royaume de Belgique (BEL), Royaume de Norvège (NOR), Royaume de Suède (SWE), Royaume de Thaïlande (THA), Royaume des Pays-Bas (NLD), Royaume du Danemark (DNK), Royaume du Maroc (MAR), Royaume-Uni de Grande-Bretagne et d'Irlande du Nord (GBR), République algérienne démocratique et populaire (DZA), République argentine (ARG), République bolivarienne du Venezuela (VEN), République coopérative de Guyane (GUY), République d'Afrique du Sud (ZAF), République d'Albanie (ALB), République d'Angola (AGO), République d'Autriche (AUT), République d'Azerbaïdjan (AZE), République d'Estonie (EST), République d'Islande (ISL), République d'Ouzbékistan (UZB), République de Bulgarie (BGR), République de Chine (TWN), République de Chypre (CYP), République de Croatie (HRV), République de Finlande (FIN), République de Gambie (GMB), République de Guinée (GIN), République de Hongrie (HUN), République de Lettonie (LVA), République de Lituanie (LTU), République de Madagascar (MDG), République de Malte (MLT), République de Maurice (MUS), République de Moldavie (MDA), République de Namibie (NAM), République de Pologne (POL), République de Saint-Marin (SMR), République de Serbie (SRB), République de Singapour (SGP), République de Slovénie (SVN), République de Zambie (ZMB), République de l'Équateur (ECU), République des Maldives (MDV), République des Philippines (PHL), République des Seychelles (SYC), République du Belarus (BLR), République du Botswana (BWA), République du Bénin (BEN), République du Chili (CHL), République du Congo (COG), République du Kazakhstan (KAZ), République du Kenya (KEN), République du Kirghizistan (KGZ), République du Paraguay (PRY), République du Pérou (PER), République du Rwanda (RWA), République du Tadjikistan (TJK), République du Zimbabwe (ZWE), République française (FRA), République fédérale d'Allemagne (DEU), République fédérale du Nigeria (NGA), République fédérale démocratique d'Éthiopie (ETH), République fédérative du Brésil (BRA), République hellénique (GRC), République italienne (ITA), République orientale de l'Uruguay (URY), République populaire de Chine (CHN), République portugaise (PRT), République slovaque (SVK), République socialiste démocratique de Sri Lanka (LKA), République tchèque (CZE), République togolaise (TGO), République-Unie de Tanzanie (TZA), Réunion (REU), État d'Israël (ISR), État indépendant de Samoa (WSM), État plurinational de Bolivie (BOL), Île de Man (IMN)
Fonction Order
  1. This product is not available.
    Ce produit est introuvable et il n'est pas possible de le commander.
  2. You can't order report on company with legal form: "legal_form"
    Cette erreur ne s'applique qu'aux: Royaume de Suède (SWE)
    En Suède, il n'est pas possible de commander un rapport en ligne (delivery_term = "o") avec les formulaires juridiques suivants :
    • 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
    Lorsque vous commandez un rapport hors ligne (delivery_term = "n", "f" ou "s"), le "nom de l'entreprise" ou le "code d'enregistrement" est obligatoire.
  5. Reg Code is required when delivery term is Online
    Lorsque vous commandez un rapport en ligne (delivery_term = "o"), le "Reg Code" est requis.
Fonction GetReport
  1. This language is not supported.
    Liste des langues disponibles pour les rapports en ligne: ar (Arabic), bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), he (Hebrew), hu (Hongrois), id (Indonésien), it (Italien), ja (Japonais), ko (Coréen), lt (Lituanien), lv (Letton), nb (Norvégien Bokmål), nl (Néerlandais), pl (Polonais), pt (Portugais), ro (Roumain), ru (Russe), sk (Slovaque), sl (Slovène), sr (Српски), sv (Suédois), th (Thai), tr (Turc), uk (Ukrainien), vi (Vietnamese), zh (Chinois)
Fonctions GetReport ChkStatus
  1. Incorrect order_id.
    L'ID de la commande est introuvable. Vous obtenez l'ID de la commande lorsque vous utilisez la fonction Order.
Fonction OrderCancellation
  1. Your order is already canceled.
    Vous n'avez plus la permission d'annuler la commande.
Fonction OrderConfirmation
  1. You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Modifications apportées à SOAP (version 4) par rapport à SOAP (version 3)

Nouvelles sections

  • country_economic_overview — comprend les sous-sections suivantes : data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informations sur les taxes payées.
  • tenders — informations sur les appels d'offres.
  • sanctions — ajoutées à la section negative_information.

Mises à jour des sections existantes

Dans les sections beneficiaries, shareholders, managers et employees_data, l'élément suivant a été ajouté :
  • source_type — type de source de données (par exemple, official, mass_media, company_admin, etc.).
Dans la section relations_of_persons, un nouvel élément a été ajouté :
  • match_type
La section capital a été restructurée :
  • L'élément « capital_amount » a été renommé « issued_capital ».
  • Les nouveaux éléments suivants ont été ajoutés :
    • number_of_shares
    • share_value
    • authorized_capital
Dans la section « employees_data » :
  • Le nouvel élément « group_figure » indique si les données comprennent des chiffres agrégés au niveau du groupe (true).
  • L'élément source_type spécifie le type de source des données.
  • L'élément is_estimated n'est désormais inclus que si sa valeur est true.
Nouvelle section assets_data — regroupe les sections existantes :
  • real_estate_data (anciennement nommée property_data), vehicles, machinery_and_equipment (anciennement nommée assets).
  • Ajouts prévus : patents et biological_assets.
Dans la section vehicles, un nouveau champ a été ajouté :
  • value
Dans la section litigations, les éléments suivants ont été ajoutés :
  • content, instance, process, authority
Dans financial_statement/positions et summary/latest_turnovers, un nouvel élément a été ajouté :
  • value_origin — décrit l'origine de la valeur ; par exemple, la valeur estimated - cette valeur est estimée et calculée à partir des données disponibles à l'aide d'une logique ou d'une IA.
Dans la section branches_data, les champs suivants ont été ajoutés :
  • registration_number
  • director_name

Remarque : des améliorations et des ajustements mineurs peuvent encore être apportés pendant la phase de stabilisation.

Webhooks Settings

Vue d'ensemble

Un webhook est un moyen pour une application de fournir à d'autres applications des informations en temps réel. Notre fonction "webhook" met en œuvre des rappels HTTP configurés avec une URL. Une charge utile HTTP POST est envoyée à cette URL au format JSON chaque fois qu'un événement spécifié se produit. Dans le cadre de notre projet, nous avons conçu la fonction webhook pour déclencher des événements spécifiques.

Mise en place d'un Webhook

Pour configurer un webhook pour votre application, accédez à la page des paramètres de l'application et recherchez la section "Paramètres des webhooks". Fournissez les informations suivantes :

  1. "URL du webhook" est l'URL où votre serveur recevra les requêtes POST du webhook.
  2. "Delivery max attempts" est le paramètre qui définit le nombre maximum de tentatives à effectuer pour livrer un événement webhook lorsque la première tentative de livraison a échoué.
  3. Le paramètre "Delivery retry timeout" permet de spécifier l'intervalle de temps entre les tentatives lorsqu'une tentative de livraison d'un webhook échoue.

Après avoir fourni ces informations, cliquez sur "Enregistrer".

Types d'événements Webhook

  1. Nouvel état de la commande

Charge utile du webhook

Lorsqu'un événement se produit, nous envoyons une requête HTTP POST à l'URL de la charge utile avec un corps JSON contenant des informations sur l'événement.

Voici un exemple de charge utile :
Exemple de charge utile du nouveau statut de la commande
Valeurs possibles du champ "new_status":
  • "Finished" - une commande est complète. Une commande peut être retirée;
  • "Updated" - une commande mise à jour, des données ajoutées à une commande terminée;
  • "Canceled" - une commande est annulée à la demande (ou avec l'accord) du client;
  • "Rejected" - une commande est rejetée. Généralement parce qu'il est impossible d'identifier une entreprise.
  • "Identification pending" - Nous avons besoin de plus d'informations de la part du client avant de pouvoir préparer une commande..

Sécuriser vos Webhooks

Il est important de vérifier que les requêtes POST envoyées à l'URL de la charge utile proviennent bien de notre application. Pour ce faire, chaque demande de webhook comprend un en-tête X-Signature.

Signature Description

Pour la signature, nous utilisons l'algorithme HMAC avec SHA512.

Secret est une concaténation de l'identifiant de l'application et de la clé secrète provenant des paramètres des webhooks.

Il est possible d'ajouter vos propres paramètres get au point de terminaison pour identifier l'expéditeur si nécessaire.

Dépannage

Le serveur doit répondre dans les 10 secondes et renvoyer un code HTTP 2XX ; dans le cas contraire, la livraison du webhook est considérée comme ayant échoué. En cas d'échec, la fonctionnalité tentera de renvoyer la demande vers le haut conformément à la politique de livraison.