Dokumentacija API Infoproffa - v2

Različica stikala V2

Začetek

Spletna storitev wsdl in sheme se nahajajo tukaj:

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

Glavne funkcije spletnih storitev:

  • SimpleSearch - Iskanje informacij o podjetjih v različnih državah.
  • Order - Ustvari order_id in vrne dvojnike. Dvojniki so izbrani z naslednjimi parametri: country, product, delivery_term and reg_code.
  • OrderCancellation - Če ste poslali zahtevek za naročilo in prejeli order_id, imate možnost preklicati to naročilo (če še ni v proizvodnji).
  • OrderConfirmation - Po prejemu spletne strani order_id boste morali svoje naročilo potrditi v eni uri. Če naročila ne boste potrdili v eni uri, bo naročilo samodejno preklicano.
  • ChkStatus - Preverite stanje naročila.
  • GetReport - Pridobite dokončana poročila.
  • GetClassifiersFinancialStatements - Pridobi vse finančne dokumente z vsemi elementi: številka_vrstice, oblikovan_opis_vrstice, ključ_jezika_vrstice in vrstni red.
  • GetLegalForms - Pridobite vse pravne obrazce za vse razpoložljive države.
  • GetActivityClassificators - Pridobite vse kode in opise za določen klasifikator dejavnosti.
  • GetDictionaryStandardPhrases - Pridobite vse standardne fraze s ključi in jezikom.
  • GetAvailableProducts - Pridobite seznam razpoložljivih izdelkov.
  • CreditOpinionCalculator - Kalkulator kreditnega mnenja pomaga dodeliti kreditno mnenje podjetju.

API zagotavlja več storitev:

  1. Spletna kreditna poročila za naslednje države: Republika Finska (FIN), Kraljevina Švedska (SWE)
  2. Poročila brez povezave za naslednje države: Vse države
  3. Kalkulator kreditnega mnenja

Kako poiskati podjetje?

Iskanje podjetja sestavljata 2 možnosti:

  1. Iskanje po imenu podjetja,
  2. Iskanje po registracijski kodi.
Seznam razpoložljivih držav: Republika Finska (FIN), Kraljevina Švedska (SWE), Kraljevina Norveška (NOR), Kraljevina Danska (DNK)
Pomembne informacije:
Norveški register ne omogoča iskanja izbrisanih podjetij po imenih. Zato ne moremo zagotoviti SimpleSearch po imenih znotraj izbrisanih podjetij na Norveškem.
Field's length:
company_name varchar(512)
company_code varchar(64)

Spodaj najdete primer:

Funkcija SimpleSearch

Možnost 2: Iskanje po registracijski kodi

Funkcija SimpleSearch

Kako naročiti kreditno poročilo?

Od registracije do prejema poročila je treba opraviti naslednje korake:

  1. Uporabnik registrira novo naročilo (funkcija "Naročilo"). Sistem vrne podatke o naročilu, seznam dvojnikov, oddanih v zadnjih 60 dneh, in počaka na potrditev naročila.
  2. Uporabnik potrdi naročilo (funkcija "OrderConfirmation"). Sistem pošlje naročilo v proizvodnjo in vrne trenutno stanje proizvodnje.
  3. Uporabnik preveri stanje naročila (funkcija "ChkStatus").
  4. Če je naročilo pripravljeno, lahko uporabnik prenese poročilo (funkcija "GetReport").
Seznam razpoložljivih držav: Republika Finska (FIN), Kraljevina Švedska (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)

Spodaj najdete primer:

KORAK 1: Naročite poročilo

Uporabniki, ki menijo, da korak potrditve naročila ni potreben, lahko uporabijo element "confirm_order" in posredujejo vrednost "TRUE".

Priprava kreditnega poročila v spletnem načinu običajno traja 10-20 sekund.
Zato morate pri spletnih poročilih preverjati vsakih 5 ali več sekund.

Seznam podjetij, ki so na voljo za testni račun:

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
Poleg tega lahko za spletna poročila (delivery_term = "o") uporabite vzorce, ustvarjene za vsako državo (uporabite: registracijsko kodo "00000000"). Ta poročila so brezplačna in jih lahko naročite z uporabo testnega računa.
Funkcija Order
Funkcija OrderCancellation

KORAK 2. Potrditev naročila

Funkcija OrderConfirmation

KORAK 3. Preverjanje stanja

Funkcija ChkStatus

KORAK 4. Pridobite poročilo

Seznam jezikov, ki so na voljo za spletna poročila: en (English), et (Estonian), ru (Russian), de (German)
Prenos spletnega poročila v formatu pdf še ni na voljo.
Funkcija GetReport

Za poročila se uporabljajo naslednji statusi:

  • V teku - Poročilo v fazi izdelave
  • Canceled - Preklicano naročilo
  • Finished - Poročilo je pripravljeno
  • Updated - Končnemu poročilu so bile dodane informacije
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - V našem sistemu je prišlo do tehnične napake. To pomeni, da smo o tej napaki obveščeni in jo bomo čim prej odpravili. Obveščeni boste, ko boste lahko prejeli naročilo.

Če je status izvedbe Finished ali Updated, lahko dobite naročilo.

Kako prenesti poročilo brez povezave?

Poročila brez povezave lahko prenesete neposredno. Tukaj so navodila, kako to storiti:

Zahteva je sestavljena iz treh delov:

  1. Fiksni del https://www.infoproff.com/en/orders/files/
  2. vaš edinstveni hash, ki ga posredujemo v odgovor.
  3. In fiksni del na koncu /download

Kako pridobiti mnenje o kreditu?

Funkcija CreditOpinionCalculator

Kako pridobiti dodatne informacije?

Funkcija GetClassifiersFinancialStatements
Funkcija GetActivityClassificators
Funkcija GetDictionaryStandardPhrases
Funkcija GetAvailableProducts

Možne napake

Te napake se lahko pojavijo med oddajo zahteve naši spletni storitvi..

Vse funkcije
  • Nepravilno uporabniško ime/geslo ali nimate dovoljenj.
    Vnesli ste napačne poverilnice ali pa je vaš dostop do API blokiran.
Funkcija SimpleSearch
  1. V tej državi nimate dovoljenj za iskanje.
    Seznam razpoložljivih držav: Republika Finska (FIN), Kraljevina Švedska (SWE)
Funkcija Order
  1. Ta izdelek ni na voljo.
    Takega izdelka ni mogoče najti in ga ni mogoče naročiti.
  2. Ne morete naročiti poročila o podjetju s pravno obliko: "legal_form"
    Ta napaka velja samo za: Kraljevina Švedska (SWE)
    Na Švedskem ni mogoče naročiti spletnega poročila (delivery_term = "o") z naslednjimi pravnimi obrazci:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. To podjetje ni na seznamu za testiranje.
    Registrske oznake podjetja ni na našem testnem seznamu.
    Seznam podjetij, ki so na voljo za testni račun:
    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. Zahtevano je ime podjetja ali matična številka
    Pri naročanju poročila brez povezave (delivery_term = "n", "f" ali "s") se zahteva "Ime podjetja" ali "Reg. koda".
  5. Reg. koda je potrebna, če je rok dostave Online
    Pri spletnem naročanju poročila (delivery_term = "o") je potrebna "Reg Code".
Funkcija GetReport
  1. Ta jezik ni podprt.
    Seznam jezikov, ki so na voljo za spletna poročila: en (English), et (Estonian), ru (Russian), de (German)
Funkcije GetReport ChkStatus
  1. Nepravilno naročilo_id.
    ID naročila ni mogoče najti. ID naročila dobite, ko uporabite funkcijo Order.
Funkcija OrderCancellation
  1. Your order is already canceled.
    Nimate več dovoljenja za preklic naročila.
Funkcija OrderConfirmation
  1. Nimate več dovoljenja za potrditev naročila. Potrditev je mogoče opraviti v eni uri po prejemu 'order_id'.

Spremembe SOAP (različica 3) v primerjavi s SOAP (različica 2)

Spremembe SOAP (različica 3) v primerjavi s SOAP (različica 2) [Pregled]

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

Če želite oddati spletno naročilo, morate iz funkcije "SimpleSearch" prejeti 'search_result_id' in šele nato lahko oddate spletno (delivery_term = 'o') naročilo.

- Spremembe na seznamu držav, ki so na voljo za spletna kreditna poročila: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Na voljo za prenos računovodskih izkazov (z uporabo izdelka: finance) v spletnem načinu: 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)


Spremembe SOAP (različica 3) v primerjavi s SOAP (različica 2) [WSDL and XSD]

File: report.xsd

Novi elementi:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Nova 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

Nov element:

- preferable_finances

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

3) SimpleSearchRequest

Odstranjeni element:

search_block.reg_code

Nov element:

search_block->company_code

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

4) SimpleSearchResponse

Odstranjeni elementi

- code

Novi elementi:

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