Infoproff API-dokumentation - v2

Växelversion V2

Komma igång

Webbtjänst wsdl och scheman finns här:

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

Webbtjänstens huvudfunktioner:

  • SimpleSearch - Sök information om företag i olika länder.
  • Order - Skapar en order_id och returnerar dubbletter. Dubletter väljs ut med hjälp av följande parametrar: country, product, delivery_term and reg_code.
  • OrderCancellation - Om du har skickat en beställningsförfrågan och fått order_id har du möjlighet att avbryta beställningen (om den inte har gått i produktion).
  • OrderConfirmation - När du har fått order_id måste du bekräfta din beställning inom en timme. Om du inte bekräftar din beställning inom en timme kommer beställningen att annulleras automatiskt.
  • ChkStatus - Kontrollera orderstatus.
  • GetReport - Få färdiga rapporter.
  • GetClassifiersFinancialStatements - Hämta alla finansiella dokument med alla element: row_number, row_formated_description, row_lang_key och row_order.
  • GetLegalForms - Få alla juridiska formulär för alla tillgängliga länder.
  • GetActivityClassificators - Få fram alla koder och beskrivningar för en specifik aktivitetsklassificator.
  • GetDictionaryStandardPhrases - Få alla standardfraser med nycklar och språk.
  • GetAvailableProducts - Få en lista över tillgängliga produkter.
  • CreditOpinionCalculator - Credit Opinion Calculator hjälper dig att tilldela ett företag ett kreditbetyg.

API tillhandahåller flera tjänster:

  1. Kreditupplysningar online för följande länder: Republiken Finland (FIN), Konungariket Sverige (SWE)
  2. Offline-rapporter för följande länder: Alla länder
  3. Kalkylator för kreditbedömning

Hur söker man efter ett företag?

Företagssökningen består av 2 alternativ:

  1. Sök efter företagsnamn,
  2. Sök efter registreringskod.
Förteckning över tillgängliga länder: Republiken Finland (FIN), Konungariket Sverige (SWE), Konungariket Norge (NOR), Konungariket Danmark (DNK)
Viktig information:
I Norges register är det inte möjligt att söka efter namn på raderade företag. Därför kan vi inte tillhandahålla en SimpleSearch efter namn inom raderade företag i Norge.
Field's length:
company_name varchar(512)
company_code varchar(64)

Nedan hittar du ett exempel:

Funktion SimpleSearch

Alternativ 2: Sök efter registreringskod

Funktion SimpleSearch

Hur beställer man en kreditupplysning?

Från registreringen till mottagandet av rapporten följer följande steg:

  1. Användaren registrerar en ny beställning (funktionen "Order"). Systemet returnerar orderuppgifter, en lista över dubbletter som placerats under de senaste 60 dagarna och inväntar orderbekräftelse.
  2. Användaren bekräftar en beställning (funktion "OrderConfirmation"). Systemet skickar beställningen till produktion och returnerar den aktuella produktionsstatusen.
  3. Användaren kontrollerar orderstatus (funktion "ChkStatus").
  4. Om en beställning är klar kan användaren hämta rapporten (funktionen "GetReport").
Förteckning över tillgängliga länder: Republiken Finland (FIN), Konungariket Sverige (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)

Nedan hittar du ett exempel:

STEG 1: Beställ rapport

Användare som anser att beställningsbekräftelsen är onödig kan använda elementet "confirm_order" och överföra värdet "TRUE".

Vanligtvis tar det 10-20 sekunder att göra en kreditupplysning online.
När det gäller online-rapporter bör du därför göra kontroller var 5:e sekund eller mer.

Lista över tillgängliga företag för ett testkonto:

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
Dessutom kan du för online-rapporter (delivery_term = "o") använda exempel som genererats för varje land (använd: registreringskod "00000000"). Dessa rapporter är gratis och kan beställas med hjälp av testkontot.
Funktion Order
Funktion OrderCancellation

STEG 2. Beställningsbekräftelse

Funktion OrderConfirmation

STEG 3. Kontroll av status

Funktion ChkStatus

STEG 4. Få en rapport

Förteckning över tillgängliga språk för online-rapporter: en (English), et (Estonian), ru (Russian), de (German)
Det är ännu inte möjligt att ladda ner online-rapporten i pdf-format.
Funktion GetReport

Följande statusar används för rapporter:

  • På gång - Rapport i produktionsskedet
  • Canceled - Avbeställd beställning
  • Finished - Rapporten är klar
  • Updated - Information har lagts till i den färdiga rapporten.
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Ett tekniskt fel har uppstått i vårt system. Det betyder att vi är informerade om felet och att vi kommer att åtgärda det så snart som möjligt. Du kommer att informeras när du kommer att kunna ta emot din beställning.

Om exekveringsstatusen är Finished eller Updated kan du få en order.

Hur laddar man ner Offline-rapporten?

Du kan ladda ner Offline-rapporter direkt. Här är en instruktion om hur du gör det:

Ansökan består av tre delar:

  1. Fast del https://www.infoproff.com/en/orders/files/
  2. Din unika hash, som vi tillhandahåller som svar.
  3. Och den fasta delen i slutet /download

Hur får man ett kreditutlåtande?

Funktion CreditOpinionCalculator

Hur får jag ytterligare information?

Funktion GetClassifiersFinancialStatements
Funktion GetActivityClassificators
Funktion GetDictionaryStandardPhrases
Funktion GetAvailableProducts

Möjliga fel

Dessa fel kan inträffa när du gör en förfrågan till vår webbtjänst.

Alla funktioner
  • Felaktigt användarnamn/lösenord eller så har du inga behörigheter.
    Du anger fel autentiseringsuppgifter eller din API-åtkomst är blockerad.
Funktion SimpleSearch
  1. Du har inte tillstånd att söka i det här landet.
    Förteckning över tillgängliga länder: Republiken Finland (FIN), Konungariket Sverige (SWE)
Funktion Order
  1. Denna produkt är inte tillgänglig.
    Produkten kan inte hittas och det är inte möjligt att beställa den.
  2. Du kan inte beställa en rapport om ett företag med juridisk form: "juridisk_form"
    Detta fel gäller endast följande: Konungariket Sverige (SWE)
    I Sverige är det inte möjligt att beställa online-rapport (delivery_term = "o") med följande juridiska former:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Detta företag finns inte med på testlistan.
    Företagets registreringskod finns inte med i vår testlista.
    Lista över tillgängliga företag för ett testkonto:
    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. Företagsnamn eller organisationsnummer krävs
    Vid beställning av offline-rapport (delivery_term = "n", "f" eller "s") krävs "Business Name" eller "Reg Code".
  5. Reg-kod krävs när leveransvillkoret är Online
    Vid beställning av online-rapport (delivery_term = "o") krävs "Reg Code".
Funktion GetReport
  1. Detta språk stöds inte.
    Förteckning över tillgängliga språk för online-rapporter: en (English), et (Estonian), ru (Russian), de (German)
Funktioner GetReport ChkStatus
  1. Felaktigt order_id.
    Order-ID kan inte hittas. Du får order-ID när du använder funktionen Order.
Funktion OrderCancellation
  1. Your order is already canceled.
    Du har inte längre rätt att avbryta beställningen.
Funktion OrderConfirmation
  1. Du har inte längre tillåtelse att bekräfta ordern. Bekräftelse kan göras inom en timme efter att du mottagit "order_id".

SOAP (version 3) ändringar jämfört med SOAP (version 2)

SOAP (version 3) ändringar jämfört med SOAP (version 2) [Översikt]

1) Ny funktion: ChkFinance

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

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

För att göra en onlinebeställning måste du få "search_result_id" från funktionen "SimpleSearch", och först därefter kan du göra en onlinebeställning (delivery_term = "o").

- Ändringar i listan över tillgängliga länder för kreditupplysningar online: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Tillgänglig för nedladdning av finansiella rapporter (med produkt: ekonomi) i online-läge: Estonia (EST), Sweden (SWE)

3) Funktion: 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 (version 3) ändringar jämfört med SOAP (version 2) [WSDL and XSD]

File: report.xsd

Nya element:

- report/negative_information/debts/item/remainder_range

- report/negative_information/debts/item/remainder_non_standard_range

File: report.wsdl

Ny funktion:

- 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

Nytt element:

- preferable_finances

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

3) SimpleSearchRequest

Borttaget element:

search_block.reg_code

Nytt element:

search_block->company_code

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

4) SimpleSearchResponse

Borttagna element

- code

Nya element:

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