Documentation de l'API d'Infoproff - v2

Version du commutateur V2

Pour commencer

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

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

Fonctions principales des services Web:

  • SimpleSearch - Recherchez des informations sur les entreprises dans différents pays.
  • Order - Crée un order_id et renvoie les doublons. Les doublons sont sélectionnés par les paramètres suivants : country, product, delivery_term and 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)
  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. Recherche par code d'enregistrement.
Liste des pays disponibles: République de Finlande (FIN), Royaume de Suède (SWE), Royaume de Norvège (NOR), Royaume du Danemark (DNK)
Informations importantes:
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 ?

L'ordre de l'enregistrement à la réception du rapport se compose des étapes suivantes:

  1. L'utilisateur enregistre une nouvelle commande (fonction "Commande"). Le système renvoie les détails de la commande, la liste des doublons placés dans les 60 derniers jours et attend la confirmation de la commande.
  2. L'utilisateur confirme une commande (fonction "OrderConfirmation"). Le système envoie l'ordre pour la production et renvoie l'état actuel de la production.
  3. L'utilisateur vérifie l'état de la commande (fonction "ChkStatus").
  4. Si une commande est prête, l'utilisateur peut alors télécharger le rapport (fonction "GetReport").
Liste des pays disponibles: République de Finlande (FIN), Royaume de Suède (SWE)
Field's length:
business_name varchar(512)
reg_code varchar(64)
vat_code varchar(64)
address varchar(512)
phone varchar(256)
email varchar(256)
additional_info varchar(512)
ref_code varchar(64)

Vous trouverez ci-dessous l'exemple:

ÉTAPE 1 : Commander le rapport

Les utilisateurs qui considèrent que l'étape de confirmation de la commande n'est pas nécessaire peuvent utiliser l'élément "confirm_order" et transmettre la valeur "TRUE".

Il faut généralement 10 à 20 secondes pour préparer le rapport de solvabilité en ligne.
Par conséquent, pour les rapports en ligne, vous devez effectuer des contrôles toutes les 5 secondes ou plus.

Liste des entreprises disponibles pour un compte test :

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
En outre, pour les rapports en ligne (delivery_term = "o"), vous pouvez utiliser des échantillons générés pour chaque pays (utilisation : code d'enregistrement "00000000"). Ces rapports sont gratuits et peuvent être commandés en utilisant le compte test.
Fonction Order
Fonction OrderCancellation

ÉTAPE 2. Confirmation de la commande

Fonction OrderConfirmation

ÉTAPE 3 : Vérification de l'état

Fonction ChkStatus

ÉTAPE 4 : Obtenir le rapport

Liste des langues disponibles pour les rapports en ligne: en (English), et (Estonian), ru (Russian), de (German)
Le téléchargement du rapport en ligne en pdf n'est pas encore disponible.
Fonction GetReport

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.

Comment télécharger le rapport hors ligne ?

Vous pouvez télécharger directement les rapports hors ligne. Voici les instructions pour le faire :

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

Erreurs possibles

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

Toutes les fonctions
  • Nom d'utilisateur/mot de passe incorrect ou vous n'avez pas d'autorisations.
    Vous avez saisi des informations d'identification erronées ou votre accès à l'API est bloqué.
Fonction SimpleSearch
  1. Vous n'avez pas d'autorisation de fouille dans ce pays.
    Liste des pays disponibles: République de Finlande (FIN), Royaume de Suède (SWE)
Fonction Order
  1. Ce produit n'est pas disponible.
    Ce produit est introuvable et il n'est pas possible de le commander.
  2. Vous ne pouvez pas commander un rapport sur une entreprise ayant une forme juridique : "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. Cette entreprise ne figure pas dans la liste des entreprises testées.
    Le code d'enregistrement de la société ne figure pas dans notre liste de tests.
    Liste des entreprises disponibles pour un compte test :
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Le nom de l'entreprise ou le code d'immatriculation est requis
    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. Le code d'enregistrement est requis lorsque le délai de livraison est en ligne
    Lorsque vous commandez un rapport en ligne (delivery_term = "o"), le "Reg Code" est requis.
Fonction GetReport
  1. Cette langue n'est pas prise en charge.
    Liste des langues disponibles pour les rapports en ligne: en (English), et (Estonian), ru (Russian), de (German)
Fonctions GetReport ChkStatus
  1. Numéro d'ordre incorrect.
    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. Vous n'avez plus la permission de confirmer la commande. La confirmation peut être faite dans l'heure qui suit la réception de 'order_id'.

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

Changements de SOAP (version 3) par rapport à SOAP (version 2) [Vue d'ensemble]

1) Nouvelle fonction: ChkFinance

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

2) Fonction: SimpleSearch

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

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

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

3) Fonction: Order
Identification is required!

Pour passer une commande en ligne, vous devez recevoir "search_result_id" de la fonction "SimpleSearch". Ce n'est qu'après cela que vous pouvez passer une commande en ligne (delivery_term = "o").

- Changements dans la liste des pays disponibles pour les rapports de crédit en ligne: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Possibilité de télécharger les états financiers (à l'aide du produit : finances) en ligne: Estonia (EST), Sweden (SWE)

3) Fonction: GetReport

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


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

File: report.xsd

Nouveaux éléments:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nouvelle fonction:

- 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

Nouvel élément:

- preferable_finances

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

3) SimpleSearchRequest

Élément supprimé:

search_block.reg_code

Nouvel élément:

search_block->company_code

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

4) SimpleSearchResponse

Éléments supprimés

- code

Nouveaux éléments:

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