Infoproff API dokumentācija - v2

Slēdža versija V2

Darba sākšana

Web pakalpojuma wsdl un shēmas atrodas šeit.:

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

Tīmekļa pakalpojuma galvenās funkcijas:

  • SimpleSearch - Meklēt informāciju par uzņēmumiem dažādās valstīs.
  • Order - Izveido order_id un atgriež dublikātus. Dublikātus atlasa pēc nākamajiem parametriem: country, product, delivery_term and reg_code.
  • OrderCancellation - Ja nosūtījāt pasūtījuma pieprasījumu un saņēmāt order_id, jums ir iespēja atcelt pasūtījumu (ja tas nav nodots ražošanā).
  • OrderConfirmation - Pēc order_id saņemšanas jums būs jāapstiprina pasūtījums 1 stundas laikā. Ja 1 stundas laikā pasūtījumu neapstiprināsiet, pasūtījums tiks automātiski atcelts.
  • ChkStatus - Pārbaudiet pasūtījuma statusu.
  • GetReport - Saņemiet pabeigtus ziņojumus.
  • GetClassifiersFinancialStatements - Iegūst visus finanšu dokumentus ar visiem elementiem: rindu_numurs, rindas_formulēts_apraksts, rindas_valodas_atslēga un rindas_kārtība.
  • GetLegalForms - Iegūstiet visu pieejamo valstu juridiskās veidlapas.
  • GetActivityClassificators - Iegūstiet visus konkrētās darbības klasifikatora kodus un aprakstus.
  • GetDictionaryStandardPhrases - Iegūstiet visas standarta frāzes ar taustiņiem un valodu.
  • GetAvailableProducts - Saņemiet pieejamo produktu sarakstu.
  • CreditOpinionCalculator - Kredīta atzinuma kalkulators palīdz piešķirt kredītnovērtējumu uzņēmumam.

API nodrošina vairākus pakalpojumus:

  1. Tiešsaistes kredītziņojumi par šādām valstīm: Somijas Republika (FIN), Zviedrijas Karaliste (SWE)
  2. Bezsaistes ziņojumi par šādām valstīm: Visas valstis
  3. Kredīta viedokļa kalkulators

Kā meklēt uzņēmumu?

Uzņēmumu meklēšana sastāv no 2 iespējām:

  1. Meklēt pēc uzņēmuma nosaukuma,
  2. Meklēt pēc reģistrācijas koda.
Pieejamo valstu saraksts: Somijas Republika (FIN), Zviedrijas Karaliste (SWE), Norvēģijas Karaliste (NOR), Dānijas Karaliste (DNK)
Svarīga informācija:
Norvēģijas reģistrs neļauj meklēt dzēstos uzņēmumus pēc nosaukumiem. Tāpēc mēs nevaram nodrošināt SimpleSearch pēc nosaukumiem Norvēģijā dzēstajos uzņēmumos.
Field's length:
company_name varchar(512)
company_code varchar(64)

Zemāk varat atrast piemēru:

Funkcija SimpleSearch

2. iespēja: meklēšana pēc reģistrācijas koda

Funkcija SimpleSearch

Kā pasūtīt kredītinformācijas ziņojumu?

No reģistrācijas līdz ziņojuma saņemšanai ir šādi soļi.:

  1. Lietotājs reģistrē jaunu pasūtījumu (funkcija "Pasūtījums"). Sistēma atgriež informāciju par pasūtījumu, pēdējo 60 dienu laikā veikto dublikātu sarakstu un gaida pasūtījuma apstiprinājumu.
  2. Lietotājs apstiprina pasūtījumu (funkcija "OrderConfirmation"). Sistēma nosūta pasūtījumu ražošanai un atgriež pašreizējo ražošanas statusu.
  3. Lietotājs pārbauda pasūtījuma statusu (funkcija "ChkStatus").
  4. Ja pasūtījums ir gatavs, lietotājs var lejupielādēt pārskatu (funkcija "GetReport").
Pieejamo valstu saraksts: Somijas Republika (FIN), Zviedrijas Karaliste (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)

Zemāk varat atrast piemēru:

1. KĀRTĪBA: Pasūtiet ziņojumu

Lietotāji, kuri uzskata, ka pasūtījuma apstiprināšanas posms nav nepieciešams, var izmantot elementu "confirm_order" un nodot vērtību "TRUE".

Parasti kredītinformācijas sagatavošana tiešsaistes režīmā aizņem 10-20 sekundes.
Tāpēc tiešsaistes pārskatos pārbaudes jāveic ik pēc 5 vai vairāk sekundēm.

Testa kontam pieejamo uzņēmumu saraksts:

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
Turklāt tiešsaistes ziņojumos (delivery_term = "o") var izmantot paraugus, kas izveidoti katrai valstij (izmantojiet reģistrācijas kodu "00000000"). Šie pārskati ir bezmaksas, un tos var pasūtīt, izmantojot testa kontu.
Funkcija Order
Funkcija OrderCancellation

2. Pasūtījuma apstiprinājums

Funkcija OrderConfirmation

3. STEPS. Stāvokļa pārbaude

Funkcija ChkStatus

4. PĒCIS. Saņemiet ziņojumu

Tiešsaistes pārskatu pieejamo valodu saraksts: en (English), et (Estonian), ru (Russian), de (German)
Tiešsaistes ziņojuma lejupielāde pdf formātā vēl nav pieejama.
Funkcija GetReport

Pārskatiem tiek izmantoti šādi statusi:

  • Izstrādes procesā - Ziņojums ražošanas posmā
  • Canceled - Atceltais pasūtījums
  • Finished - Ziņojums ir gatavs
  • Updated - Gatavajam ziņojumam tika pievienota informācija
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Mūsu sistēmā ir notikusi tehniska kļūda. Tas nozīmē, ka mēs esam informēti par šo kļūdu un pēc iespējas ātrāk to novērsīsim. Jūs tiksiet informēts, kad varēsiet saņemt pasūtījumu.

Ja izpildes statuss ir Finished vai Updated, tad varat saņemt rīkojumu.

Kā lejupielādēt bezsaistes atskaiti?

Bezsaistes režīmā pieejamos pārskatus varat lejupielādēt tieši. Šeit ir norādījumi, kā to darīt:

Pieprasījums sastāv no 3 daļām:

  1. Fiksētā daļa https://www.infoproff.com/en/orders/files/
  2. Jūsu unikālais hash, ko mēs sniedzam kā atbildi.
  3. Un fiksēto daļu beigās /download

Kā saņemt kredīta atzinumu?

Funkcija CreditOpinionCalculator

Kā iegūt papildu informāciju?

Funkcija GetClassifiersFinancialStatements
Funkcija GetActivityClassificators
Funkcija GetDictionaryStandardPhrases
Funkcija GetAvailableProducts

Iespējamās kļūdas

Veicot pieprasījumu mūsu tīmekļa pakalpojumam, var rasties šādas kļūdas..

Visas funkcijas
  • Nepareizs lietotājvārds/parole vai jums nav atļauju.
    Jūs ievadāt nepareizus akreditācijas datus vai jūsu API piekļuve ir bloķēta.
Funkcija SimpleSearch
  1. Šajā valstī jums nav meklēšanas atļauju.
    Pieejamo valstu saraksts: Somijas Republika (FIN), Zviedrijas Karaliste (SWE)
Funkcija Order
  1. Šis produkts nav pieejams.
    Šādu produktu nevar atrast un nav iespējams pasūtīt.
  2. Jūs nevarat pasūtīt ziņojumu par uzņēmumu ar juridisku formu: "legal_form"
    Šī kļūda attiecas tikai uz: Zviedrijas Karaliste (SWE)
    Zviedrijā nav iespējams pasūtīt tiešsaistes ziņojumu (delivery_term = "o") ar nākamajām juridiskajām veidlapām:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Šis uzņēmums nav iekļauts testa sarakstā.
    Uzņēmuma reģistrācijas koda nav mūsu testa sarakstā.
    Testa kontam pieejamo uzņēmumu saraksts:
    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. Nepieciešams uzņēmuma nosaukums vai reģistrācijas kods
    Pasūtot bezsaistes pārskatu (delivery_term = "n", "f" vai "s"), ir jānorāda "Uzņēmuma nosaukums" vai "Reģistrācijas kods".
  5. Reģistrācijas kods ir nepieciešams, ja piegādes termiņš ir Online
    Pasūtot tiešsaistes pārskatu (delivery_term = "o"), ir jānorāda "Reģistrācijas kods".
Funkcija GetReport
  1. Šī valoda netiek atbalstīta.
    Tiešsaistes pārskatu pieejamo valodu saraksts: en (English), et (Estonian), ru (Russian), de (German)
Funkcijas GetReport ChkStatus
  1. Nepareizs order_id.
    Pasūtījuma ID nav atrodams. Pasūtījuma ID iegūsiet, kad izmantosiet Order funkciju.
Funkcija OrderCancellation
  1. Your order is already canceled.
    Jums vairs nav atļaujas atcelt pasūtījumu.
Funkcija OrderConfirmation
  1. Jums vairs nav atļaujas apstiprināt pasūtījumu. Apstiprinājumu var veikt vienas stundas laikā pēc "order_id" saņemšanas.

SOAP (3. versija) izmaiņas salīdzinājumā ar SOAP (2. versija)

SOAP (3. versija) izmaiņas salīdzinājumā ar SOAP (2. versija) [Pārskats]

1) Jauna 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!

Lai veiktu tiešsaistes pasūtījumu, no funkcijas "SimpleSearch" ir jāsaņem "search_result_id", un tikai pēc tam var veikt tiešsaistes (delivery_term = 'o') pasūtījumu.

- Izmaiņas tiešsaistē pieejamo kredītinformācijas ziņojumu valstu sarakstā: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Pieejams lejupielādēt finanšu pārskatus (izmantojot produktu: finanses) tiešsaistes režīmā: 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) izmaiņas salīdzinājumā ar SOAP (2. versija) [WSDL and XSD]

File: report.xsd

Jauni elementi:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Jauna 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

Jauns elements:

- preferable_finances

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

3) SimpleSearchRequest

Noņemtais elements:

search_block.reg_code

Jauns elements:

search_block->company_code

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

4) SimpleSearchResponse

Noņemtie elementi

- code

Jauni elementi:

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