"Infoproff API" dokumentacija - v2

Komutatoriaus versija V2

Darbo pradžia

Žiniatinklio paslaugos wsdl ir schemos pateikiamos čia:

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

Pagrindinės žiniatinklio paslaugos funkcijos:

  • SimpleSearch - Ieškokite informacijos apie įmones įvairiose šalyse.
  • Order - Sukuria order_id ir grąžina dublikatus. Dublikatai atrenkami pagal kitus parametrus: country, product, delivery_term and reg_code.
  • OrderCancellation - Jei išsiuntėte užsakymo užklausą ir gavote order_id, turite galimybę atšaukti šį užsakymą (jei jis dar nepradėtas gaminti).
  • OrderConfirmation - Gavę order_id turėsite patvirtinti užsakymą per 1 valandą. Jei užsakymo nepatvirtinsite per 1 valandą, užsakymas bus automatiškai atšauktas.
  • ChkStatus - Patikrinkite užsakymo būseną.
  • GetReport - Gaukite baigtas ataskaitas.
  • GetClassifiersFinancialStatements - Gaukite visus finansinius dokumentus su visais elementais: eilutės_numeris, eilutės_formuluotas_aprašymas, eilutės_lang_key ir eilutės_order.
  • GetLegalForms - Gaukite visų galimų šalių teisines formas.
  • GetActivityClassificators - Gaukite visus konkrečios veiklos klasifikatoriaus kodus ir aprašymus.
  • GetDictionaryStandardPhrases - Gaukite visas standartines frazes su raktais ir kalba.
  • GetAvailableProducts - Gaukite turimų produktų sąrašą.
  • CreditOpinionCalculator - Kredito nuomonės skaičiuoklė padeda priskirti įmonei kredito nuomonę.

API teikia keletą paslaugų:

  1. Internetinės kredito ataskaitos šiose šalyse: Suomijos Respublika (FIN), Švedijos Karalystė (SWE)
  2. Neprisijungus prie interneto pateiktos šių šalių ataskaitos: Visos šalys
  3. Kredito nuomonės skaičiuoklė

Kaip ieškoti įmonės?

Įmonių paiešką sudaro 2 parinktys:

  1. Paieška pagal įmonės pavadinimą,
  2. Paieška pagal registracijos kodą.
Galimų šalių sąrašas: Suomijos Respublika (FIN), Švedijos Karalystė (SWE), Norvegijos Karalystė (NOR), Danijos Karalystė (DNK)
Svarbi informacija:
Norvegijos registre negalima ieškoti išbrauktų įmonių pagal pavadinimus. Todėl negalime pateikti SimpleSearch pagal pavadinimus ištrintose Norvegijos įmonėse.
Field's length:
company_name varchar(512)
company_code varchar(64)

Žemiau rasite pavyzdį:

Funkcija SimpleSearch

2 galimybė: Paieška pagal registracijos kodą

Funkcija SimpleSearch

Kaip užsisakyti kredito ataskaitą?

Nuo registracijos iki ataskaitos gavimo atliekami šie veiksmai:

  1. Vartotojas užregistruoja naują užsakymą (funkcija "Užsakymas"). Sistema grąžina užsakymo informaciją, per pastarąsias 60 dienų pateiktų dublikatų sąrašą ir laukia užsakymo patvirtinimo.
  2. Vartotojas patvirtina užsakymą (funkcija "OrderConfirmation"). Sistema išsiunčia užsakymą gamybai ir grąžina esamą gamybos būseną.
  3. Vartotojas patikrina užsakymo būseną (funkcija "ChkStatus").
  4. Jei užsakymas parengtas, naudotojas gali atsisiųsti ataskaitą (funkcija "GetReport").
Galimų šalių sąrašas: Suomijos Respublika (FIN), Švedijos Karalystė (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)

Žemiau rasite pavyzdį:

1 ŽINGSNIS: Užsisakykite ataskaitą

Vartotojai, kurie mano, kad užsakymo patvirtinimo etapas nereikalingas, gali naudoti elementą "confirm_order" ir perduoti reikšmę "TRUE".

Paprastai kredito ataskaitos parengimas internetu užtrunka 10-20 sekundžių.
Todėl internetines ataskaitas turėtumėte tikrinti kas 5 ar daugiau sekundžių.

Bandomosios paskyros galimų įmonių sąrašas:

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
Be to, internetinėse ataskaitose (delivery_term = "o"), galite naudoti kiekvienai šaliai sukurtus pavyzdžius (naudokite: registracijos kodą "00000000"). Šios ataskaitos yra nemokamos ir jas galima užsisakyti naudojantis bandomąja paskyra.
Funkcija Order
Funkcija OrderCancellation

2 ŽINGSNIS. Užsakymo patvirtinimas

Funkcija OrderConfirmation

3 ŽINGSNIS. Būsenos tikrinimas

Funkcija ChkStatus

4 ŽINGSNIS. Gaukite ataskaitą

Prieinamų internetinių ataskaitų kalbų sąrašas: en (English), et (Estonian), ru (Russian), de (German)
Internetinės ataskaitos atsisiuntimas pdf formatu dar negalimas.
Funkcija GetReport

Ataskaitoms naudojamos šios būsenos:

  • Vykdoma - Gamybos etapo ataskaita
  • Canceled - Atšauktas užsakymas
  • Finished - Ataskaita parengta
  • Updated - Į parengtą ataskaitą buvo įtraukta informacija
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Mūsų sistemoje įvyko techninė klaida. Tai reiškia, kad esame informuoti apie šią klaidą ir ją kuo greičiau ištaisysime. Jums bus pranešta, kada galėsite gauti užsakymą.

Jei vykdymo būsena yra Finished arba Updated, galite gauti užsakymą.

Kaip atsisiųsti ataskaitą neprisijungus prie interneto?

Galite tiesiogiai atsisiųsti neprisijungus prie interneto parengtas ataskaitas. Čia pateikiama instrukcija, kaip tai padaryti:

Prašymą sudaro 3 dalys:

  1. Fiksuota dalis https://www.infoproff.com/en/orders/files/
  2. Jūsų unikalus hash, kurį pateikiame atsakydami.
  3. Ir fiksuota dalis pabaigoje /download

Kaip gauti kredito nuomonę?

Funkcija CreditOpinionCalculator

Kaip gauti papildomos informacijos?

Funkcija GetClassifiersFinancialStatements
Funkcija GetActivityClassificators
Funkcija GetDictionaryStandardPhrases
Funkcija GetAvailableProducts

Galimos klaidos

Šios klaidos gali atsirasti teikiant užklausą mūsų žiniatinklio paslaugai..

Visos funkcijos
  • Neteisingas naudotojo vardas / slaptažodis arba neturite leidimų.
    Įvedate neteisingus įgaliojimus arba jūsų API prieiga yra užblokuota.
Funkcija SimpleSearch
  1. Šioje šalyje neturite leidimų atlikti kratą.
    Galimų šalių sąrašas: Suomijos Respublika (FIN), Švedijos Karalystė (SWE)
Funkcija Order
  1. Šio produkto nėra.
    Tokio produkto nerandama ir jo neįmanoma užsisakyti.
  2. Negalite užsisakyti ataskaitos apie juridinę formą turinčią įmonę: "legal_form"
    Ši klaida taikoma tik: Švedijos Karalystė (SWE)
    Švedijoje negalima užsisakyti internetinės ataskaitos (delivery_term = "o") su kitomis teisinėmis formomis:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Ši bendrovė nėra įtraukta į bandymų sąrašą.
    Įmonės registracijos kodo nėra mūsų bandymų sąraše.
    Bandomosios paskyros galimų įmonių sąrašas:
    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. Būtina nurodyti įmonės pavadinimą arba reg. kodą
    Užsakant ataskaitą neprisijungus prie interneto (delivery_term = "n", "f" arba "s"), būtina nurodyti "Business Name" arba "Reg Code".
  5. Reg. kodas reikalingas, kai pristatymo terminas yra Online
    Užsakant ataskaitą internetu (delivery_term = "o"), būtina nurodyti "Reg. kodą".
Funkcija GetReport
  1. Ši kalba nepalaikoma.
    Prieinamų internetinių ataskaitų kalbų sąrašas: en (English), et (Estonian), ru (Russian), de (German)
Funkcijos GetReport ChkStatus
  1. Neteisingas order_id.
    Užsakymo ID nerandamas. Užsakymo ID gausite, kai naudosite Order funkciją.
Funkcija OrderCancellation
  1. Your order is already canceled.
    Jūs nebeturite leidimo atšaukti užsakymo.
Funkcija OrderConfirmation
  1. Jūs nebeturite leidimo patvirtinti užsakymo. Patvirtinimas gali būti atliktas per vieną valandą po to, kai gavote "order_id".

SOAP (3 versija) pakeitimai, palyginti su SOAP (2 versija)

SOAP (3 versija) pakeitimai, palyginti su SOAP (2 versija) [Apžvalga]

1) Nauja funkcija: ChkFinance

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

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

Norėdami pateikti užsakymą internetu, turite gauti "search_result_id" iš funkcijos "SimpleSearch" ir tik tada galite pateikti užsakymą internetu (delivery_term = "o").

- Pakeistas šalių, kuriose galima gauti kredito ataskaitas internetu, sąrašas: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Galimybė atsisiųsti finansines ataskaitas (naudojant produktą: finansai) internetiniu režimu: Estonia (EST), Sweden (SWE)

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


SOAP (3 versija) pakeitimai, palyginti su SOAP (2 versija) [WSDL and XSD]

File: report.xsd

Nauji elementai:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nauja funkcija:

- 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

Naujas elementas:

- preferable_finances

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

3) SimpleSearchRequest

Pašalintas elementas:

search_block.reg_code

Naujas elementas:

search_block->company_code

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

4) SimpleSearchResponse

Pašalinti elementai

- code

Nauji elementai:

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