Infoproff API-dokumentaatio - v4

Switch-versio V4

Aloittaminen

Verkkopalvelun wsdl ja kaaviot sijaitsevat täällä.:

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 - Etsi yritysten tietoja eri maista.
  • ChkFinance - Etsi saatavilla olevia tilinpäätöksiä.
  • Order - Luo order_id ja palauttaa kaksoiskappaleet. Kaksoiskappaleet valitaan seuraavien parametrien mukaan: country, product, reg_code.
  • OrderCancellation - Jos olet lähettänyt tilauspyynnön ja saanut order_id, sinulla on mahdollisuus peruuttaa tilaus (jos se ei ole mennyt tuotantoon).
  • OrderConfirmation - Kun olet saanut order_id, sinun on vahvistettava tilauksesi 1 tunnin kuluessa. Jos et vahvista tilausta 1 tunnin kuluessa, tilaus peruutetaan automaattisesti.
  • ChkStatus - Tarkista tilauksen tila.
  • GetReport - Hanki valmiit raportit.
  • GetClassifiersFinancialStatements - Hae kaikki rahoitusasiakirjat, joissa on kaikki elementit: row_number, row_formated_description, row_langing_key ja row_order.
  • GetLegalForms - Hanki kaikki oikeudelliset lomakkeet kaikista saatavilla olevista maista.
  • GetActivityClassificators - Hae kaikki tietyn toiminnan luokittelijan koodit ja kuvaukset.
  • GetDictionaryStandardPhrases - Saat kaikki vakiolausekkeet avaimilla ja kielellä.
  • GetAvailableProducts - Saat luettelon saatavilla olevista tuotteista.
  • CreditOpinionCalculator - Credit Opinion Calculator auttaa antamaan yritykselle luottoluokituksen.

API tarjoaa useita palveluja:

  1. Online-luottoraportit seuraavista maista: Suomen tasavalta (FIN), Ruotsin kuningaskunta (SWE), Belgian kuningaskunta (BEL), Alankomaiden kuningaskunta (NLD), Viron tasavalta (EST), Kazakstanin tasavalta (KAZ), Puolan tasavalta (POL), Kirgisian tasavalta (KGZ), Kiinan kansantasavalta (CHN), Mongolia (MNG)
  2. Offline-raportit seuraavista maista: Kaikki maat
  3. Luottolausuntolaskuri

Miten etsiä yritystä?

Yrityshaku koostuu 2 vaihtoehdosta:

  1. Haku yrityksen nimen mukaan,
  2. Search by company code.
Luettelo käytettävissä olevista maista: Alankomaiden kuningaskunta (NLD), Albanian tasavalta (ALB), Algerian demokraattinen kansantasavalta (DZA), Angolan tasavalta (AGO), Argentiinan tasavalta (ARG), Australian kansainyhteisö (AUS), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Beninin tasavalta (BEN), Bolivian monikansallinen valtio (BOL), Bosnia ja Hertsegovina (BIH), Botswanan tasavalta (BWA), Brasilian liittotasavalta (BRA), Bulgarian tasavalta (BGR), Chilen tasavalta (CHL), Ecuadorin tasavalta (ECU), Espanjan kuningaskunta (ESP), Etelä-Afrikan tasavalta (ZAF), Etiopian demokraattinen liittotasavalta (ETH), Filippiinien tasavalta (PHL), Gambian tasavalta (GMB), Georgia (GEO), Grönlanti (GRL), Guadeloupe (GLP), Guinean tasavalta (GIN), Guyanan osuustoiminnallinen tasavalta (GUY), Helleenien tasavalta (GRC), Hong Kong (HKG), Irlanti (IRL), Islannin tasavalta (ISL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Israelin valtio (ISR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Japani (JPN), Jerseyn maakunta (JEY), Kanada (CAN), Kazakstanin tasavalta (KAZ), Kenian tasavalta (KEN), Kiinan kansantasavalta (CHN), Kiinan tasavalta (TWN), Kirgisian tasavalta (KGZ), Kongon tasavalta (COG), Kosovo (XXK), Kroatian tasavalta (HRV), Kyproksen tasavalta (CYP), Latvian tasavalta (LVA), Liechtensteinin ruhtinaskunta (LIE), Liettuan tasavalta (LTU), Luxemburgin suurherttuakunta (LUX), Madagaskarin tasavalta (MDG), Malediivien tasavalta (MDV), Maltan tasavalta (MLT), Mansaari (IMN), Marokon kuningaskunta (MAR), Martinique (MTQ), Mauritiuksen tasavalta (MUS), Mayotte (MYT), Moldovan tasavalta (MDA), Monacon ruhtinaskunta (MCO), Mongolia (MNG), Namibian tasavalta (NAM), Nigerian liittotasavalta (NGA), Norjan kuningaskunta (NOR), Norsunluurannikko (CIV), Paraguayn tasavalta (PRY), Perun tasavalta (PER), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan Guayana (GUF), Ranskan tasavalta (FRA), Romania (ROU), Ruandan tasavalta (RWA), Ruotsin kuningaskunta (SWE), Saint Martinin kollektiivisuus (MAF), Saksan liittotasavalta (DEU), Sambian tasavalta (ZMB), Samoan itsenäinen valtio (WSM), San Marinon tasavalta (SMR), Serbian tasavalta (SRB), Seychellien tasavalta (SYC), Singaporen tasavalta (SGP), Slovakian tasavalta (SVK), Slovenian tasavalta (SVN), Sri Lankan demokraattinen sosialistinen tasavalta (LKA), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tadžikistanin tasavalta (TJK), Tansanian yhdistynyt tasavalta (TZA), Tanskan kuningaskunta (DNK), Tapaaminen (REU), Thaimaan kuningaskunta (THA), Togon tasavalta (TGO), Tšekin tasavalta (CZE), Unkarin tasavalta (HUN), Uruguayn itäinen tasavalta (URY), Uusi-Seelanti (NZL), Uzbekistanin tasavalta (UZB), Valko-Venäjän tasavalta (BLR), Venezuelan bolivariaaninen tasavalta (VEN), Venäjän federaatio (RUS), Viron tasavalta (EST), Zimbabwen tasavalta (ZWE)

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.

Tärkeää tietoa:

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.

Norjan rekisteristä ei voi hakea poistettuja yrityksiä nimien perusteella. Näin ollen emme voi tarjota SimpleSearch -palvelua nimien perusteella Norjassa poistettujen yritysten sisällä.

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

Alla on esimerkki:

Toiminto SimpleSearch

Vaihtoehto 2: Haku rekisteröintikoodin perusteella

Toiminto SimpleSearch

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

Toiminto UnifiedSearch

Miten tilata luottotietoraportti?

List of available countries for online credit reports: Alankomaiden kuningaskunta (NLD), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Bulgarian tasavalta (BGR), Espanjan kuningaskunta (ESP), Helleenien tasavalta (GRC), Irlanti (IRL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Kazakstanin tasavalta (KAZ), Kiinan kansantasavalta (CHN), Kirgisian tasavalta (KGZ), Kroatian tasavalta (HRV), Latvian tasavalta (LVA), Luxemburgin suurherttuakunta (LUX), Maltan tasavalta (MLT), Moldovan tasavalta (MDA), Mongolia (MNG), Norjan kuningaskunta (NOR), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan tasavalta (FRA), Ruotsin kuningaskunta (SWE), Saksan liittotasavalta (DEU), Slovakian tasavalta (SVK), Slovenian tasavalta (SVN), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tanskan kuningaskunta (DNK), Tšekin tasavalta (CZE), Unkarin tasavalta (HUN), Venäjän federaatio (RUS), Viron tasavalta (EST)
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))

Toiminto SimpleSearch

To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Miten etsiä yritystä?

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

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

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

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

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

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Identification pending - Kertomuksen valmistelu on keskeytetty. Vaatii asiakkaalta lisätietoja.
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

Jos suoritustila on Finished tai Updated, voit saada toimeksiannon.

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

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: ar (Arabic), bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), he (Hebrew), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sr (Српски), sv (Ruotsalainen), th (Thai), tr (Turkkilainen), uk (Ukrainan), vi (Vietnamese), zh (Kiinalainen)

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

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

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

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

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

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Identification pending - Kertomuksen valmistelu on keskeytetty. Vaatii asiakkaalta lisätietoja.
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

Jos suoritustila on Finished tai Updated, voit saada toimeksiannon.

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

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: ar (Arabic), bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), he (Hebrew), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sr (Српски), sv (Ruotsalainen), th (Thai), tr (Turkkilainen), uk (Ukrainan), vi (Vietnamese), zh (Kiinalainen)

Miten tilata arkistoitu luottotieto?

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

Toiminto 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: Miten etsiä yritystä?

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

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

Miten tilata tilinpäätöstiedot verkossa?

STEP 1: Find a company

Toiminto SimpleSearch

To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Miten etsiä yritystä?

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: Etsi saatavilla olevia tilinpäätöstietoja

Toiminto ChkFinance

Tätä toimintoa tarvitaan vain tuotetta tilattaessa: finances (Financial statements) ja delivery_term = 'o'.

Luettelo käytettävissä olevista maista: Viron tasavalta (EST), Ruotsin kuningaskunta (SWE)

STEP 3: Tilaa tilinpäätös

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

Toiminto 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

Toiminto 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

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

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • Identification pending - Kertomuksen valmistelu on keskeytetty. Vaatii asiakkaalta lisätietoja.
  • Canceled - Peruutettu tilaus
  • Finished - Raportti on valmis
  • Updated - Valmiiseen kertomukseen on lisätty tietoja
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Järjestelmässämme on tapahtunut tekninen virhe. Tämä tarkoittaa, että olemme tietoisia tästä virheestä ja korjaamme sen mahdollisimman pian. Sinulle ilmoitetaan, kun voit vastaanottaa tilauksen.

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

Toiminto GetReport
Luettelo käytettävissä olevista kielistä: ar (Arabic), bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), he (Hebrew), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sr (Српски), sv (Ruotsalainen), th (Thai), tr (Turkkilainen), uk (Ukrainan), vi (Vietnamese), zh (Kiinalainen)
To see the examples of xml request/response, please follow the link: How to get finished order?

Miten ladata vakioraportteja (muissa muodoissa kuin XML-muodossa)?

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.

Pyyntö koostuu kolmesta osasta:

  1. Kiinteä osa https://www.infoproff.com/en/orders/files/
  2. Yksilöllinen hash-tunnuksesi, jonka annamme vastauksena.
  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 - Alkuperäinen (ei vaihtoa), 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

Miten ladata ei-standardituotteita?

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.

Pyyntö koostuu kolmesta osasta:

  1. Fixed part https://www.infoproff.com/en/orders/files/
  2. Yksilöllinen hash-tunnuksesi, jonka annamme vastauksena.
  3. Ja korjattu osa lopussa /download

Miten saada luottoa koskeva lausunto?

Toiminto CreditOpinionCalculator

Miten saada lisätietoja?

Toiminto GetClassifiersFinancialStatements
Toiminto GetActivityClassificators
Toiminto GetDictionaryStandardPhrases
Toiminto GetAvailableProducts

delivery_term:

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

Mahdolliset virheet

Näitä virheitä voi esiintyä, kun teet pyynnön verkkopalveluumme..

Kaikki toiminnot
  • Incorrect username/password or you have no permissions.
    Syötät väärät tunnistetiedot tai API-käyttömahdollisuutesi on estetty.
Toiminto SimpleSearch
  1. You don't have permissions to search in this country.
    Luettelo käytettävissä olevista maista: Alankomaiden kuningaskunta (NLD), Albanian tasavalta (ALB), Algerian demokraattinen kansantasavalta (DZA), Angolan tasavalta (AGO), Argentiinan tasavalta (ARG), Australian kansainyhteisö (AUS), Azerbaidžanin tasavalta (AZE), Belgian kuningaskunta (BEL), Beninin tasavalta (BEN), Bolivian monikansallinen valtio (BOL), Bosnia ja Hertsegovina (BIH), Botswanan tasavalta (BWA), Brasilian liittotasavalta (BRA), Bulgarian tasavalta (BGR), Chilen tasavalta (CHL), Ecuadorin tasavalta (ECU), Espanjan kuningaskunta (ESP), Etelä-Afrikan tasavalta (ZAF), Etiopian demokraattinen liittotasavalta (ETH), Filippiinien tasavalta (PHL), Gambian tasavalta (GMB), Georgia (GEO), Grönlanti (GRL), Guadeloupe (GLP), Guinean tasavalta (GIN), Guyanan osuustoiminnallinen tasavalta (GUY), Helleenien tasavalta (GRC), Hong Kong (HKG), Irlanti (IRL), Islannin tasavalta (ISL), Ison-Britannian ja Pohjois-Irlannin yhdistynyt kuningaskunta (GBR), Israelin valtio (ISR), Italian tasavalta (ITA), Itävallan tasavalta (AUT), Japani (JPN), Jerseyn maakunta (JEY), Kanada (CAN), Kazakstanin tasavalta (KAZ), Kenian tasavalta (KEN), Kiinan kansantasavalta (CHN), Kiinan tasavalta (TWN), Kirgisian tasavalta (KGZ), Kongon tasavalta (COG), Kosovo (XXK), Kroatian tasavalta (HRV), Kyproksen tasavalta (CYP), Latvian tasavalta (LVA), Liechtensteinin ruhtinaskunta (LIE), Liettuan tasavalta (LTU), Luxemburgin suurherttuakunta (LUX), Madagaskarin tasavalta (MDG), Malediivien tasavalta (MDV), Maltan tasavalta (MLT), Mansaari (IMN), Marokon kuningaskunta (MAR), Martinique (MTQ), Mauritiuksen tasavalta (MUS), Mayotte (MYT), Moldovan tasavalta (MDA), Monacon ruhtinaskunta (MCO), Mongolia (MNG), Namibian tasavalta (NAM), Nigerian liittotasavalta (NGA), Norjan kuningaskunta (NOR), Norsunluurannikko (CIV), Paraguayn tasavalta (PRY), Perun tasavalta (PER), Portugalin tasavalta (PRT), Puolan tasavalta (POL), Ranskan Guayana (GUF), Ranskan tasavalta (FRA), Romania (ROU), Ruandan tasavalta (RWA), Ruotsin kuningaskunta (SWE), Saint Martinin kollektiivisuus (MAF), Saksan liittotasavalta (DEU), Sambian tasavalta (ZMB), Samoan itsenäinen valtio (WSM), San Marinon tasavalta (SMR), Serbian tasavalta (SRB), Seychellien tasavalta (SYC), Singaporen tasavalta (SGP), Slovakian tasavalta (SVK), Slovenian tasavalta (SVN), Sri Lankan demokraattinen sosialistinen tasavalta (LKA), Suomen tasavalta (FIN), Sveitsin valaliitto (CHE), Tadžikistanin tasavalta (TJK), Tansanian yhdistynyt tasavalta (TZA), Tanskan kuningaskunta (DNK), Tapaaminen (REU), Thaimaan kuningaskunta (THA), Togon tasavalta (TGO), Tšekin tasavalta (CZE), Unkarin tasavalta (HUN), Uruguayn itäinen tasavalta (URY), Uusi-Seelanti (NZL), Uzbekistanin tasavalta (UZB), Valko-Venäjän tasavalta (BLR), Venezuelan bolivariaaninen tasavalta (VEN), Venäjän federaatio (RUS), Viron tasavalta (EST), Zimbabwen tasavalta (ZWE)
Toiminto Order
  1. This product is not available.
    Tällaista tuotetta ei löydy, eikä sitä voi tilata.
  2. You can't order report on company with legal form: "legal_form"
    Tämä virhe koskee vain: Ruotsin kuningaskunta (SWE)
    Ruotsissa ei ole mahdollista tilata online-raporttia (delivery_term = "o") seuraavien oikeudellisten lomakkeiden kanssa:
    • 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
    Offline-raporttia tilattaessa (delivery_term = "n", "f" tai "s") vaaditaan "Business Name" tai "Reg Code".
  5. Reg Code is required when delivery term is Online
    Kun tilaat online-raportin (delivery_term = "o"), "Reg Code" vaaditaan.
Toiminto GetReport
  1. This language is not supported.
    Luettelo Online-raporttien käytettävissä olevista kielistä: ar (Arabic), bg (Bulgarian), cs (Tšekki), da (Tanskalainen), de (Saksan), el (Kreikkalainen), en (Englanti), es (Espanjan), et (Viron), fi (Suomalainen), fr (Ranskan), he (Hebrew), hu (Unkarilainen), id (Indonesialainen), it (Italian), ja (Japanilainen), ko (Korean), lt (Liettuan), lv (Latvian), nb (Norjalainen Bokmål), nl (Hollantilainen), pl (Puolan), pt (Portugalin), ro (Romanian), ru (Venäläinen), sk (Slovakian), sl (Slovenian), sr (Српски), sv (Ruotsalainen), th (Thai), tr (Turkkilainen), uk (Ukrainan), vi (Vietnamese), zh (Kiinalainen)
Toiminnot GetReport ChkStatus
  1. Incorrect order_id.
    Tilaustunnusta ei löydy. Saat tilauksen ID:n, kun käytät Order -toimintoa.
Toiminto OrderCancellation
  1. Your order is already canceled.
    Sinulla ei ole enää lupaa peruuttaa tilausta.
Toiminto 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 (versio 4) muutokset verrattuna SOAP (versio 3)

Uudet osat

  • country_economic_overview — sisältää seuraavat alaosat: data_transparency_index, country_development_indicators, economic_forecast.
  • paid_taxes — tiedot maksetuista veroista.
  • tenders — tiedot tarjouskilpailuista.
  • sanctions — lisätty osioon negative_information.

Olemassa olevien osioiden päivitykset

Kohdissa beneficiaries, shareholders, managers ja employees_data on lisätty seuraava elementti:
  • source_type — tietolähteen tyyppi (esim. official, mass_media, company_admin jne.).
relations_of_persons -osioon on lisätty uusi elementti:
  • match_type
capital -osio on uudistettu:
  • Elementin nimi ” capital_amount ” on muutettu nimeksi ” issued_capital ”.
  • Seuraavat uudet elementit on lisätty:
    • number_of_shares
    • share_value
    • authorized_capital
Kohdassa ” employees_data ” (Tietojen lähde):
  • Uusi elementti group_figure ilmaisee, sisältävätkö tiedot ryhmätason aggregoituja lukuja (true).
  • Elementti source_type määrittää tietolähteen tyypin.
  • Elementti is_estimated sisältyy nyt vain, jos sen arvo on true.
Uusi assets_data -osio — yhdistää aiemmin olemassa olleet osiot:
  • real_estate_data (aiemmin nimeltään property_data), vehicles, machinery_and_equipment (aiemmin nimeltään assets).
  • Suunnitellut lisäykset: patents ja biological_assets.
vehicles -osioon on lisätty uusi kenttä:
  • value
litigations -osioon on lisätty seuraavat elementit:
  • content, instance, process, authority
financial_statement/positions ja summary/latest_turnovers on lisätty uusi elementti:
  • value_origin — kuvaa arvon alkuperän; esimerkiksi arvo estimated - tämä arvo on arvioitu ja laskettu käytettävissä olevien tietojen perusteella logiikan tai tekoälyn avulla.
branches_data -osioon on lisätty seuraavat kentät:
  • registration_number
  • director_name

Huomautus: Pieniä parannuksia ja muutoksia voi vielä tulla vakautusvaiheen aikana.

Webhooks Settings

Yleiskatsaus

Webhook on tapa, jolla sovellus voi toimittaa muille sovelluksille reaaliaikaista tietoa. Webhook-ominaisuutemme toteuttaa HTTP-kutsut, jotka on määritetty URL-osoitteella. HTTP POST -hyötykuorma lähetetään tähän URL-osoitteeseen JSON-muodossa aina, kun tietty tapahtuma tapahtuu. Projektimme yhteydessä olemme suunnitelleet webhook-toiminnon käynnistämään tiettyjä tapahtumia.

Webhookin määrittäminen

Jos haluat määrittää webhookin sovellukseesi, siirry sovelluksen asetussivulle ja etsi kohta "Webhooks Settings". Anna seuraavat tiedot:

  1. "Webhook URL" on URL-osoite, johon palvelimesi vastaanottaa webhook POST-pyyntöjä.
  2. "Toimituksen enimmäisyritykset" on asetus, joka määrittelee webhook-tapahtuman toimittamiseksi tehtävien uusintayritysten enimmäismäärän, kun ensimmäinen toimitusyritys epäonnistuu.
  3. "Toimituksen uudelleenkokeilun aikakatkaisu" on asetus, jonka avulla voit määrittää uudelleenkokeilujen välisen ajanjakson, kun webhookin toimitusyritys epäonnistuu.

Kun olet antanut nämä tiedot, napsauta "Tallenna".

Webhook-tapahtumatyypit

  1. Tilauksen uusi tila

Webhookin hyötykuorma

Kun tapahtuma tapahtuu, lähetämme HTTP POST -pyynnön hyötyosoitteen URL-osoitteeseen, jossa on JSON-runko, joka sisältää tietoja tapahtumasta.

Tässä on esimerkki hyötykuormasta:
Esimerkki tilauksen uutta tilaa koskevasta hyötykuormasta
Kentän "new_status" mahdolliset arvot:
  • "Finished" - tilaus on valmis. Tilauksen voi noutaa;
  • "Updated" - päivitetty tilaus, valmiiseen tilaukseen lisättyjä tietoja;
  • "Canceled" - tilaus peruutetaan asiakkaan pyynnöstä (tai suostumuksella).;
  • "Rejected" - tilaus hylätään. Yleensä siksi, että yritystä on mahdotonta tunnistaa....
  • "Identification pending" - Tarvitsemme asiakkaalta lisätietoja, ennen kuin voimme valmistella tilauksen..

Webhookien suojaaminen

On tärkeää varmistaa, että hyötyosoitteen URL-osoitteeseen lähetetyt POST-pyynnöt ovat sovelluksestamme. Tämän helpottamiseksi jokainen webhook-pyyntö sisältää X-Signature-otsikon.

Allekirjoitus Kuvaus

Allekirjoittamiseen käytämme HMAC- ja SHA512-algoritmia.

Salaisuus on sovellustunnuksen ja webhooks-asetusten salaisen avaimen yhdistelmä.

Tarvittaessa on mahdollista lisätä omia get-parameja päätepisteeseen lähettäjän tunnistamiseksi.

Vianmääritys

Palvelimen on vastattava 10 sekunnin kuluessa ja palautettava 2XX HTTP-koodi; muussa tapauksessa webhookin toimitus katsotaan epäonnistuneeksi. Epäonnistumisen sattuessa toiminto yrittää lähettää pyynnön uudelleen toimituskäytännön mukaisesti.