Infoproff API dokumentatsioon - v2

Vaheta versiooni V2

Alustamine

Veebiteenuse wsdl ja skeemid asuvad siin:

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

Veebiteenuse põhifunktsioonid:

  • SimpleSearch - Otsige teavet ettevõtete kohta erinevates riikides.
  • Order - Luuakse order_id ja tagastatakse duplikaadid. Duplikaadid valitakse järgmiste parameetrite järgi: country, product, delivery_term and reg_code.
  • OrderCancellation - Kui olete saatnud tellimuse ja saanud order_id, on teil võimalus see tellimus tühistada (kui see ei ole veel tootmisse läinud).
  • OrderConfirmation - Pärast seda, kui olete saanud order_id, peate oma tellimuse kinnitama 1 tunni jooksul. Kui te ei kinnita oma tellimust 1 tunni jooksul, tühistatakse tellimus automaatselt.
  • ChkStatus - Kontrollige tellimuse staatust.
  • GetReport - Hankige valmis aruanded.
  • GetClassifiersFinancialStatements - Hangib kõik finantsdokumendid kõigi elementidega: row_number, row_formated_description, row_lang_key ja row_order.
  • GetLegalForms - Hangi kõik õiguslikud vormid kõigi olemasolevate riikide jaoks.
  • GetActivityClassificators - Hangi kõik koodid ja kirjeldused konkreetse tegevusala klassifikaatori jaoks.
  • GetDictionaryStandardPhrases - Saate kõik standardfraasid koos võtmete ja keelega.
  • GetAvailableProducts - Hankige nimekiri saadaolevatest toodetest.
  • CreditOpinionCalculator - Krediidihinnangu kalkulaator aitab määrata ettevõtte krediidihinnangut.

API pakub mitmeid teenuseid:

  1. Online-krediidiaruanded järgmiste riikide kohta: Soome (FIN), Rootsi (SWE)
  2. Offline-aruanded järgmiste riikide kohta: Kõik riigid
  3. Krediidiarvamuse kalkulaator

Kuidas otsida ettevõtet?

Ettevõtte otsing koosneb 2 valikust:

  1. Otsing ettevõtte nime järgi,
  2. Otsing registreerimiskoodi järgi.
Olemasolevate riikide loetelu: Soome (FIN), Rootsi (SWE), Norra (NOR), Taani (DNK)
Oluline teave:
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.
Field's length:
company_name varchar(512)
company_code varchar(64)

Allpool leiate näite:

Funktsioon SimpleSearch

Võimalus 2: Otsing registreerimiskoodi järgi

Funktsioon SimpleSearch

Kuidas tellida krediidiinfo?

Registreerimisest kuni aruande kättesaamiseni kulgevad järgmised etapid:

  1. Kasutaja registreerib uue tellimuse (funktsioon "Tellimus"). Süsteem tagastab tellimuse üksikasjad, viimase 60 päeva jooksul tehtud duplikaatide nimekirja ja ootab tellimuse kinnitust.
  2. Kasutaja kinnitab tellimuse (funktsioon "OrderConfirmation"). Süsteem saadab tellimuse tootmisse ja tagastab praeguse tootmisseisundi.
  3. Kasutaja kontrollib tellimuse staatust (funktsioon "ChkStatus").
  4. Kui tellimus on valmis, saab kasutaja aruande alla laadida (funktsioon "GetReport").
Olemasolevate riikide loetelu: Soome (FIN), Rootsi (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)

Allpool leiate näite:

1. samm: aruande tellimine

Kasutajad, kes peavad tellimuse kinnitamise sammu mittevajalikuks, võivad kasutada elementi "confirm_order" ja edastada väärtuse "TRUE".

Tavaliselt kulub krediidireporti koostamiseks veebipõhises režiimis 10-20 sekundit.
Seetõttu peaksite veebipõhiste aruannete puhul tegema kontrolle iga 5 või enama sekundi järel.

Testkonto jaoks kättesaadavate ettevõtete nimekiri:

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
Lisaks saate veebipõhiste aruannete (delivery_term = "o") puhul kasutada iga riigi jaoks loodud näidiseid (kasutage registreerimiskoodi "00000000"). Need aruanded on tasuta ja neid saab tellida testkonto abil.
Funktsioon Order
Funktsioon OrderCancellation

2. SAMM. Tellimuse kinnitamine

Funktsioon OrderConfirmation

STEP 3. Staatuse kontrollimine

Funktsioon ChkStatus

SAMM 4. Hangi aruanne

Online-aruannete jaoks kättesaadavate keelte loetelu: en (English), et (Estonian), ru (Russian), de (German)
Veebipõhise aruande allalaadimine pdf-formaadis ei ole veel võimalik.
Funktsioon GetReport

Aruannete puhul kasutatakse järgmisi olekuid:

  • Toimumisel - Aruanne tootmisetapis
  • Canceled - Tühistatud tellimus
  • Finished - Aruanne on valmis
  • Updated - Valmis aruandesse lisati teave
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Meie süsteemis on ilmnenud tehniline viga. See tähendab, et meid on sellest veast teavitatud ja me parandame selle niipea kui võimalik. Teid teavitatakse, kui saate tellimuse kätte.

Kui täitmise staatus on Finished või Updated, siis saate tellimuse.

Kuidas laadida alla Offline-aruanne?

Saate otse alla laadida Offline-aruandeid. Siin on juhised, kuidas seda teha:

Taotlus koosneb 3 osast:

  1. Fikseeritud osa https://www.infoproff.com/en/orders/files/
  2. Teie unikaalne hash, mille me anname vastuseks
  3. Ja fikseeritud osa lõpus /download

Kuidas saada krediidihinnangut?

Funktsioon CreditOpinionCalculator

Kuidas saada lisateavet?

Funktsioon GetClassifiersFinancialStatements
Funktsioon GetActivityClassificators
Funktsioon GetDictionaryStandardPhrases
Funktsioon GetAvailableProducts

Võimalikud vead

Need vead võivad ilmneda meie veebiteenusele taotluse esitamisel.

Kõik funktsioonid
  • Vale kasutajanimi/parool või teil ei ole õigusi.
    Te sisestate valed volitused või teie API-juurdepääs on blokeeritud.
Funktsioon SimpleSearch
  1. Teil ei ole selles riigis otsingulubasid.
    Olemasolevate riikide loetelu: Soome (FIN), Rootsi (SWE)
Funktsioon Order
  1. See toode ei ole saadaval.
    Sellist toodet ei leia ja seda ei ole võimalik tellida.
  2. Te ei saa tellida aruannet juriidilise vormiga ettevõtte kohta: "legal_form"
    See viga kehtib ainult: Rootsi (SWE)
    Rootsis ei ole võimalik tellida veebipõhist aruannet (delivery_term = "o") koos järgmiste juriidiliste vormidega:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. See ettevõte ei ole testimisnimekirjas.
    Ettevõtte registreerimiskood ei ole meie testimisnimekirjas.
    Testkonto jaoks kättesaadavate ettevõtete nimekiri:
    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. Vajalik on ärinimi või reg-kood
    Offline-aruande tellimisel (delivery_term = "n", "f" või "s") on nõutav "Business Name" või "Reg Code".
  5. Reg-kood on nõutav, kui tarneaeg on Online
    Kui tellite veebipõhise aruande (delivery_term = "o"), siis on nõutav "Reg Code".
Funktsioon GetReport
  1. Seda keelt ei toetata.
    Online-aruannete jaoks kättesaadavate keelte loetelu: en (English), et (Estonian), ru (Russian), de (German)
Funktsioonid GetReport ChkStatus
  1. Vale order_id.
    Tellimuse ID-d ei leia. Tellimuse ID saate, kui kasutate funktsiooni Order.
Funktsioon OrderCancellation
  1. Your order is already canceled.
    Teil ei ole enam luba tellimuse tühistamiseks.
Funktsioon OrderConfirmation
  1. Teil ei ole enam luba tellimuse kinnitamiseks. Kinnitus võib toimuda ühe tunni jooksul pärast tellimuse 'order_id' saamist.

SOAPi (versioon 3) muudatused võrreldes SOAPiga (versioon 2)

SOAPi (versioon 3) muudatused võrreldes SOAPiga (versioon 2) [Ülevaade]

1) Uus funktsioon: ChkFinance

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

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

Online-tellimuse tegemiseks peate saama funktsioonilt "SimpleSearch" 'search_result_id' ja alles pärast seda saate esitada online-tellimuse (delivery_term = 'o').

- Muudatused veebipõhiste krediidiinformatsioonide jaoks kättesaadavate riikide nimekirjas: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Võimalik finantsaruannete allalaadimine (kasutades toodet: rahandus) veebirežiimis: Estonia (EST), Sweden (SWE)

3) Funktsioon: 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)


SOAPi (versioon 3) muudatused võrreldes SOAPiga (versioon 2) [WSDL and XSD]

File: report.xsd

Uued elemendid:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Uus funktsioon:

- 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

Uus element:

- preferable_finances

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

3) SimpleSearchRequest

Eemaldatud element:

search_block.reg_code

Uus element:

search_block->company_code

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

4) SimpleSearchResponse

Eemaldatud elemendid

- code

Uued elemendid:

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