Infoproff API-dokumentation - v3

Komma igång

Webbtjänst wsdl och scheman finns här:

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

Web service functions:

SimpleSearch - Sök information om företag i olika länder.
ChkFinance - Sök efter tillgängliga finansiella rapporter.
Order - Skapar en order_id och returnerar dubbletter. Dubletter väljs ut med hjälp av följande parametrar: country, product, reg_code.
OrderCancellation - Om du har skickat en beställningsförfrågan och fått order_id har du möjlighet att avbryta beställningen (om den inte har gått i produktion).
OrderConfirmation - När du har fått order_id måste du bekräfta din beställning inom en timme. Om du inte bekräftar din beställning inom en timme kommer beställningen att annulleras automatiskt.
ChkStatus - Kontrollera orderstatus.
GetReport - Få färdiga rapporter.

GetClassifiersFinancialStatements - Hämta alla finansiella dokument med alla element: row_number, row_formated_description, row_lang_key och row_order.
GetLegalForms - Få alla juridiska formulär för alla tillgängliga länder.
GetActivityClassificators - Få fram alla koder och beskrivningar för en specifik aktivitetsklassificator.
GetDictionaryStandardPhrases - Få alla standardfraser med nycklar och språk.
GetAvailableProducts - Få en lista över tillgängliga produkter.

CreditOpinionCalculator - Credit Opinion Calculator hjälper dig att tilldela ett företag ett kreditbetyg.

API tillhandahåller flera tjänster:

Kreditupplysningar online för följande länder: Republiken Finland (FIN), Konungariket Sverige (SWE), Konungariket Belgien (BEL), Konungariket Nederländerna (NLD), Republiken Estland (EST), Republiken Kazakstan (KAZ), Republiken Polen (POL), Kirgizistan (KGZ), Folkrepubliken Kina (CHN), Mongoliet (MNG)
Offline-rapporter för följande länder: Alla länder
Kalkylator för kreditbedömning

Hur söker man efter ett företag?

Företagssökningen består av 2 alternativ:

Sök efter företagsnamn,
Search by company code.

Förteckning över tillgängliga länder: Australiska samväldet (AUS), Bailiwick of Jersey (JEY), Bolivarianska republiken Venezuela (VEN), Bolivias plurinationella stat (BOL), Bosnien och Hercegovina (BIH), Demokratiska folkrepubliken Algeriet (DZA), Demokratiska socialistiska republiken Sri Lanka (LKA), Elfenbenskusten (CIV), Federala demokratiska republiken Etiopien (ETH), Folkrepubliken Kina (CHN), Franska Guyana (GUF), Franska republiken (FRA), Furstendömet Liechtenstein (LIE), Furstendömet Monaco (MCO), Förbundsrepubliken Brasilien (BRA), Förbundsrepubliken Nigeria (NGA), Förbundsrepubliken Tyskland (DEU), Förenade Arabemiraten (ARE), Förenade konungariket Storbritannien och Nordirland (GBR), Förenade republiken Tanzania (TZA), Georgien (GEO), Grönland (GRL), Guadeloupe (GLP), Hong Kong (HKG), Irland (IRL), Isle of Man (IMN), Italienska republiken (ITA), Japan (JPN), Kanada (CAN), Kirgizistan (KGZ), Konungariket Belgien (BEL), Konungariket Danmark (DNK), Konungariket Marocko (MAR), Konungariket Nederländerna (NLD), Konungariket Norge (NOR), Konungariket Spanien (ESP), Konungariket Sverige (SWE), Konungariket Thailand (THA), Kooperativa republiken Guyana (GUY), Kosovo (XXK), Martinique (MTQ), Mayotte (MYT), Mongoliet (MNG), Nya Zeeland (NZL), Portugisiska republiken (PRT), Republiken Albanien (ALB), Republiken Angola (AGO), Republiken Argentina (ARG), Republiken Azerbajdzjan (AZE), Republiken Benin (BEN), Republiken Botswana (BWA), Republiken Bulgarien (BGR), Republiken Chile (CHL), Republiken Cypern (CYP), Republiken Ecuador (ECU), Republiken Estland (EST), Republiken Filippinerna (PHL), Republiken Finland (FIN), Republiken Gambia (GMB), Republiken Grekland (GRC), Republiken Guinea (GIN), Republiken Island (ISL), Republiken Kazakstan (KAZ), Republiken Kenya (KEN), Republiken Kina (TWN), Republiken Kongo (COG), Republiken Kroatien (HRV), Republiken Lettland (LVA), Republiken Litauen (LTU), Republiken Madagaskar (MDG), Republiken Maldiverna (MDV), Republiken Malta (MLT), Republiken Mauritius (MUS), Republiken Moldavien (MDA), Republiken Namibia (NAM), Republiken Paraguay (PRY), Republiken Peru (PER), Republiken Polen (POL), Republiken Rwanda (RWA), Republiken San Marino (SMR), Republiken Serbien (SRB), Republiken Seychellerna (SYC), Republiken Singapore (SGP), Republiken Slovenien (SVN), Republiken Sydafrika (ZAF), Republiken Tadzjikistan (TJK), Republiken Ungern (HUN), Republiken Uzbekistan (UZB), Republiken Vitryssland (BLR), Republiken Zambia (ZMB), Republiken Zimbabwe (ZWE), Republiken Österrike (AUT), Rumänien (ROU), Ryska federationen (RUS), Samfundet Sankt Martin (MAF), Samoas oberoende stat (WSM), Schweiziska edsförbundet (CHE), Slovakien (SVK), Staten Israel (ISR), Storhertigdömet Luxemburg (LUX), Tjeckien (CZE), Togolesiska republiken (TGO), Återförening (REU), Östra Republiken Uruguay (URY)

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 information:

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.

I Norges register är det inte möjligt att söka efter namn på raderade företag. Därför kan vi inte tillhandahålla en SimpleSearch efter namn inom raderade företag i Norge.

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

Nedan hittar du ett exempel:

Alternativ 1: Sök efter företagsnamn

Funktion SimpleSearch

Alternativ 2: Sök efter registreringskod

Funktion SimpleSearch

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

Funktion UnifiedSearch

Hur beställer man en kreditupplysning?

List of available countries for online credit reports: Folkrepubliken Kina (CHN), Franska republiken (FRA), Förbundsrepubliken Tyskland (DEU), Förenade konungariket Storbritannien och Nordirland (GBR), Irland (IRL), Italienska republiken (ITA), Kirgizistan (KGZ), Konungariket Belgien (BEL), Konungariket Nederländerna (NLD), Konungariket Norge (NOR), Konungariket Spanien (ESP), Konungariket Sverige (SWE), Mongoliet (MNG), Portugisiska republiken (PRT), Republiken Azerbajdzjan (AZE), Republiken Bulgarien (BGR), Republiken Estland (EST), Republiken Finland (FIN), Republiken Grekland (GRC), Republiken Kazakstan (KAZ), Republiken Kroatien (HRV), Republiken Malta (MLT), Republiken Moldavien (MDA), Republiken Polen (POL), Republiken Slovenien (SVN), Republiken Ungern (HUN), Republiken Österrike (AUT), Ryska federationen (RUS), Schweiziska edsförbundet (CHE), Slovakien (SVK), Storhertigdömet Luxemburg (LUX), Tjeckien (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:

Online/Offline Order Example (with search_result_id)
Offline Order Example (without search_result_id)

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: Hur söker man efter ett företag?

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öljande statusar används för rapporter:

På gång - Rapport i produktionsskedet
Identification pending - Förberedelse av rapport i vänteläge. Kräver ytterligare data från kunden.
Canceled - Avbeställd beställning
Finished - Rapporten är klar
Updated - Information har lagts till i den färdiga rapporten.
Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
Technical Error - Ett tekniskt fel har uppstått i vårt system. Det betyder att vi är informerade om felet och att vi kommer att åtgärda det så snart som möjligt. Du kommer att informeras när du kommer att kunna ta emot din beställning.

Om exekveringsstatusen är Finished eller Updated kan du få en order.

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

Funktion GetReport

Förteckning över tillgängliga språk: bg (Bulgariska), cs (Tjeckien), da (danska), de (Tyska), el (Grekiska), en (Engelska), es (Spanska), et (Estniska), fi (finska), fr (Franska), hu (Ungerska), id (indonesiska), it (Italienska), ja (Japanska), ko (Koreanska), lt (Litauiska), lv (Lettiska), nb (Norska Bokmål), nl (Nederländska), pl (Polsk), pt (Portugisiska), ro (Rumänska), ru (Ryska), sk (Slovakien), sl (Slovenska), sr (Српски), sv (Svenska), tr (Turkiska), uk (Ukrainska), zh (Kinesiska)

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öljande statusar används för rapporter:

På gång - Rapport i produktionsskedet
Identification pending - Förberedelse av rapport i vänteläge. Kräver ytterligare data från kunden.
Canceled - Avbeställd beställning
Finished - Rapporten är klar
Updated - Information har lagts till i den färdiga rapporten.
Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
Technical Error - Ett tekniskt fel har uppstått i vårt system. Det betyder att vi är informerade om felet och att vi kommer att åtgärda det så snart som möjligt. Du kommer att informeras när du kommer att kunna ta emot din beställning.

Om exekveringsstatusen är Finished eller Updated kan du få en order.

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

Funktion GetReport

Hur beställer jag en arkiverad kreditupplysning?

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

Funktion 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: Hur söker man efter ett företag?

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

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

Hur beställer man bokslut online?

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: Hur söker man efter ett företag?

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 efter tillgängliga bokslutshandlingar

Funktion ChkFinance

Den här funktionen behövs bara när du beställer en produkt: finances (Financial statements) med delivery_term = 'o'.

Förteckning över tillgängliga länder: Republiken Estland (EST), Konungariket Sverige (SWE)

STEP 3: Beställ bokslut

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öljande statusar används för rapporter:

På gång - Rapport i produktionsskedet

Identification pending - Förberedelse av rapport i vänteläge. Kräver ytterligare data från kunden.

Canceled - Avbeställd beställning

Finished - Rapporten är klar

Updated - Information har lagts till i den färdiga rapporten.

Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).

Technical Error - Ett tekniskt fel har uppstått i vårt system. Det betyder att vi är informerade om felet och att vi kommer att åtgärda det så snart som möjligt. Du kommer att informeras när du kommer att kunna ta emot din beställning.

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

Förteckning över tillgängliga språk: bg (Bulgariska), cs (Tjeckien), da (danska), de (Tyska), el (Grekiska), en (Engelska), es (Spanska), et (Estniska), fi (finska), fr (Franska), hu (Ungerska), id (indonesiska), it (Italienska), ja (Japanska), ko (Koreanska), lt (Litauiska), lv (Lettiska), nb (Norska Bokmål), nl (Nederländska), pl (Polsk), pt (Portugisiska), ro (Rumänska), ru (Ryska), sk (Slovakien), sl (Slovenska), sr (Српски), sv (Svenska), tr (Turkiska), uk (Ukrainska), zh (Kinesiska)
To see the examples of xml request/response, please follow the link: How to get finished order?

Hur laddar man ner standardrapporter (i andra format än 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.

Ansökan består av tre delar:

Fast del https://www.infoproff.com/en/orders/files/

Din unika hash, som vi tillhandahåller som svar.

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, sr, sv, tr, uk, zh
doc_type: pdf, html, docx, xlsx
currency_position: left, right
preferred_currency: XXX - Original (inget utbyte), 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

Hur laddar man ner icke-standardiserade 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.

Ansökan består av tre delar:

Fixed part https://www.infoproff.com/en/orders/files/

Din unika hash, som vi tillhandahåller som svar.

Och den fasta delen i slutet /download

Hur får man ett kreditutlåtande?

Funktion CreditOpinionCalculator

Hur får jag ytterligare information?

Funktion GetClassifiersFinancialStatements

Funktion GetLegalForms

Funktion GetActivityClassificators

Funktion GetDictionaryStandardPhrases

Funktion GetAvailableProducts

delivery_term:

"o" = "Online"

"n" = "Normal"

"f" = "Flash"

"s" = "SuperFlash"

Möjliga fel

Dessa fel kan inträffa när du gör en förfrågan till vår webbtjänst.

Alla funktioner

Incorrect username/password or you have no permissions.

Du anger fel autentiseringsuppgifter eller din API-åtkomst är blockerad.

Funktion SimpleSearch

You don't have permissions to search in this country.

Förteckning över tillgängliga länder: Australiska samväldet (AUS), Bailiwick of Jersey (JEY), Bolivarianska republiken Venezuela (VEN), Bolivias plurinationella stat (BOL), Bosnien och Hercegovina (BIH), Demokratiska folkrepubliken Algeriet (DZA), Demokratiska socialistiska republiken Sri Lanka (LKA), Elfenbenskusten (CIV), Federala demokratiska republiken Etiopien (ETH), Folkrepubliken Kina (CHN), Franska Guyana (GUF), Franska republiken (FRA), Furstendömet Liechtenstein (LIE), Furstendömet Monaco (MCO), Förbundsrepubliken Brasilien (BRA), Förbundsrepubliken Nigeria (NGA), Förbundsrepubliken Tyskland (DEU), Förenade Arabemiraten (ARE), Förenade konungariket Storbritannien och Nordirland (GBR), Förenade republiken Tanzania (TZA), Georgien (GEO), Grönland (GRL), Guadeloupe (GLP), Hong Kong (HKG), Irland (IRL), Isle of Man (IMN), Italienska republiken (ITA), Japan (JPN), Kanada (CAN), Kirgizistan (KGZ), Konungariket Belgien (BEL), Konungariket Danmark (DNK), Konungariket Marocko (MAR), Konungariket Nederländerna (NLD), Konungariket Norge (NOR), Konungariket Spanien (ESP), Konungariket Sverige (SWE), Konungariket Thailand (THA), Kooperativa republiken Guyana (GUY), Kosovo (XXK), Martinique (MTQ), Mayotte (MYT), Mongoliet (MNG), Nya Zeeland (NZL), Portugisiska republiken (PRT), Republiken Albanien (ALB), Republiken Angola (AGO), Republiken Argentina (ARG), Republiken Azerbajdzjan (AZE), Republiken Benin (BEN), Republiken Botswana (BWA), Republiken Bulgarien (BGR), Republiken Chile (CHL), Republiken Cypern (CYP), Republiken Ecuador (ECU), Republiken Estland (EST), Republiken Filippinerna (PHL), Republiken Finland (FIN), Republiken Gambia (GMB), Republiken Grekland (GRC), Republiken Guinea (GIN), Republiken Island (ISL), Republiken Kazakstan (KAZ), Republiken Kenya (KEN), Republiken Kina (TWN), Republiken Kongo (COG), Republiken Kroatien (HRV), Republiken Lettland (LVA), Republiken Litauen (LTU), Republiken Madagaskar (MDG), Republiken Maldiverna (MDV), Republiken Malta (MLT), Republiken Mauritius (MUS), Republiken Moldavien (MDA), Republiken Namibia (NAM), Republiken Paraguay (PRY), Republiken Peru (PER), Republiken Polen (POL), Republiken Rwanda (RWA), Republiken San Marino (SMR), Republiken Serbien (SRB), Republiken Seychellerna (SYC), Republiken Singapore (SGP), Republiken Slovenien (SVN), Republiken Sydafrika (ZAF), Republiken Tadzjikistan (TJK), Republiken Ungern (HUN), Republiken Uzbekistan (UZB), Republiken Vitryssland (BLR), Republiken Zambia (ZMB), Republiken Zimbabwe (ZWE), Republiken Österrike (AUT), Rumänien (ROU), Ryska federationen (RUS), Samfundet Sankt Martin (MAF), Samoas oberoende stat (WSM), Schweiziska edsförbundet (CHE), Slovakien (SVK), Staten Israel (ISR), Storhertigdömet Luxemburg (LUX), Tjeckien (CZE), Togolesiska republiken (TGO), Återförening (REU), Östra Republiken Uruguay (URY)

Funktion Order

This product is not available.

Produkten kan inte hittas och det är inte möjligt att beställa den.

You can't order report on company with legal form: "legal_form"

Detta fel gäller endast följande: Konungariket Sverige (SWE)
I Sverige är det inte möjligt att beställa online-rapport (delivery_term = "o") med följande juridiska former:

enskild näringsidkare

kommanditbolag

handelsbolag

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

Business Name or Reg Code is required

Vid beställning av offline-rapport (delivery_term = "n", "f" eller "s") krävs "Business Name" eller "Reg Code".

Reg Code is required when delivery term is Online

Vid beställning av online-rapport (delivery_term = "o") krävs "Reg Code".

Funktion GetReport

This language is not supported.

Förteckning över tillgängliga språk för online-rapporter: bg (Bulgariska), cs (Tjeckien), da (danska), de (Tyska), el (Grekiska), en (Engelska), es (Spanska), et (Estniska), fi (finska), fr (Franska), hu (Ungerska), id (indonesiska), it (Italienska), ja (Japanska), ko (Koreanska), lt (Litauiska), lv (Lettiska), nb (Norska Bokmål), nl (Nederländska), pl (Polsk), pt (Portugisiska), ro (Rumänska), ru (Ryska), sk (Slovakien), sl (Slovenska), sr (Српски), sv (Svenska), tr (Turkiska), uk (Ukrainska), zh (Kinesiska)

Funktioner GetReport ChkStatus

Incorrect order_id.

Order-ID kan inte hittas. Du får order-ID när du använder funktionen Order.

Funktion OrderCancellation

Your order is already canceled.

Du har inte längre rätt att avbryta beställningen.

Funktion OrderConfirmation

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) ändringar jämfört med SOAP (version 2)

SOAP (version 3) ändringar jämfört med 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: Australiska samväldet (AUS), Bailiwick of Jersey (JEY), Bolivarianska republiken Venezuela (VEN), Bolivias plurinationella stat (BOL), Bosnien och Hercegovina (BIH), Demokratiska folkrepubliken Algeriet (DZA), Demokratiska socialistiska republiken Sri Lanka (LKA), Elfenbenskusten (CIV), Federala demokratiska republiken Etiopien (ETH), Folkrepubliken Kina (CHN), Franska Guyana (GUF), Franska republiken (FRA), Furstendömet Liechtenstein (LIE), Furstendömet Monaco (MCO), Förbundsrepubliken Brasilien (BRA), Förbundsrepubliken Nigeria (NGA), Förbundsrepubliken Tyskland (DEU), Förenade Arabemiraten (ARE), Förenade konungariket Storbritannien och Nordirland (GBR), Förenade republiken Tanzania (TZA), Georgien (GEO), Grönland (GRL), Guadeloupe (GLP), Hong Kong (HKG), Irland (IRL), Isle of Man (IMN), Italienska republiken (ITA), Japan (JPN), Kanada (CAN), Kirgizistan (KGZ), Konungariket Belgien (BEL), Konungariket Danmark (DNK), Konungariket Marocko (MAR), Konungariket Nederländerna (NLD), Konungariket Norge (NOR), Konungariket Spanien (ESP), Konungariket Sverige (SWE), Konungariket Thailand (THA), Kooperativa republiken Guyana (GUY), Kosovo (XXK), Martinique (MTQ), Mayotte (MYT), Mongoliet (MNG), Nya Zeeland (NZL), Portugisiska republiken (PRT), Republiken Albanien (ALB), Republiken Angola (AGO), Republiken Argentina (ARG), Republiken Azerbajdzjan (AZE), Republiken Benin (BEN), Republiken Botswana (BWA), Republiken Bulgarien (BGR), Republiken Chile (CHL), Republiken Cypern (CYP), Republiken Ecuador (ECU), Republiken Estland (EST), Republiken Filippinerna (PHL), Republiken Finland (FIN), Republiken Gambia (GMB), Republiken Grekland (GRC), Republiken Guinea (GIN), Republiken Island (ISL), Republiken Kazakstan (KAZ), Republiken Kenya (KEN), Republiken Kina (TWN), Republiken Kongo (COG), Republiken Kroatien (HRV), Republiken Lettland (LVA), Republiken Litauen (LTU), Republiken Madagaskar (MDG), Republiken Maldiverna (MDV), Republiken Malta (MLT), Republiken Mauritius (MUS), Republiken Moldavien (MDA), Republiken Namibia (NAM), Republiken Paraguay (PRY), Republiken Peru (PER), Republiken Polen (POL), Republiken Rwanda (RWA), Republiken San Marino (SMR), Republiken Serbien (SRB), Republiken Seychellerna (SYC), Republiken Singapore (SGP), Republiken Slovenien (SVN), Republiken Sydafrika (ZAF), Republiken Tadzjikistan (TJK), Republiken Ungern (HUN), Republiken Uzbekistan (UZB), Republiken Vitryssland (BLR), Republiken Zambia (ZMB), Republiken Zimbabwe (ZWE), Republiken Österrike (AUT), Rumänien (ROU), Ryska federationen (RUS), Samfundet Sankt Martin (MAF), Samoas oberoende stat (WSM), Schweiziska edsförbundet (CHE), Slovakien (SVK), Staten Israel (ISR), Storhertigdömet Luxemburg (LUX), Tjeckien (CZE), Togolesiska republiken (TGO), Återförening (REU), Östra Republiken Uruguay (URY)

- 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: Folkrepubliken Kina (CHN), Franska republiken (FRA), Förbundsrepubliken Tyskland (DEU), Förenade konungariket Storbritannien och Nordirland (GBR), Irland (IRL), Italienska republiken (ITA), Kirgizistan (KGZ), Konungariket Belgien (BEL), Konungariket Nederländerna (NLD), Konungariket Norge (NOR), Konungariket Spanien (ESP), Konungariket Sverige (SWE), Mongoliet (MNG), Portugisiska republiken (PRT), Republiken Azerbajdzjan (AZE), Republiken Bulgarien (BGR), Republiken Estland (EST), Republiken Finland (FIN), Republiken Grekland (GRC), Republiken Kazakstan (KAZ), Republiken Kroatien (HRV), Republiken Malta (MLT), Republiken Moldavien (MDA), Republiken Polen (POL), Republiken Slovenien (SVN), Republiken Ungern (HUN), Republiken Österrike (AUT), Ryska federationen (RUS), Schweiziska edsförbundet (CHE), Slovakien (SVK), Storhertigdömet Luxemburg (LUX), Tjeckien (CZE)

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

3) Function: GetReport

- Changes in of available languages: bg (Bulgariska), cs (Tjeckien), da (danska), de (Tyska), el (Grekiska), en (Engelska), es (Spanska), et (Estniska), fi (finska), fr (Franska), hu (Ungerska), id (indonesiska), it (Italienska), ja (Japanska), ko (Koreanska), lt (Litauiska), lv (Lettiska), nb (Norska Bokmål), nl (Nederländska), pl (Polsk), pt (Portugisiska), ro (Rumänska), ru (Ryska), sk (Slovakien), sl (Slovenska), sr (Српски), sv (Svenska), tr (Turkiska), uk (Ukrainska), zh (Kinesiska)

SOAP (version 3) ändringar jämfört med 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

Nya element:

- search_result_id (is required for order with delivery_term = 'o')

- name_transliteration

- reg_code

- vat_code

- unified_legal_form

Webhooks Settings

Översikt

En webhook är ett sätt för en applikation att förse andra applikationer med realtidsinformation. Vår webhook-funktion implementerar HTTP-callbacks som konfigureras med en URL. En HTTP POST-nyttolast skickas till denna URL i JSON-format när en angiven händelse inträffar. I samband med vårt projekt har vi utformat webhook-funktionen för att utlösa specifika händelser.

Konfigurera en webhook

För att konfigurera en webhook för din applikation, navigera till sidan för applikationsinställningar och leta efter avsnittet "Webhooks Settings". Ange följande information:

"Webhook URL" är den URL där servern tar emot POST-förfrågningar från webhook.

"Delivery max attempts" är den inställning som definierar det maximala antalet försök som ska göras för att leverera en webhook-händelse när det första leveransförsöket misslyckas.

"Delivery retry timeout" är en inställning som gör att du kan ange tidsintervallet mellan omförsöken när ett leveransförsök för en webhook misslyckas.

När du har angett dessa uppgifter klickar du på "Spara".

Händelsetyper för webhook

Ny status för ordern

Webhook nyttolast

När en händelse inträffar skickar vi en HTTP POST-begäran till nyttolastens URL med en JSON-kropp som innehåller information om händelsen.

Här är ett exempel på en nyttolast:

Nyttolast exempel på ny status för order

Möjliga värden för fältet "new_status":

"Finished" - en order är komplett. En order kan hämtas;

"Updated" - en order uppdateras, uppgifter läggs till i en slutförd order;

"Canceled" - en order annulleras på kundens begäran (eller medgivande);

"Rejected" - en order avvisas. Vanligtvis för att det är omöjligt att identifiera ett företag.

Säkra dina webhooks

Det är viktigt att verifiera att POST-förfrågningar som skickas till nyttolastens URL kommer från vår applikation. För att hjälpa till med detta innehåller varje webhook-förfrågan en X-Signature-header.

Beskrivning av signatur

För signering använder vi HMAC med SHA512-algoritmen.

Secret är en sammankoppling av App ID och Secret Key från inställningarna för webhooks.

Det är möjligt att lägga till egna get-params till slutpunkten för att identifiera avsändaren vid behov.

Felsökning

En server måste svara inom 10 sekunder och returnera en 2XX HTTP-kod, annars anses leveransen av webhooken ha misslyckats. Om leveransen misslyckas kommer funktionen att försöka skicka begäran på nytt enligt leveranspolicyn.