Veebiteenuse wsdl ja skeemid asuvad siin:
http://wsdfn.infoproff.com/v3/
Web service functions:
API pakub mitmeid teenuseid:
Ettevõtte otsing koosneb 2 valikust:
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.
Norra register ei võimalda kustutatud äriühingute otsingut nimede järgi. Seetõttu ei saa me Norra kustutatud äriühingute puhul pakkuda SimpleSearch nime järgi.
Allpool leiate näite:
Below you can find the example of how to order and download reports:
To order an Online/Offline with identification report you need to receive "<search_result_id>".
To do so, please follow the link: Kuidas otsida ettevõtet?
Aruannete puhul kasutatakse järgmisi olekuid:
Kui täitmise staatus on Finished või Updated, siis saate tellimuse.
Aruannete puhul kasutatakse järgmisi olekuid:
Kui täitmise staatus on Finished või Updated, siis saate tellimuse.
To order an online financial statements, you need to receive "<search_result_id>".
To do so, please follow the link: Kuidas otsida ettevõtet?
Seda funktsiooni on vaja ainult siis, kui tellite toote: finances (Financial statements) koos delivery_term = 'o'.
Aruannete puhul kasutatakse järgmisi olekuid:
If the execution status is Finished or Updated, then you can get an order.
Taotlus koosneb 3 osast:
/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
https://www.infoproff.com/en/orders/files/<order_hash>/report?&lang=en&doc_type=pdf¤cy_position=left&preferred_currency=EUR
Taotlus koosneb 3 osast:
delivery_term:
Need vead võivad ilmneda meie veebiteenusele taotluse esitamisel.
Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)
- Changes in list of available countries: Araabia Ühendemiraadid (ARE), Aserbaidžaan (AZE), Austraalia (AUS), Austria (AUT), Belgia (BEL), Eesti (EST), Gruusia (GEO), Gröönimaa (GRL), Hiina (CHN), Hiina Vabariik (TWN), Hispaania (ESP), Holland (NLD), Hongkong (HKG), Iirimaa (IRL), Iisrael (ISR), Itaalia (ITA), Jaapan (JPN), Kasahstan (KAZ), Kosovo (XXK), Kõrgõzstan (KGZ), Küpros (CYP), Läti (LVA), Moldova (MDA), Mongoolia (MNG), Norra (NOR), Poola (POL), Portugal (PRT), Prantsusmaa (FRA), Rootsi (SWE), Saksamaa (DEU), Samoa (WSM), Seišellid (SYC), Singapur (SGP), Soome (FIN), Suurbritannia (GBR), Taani (DNK), Tadžikistan (TJK), Usbekistan (UZB), Valgevene (BLR), Šveits (CHE)
- 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.
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: Belgia (BEL), Eesti (EST), Hiina (CHN), Holland (NLD), Kasahstan (KAZ), Kõrgõzstan (KGZ), Mongoolia (MNG), Poola (POL), Rootsi (SWE), Soome (FIN)
- Available to download financial statements (using product: finances) in online mode: Estonia (EST), Sweden (SWE)
- Changes in of available languages: bg (Bulgaaria), cs (Tšehhi), da (Taani), de (Saksa), el (Kreeka), en (Inglise), es (Hispaania), et (Eesti), fi (Soome), fr (Prantsuse), hu (Ungari), id (Indoneesia), it (Itaalia), ja (Jaapani), ko (Korea), lt (Leedu), lv (Läti), nb (Norra keel Bokmål), nl (Hollandi), pl (Poola), pt (Portugali), ro (Rumeenia), ru (Venemaa), sk (Slovakkia), sl (Sloveenia), sr (Српски), sv (Rootsi), tr (Türgi), uk (Ukraina), zh (Hiina)
New elements:
- report/negative_information/debts/item/remainder_range
- report/negative_information/debts/item/remainder_non_standard_range
New function:
- ChkFinance
Function that allows you to search for available financial statements.
1) OrderReportRequest has a choice:
- order_details:
Using general information: business_name, reg_code, vat_code, address, phone, email, additional_info
- order_details_by_id:
Using 'search_result_id'
2) order_details
New element:
- preferable_finances
3) SimpleSearchRequest
Removed element:
search_block.reg_code
New element:
search_block->company_code
4) SimpleSearchResponse
Removed elements
- code
Uued elemendid:
Veebikonks on viis, kuidas rakendus saab teistele rakendustele reaalajas teavet edastada. Meie webhook-funktsioon rakendab HTTP-kõnesid, mis on konfigureeritud URL-i abil. Sellele URL-ile saadetakse JSON-vormingus HTTP POST-saateleht, kui toimub kindlaksmääratud sündmus. Meie projekti kontekstis oleme kujundanud webhook-funktsiooni konkreetsete sündmuste käivitamiseks.
Veebikonksu seadistamiseks rakenduse jaoks navigeeri rakenduse seadete lehele ja otsi jaotist "Veebikonksude seaded". Ja esitage järgmised andmed:
Pärast nende andmete esitamist klõpsake nuppu "Salvesta".
Kui sündmus toimub, saadame HTTP POST päringu tasulise URL-i aadressile koos JSON-korpusega, mis sisaldab teavet sündmuse kohta.
Oluline on kontrollida, et POST päringud, mis saadetakse kasulikule URL-ile, on meie rakendusest. Selle abistamiseks sisaldab iga veebikonksu taotlus X-Signature päise.
Allkirjastamiseks kasutame HMAC-i ja SHA512 algoritmi.
Saladus on rakenduse ID ja salajase võtme ühendamine veebikonksude seadetest.
Vajaduse korral on võimalik lõpp-punktile lisada oma get-parameetrid saatja tuvastamiseks.
Server peab vastama 10 sekundi jooksul ja tagastama HTTP-koodi 2XX; vastasel juhul loetakse veebikonksu edastamine ebaõnnestunuks. Ebaõnnestumise korral üritab funktsioon päringut uuesti saata vastavalt tarnepoliitikale.