Infoproff API Documentatie - v2

Switch-versie V2

Aan de slag

Web service wsdl en schema's zijn hier te vinden:

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

Hoofdfuncties van de webdienst:

  • SimpleSearch - Zoek informatie over bedrijven in verschillende landen.
  • Order - Creëert een order_id en retourneert duplicaten. Duplicaten worden geselecteerd door volgende parameters: country, product, delivery_term and reg_code.
  • OrderCancellation - Als u een bestelaanvraag hebt verzonden en de order_id hebt ontvangen, hebt u de mogelijkheid om deze bestelling te annuleren (als ze nog niet in productie is gegaan).
  • OrderConfirmation - Na het ontvangen van order_id moet u uw bestelling binnen 1 uur bevestigen. Indien u uw bestelling niet binnen 1 uur bevestigt, zal deze automatisch geannuleerd worden.
  • ChkStatus - Controleer de status van de bestelling.
  • GetReport - Maak de rapporten af.
  • GetClassifiersFinancialStatements - Verkrijg alle financiële documenten met alle elementen: rij_nummer, rij_opgemaakte_omschrijving, rij_lang_sleutel en rij_volgorde.
  • GetLegalForms - Krijg alle wettelijke formulieren voor alle beschikbare landen.
  • GetActivityClassificators - Krijg alle codes en beschrijvingen voor specifieke activiteitenclassificator.
  • GetDictionaryStandardPhrases - Krijg alle standaardzinnen met sleutels en taal.
  • GetAvailableProducts - Een lijst van beschikbare producten.
  • CreditOpinionCalculator - Credit Opinion Calculator helpt bij het bepalen van de kredietwaardigheid van een bedrijf.

API biedt verschillende diensten:

  1. Online kredietrapporten voor de volgende landen: Republiek Finland (FIN), Koninkrijk Zweden (SWE)
  2. Offline verslagen voor de volgende landen: Alle landen
  3. Kredietadvies calculator

Hoe zoek ik een bedrijf?

Het zoeken naar bedrijven bestaat uit 2 opties:

  1. Zoeken op bedrijfsnaam,
  2. Zoeken op registratiecode.
Lijst van beschikbare landen: Republiek Finland (FIN), Koninkrijk Zweden (SWE), Koninkrijk Noorwegen (NOR), Koninkrijk Denemarken (DNK)
Belangrijke informatie:
In het Noorse register is het niet mogelijk om in geschrapte ondernemingen op naam te zoeken. Daarom kunnen wij geen SimpleSearch op naam aanbieden binnen de geschrapte vennootschappen in Noorwegen.
Field's length:
company_name varchar(512)
company_code varchar(64)

Hieronder vindt u het voorbeeld:

Functie SimpleSearch

Optie 2: Zoeken op registratiecode

Functie SimpleSearch

Hoe kan ik een kredietrapport bestellen?

De volgorde van registratie tot ontvangst van het rapport bestaat uit de volgende stappen:

  1. De gebruiker registreert een nieuwe bestelling (functie "Bestelling"). Het systeem geeft de details van de bestelling weer, een lijst van duplicaten die in de laatste 60 dagen zijn geplaatst en wacht op de bevestiging van de bestelling.
  2. De gebruiker bevestigt een order (functie "OrderConfirmation"). Het systeem verstuurt de order voor productie en geeft de huidige productiestatus terug.
  3. De gebruiker controleert de status van de bestelling (functie "ChkStatus").
  4. Als een order klaar is, kan de gebruiker het rapport downloaden (functie "GetReport").
Lijst van beschikbare landen: Republiek Finland (FIN), Koninkrijk Zweden (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)

Hieronder vindt u het voorbeeld:

STAP 1: Rapport bestellen

Gebruikers die de stap van orderbevestiging overbodig achten, kunnen het element "confirm_order" gebruiken en de waarde "TRUE" doorgeven.

Meestal duurt het 10-20 seconden om het kredietrapport in online modus op te stellen.
Daarom moet u voor onlinerapporten elke 5 of meer seconden een controle uitvoeren.

Lijst van beschikbare bedrijven voor een testaccount:

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
Bovendien kunt u voor online-rapporten (delivery_term = "o") gebruik maken van voorbeelden die voor elk land zijn gegenereerd (gebruik: registratiecode "00000000"). Deze rapporten zijn gratis en kunnen worden besteld met behulp van een testaccount.
Functie Order
Functie OrderCancellation

STAP 2. Bevestiging van de bestelling

Functie OrderConfirmation

STAP 3. Statuscontrole

Functie ChkStatus

STAP 4. Verkrijg verslag

Lijst van beschikbare talen voor onlinerapporten: en (English), et (Estonian), ru (Russian), de (German)
Het on line-verslag in pdf-formaat kan nog niet worden gedownload.
Functie GetReport

De volgende statussen worden gebruikt voor rapporten:

  • In uitvoering - Verslag in de productiefase
  • Canceled - Geannuleerde bestelling
  • Finished - Het verslag is klaar
  • Updated - Er is informatie toegevoegd aan het eindverslag
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Er is een technische fout opgetreden in ons systeem. Dit betekent dat wij op de hoogte zijn van deze fout en deze zo spoedig mogelijk zullen herstellen. U zult op de hoogte worden gebracht wanneer u de bestelling kunt ontvangen.

Als de uitvoeringsstatus Finished of Updated is, dan kunt u een order krijgen.

Hoe kan ik een Offline rapport downloaden?

U kunt Offline rapporten direct downloaden. Hier is de instructie hoe u dat moet doen:

Het verzoek bestaat uit 3 delen:

  1. Vast onderdeel https://www.infoproff.com/en/orders/files/
  2. Uw unieke hash, die wij als antwoord geven
  3. En het vaste gedeelte aan het eind /download

Hoe kan ik een kredietadvies krijgen?

Functie CreditOpinionCalculator

Hoe kan ik aanvullende informatie krijgen?

Functie GetClassifiersFinancialStatements
Functie GetActivityClassificators
Functie GetDictionaryStandardPhrases
Functie GetAvailableProducts

Mogelijke fouten

Deze fouten kunnen zich voordoen bij het aanvragen van onze webdienst.

Alle functies
  • Onjuiste gebruikersnaam/wachtwoord of u hebt geen rechten.
    U voert de verkeerde inloggegevens in of uw API-toegang is geblokkeerd.
Functie SimpleSearch
  1. Je hebt geen toestemming om te zoeken in dit land.
    Lijst van beschikbare landen: Republiek Finland (FIN), Koninkrijk Zweden (SWE)
Functie Order
  1. Dit product is niet beschikbaar.
    Dit product kan niet gevonden worden en het is niet mogelijk om het te bestellen.
  2. Je kunt geen rapport bestellen over een bedrijf met een rechtsvorm: "legal_form"
    Deze fout geldt alleen voor: Koninkrijk Zweden (SWE)
    In Zweden is het niet mogelijk om online verslag (delivery_term = "o") te bestellen met de volgende rechtsvormen:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Dit bedrijf staat niet in de testlijst.
    De bedrijfsregistratiecode staat niet in onze testlijst.
    Lijst van beschikbare bedrijven voor een testaccount:
    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. Bedrijfsnaam of Reg Code is vereist
    Bij bestelling van een offline rapport (leveringstermijn = "n", "f" of "s") is "Bedrijfsnaam" of "Reg Code" vereist.
  5. Reg Code is vereist wanneer de leveringsperiode Online is
    Bij bestelling van een online rapport (leveringstermijn = "o") is "Reg Code" vereist.
Functie GetReport
  1. Deze taal wordt niet ondersteund.
    Lijst van beschikbare talen voor onlinerapporten: en (English), et (Estonian), ru (Russian), de (German)
Functies GetReport ChkStatus
  1. Onjuist order_id.
    Order ID kan niet worden gevonden. U krijgt de order ID wanneer u de Order functie gebruikt.
Functie OrderCancellation
  1. Your order is already canceled.
    Je hebt geen toestemming meer om de bestelling te annuleren.
Functie OrderConfirmation
  1. Je hebt geen toestemming meer om de bestelling te bevestigen. Bevestiging kan plaatsvinden binnen een uur nadat je 'order_id' hebt ontvangen.

SOAP (versie 3) wijzigingen ten opzichte van SOAP (versie 2)

SOAP (versie 3) wijzigingen ten opzichte van SOAP (versie 2) [Overzicht]

1) Nieuwe functie: ChkFinance

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

2) Functie: 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) Functie: Order
Identification is required!

Om een online bestelling te plaatsen, moet je 'search_result_id' ontvangen van functie 'SimpleSearch', en pas daarna kun je een online (delivery_term = 'o') bestelling plaatsen.

- Wijzigingen in de lijst van beschikbare landen voor online kredietrapporten: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Beschikbaar om financiële overzichten te downloaden (met behulp van product: financiën) in online modus: Estonia (EST), Sweden (SWE)

3) Functie: 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)


SOAP (versie 3) wijzigingen ten opzichte van SOAP (versie 2) [WSDL and XSD]

File: report.xsd

Nieuwe elementen:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nieuwe functie:

- 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

Nieuw element:

- preferable_finances

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

3) SimpleSearchRequest

Verwijderd element:

search_block.reg_code

Nieuw element:

search_block->company_code

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

4) SimpleSearchResponse

Verwijderde elementen

- code

Nieuwe elementen:

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