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 :

  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)
  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: Confédération suisse (CHE), Groenland (GRL), Géorgie (GEO), 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 d'Ouzbékistan (UZB), République de Chypre (CYP), République de Finlande (FIN), République de Moldavie (MDA), République de Pologne (POL), République du Belarus (BLR), 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)
Informations importantes:

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

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

Comment commander un dossier de crédit ?


List of available countries for online credit reports: Royaume de Belgique (BEL), Royaume de Suède (SWE), Royaume des Pays-Bas (NLD), République d'Estonie (EST), République de Finlande (FIN), République de Pologne (POL), République du Kazakhstan (KAZ), République du Kirghizistan (KGZ)
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
  • 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), 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
  • 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: 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), sv (Suédois), tr (Turc), uk (Ukrainien), zh (Chinois)

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
  • 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), 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 :

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

  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: Confédération suisse (CHE), Groenland (GRL), Géorgie (GEO), 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 d'Ouzbékistan (UZB), République de Chypre (CYP), République de Finlande (FIN), République de Moldavie (MDA), République de Pologne (POL), République du Belarus (BLR), 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)
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: 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), sv (Suédois), tr (Turc), uk (Ukrainien), 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'.

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: Confédération suisse (CHE), Groenland (GRL), Géorgie (GEO), 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 d'Ouzbékistan (UZB), République de Chypre (CYP), République de Finlande (FIN), République de Moldavie (MDA), République de Pologne (POL), République du Belarus (BLR), 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)

- 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: Royaume de Belgique (BEL), Royaume de Suède (SWE), Royaume des Pays-Bas (NLD), République d'Estonie (EST), République de Finlande (FIN), République de Pologne (POL), République du Kazakhstan (KAZ), République du Kirghizistan (KGZ)

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

  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.

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.