Infoproff API dokumentáció - v2

Switch verzió V2

Kezdő lépések

A webszolgáltatás wsdl és sémák itt találhatók:

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

Webszolgáltatás fő funkciói:

  • SimpleSearch - Céginformációk keresése különböző országokban.
  • Order - Létrehoz egy order_id címet és visszaadja a duplikátumokat. A duplikátumokat a következő paraméterek alapján választja ki: country, product, delivery_term and reg_code.
  • OrderCancellation - Ha elküldött egy megrendelési kérelmet, és megkapta a order_id, akkor lehetősége van arra, hogy törölje ezt a megrendelést (ha nem ment a termelésbe).
  • OrderConfirmation - Miután megkapta a order_id címet, 1 órán belül meg kell erősítenie a megrendelését. Ha nem erősíti meg a megrendelést 1 órán belül, a megrendelés automatikusan törlésre kerül.
  • ChkStatus - Ellenőrizze a rendelés státuszát.
  • GetReport - Szerezze be a kész jelentéseket.
  • GetClassifiersFinancialStatements - Az összes pénzügyi dokumentum lekérdezése az összes elemmel: row_number, row_formated_description, row_lang_key és row_order.
  • GetLegalForms - Szerezze be az összes jogi formanyomtatványt az összes rendelkezésre álló országhoz.
  • GetActivityClassificators - Az összes kód és leírás lekérdezése az adott tevékenységosztályozóhoz.
  • GetDictionaryStandardPhrases - Kapja meg az összes szabványos kifejezést kulcsokkal és nyelvvel.
  • GetAvailableProducts - A rendelkezésre álló termékek listája.
  • CreditOpinionCalculator - A Credit Opinion Calculator segít a vállalatra vonatkozó hitelminősítéshez hozzárendelni a hitelminősítést.

Az API számos szolgáltatást nyújt:

  1. Online hiteljelentések a következő országok számára: Finn Köztársaság (FIN), Svéd Királyság (SWE)
  2. Offline jelentések a következő országok számára: Minden ország
  3. Hitel vélemény kalkulátor

Hogyan keressünk céget?

A cégkeresés 2 lehetőségből áll:

  1. Keresés cégnév alapján,
  2. Keresés regisztrációs kód alapján.
Az elérhető országok listája: Finn Köztársaság (FIN), Svéd Királyság (SWE), Norvég Királyság (NOR), Dán Királyság (DNK)
Fontos információk:
A norvég nyilvántartás nem teszi lehetővé a törölt vállalatok név szerinti keresését. Ezért nem tudunk a norvégiai törölt vállalatokon belül a SimpleSearch oldalon név szerint keresni.
Field's length:
company_name varchar(512)
company_code varchar(64)

Az alábbiakban a példát találja:

Funkció SimpleSearch

2. lehetőség: Keresés regisztrációs kód alapján

Funkció SimpleSearch

Hogyan rendelhetek hiteljelentést?

A regisztrációtól a jelentés kézhezvételéig a következő lépésekből áll a folyamat:

  1. A Felhasználó új megrendelést regisztrál (a "Megrendelés" funkció). A rendszer visszaküldi a megrendelés adatait, az elmúlt 60 napban leadott duplikátumok listáját, és várja a megrendelés visszaigazolását.
  2. A felhasználó megerősíti a megrendelést (a "OrderConfirmation" funkció). A rendszer elküldi a megrendelést gyártásra, és visszaadja az aktuális gyártási státuszt.
  3. A felhasználó ellenőrzi a rendelés státuszát (ChkStatus funkció).
  4. Ha a megrendelés készen áll, akkor a Felhasználó letöltheti a jelentést (a "GetReport" funkcióval).
Az elérhető országok listája: Finn Köztársaság (FIN), Svéd Királyság (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)

Az alábbiakban a példát találja:

1. LÉPÉS: Jelentés megrendelése

Azok a felhasználók, akik a megrendelés megerősítésének lépését szükségtelennek tartják, használhatják a "confirm_order" elemet, és átadhatják a "TRUE" értéket.

Általában 10-20 másodpercet vesz igénybe a hiteljelentés elkészítése online módban.
Ezért az online jelentések esetében legalább 5 vagy több másodpercenként ellenőrizni kell.

A tesztszámlához rendelkezésre álló vállalatok listája:

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
Ezenkívül a (delivery_term = "o") online jelentésekhez minden országra generált mintákat használhat (használd a "00000000" regisztrációs kódot). Ezek a jelentések ingyenesek, és a tesztfiók használatával rendelhetők meg.
Funkció Order
Funkció OrderCancellation

2. LÉPÉS. Megrendelés megerősítése

Funkció OrderConfirmation

LÉPÉS 3. Állapotellenőrzés

Funkció ChkStatus

4. LÉPÉS. Jelentés beszerzése

Az online jelentésekhez rendelkezésre álló nyelvek listája: en (English), et (Estonian), ru (Russian), de (German)
Az online jelentés letöltése pdf formátumban még nem elérhető.
Funkció GetReport

A következő státuszokat használják a jelentésekhez:

  • Folyamatban - Jelentés a gyártási szakaszban
  • Canceled - Törölt megrendelés
  • Finished - A jelentés elkészült
  • Updated - A kész jelentés kiegészült információkkal
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Technikai hiba történt a rendszerünkben. Ez azt jelenti, hogy értesültünk a hibáról, és a lehető leghamarabb kijavítjuk. Értesítjük Önt, ha a megrendelést át tudja venni.

Ha a végrehajtási státusz Finished vagy Updated, akkor kaphat megbízást.

Hogyan tölthető le az Offline jelentés?

Az offline jelentéseket közvetlenül letöltheti. Itt van az utasítás, hogyan kell ezt megtennie:

A kérelem 3 részből áll:

  1. Rögzített rész https://www.infoproff.com/en/orders/files/
  2. Az Ön egyedi azonosítószámát, amelyet válaszul adunk meg.
  3. És a végén rögzített rész /download

Hogyan lehet hitelvéleményt szerezni?

Funkció CreditOpinionCalculator

Hogyan juthatok további információkhoz?

Funkció GetClassifiersFinancialStatements
Funkció GetActivityClassificators
Funkció GetDictionaryStandardPhrases
Funkció GetAvailableProducts

Lehetséges hibák

Ezek a hibák előfordulhatnak a webes szolgáltatásunkhoz intézett kérés során.

Minden funkció
  • Helytelen felhasználónév/jelszó vagy nincsenek jogosultságai.
    Rossz hitelesítő adatokat adtál meg, vagy az API-hozzáférésed blokkolva van.
Funkció SimpleSearch
  1. Ebben az országban nincs engedélye a házkutatásra.
    Az elérhető országok listája: Finn Köztársaság (FIN), Svéd Királyság (SWE)
Funkció Order
  1. Ez a termék nem áll rendelkezésre.
    Ilyen termék nem található, és nem lehet megrendelni.
  2. Nem rendelhet jelentést a jogi formájú cégről: "jogi_forma"
    Ez a hiba csak a következőkre vonatkozik: Svéd Királyság (SWE)
    Svédországban nem lehet online jelentést (delivery_term = "o") rendelni a következő jogi formanyomtatványokkal:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Ez a vállalat nem szerepel a tesztlistán.
    A vállalat regisztrációs kódja nem szerepel a tesztlistánkon.
    A tesztszámlához rendelkezésre álló vállalatok listája:
    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. Cégnév vagy reg kód szükséges
    Offline jelentés megrendelésekor (delivery_term = "n", "f" vagy "s") a "Business Name" vagy "Reg Code" megadása kötelező.
  5. A Reg kódra akkor van szükség, ha a szállítási határidő Online
    Online jelentés megrendelésekor (delivery_term = "o") a "Reg Code" megadása kötelező.
Funkció GetReport
  1. Ez a nyelv nem támogatott.
    Az online jelentésekhez rendelkezésre álló nyelvek listája: en (English), et (Estonian), ru (Russian), de (German)
Funkciók GetReport ChkStatus
  1. Helytelen order_id.
    A rendelés azonosítója nem található. A rendelés azonosítóját a Order funkció használatával kapja meg.
Funkció OrderCancellation
  1. Your order is already canceled.
    Már nincs engedélye a megrendelés törlésére.
Funkció OrderConfirmation
  1. Már nincs engedélye a megrendelés megerősítésére. A visszaigazolás a 'order_id' beérkezésétől számított egy órán belül megtörténhet.

A SOAP (3. verzió) változásai a SOAP (2. verzióhoz képest)

A SOAP (3. verzió) változásai a SOAP (2. verzióhoz képest) [Áttekintés]

1) Új funkció: ChkFinance

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

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

Az online megrendelés leadásához a 'SimpleSearch' függvénytől meg kell kapnia a 'search_result_id' értéket, és csak ezt követően adhat le online (delivery_term = 'o') megrendelést.

- Változások az online hiteljelentésekhez elérhető országok listáján: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- A pénzügyi kimutatások online módban letölthetők (termék használatával: pénzügyek).: Estonia (EST), Sweden (SWE)

3) Funkció: 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)


A SOAP (3. verzió) változásai a SOAP (2. verzióhoz képest) [WSDL and XSD]

File: report.xsd

Új elemek:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Új funkció:

- 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

Új elem:

- preferable_finances

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

3) SimpleSearchRequest

Eltávolított elem:

search_block.reg_code

Új elem:

search_block->company_code

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

4) SimpleSearchResponse

Eltávolított elemek

- code

Új elemek:

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