Infoproff API-dokumentation - v3


Kom godt i gang


Webservice wsdl og skemaer findes her:

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

Web service functions:

  • SimpleSearch - Søg oplysninger om virksomheder i forskellige lande.
  • ChkFinance - Søg efter tilgængelige regnskaber.
  • Order - Opretter en order_id og returnerer dubletter. Duplikater udvælges ved hjælp af følgende parametre: country, product, reg_code.
  • OrderCancellation - Hvis du har sendt en ordreanmodning og modtaget order_id, har du mulighed for at annullere denne ordre (hvis den ikke er gået i produktion).
  • OrderConfirmation - Når du har modtaget order_id, skal du bekræfte din ordre inden for 1 time. Hvis du ikke bekræfter din ordre inden for 1 time, vil ordren automatisk blive annulleret.
  • ChkStatus - Kontroller ordrestatus.
  • GetReport - Få færdige rapporter.

  • GetClassifiersFinancialStatements - Hent alle finansielle dokumenter med alle elementer: row_number, row_formated_description, row_lang_key og row_order.
  • GetLegalForms - Få alle juridiske formularer for alle tilgængelige lande.
  • GetActivityClassificators - Få alle koder og beskrivelser for en specifik aktivitetsklassifikator.
  • GetDictionaryStandardPhrases - Få alle standardsætninger med nøgler og sprog.
  • GetAvailableProducts - Få en liste over tilgængelige produkter.

  • CreditOpinionCalculator - Credit Opinion Calculator hjælper med at tildele kreditvurdering af en virksomhed.

API tilbyder flere tjenester:

  1. Online kreditrapporter for følgende lande: Republikken Finland (FIN), Kongeriget Sverige (SWE), Kongeriget Belgien (BEL), Kongeriget Nederlandene (NLD), Republikken Estland (EST)
  2. Offline-rapporter for følgende lande: Alle lande
  3. Beregner til kreditvurdering

Hvordan søger man efter en virksomhed?


Virksomhedssøgningen består af 2 muligheder:

  1. Søg efter virksomhedsnavn,
  2. Search by company code.
Liste over tilgængelige lande: Den Franske Republik (FRA), Den Italienske Republik (ITA), Den Kirgisiske Republik (KGZ), Den Portugisiske Republik (PRT), Det Forenede Kongerige Storbritannien og Nordirland (GBR), Det Schweiziske Forbund (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgien (GEO), Grønland (GRL), Irland (IRL), Kongeriget Belgien (BEL), Kongeriget Danmark (DNK), Kongeriget Nederlandene (NLD), Kongeriget Norge (NOR), Kongeriget Spanien (ESP), Kongeriget Sverige (SWE), Mongoliet (MNG), Republikken Aserbajdsjan (AZE), Republikken Belarus (BLR), Republikken Cypern (CYP), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Usbekistan (UZB), Republikken Østrig (AUT)
Vigtige oplysninger:

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.

I Norges register er det ikke muligt at søge efter slettede virksomheder efter navn. Derfor kan vi ikke levere en SimpleSearch efter navne inden for slettede virksomheder i Norge.

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

Nedenfor kan du finde et eksempel:


Funktion SimpleSearch

Mulighed 2: Søg efter registreringskode

Funktion SimpleSearch

Hvordan bestiller man en kreditrapport?


List of available countries for online credit reports: Den Kirgisiske Republik (KGZ), Kongeriget Belgien (BEL), Kongeriget Nederlandene (NLD), Kongeriget Sverige (SWE), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Polen (POL)
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))

Funktion SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Hvordan søger man efter en virksomhed?

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

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

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

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

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

Følgende tilstande anvendes til rapporter:

  • I gang - Rapport i produktionsfasen
  • Canceled - Annulleret ordre
  • Finished - Rapporten er klar
  • Updated - Der blev tilføjet oplysninger til den færdige rapport
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Der er opstået en teknisk fejl i vores system. Det betyder, at vi er informeret om denne fejl og vil rette den hurtigst muligt. Du vil blive informeret, når du vil kunne modtage din ordre.

Hvis udførelsesstatus er Finished eller Updated, kan du få en ordre.

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

Funktion GetReport
Liste over tilgængelige sprog: bg (Bulgarsk), cs (Tjekkisk), da (Dansk), de (Tysk), el (Græsk), en (Engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Lettisk), nb (Norsk bokmål), nl (Hollandsk), pl (Polsk), pt (Portugisisk), ro (Rumænsk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)

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

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

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

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

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

Følgende tilstande anvendes til rapporter:

  • I gang - Rapport i produktionsfasen
  • Canceled - Annulleret ordre
  • Finished - Rapporten er klar
  • Updated - Der blev tilføjet oplysninger til den færdige rapport
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Der er opstået en teknisk fejl i vores system. Det betyder, at vi er informeret om denne fejl og vil rette den hurtigst muligt. Du vil blive informeret, når du vil kunne modtage din ordre.

Hvis udførelsesstatus er Finished eller Updated, kan du få en ordre.

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

Funktion GetReport
Liste over tilgængelige sprog: bg (Bulgarsk), cs (Tjekkisk), da (Dansk), de (Tysk), el (Græsk), en (Engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Lettisk), nb (Norsk bokmål), nl (Hollandsk), pl (Polsk), pt (Portugisisk), ro (Rumænsk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)

Hvordan bestiller man online årsregnskaber?


STEP 1: Find a company

Funktion SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Hvordan søger man efter en virksomhed?

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: Søg efter tilgængelige regnskaber

Funktion ChkFinance

Denne funktion er kun nødvendig, når du bestiller et produkt: finances (Financial statements) med delivery_term = 'o'.

Liste over tilgængelige lande: Republikken Estland (EST), Kongeriget Sverige (SWE)

STEP 3: Bestil årsregnskaber

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

Funktion 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

Funktion 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

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

Følgende tilstande anvendes til rapporter:

  • I gang - Rapport i produktionsfasen
  • Canceled - Annulleret ordre
  • Finished - Rapporten er klar
  • Updated - Der blev tilføjet oplysninger til den færdige rapport
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Der er opstået en teknisk fejl i vores system. Det betyder, at vi er informeret om denne fejl og vil rette den hurtigst muligt. Du vil blive informeret, når du vil kunne modtage din ordre.

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

Funktion GetReport
Liste over tilgængelige sprog: bg (Bulgarsk), cs (Tjekkisk), da (Dansk), de (Tysk), el (Græsk), en (Engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Lettisk), nb (Norsk bokmål), nl (Hollandsk), pl (Polsk), pt (Portugisisk), ro (Rumænsk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)
To see the examples of xml request/response, please follow the link: How to get finished order?

Hvordan downloader jeg standardrapporter (i andre formater end 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.

Anmodningen består af 3 dele:

  1. Fast del https://www.infoproff.com/en/orders/files/
  2. Din unikke hash, som vi giver dig som svar
  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 (ingen ombytning), 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

Hvordan downloader jeg ikke-standardiserede produkter?


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.

Anmodningen består af 3 dele:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Din unikke hash, som vi giver dig som svar
  3. Og den faste del i slutningen /download

Hvordan får jeg en kreditvurdering?


Funktion CreditOpinionCalculator

Hvordan får jeg yderligere oplysninger?


Funktion GetClassifiersFinancialStatements
Funktion GetActivityClassificators
Funktion GetDictionaryStandardPhrases
Funktion GetAvailableProducts

delivery_term:

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

Mulige fejl


Disse fejl kan opstå, når du anmoder om vores webtjeneste.


Alle funktioner
  • Incorrect username/password or you have no permissions.
    Du har indtastet forkerte legitimationsoplysninger, eller din API-adgang er blokeret.

Funktion SimpleSearch
  1. You don't have permissions to search in this country.
    Liste over tilgængelige lande: Den Franske Republik (FRA), Den Italienske Republik (ITA), Den Kirgisiske Republik (KGZ), Den Portugisiske Republik (PRT), Det Forenede Kongerige Storbritannien og Nordirland (GBR), Det Schweiziske Forbund (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgien (GEO), Grønland (GRL), Irland (IRL), Kongeriget Belgien (BEL), Kongeriget Danmark (DNK), Kongeriget Nederlandene (NLD), Kongeriget Norge (NOR), Kongeriget Spanien (ESP), Kongeriget Sverige (SWE), Mongoliet (MNG), Republikken Aserbajdsjan (AZE), Republikken Belarus (BLR), Republikken Cypern (CYP), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Usbekistan (UZB), Republikken Østrig (AUT)
Funktion Order
  1. This product is not available.
    Et sådant produkt kan ikke findes, og det er ikke muligt at bestille.
  2. You can't order report on company with legal form: "legal_form"
    Denne fejl gælder kun for: Kongeriget Sverige (SWE)
    I Sverige er det ikke muligt at bestille online-rapport (delivery_term = "o") med de næste juridiske formularer:
    • 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
    Ved bestilling af offline-rapport (delivery_term = "n", "f" eller "s") er "Business Name" eller "Reg Code" påkrævet.
  5. Reg Code is required when delivery term is Online
    Ved bestilling af online-rapport (delivery_term = "o") er "Reg Code" påkrævet.

Funktion GetReport
  1. This language is not supported.
    Liste over tilgængelige sprog for Online-rapporter: bg (Bulgarsk), cs (Tjekkisk), da (Dansk), de (Tysk), el (Græsk), en (Engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Lettisk), nb (Norsk bokmål), nl (Hollandsk), pl (Polsk), pt (Portugisisk), ro (Rumænsk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)

Funktioner GetReport ChkStatus
  1. Incorrect order_id.
    Ordre-ID kan ikke findes. Du får ordre-ID, når du bruger funktionen Order.

Funktion OrderCancellation
  1. Your order is already canceled.
    Du har ikke længere tilladelse til at annullere ordren.

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

SOAP (version 3) ændringer i forhold til SOAP (version 2)


SOAP (version 3) ændringer i forhold til 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: Den Franske Republik (FRA), Den Italienske Republik (ITA), Den Kirgisiske Republik (KGZ), Den Portugisiske Republik (PRT), Det Forenede Kongerige Storbritannien og Nordirland (GBR), Det Schweiziske Forbund (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgien (GEO), Grønland (GRL), Irland (IRL), Kongeriget Belgien (BEL), Kongeriget Danmark (DNK), Kongeriget Nederlandene (NLD), Kongeriget Norge (NOR), Kongeriget Spanien (ESP), Kongeriget Sverige (SWE), Mongoliet (MNG), Republikken Aserbajdsjan (AZE), Republikken Belarus (BLR), Republikken Cypern (CYP), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Usbekistan (UZB), Republikken Østrig (AUT)

- 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: Den Kirgisiske Republik (KGZ), Kongeriget Belgien (BEL), Kongeriget Nederlandene (NLD), Kongeriget Sverige (SWE), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Polen (POL)

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

3) Function: GetReport

- Changes in of available languages: bg (Bulgarsk), cs (Tjekkisk), da (Dansk), de (Tysk), el (Græsk), en (Engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Lettisk), nb (Norsk bokmål), nl (Hollandsk), pl (Polsk), pt (Portugisisk), ro (Rumænsk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)


SOAP (version 3) ændringer i forhold til 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

Nye elementer:

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

Webhooks Settings


Oversigt

Et webhook er en måde, hvorpå en applikation kan give andre applikationer information i realtid. Vores webhook-funktion implementerer HTTP-callbacks, der er konfigureret med en URL. En HTTP POST-nyttelast sendes til denne URL i JSON-format, hver gang en bestemt begivenhed indtræffer. I forbindelse med vores projekt har vi designet webhook-funktionen til at udløse specifikke begivenheder.

Opsætning af et webhook

For at oprette et webhook til din applikation skal du navigere til siden med applikationsindstillinger og kigge efter afsnittet 'Webhooks Settings'. Og angiv følgende oplysninger:

  1. "Webhook URL" er den URL, hvor din server vil modtage webhook POST-anmodninger.
  2. "Delivery max attempts" er den indstilling, der definerer det maksimale antal forsøg, der skal gøres for at levere en webhook-hændelse, når det første leveringsforsøg mislykkes.
  3. "Delivery retry timeout" er en indstilling, der giver dig mulighed for at angive tidsintervallet mellem gentagne forsøg, når et webhook-leveringsforsøg mislykkes.

Når du har angivet disse oplysninger, skal du klikke på 'Gem'.

Webhook-hændelsestyper

  1. Ny status for ordren

Webhook-nyttelast

Når en begivenhed indtræffer, sender vi en HTTP POST-anmodning til payload-URL'en med en JSON-body, der indeholder oplysninger om begivenheden.

Her er et eksempel på payload:
Eksempel på payload af ny ordrestatus
Mulige værdier i feltet "new_status":
  • "Finished" - en ordre er komplet. En ordre kan afhentes;
  • "Updated" - en ordre opdateret, data tilføjet til en afsluttet ordre;
  • "Canceled" - en ordre annulleres på en kundes anmodning (eller samtykke);
  • "Rejected" - en ordre bliver afvist. Som regel fordi det er umuligt at identificere en virksomhed..

Sikring af dine webhooks

Det er vigtigt at verificere, at POST-anmodninger, der sendes til payload-URL'en, kommer fra vores applikation. For at hjælpe med dette indeholder hver webhook-anmodning en X-Signature-header.

Signatur Beskrivelse

Til signering bruger vi HMAC med SHA512-algoritmen.

Secret er en sammenkædning af App ID og Secret Key fra webhooks-indstillingerne.

Det er muligt at tilføje dine egne get-params til endpointet for at identificere afsenderen, hvis det er nødvendigt.

Fejlfinding

En server skal svare inden for 10 sekunder og returnere en 2XX HTTP-kode; ellers betragtes levering af webhook som mislykket. I tilfælde af fejl vil funktionen forsøge at sende anmodningen igen i henhold til leveringspolitikken.