Infoproff API-dokumentasjon - v3


Komme i gang


Webtjenesten wsdl og skjemaer finnes her.:

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

Web service functions:

  • SimpleSearch - Søk etter informasjon om selskaper i ulike land.
  • ChkFinance - Søk etter tilgjengelige regnskaper.
  • Order - Oppretter en order_id og returnerer duplikater. Duplikater velges ved hjelp av følgende parametere: country, product, reg_code.
  • OrderCancellation - Hvis du har sendt en bestillingsforespørsel og mottatt order_id, har du mulighet til å kansellere denne bestillingen (hvis den ikke er gått i produksjon).
  • OrderConfirmation - Etter å ha fått order_id må du bekrefte bestillingen din innen 1 time. Hvis du ikke bekrefter bestillingen din innen 1 time, blir bestillingen automatisk kansellert.
  • ChkStatus - Sjekk bestillingsstatus.
  • GetReport - Få ferdige rapporter.

  • GetClassifiersFinancialStatements - Hent alle finansielle dokumenter med alle elementer: row_number, row_formated_description, row_lang_key og row_order.
  • GetLegalForms - Få alle juridiske skjemaer for alle tilgjengelige land.
  • GetActivityClassificators - Få alle koder og beskrivelser for spesifikke aktivitetsklassifikatorer.
  • GetDictionaryStandardPhrases - Få alle standardfraser med nøkler og språk.
  • GetAvailableProducts - Få en liste over tilgjengelige produkter.

  • CreditOpinionCalculator - Kredittvurderingskalkulator hjelper deg med å tildele kredittvurdering på et selskap.

API tilbyr flere tjenester:

  1. Nettbaserte kredittrapporter for følgende land: Republikken Finland (FIN), Kongeriket Sverige (SWE), Kongeriket Belgia (BEL), Kongeriket Nederlandene (NLD), Republikken Estland (EST)
  2. Frakoblede rapporter for følgende land: Alle land
  3. Kredittvurderingskalkulator

Hvordan søke etter et selskap?


Firmasøket består av to alternativer:

  1. Søk etter firmanavn,
  2. Search by company code.
Liste over tilgjengelige land: Den franske republikk (FRA), Den italienske republikk (ITA), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgia (GEO), Grønland (GRL), Irland (IRL), Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Danmark (DNK), Kongeriket Nederlandene (NLD), Kongeriket Norge (NOR), Kongeriket Spania (ESP), Kongeriket Sverige (SWE), Mongolia (MNG), Republikken Aserbajdsjan (AZE), Republikken Estland (EST), Republikken Finland (FIN), Republikken Hviterussland (BLR), Republikken Kasakhstan (KAZ), Republikken Kypros (CYP), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Usbekistan (UZB), Republikken Østerrike (AUT)
Viktig informasjon:

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.

Norge-registeret tillater ikke å søke i slettede selskaper etter navn. Derfor kan vi ikke gi en SimpleSearch etter navn i slettede selskaper i Norge.

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

Nedenfor finner du et eksempel:


Funksjon SimpleSearch

Alternativ 2: Søk etter registreringskode

Funksjon SimpleSearch

Hvordan bestille en kredittrapport?


List of available countries for online credit reports: Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Nederlandene (NLD), Kongeriket 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))

Funksjon 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øke etter et selskap?

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

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

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

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

Funksjon 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 statuser brukes for rapporter:

  • Under arbeid - Rapport på produksjonsstadiet
  • Canceled - Kansellert ordre
  • Finished - Rapporten er klar
  • Updated - Informasjon ble lagt til i den ferdige rapporten
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Det har oppstått en teknisk feil i systemet vårt. Dette betyr at vi er informert om denne feilen og vil fikse den så snart som mulig. Du vil bli informert om når du vil kunne motta bestillingen.

Hvis utførelsesstatusen er Finished eller Updated, kan du få en ordre.

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

Funksjon GetReport
Liste over tilgjengelige språk: bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Latvisk), nb (Norsk bokmål), nl (Nederlandsk), pl (Polsk), pt (Portugisisk), ro (Rumensk), 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))

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

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

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

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

Følgende statuser brukes for rapporter:

  • Under arbeid - Rapport på produksjonsstadiet
  • Canceled - Kansellert ordre
  • Finished - Rapporten er klar
  • Updated - Informasjon ble lagt til i den ferdige rapporten
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Det har oppstått en teknisk feil i systemet vårt. Dette betyr at vi er informert om denne feilen og vil fikse den så snart som mulig. Du vil bli informert om når du vil kunne motta bestillingen.

Hvis utførelsesstatusen er Finished eller Updated, kan du få en ordre.

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

Funksjon GetReport
Liste over tilgjengelige språk: bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Latvisk), nb (Norsk bokmål), nl (Nederlandsk), pl (Polsk), pt (Portugisisk), ro (Rumensk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)

Hvordan bestille regnskaper på nettet?


STEP 1: Find a company

Funksjon SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Hvordan søke etter et selskap?

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øk etter tilgjengelige regnskaper

Funksjon ChkFinance

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

Liste over tilgjengelige land: Republikken Estland (EST), Kongeriket Sverige (SWE)

STEP 3: Bestill årsregnskap

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

Funksjon 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

Funksjon 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

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

Følgende statuser brukes for rapporter:

  • Under arbeid - Rapport på produksjonsstadiet
  • Canceled - Kansellert ordre
  • Finished - Rapporten er klar
  • Updated - Informasjon ble lagt til i den ferdige rapporten
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Det har oppstått en teknisk feil i systemet vårt. Dette betyr at vi er informert om denne feilen og vil fikse den så snart som mulig. Du vil bli informert om når du vil kunne motta bestillingen.

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

Funksjon GetReport
Liste over tilgjengelige språk: bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Latvisk), nb (Norsk bokmål), nl (Nederlandsk), pl (Polsk), pt (Portugisisk), ro (Rumensk), 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 laste ned standardrapporter (i andre formater enn 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.

Forespørselen består av 3 deler:

  1. Fast del https://www.infoproff.com/en/orders/files/
  2. Din unike hash-kode, som vi oppgir 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 ombytting), 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 laste ned ikke-standardiserte 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.

Forespørselen består av 3 deler:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Din unike hash-kode, som vi oppgir som svar
  3. Og fast del på slutten /download

Hvordan få kredittuttalelse?


Funksjon CreditOpinionCalculator

Hvordan få ytterligere informasjon?


Funksjon GetClassifiersFinancialStatements
Funksjon GetActivityClassificators
Funksjon GetDictionaryStandardPhrases
Funksjon GetAvailableProducts

delivery_term:

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

Mulige feil


Disse feilene kan oppstå når du gjør forespørsler til nettjenesten vår.


Alle funksjoner
  • Incorrect username/password or you have no permissions.
    Du oppgir feil legitimasjon, eller API-tilgangen din er blokkert.

Funksjon SimpleSearch
  1. You don't have permissions to search in this country.
    Liste over tilgjengelige land: Den franske republikk (FRA), Den italienske republikk (ITA), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgia (GEO), Grønland (GRL), Irland (IRL), Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Danmark (DNK), Kongeriket Nederlandene (NLD), Kongeriket Norge (NOR), Kongeriket Spania (ESP), Kongeriket Sverige (SWE), Mongolia (MNG), Republikken Aserbajdsjan (AZE), Republikken Estland (EST), Republikken Finland (FIN), Republikken Hviterussland (BLR), Republikken Kasakhstan (KAZ), Republikken Kypros (CYP), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Usbekistan (UZB), Republikken Østerrike (AUT)
Funksjon Order
  1. This product is not available.
    Slike produkter finnes ikke, og det er ikke mulig å bestille dem.
  2. You can't order report on company with legal form: "legal_form"
    Denne feilen gjelder bare for: Kongeriket Sverige (SWE)
    I Sverige er det ikke mulig å bestille online-rapport (delivery_term = "o") med de neste juridiske skjemaene:
    • 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 av offline rapport (delivery_term = "n", "f" eller "s") er "Business Name" eller "Reg Code" påkrevd.
  5. Reg Code is required when delivery term is Online
    Ved bestilling av nettrapport (delivery_term = "o") er "Reg Code" påkrevd.

Funksjon GetReport
  1. This language is not supported.
    Liste over tilgjengelige språk for elektroniske rapporter: bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Latvisk), nb (Norsk bokmål), nl (Nederlandsk), pl (Polsk), pt (Portugisisk), ro (Rumensk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)

Funksjoner GetReport ChkStatus
  1. Incorrect order_id.
    Bestillings-ID kan ikke bli funnet. Du får ordre-ID når du bruker funksjonen Order.

Funksjon OrderCancellation
  1. Your order is already canceled.
    Du har ikke lenger tillatelse til å kansellere bestillingen.

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

Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 2)


Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 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 republikk (FRA), Den italienske republikk (ITA), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), Georgia (GEO), Grønland (GRL), Irland (IRL), Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Danmark (DNK), Kongeriket Nederlandene (NLD), Kongeriket Norge (NOR), Kongeriket Spania (ESP), Kongeriket Sverige (SWE), Mongolia (MNG), Republikken Aserbajdsjan (AZE), Republikken Estland (EST), Republikken Finland (FIN), Republikken Hviterussland (BLR), Republikken Kasakhstan (KAZ), Republikken Kypros (CYP), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Usbekistan (UZB), Republikken Østerrike (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: Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Nederlandene (NLD), Kongeriket 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 (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), hu (Ungarsk), id (Indonesisk), it (Italiensk), ja (Japansk), ko (Koreansk), lt (Litauisk), lv (Latvisk), nb (Norsk bokmål), nl (Nederlandsk), pl (Polsk), pt (Portugisisk), ro (Rumensk), ru (Russisk), sk (Slovakisk), sl (Slovensk), sv (Svensk), tr (Tyrkisk), uk (Ukrainsk), zh (Kinesisk)


Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 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


Oversikt

En webhook er en måte for en applikasjon å gi andre applikasjoner sanntidsinformasjon på. Vår webhook-funksjon implementerer HTTP-tilbakekall som konfigureres med en URL. En HTTP POST-nyttelast sendes til denne URL-en i JSON-format når en spesifisert hendelse inntreffer. I forbindelse med prosjektet vårt har vi utformet webhook-funksjonen for å utløse spesifikke hendelser.

Konfigurere en webhook

Hvis du vil konfigurere en webhook for applikasjonen din, går du til applikasjonsinnstillingssiden og leter etter delen "Webhooks Settings". Oppgi følgende informasjon:

  1. "Webhook URL" er URL-adressen der serveren mottar POST-forespørsler om webhook.
  2. "Delivery max attempts" er innstillingen som definerer det maksimale antallet nye forsøk som skal gjøres for å levere en webhook-hendelse når det første leveringsforsøket mislykkes.
  3. "Delivery retry timeout" er en innstilling som lar deg spesifisere tidsintervallet mellom nye forsøk når et leveringsforsøk for en webhook mislykkes.

Når du har oppgitt disse opplysningene, klikker du på "Lagre".

Webhook-hendelsestyper

  1. Ny status for bestillingen

Nyttelast for webhook

Når en hendelse inntreffer, sender vi en HTTP POST-forespørsel til nyttelast-URL-en med en JSON-tekst som inneholder informasjon om hendelsen.

Her er et eksempel på nyttelast:
Eksempel på nytt nyttelast for ny ordrestatus
Mulige verdier i feltet "new_status":
  • "Finished" - en bestilling er fullført. En bestilling kan hentes;
  • "Updated" - en ordre som er oppdatert, data som er lagt til i en fullført ordre;
  • "Canceled" - en ordre kanselleres på kundens forespørsel (eller samtykke);
  • "Rejected" - en bestilling avvises. Vanligvis fordi det er umulig å identifisere et selskap..

Sikring av webhooks

Det er viktig å verifisere at POST-forespørsler som sendes til nyttelast-URL-en, kommer fra applikasjonen vår. For å hjelpe til med dette inneholder hver webhook-forespørsel en X-Signature-header.

Signatur Beskrivelse

Til signering bruker vi HMAC med SHA512-algoritmen.

Secret er en sammenkobling av App ID og Secret Key fra webhooks-innstillingene.

Det er mulig å legge til egne get-params i endepunktet for å identifisere avsenderen ved behov.

Feilsøking

En server må svare innen 10 sekunder og returnere en 2XX HTTP-kode, ellers anses webhook-leveringen som mislykket. Hvis dette mislykkes, vil funksjonen forsøke å sende forespørselen på nytt i henhold til retningslinjene for levering.