Documentation de l'API d'Infoproff - v3

Pour commencer

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

http://wsdfn.infoproff.com/v3/

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 :

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)
Rapports hors ligne pour les pays suivants : Tous les pays
Calculateur d'avis de crédit

Comment rechercher une entreprise ?

La recherche d'entreprise comprend 2 options:

Recherche par nom de société,
Search by company code.

Liste des pays disponibles: Bosnie-Herzégovine (BIH), 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), Émirats arabes unis (ARE), É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:

Option 1 : Recherche par nom de société

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 Suède (SWE), Royaume des Pays-Bas (NLD), Royaume-Uni de Grande-Bretagne et d'Irlande du Nord (GBR), République d'Autriche (AUT), République d'Estonie (EST), République de Finlande (FIN), République de Moldavie (MDA), République de Pologne (POL), 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 italienne (ITA), République populaire de Chine (CHN), République portugaise (PRT)

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:

Online/Offline Order Example (with search_result_id)
Offline Order Example (without search_result_id)

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: bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), 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), tr (Turc), uk (Ukrainien), 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

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: bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), 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), tr (Turc), uk (Ukrainien), 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 :

Partie fixe https://www.infoproff.com/en/orders/files/

Votre code d'accès unique, que nous fournissons en réponse à votre demande

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, bg, cs, da, de, el, fi, fr, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, tr, uk, 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 :

Fixed part https://www.infoproff.com/en/orders/files/

Votre code d'accès unique, que nous fournissons en réponse à votre demande

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 GetLegalForms

Fonction GetActivityClassificators

Fonction GetDictionaryStandardPhrases

Fonction GetAvailableProducts

delivery_term:

"o" = "Online"

"n" = "Normal"

"f" = "Flash"

"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

You don't have permissions to search in this country.

Liste des pays disponibles: Bosnie-Herzégovine (BIH), 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), Émirats arabes unis (ARE), État d'Israël (ISR), État indépendant de Samoa (WSM), État plurinational de Bolivie (BOL), Île de Man (IMN)

Fonction Order

This product is not available.

Ce produit est introuvable et il n'est pas possible de le commander.

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

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

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.

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

This language is not supported.

Liste des langues disponibles pour les rapports en ligne: bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), 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), tr (Turc), uk (Ukrainien), zh (Chinois)

Fonctions GetReport ChkStatus

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

Your order is already canceled.

Vous n'avez plus la permission d'annuler la commande.

Fonction OrderConfirmation

You don't have permission to confirm the order anymore. Confirmation can be done within one hour after you recieved 'order_id'.

Changements de SOAP (version 3) par rapport à SOAP (version 2)

Changements de SOAP (version 3) par rapport à SOAP (version 2) [Overview]

1) New function: ChkFinance

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

2) Function: SimpleSearch

- Changes in list of available countries: Bosnie-Herzégovine (BIH), 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), Émirats arabes unis (ARE), État d'Israël (ISR), État indépendant de Samoa (WSM), État plurinational de Bolivie (BOL), Île de Man (IMN)

- 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) Function: Order

Identification is required!

To place an online order, you need to recieve 'search_result_id' from function 'SimpleSearch', and only after that you can place an online (delivery_term = 'o') order.

- Changes in 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 Suède (SWE), Royaume des Pays-Bas (NLD), Royaume-Uni de Grande-Bretagne et d'Irlande du Nord (GBR), République d'Autriche (AUT), République d'Estonie (EST), République de Finlande (FIN), République de Moldavie (MDA), République de Pologne (POL), 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 italienne (ITA), République populaire de Chine (CHN), République portugaise (PRT)

- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)

3) Function: GetReport

- Changes in of available languages: bg (Bulgare), cs (Tchèque), da (Danois), de (Allemand), el (Grecque), en (Anglais), es (Espagnol), et (Estonien), fi (Finlandais), fr (Français), 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), tr (Turc), uk (Ukrainien), zh (Chinois)

Changements de SOAP (version 3) par rapport à SOAP (version 2) [WSDL and XSD]

File: report.xsd

New elements:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

New function:

- 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

New element:

- preferable_finances

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

3) SimpleSearchRequest

Removed element:

search_block.reg_code

New element:

search_block->company_code

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

4) SimpleSearchResponse

Removed elements

- code

Nouveaux éléments:

- search_result_id (is required for order with delivery_term = 'o')

- name_transliteration

- reg_code

- vat_code

- unified_legal_form

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 :

"URL du webhook" est l'URL où votre serveur recevra les requêtes POST du webhook.

"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é.

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

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.

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.