Infoproff API-dokumentaatio - v2

Switch-versio V2

Aloittaminen

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

http://wsdfn.infoproff.com/v2/

Verkkopalvelun päätoiminnot:

  • SimpleSearch - Etsi yritysten tietoja eri maista.
  • Order - Luo order_id ja palauttaa kaksoiskappaleet. Kaksoiskappaleet valitaan seuraavien parametrien mukaan: country, product, delivery_term and 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)
  2. Offline-raportit seuraavista maista: Kaikki maat
  3. Luottolausuntolaskuri

Miten etsiä yritystä?

Yrityshaku koostuu 2 vaihtoehdosta:

  1. Haku yrityksen nimen mukaan,
  2. Haku rekisteröintikoodin mukaan.
Luettelo käytettävissä olevista maista: Suomen tasavalta (FIN), Ruotsin kuningaskunta (SWE), Norjan kuningaskunta (NOR), Tanskan kuningaskunta (DNK)
Tärkeää tietoa:
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

Miten tilata luottotietoraportti?

Rekisteröinnistä raportin vastaanottamiseen kuluu seuraavat vaiheet:

  1. Käyttäjä rekisteröi uuden tilauksen (toiminto "Tilaus"). Järjestelmä palauttaa tilauksen tiedot, luettelon viimeisten 60 päivän aikana tehdyistä päällekkäisistä tilauksista ja odottaa tilausvahvistusta.
  2. Käyttäjä vahvistaa tilauksen (toiminto "OrderConfirmation"). Järjestelmä lähettää tilauksen tuotantoon ja palauttaa nykyisen tuotantotilanteen.
  3. Käyttäjä tarkistaa tilauksen tilan (toiminto "ChkStatus").
  4. Jos tilaus on valmis, käyttäjä voi ladata raportin (toiminto "GetReport").
Luettelo käytettävissä olevista maista: Suomen tasavalta (FIN), Ruotsin kuningaskunta (SWE)
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)

Alla on esimerkki:

VAIHE 1: Tilaa raportti

Käyttäjät, jotka pitävät tilausvahvistusvaihetta tarpeettomana, voivat käyttää elementtiä "confirm_order" ja antaa arvon "TRUE".

Yleensä luottotietoraportin laatiminen verkossa kestää 10-20 sekuntia.
Sen vuoksi verkkoraportteja varten tarkistukset olisi tehtävä vähintään 5 sekunnin välein.

Luettelo testitiliä varten käytettävissä olevista yrityksistä:

01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
Lisäksi voit käyttää verkkoraporteissa (delivery_term = "o") kunkin maan osalta luotuja näytteitä (käytä rekisteröintikoodia "00000000"). Nämä raportit ovat maksuttomia, ja niitä voi tilata testitiliä käyttäen.
Toiminto Order
Toiminto OrderCancellation

VAIHE 2. Tilausvahvistus

Toiminto OrderConfirmation

VAIHE 3. Tilan tarkistus

Toiminto ChkStatus

VAIHE 4. Hanki raportti

Luettelo Online-raporttien käytettävissä olevista kielistä: en (English), et (Estonian), ru (Russian), de (German)
Online-raportin lataaminen pdf-muodossa ei ole vielä mahdollista.
Toiminto GetReport

Seuraavia tiloja käytetään raporteissa:

  • Käynnissä - Raportti tuotantovaiheessa
  • 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.

Miten ladata offline-raportti?

Voit ladata Offline-raportit suoraan. Tässä on ohje, miten sinun on tehtävä se:

Pyyntö koostuu kolmesta osasta:

  1. Kiinteä osa 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

Mahdolliset virheet

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

Kaikki toiminnot
  • Väärä käyttäjätunnus/salasana tai sinulla ei ole oikeuksia.
    Syötät väärät tunnistetiedot tai API-käyttömahdollisuutesi on estetty.
Toiminto SimpleSearch
  1. Teillä ei ole lupia tehdä etsintöjä tässä maassa.
    Luettelo käytettävissä olevista maista: Suomen tasavalta (FIN), Ruotsin kuningaskunta (SWE)
Toiminto Order
  1. Tätä tuotetta ei ole saatavilla.
    Tällaista tuotetta ei löydy, eikä sitä voi tilata.
  2. Et voi tilata raporttia yrityksestä, jolla on oikeudellinen muoto: "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. Tämä yritys ei ole testiluettelossa.
    Yrityksen rekisteröintikoodi ei ole testiluettelossamme.
    Luettelo testitiliä varten käytettävissä olevista yrityksistä:
    01120389 FIN, 01163231 FIN, 01332146 FIN, 01795458 FIN, 02245466 FIN, 07640633 FIN, 08481566 FIN, 08607931 FIN, 09484603 FIN, 09488655 FIN, 16366779 FIN, 16433070 FIN, 16457849 FIN, 16564505 FIN, 19148611 FIN, 20453920 FIN, 20453947 FIN, 26513621 FIN, 27019879 FIN, 27240442 FIN, 27330384 FIN, 27748684 FIN, 28725388 FIN, 29048796 FIN, 5560117482 SWE, 5564294089 SWE, 5566436035 SWE, 5569760464 SWE
  4. Yrityksen nimi tai rekisterikoodi vaaditaan
    Offline-raporttia tilattaessa (delivery_term = "n", "f" tai "s") vaaditaan "Business Name" tai "Reg Code".
  5. Reg-koodi tarvitaan, kun toimitusehto on Online
    Kun tilaat online-raportin (delivery_term = "o"), "Reg Code" vaaditaan.
Toiminto GetReport
  1. Tätä kieltä ei tueta.
    Luettelo Online-raporttien käytettävissä olevista kielistä: en (English), et (Estonian), ru (Russian), de (German)
Toiminnot GetReport ChkStatus
  1. Väärä tilaus_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. Sinulla ei ole enää lupaa vahvistaa tilausta. Vahvistus voidaan tehdä tunnin kuluessa siitä, kun olet saanut 'order_id'.

SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2).

SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2). [Yleiskatsaus]

1) Uusi toiminto: ChkFinance

Allows you to search for available financial statements.
Currently available only in EST (Estonia), SWE (Sweden)

2) Toiminto: SimpleSearch

- Changes in list of available countries: Finland (FIN), Sweden (SWE), Norway (NOR), Denmark (DNK), Belgium (BEL), Estonia (EST), Netherlands (NLD), United Kingdom (GBR), Ireland (IRL), France (FRA), Spain (ESP), Portugal (PRT), Germany (DEU), Italy (ITA), Austria (AUT), Switzerland (CHE), Cyprus (CYP)

- 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) Toiminto: Order
Identification is required!

Jotta voit tehdä verkkotilauksen, sinun on saatava 'search_result_id' funktiosta 'SimpleSearch', ja vasta sen jälkeen voit tehdä verkkotilauksen (delivery_term = 'o').

- Muutokset online-luottotietoja varten käytettävissä olevien maiden luettelossa: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Tilinpäätöstiedot ovat ladattavissa (käyttämällä tuotetta: finances) online-tilassa.: Estonia (EST), Sweden (SWE)

3) Toiminto: GetReport

- Changes in of available languages: en (English), et (Estonian), ru (Russian), de (German), zh (Chinese), ja (Japanese), bg (Bulgarian), cs (Czech), da (Danish), el (Greek), fi (Finnish), fr (French), hu (Hungarian), it (Italian), lv (Latvian), lt (Lithuanian), nl (Dutch), pl (Polish), pt (Portuguese), ro (Romanian), sk (Slovak), sl (Slovenian), es (Spanish), sv (Swedish)


SOAPin (versio 3) muutokset verrattuna SOAPiin (versio 2). [WSDL and XSD]

File: report.xsd

Uudet elementit:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Uusi toiminto:

- 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

Uusi elementti:

- preferable_finances

NB: This element is required only ordering a product: finances (Financial statements) with delivery_term = 'o'.

3) SimpleSearchRequest

Poistettu elementti:

search_block.reg_code

Uusi elementti:

search_block->company_code

NB: in some countries we allow to search companies by vat_code.

4) SimpleSearchResponse

Poistetut elementit

- code

Uudet elementit:

  • - search_result_id (is required for order with delivery_term = 'o')
  • - name_transliteration
  • - reg_code
  • - vat_code
  • - unified_legal_form