Infoproff API-dokumentasjon - v4

Bytt versjon V4

Komme i gang

Webtjenesten wsdl og skjemaer finnes her.:

https://wsdfn.infoproff.com/v4/

Postman Collection (API v4) — Ready for Use:

https://www.postman.com/infoproff/infoproff-webservices/documentation/9kweer5/soap-api-v4

Postman provides a convenient way to test our API without the need to write any code. It can also automatically generate example HTTP requests for most common programming languages.

The requests generated by Postman are basic HTTP calls compatible with our SOAP API. However, for production-grade integration, we recommend using fully featured SOAP clients available in most programming languages. These clients can work directly with WSDL and XSD, automatically handling schemas, data types, and message structures.

Using a dedicated SOAP client ensures a more reliable and robust integration, reducing the likelihood of errors when constructing and parsing SOAP messages.

Authentification details

The primary authentication method is HTTP Basic Auth. Using the Authorization header with encoded credentials is the preferred and recommended approach.

The username corresponds to the App ID, and the password is the associated Secret Key. These values are generated in the API Tokens section of the user dashboard and are not related to the credentials used for logging into the portal.

The authentication_block mechanism, used in previous API versions, is still supported for backward compatibility but is considered deprecated and should not be used in new integrations.

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), Republikken Kasakhstan (KAZ), Republikken Polen (POL), Kirgisistan (KGZ), Folkerepublikken Kina (CHN), Mongolia (MNG)
  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: Bosnia-Hercegovina (BIH), Canada (CAN), Den bolivarianske republikken Venezuela (VEN), Den demokratiske folkerepublikken Algerie (DZA), Den demokratiske sosialistiske republikken Sri Lanka (LKA), Den forente republikk Tanzania (TZA), Den franske republikk (FRA), Den føderale demokratiske republikken Etiopia (ETH), Den føderative republikken Brasil (BRA), Den greske republikk (GRC), Den italienske republikk (ITA), Den kooperative republikken Guyana (GUY), Den plurinasjonale staten Bolivia (BOL), Den russiske føderasjon (RUS), Den slovakiske republikk (SVK), Den togolesiske republikk (TGO), Den uavhengige staten Samoa (WSM), Den østlige republikken Uruguay (URY), Det australske samveldet (AUS), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Elfenbenskysten (CIV), Folkerepublikken Kina (CHN), Forbundsrepublikken Nigeria (NGA), Forbundsrepublikken Tyskland (DEU), Fransk Guyana (GUF), Fyrstedømmet Liechtenstein (LIE), Fyrstedømmet Monaco (MCO), Georgia (GEO), Gjenforening (REU), Grønland (GRL), Guadeloupe (GLP), Hong Kong (HKG), Irland (IRL), Isle of Man (IMN), Japan (JPN), Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Danmark (DNK), Kongeriket Marokko (MAR), Kongeriket Nederlandene (NLD), Kongeriket Norge (NOR), Kongeriket Spania (ESP), Kongeriket Sverige (SWE), Kongeriket Thailand (THA), Kosovo (XXK), Martinique (MTQ), Mayotte (MYT), Mongolia (MNG), New Zealand (NZL), Republikken Albania (ALB), Republikken Angola (AGO), Republikken Argentina (ARG), Republikken Aserbajdsjan (AZE), Republikken Benin (BEN), Republikken Botswana (BWA), Republikken Bulgaria (BGR), Republikken Chile (CHL), Republikken Ecuador (ECU), Republikken Estland (EST), Republikken Filippinene (PHL), Republikken Finland (FIN), Republikken Gambia (GMB), Republikken Guinea (GIN), Republikken Hviterussland (BLR), Republikken Island (ISL), Republikken Kasakhstan (KAZ), Republikken Kenya (KEN), Republikken Kina (TWN), Republikken Kongo (COG), Republikken Kroatia (HRV), Republikken Kypros (CYP), Republikken Latvia (LVA), Republikken Litauen (LTU), Republikken Madagaskar (MDG), Republikken Maldivene (MDV), Republikken Malta (MLT), Republikken Mauritius (MUS), Republikken Moldova (MDA), Republikken Namibia (NAM), Republikken Paraguay (PRY), Republikken Peru (PER), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Rwanda (RWA), Republikken San Marino (SMR), Republikken Serbia (SRB), Republikken Seychellene (SYC), Republikken Singapore (SGP), Republikken Slovenia (SVN), Republikken Sør-Afrika (ZAF), Republikken Tadsjikistan (TJK), Republikken Ungarn (HUN), Republikken Usbekistan (UZB), Republikken Zambia (ZMB), Republikken Zimbabwe (ZWE), Republikken Østerrike (AUT), Romania (ROU), Samfunnet Saint Martin (MAF), Staten Israel (ISR), Storhertugdømmet Luxembourg (LUX), The Bailiwick of Jersey (JEY), Tsjekkia (CZE)

The search for other countries is performed only in the database of archived reports. If you do not find the desired company, enter the company details manually.

Viktig informasjon:

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

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

Option 3: Search by query (by name or code)

Funksjon UnifiedSearch

Hvordan bestille en kredittrapport?

List of available countries for online credit reports: Den franske republikk (FRA), Den greske republikk (GRC), Den italienske republikk (ITA), Den russiske føderasjon (RUS), Den slovakiske republikk (SVK), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Folkerepublikken Kina (CHN), Forbundsrepublikken Tyskland (DEU), 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 Bulgaria (BGR), Republikken Estland (EST), Republikken Finland (FIN), Republikken Kasakhstan (KAZ), Republikken Kroatia (HRV), Republikken Latvia (LVA), Republikken Malta (MLT), Republikken Moldova (MDA), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Slovenia (SVN), Republikken Ungarn (HUN), Republikken Østerrike (AUT), Storhertugdømmet Luxembourg (LUX), Tsjekkia (CZE)
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
  • Identification pending - Utarbeidelse av rapporten er satt på vent. Krever ytterligere data fra kunden.
  • 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: ar (Arabic), bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), he (Hebrew), 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), sr (Српски), sv (Svensk), th (Thai), tr (Tyrkisk), uk (Ukrainsk), vi (Vietnamese), 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
  • Identification pending - Utarbeidelse av rapporten er satt på vent. Krever ytterligere data fra kunden.
  • 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: ar (Arabic), bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), he (Hebrew), 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), sr (Српски), sv (Svensk), th (Thai), tr (Tyrkisk), uk (Ukrainsk), vi (Vietnamese), zh (Kinesisk)

Hvordan bestiller jeg en arkivert kredittrapport?

Purchase of an archived report is available for all countries.

Below you can find the example of how to order and download archived reports:

STEP 1: Find a company

Funksjon SimpleSearch

To order an archived report you need to receive "<search_result_id>" which has an "<archived_reports>" section that contains a product you need.
To do so, please follow the link: Hvordan søke etter et selskap?

Example companies with archived reports:

  • Country: EST, Reg. Code: 12309116
  • Country: EST, Reg. Code: 12854256
  • Country: EST, Reg. Code: 12830238
  • Country: USA, Company name: Apple

STEP 2: Order a report

Funksjon Order

STEP 3: Order cancellation (Optional)

Just like the online/offline reports.

STEP 4: Order confirmation

Just like the online/offline reports.

STEP 5: Check order status

Just like the online/offline reports.

For archived orders checking order status once every 5 seconds is acceptable frequency.

STEP 6: Get report

Just like the online/offline reports.

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
  • Identification pending - Utarbeidelse av rapporten er satt på vent. Krever ytterligere data fra kunden.
  • 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: ar (Arabic), bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), he (Hebrew), 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), sr (Српски), sv (Svensk), th (Thai), tr (Tyrkisk), uk (Ukrainsk), vi (Vietnamese), 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, ar, bg, cs, da, de, el, fi, fr, he, hu, id, it, ja, ko, lt, nl, nb, pl, pt, ro, sk, sl, es, sr, sv, th, tr, uk, vi, 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: Bosnia-Hercegovina (BIH), Canada (CAN), Den bolivarianske republikken Venezuela (VEN), Den demokratiske folkerepublikken Algerie (DZA), Den demokratiske sosialistiske republikken Sri Lanka (LKA), Den forente republikk Tanzania (TZA), Den franske republikk (FRA), Den føderale demokratiske republikken Etiopia (ETH), Den føderative republikken Brasil (BRA), Den greske republikk (GRC), Den italienske republikk (ITA), Den kooperative republikken Guyana (GUY), Den plurinasjonale staten Bolivia (BOL), Den russiske føderasjon (RUS), Den slovakiske republikk (SVK), Den togolesiske republikk (TGO), Den uavhengige staten Samoa (WSM), Den østlige republikken Uruguay (URY), Det australske samveldet (AUS), Det forente kongerike Storbritannia og Nord-Irland (GBR), Det sveitsiske edsforbundet (CHE), Elfenbenskysten (CIV), Folkerepublikken Kina (CHN), Forbundsrepublikken Nigeria (NGA), Forbundsrepublikken Tyskland (DEU), Fransk Guyana (GUF), Fyrstedømmet Liechtenstein (LIE), Fyrstedømmet Monaco (MCO), Georgia (GEO), Gjenforening (REU), Grønland (GRL), Guadeloupe (GLP), Hong Kong (HKG), Irland (IRL), Isle of Man (IMN), Japan (JPN), Kirgisistan (KGZ), Kongeriket Belgia (BEL), Kongeriket Danmark (DNK), Kongeriket Marokko (MAR), Kongeriket Nederlandene (NLD), Kongeriket Norge (NOR), Kongeriket Spania (ESP), Kongeriket Sverige (SWE), Kongeriket Thailand (THA), Kosovo (XXK), Martinique (MTQ), Mayotte (MYT), Mongolia (MNG), New Zealand (NZL), Republikken Albania (ALB), Republikken Angola (AGO), Republikken Argentina (ARG), Republikken Aserbajdsjan (AZE), Republikken Benin (BEN), Republikken Botswana (BWA), Republikken Bulgaria (BGR), Republikken Chile (CHL), Republikken Ecuador (ECU), Republikken Estland (EST), Republikken Filippinene (PHL), Republikken Finland (FIN), Republikken Gambia (GMB), Republikken Guinea (GIN), Republikken Hviterussland (BLR), Republikken Island (ISL), Republikken Kasakhstan (KAZ), Republikken Kenya (KEN), Republikken Kina (TWN), Republikken Kongo (COG), Republikken Kroatia (HRV), Republikken Kypros (CYP), Republikken Latvia (LVA), Republikken Litauen (LTU), Republikken Madagaskar (MDG), Republikken Maldivene (MDV), Republikken Malta (MLT), Republikken Mauritius (MUS), Republikken Moldova (MDA), Republikken Namibia (NAM), Republikken Paraguay (PRY), Republikken Peru (PER), Republikken Polen (POL), Republikken Portugal (PRT), Republikken Rwanda (RWA), Republikken San Marino (SMR), Republikken Serbia (SRB), Republikken Seychellene (SYC), Republikken Singapore (SGP), Republikken Slovenia (SVN), Republikken Sør-Afrika (ZAF), Republikken Tadsjikistan (TJK), Republikken Ungarn (HUN), Republikken Usbekistan (UZB), Republikken Zambia (ZMB), Republikken Zimbabwe (ZWE), Republikken Østerrike (AUT), Romania (ROU), Samfunnet Saint Martin (MAF), Staten Israel (ISR), Storhertugdømmet Luxembourg (LUX), The Bailiwick of Jersey (JEY), Tsjekkia (CZE)
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: ar (Arabic), bg (Bulgarsk), cs (Tsjekkisk), da (Dansk), de (Tysk), el (Gresk), en (engelsk), es (Spansk), et (Estisk), fi (Finsk), fr (Fransk), he (Hebrew), 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), sr (Српски), sv (Svensk), th (Thai), tr (Tyrkisk), uk (Ukrainsk), vi (Vietnamese), 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 4) sammenlignet med SOAP (versjon 3)

Nye seksjoner

  • country_economic_overview — inneholder følgende underavsnitt: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — informasjon om betalte skatter.
  • tenders — informasjon om anbud.
  • sanctions — lagt til i seksjonen « negative_information ».

Oppdateringer av eksisterende seksjoner

I seksjonene beneficiaries, shareholders, managers og employees_data ble følgende element lagt til:
  • source_type — type datakilde (f.eks. official, mass_media, company_admin, osv.).
I delen relations_of_persons er det lagt til et nytt element:
  • match_type
Avsnittet « capital » er omstrukturert:
  • Elementet « capital_amount » har fått nytt navn: « issued_capital ».
  • Følgende nye elementer er lagt til:
    • number_of_shares
    • share_value
    • authorized_capital
I delen « employees_data »:
  • Det nye elementet « group_figure » angir om dataene inkluderer aggregerte tall på gruppenivå (true).
  • Elementet source_type angir datakildetypen.
  • Elementet « is_estimated » er nå bare inkludert hvis verdien er « true ».
Ny seksjon « assets_data » — konsoliderer tidligere eksisterende seksjoner:
  • real_estate_data (tidligere kalt property_data), vehicles, machinery_and_equipment (tidligere kalt assets).
  • Planlagte fremtidige tillegg: « patents » og « biological_assets ».
I delen « vehicles » er det lagt til et nytt felt:
  • value
I delen litigations er følgende elementer lagt til:
  • content, instance, process, authority
I financial_statement/positions og summary/latest_turnovers er det lagt til et nytt element:
  • value_origin — beskriver opprinnelsen til verdien; for eksempel verdien estimated – denne verdien er estimert og beregnet basert på tilgjengelige data ved hjelp av logikk eller AI.
I delen branches_data er følgende felt lagt til:
  • registration_number
  • director_name

Merk: Mindre forbedringer og justeringer kan fortsatt forekomme i stabiliseringsfasen.

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..
  • "Identification pending" - Vi trenger mer informasjon fra kunden før vi kan forberede en ordre..

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.