Infoproff API-dokumentation - v2

Switch-version V2

Kom godt i gang

Webservice wsdl og skemaer findes her:

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

Webtjenestens hovedfunktioner:

  • SimpleSearch - Søg oplysninger om virksomheder i forskellige lande.
  • Order - Opretter en order_id og returnerer dubletter. Duplikater udvælges ved hjælp af følgende parametre: country, product, delivery_term and reg_code.
  • OrderCancellation - Hvis du har sendt en ordreanmodning og modtaget order_id, har du mulighed for at annullere denne ordre (hvis den ikke er gået i produktion).
  • OrderConfirmation - Når du har modtaget order_id, skal du bekræfte din ordre inden for 1 time. Hvis du ikke bekræfter din ordre inden for 1 time, vil ordren automatisk blive annulleret.
  • ChkStatus - Kontroller ordrestatus.
  • GetReport - Få færdige rapporter.
  • GetClassifiersFinancialStatements - Hent alle finansielle dokumenter med alle elementer: row_number, row_formated_description, row_lang_key og row_order.
  • GetLegalForms - Få alle juridiske formularer for alle tilgængelige lande.
  • GetActivityClassificators - Få alle koder og beskrivelser for en specifik aktivitetsklassifikator.
  • GetDictionaryStandardPhrases - Få alle standardsætninger med nøgler og sprog.
  • GetAvailableProducts - Få en liste over tilgængelige produkter.
  • CreditOpinionCalculator - Credit Opinion Calculator hjælper med at tildele kreditvurdering af en virksomhed.

API tilbyder flere tjenester:

  1. Online kreditrapporter for følgende lande: Republikken Finland (FIN), Kongeriget Sverige (SWE)
  2. Offline-rapporter for følgende lande: Alle lande
  3. Beregner til kreditvurdering

Hvordan søger man efter en virksomhed?

Virksomhedssøgningen består af 2 muligheder:

  1. Søg efter virksomhedsnavn,
  2. Søg efter registreringskode.
Liste over tilgængelige lande: Republikken Finland (FIN), Kongeriget Sverige (SWE), Kongeriget Norge (NOR), Kongeriget Danmark (DNK)
Vigtige oplysninger:
I Norges register er det ikke muligt at søge efter slettede virksomheder efter navn. Derfor kan vi ikke levere en SimpleSearch efter navne inden for slettede virksomheder i Norge.
Field's length:
company_name varchar(512)
company_code varchar(64)

Nedenfor kan du finde et eksempel:

Funktion SimpleSearch

Mulighed 2: Søg efter registreringskode

Funktion SimpleSearch

Hvordan bestiller man en kreditrapport?

Rækkefølgen fra registrering til modtagelse af rapporten består af følgende trin:

  1. Brugeren registrerer en ny ordre (funktionen "Order"). Systemet returnerer ordreoplysninger, en liste over dubletter placeret inden for de sidste 60 dage og afventer ordrebekræftelse.
  2. Brugeren bekræfter en ordre (funktionen "OrderConfirmation"). Systemet sender ordren til produktion og returnerer den aktuelle produktionsstatus.
  3. Brugeren kontrollerer ordrestatus (funktion "ChkStatus").
  4. Hvis en ordre er klar, kan brugeren downloade rapporten (funktionen "GetReport").
Liste over tilgængelige lande: Republikken Finland (FIN), Kongeriget 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)

Nedenfor kan du finde et eksempel:

TRIN 1: Bestil rapport

Brugere, der mener, at det ikke er nødvendigt at bekræfte ordren, kan bruge elementet "confirm_order" og overføre værdien "TRUE".

Det tager normalt 10-20 sekunder at udarbejde en kreditrapport online.
Derfor bør du i forbindelse med online-rapporter foretage kontrol hvert 5. eller flere sekunder.

Liste over tilgængelige virksomheder til en 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
Desuden kan du i forbindelse med online-rapporter (delivery_term = "o") bruge prøver, der er genereret for hvert land (brug: registreringskode "00000000"). Disse rapporter er gratis og kan bestilles ved hjælp af en testkonto.
Funktion Order
Funktion OrderCancellation

TRIN 2. Bekræftelse af bestilling

Funktion OrderConfirmation

TRIN 3. Kontrol af status

Funktion ChkStatus

TRIN 4. Hent rapport

Liste over tilgængelige sprog for Online-rapporter: en (English), et (Estonian), ru (Russian), de (German)
Det er endnu ikke muligt at downloade online-rapporten i pdf-format.
Funktion GetReport

Følgende tilstande anvendes til rapporter:

  • I gang - Rapport i produktionsfasen
  • Canceled - Annulleret ordre
  • Finished - Rapporten er klar
  • Updated - Der blev tilføjet oplysninger til den færdige rapport
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Der er opstået en teknisk fejl i vores system. Det betyder, at vi er informeret om denne fejl og vil rette den hurtigst muligt. Du vil blive informeret, når du vil kunne modtage din ordre.

Hvis udførelsesstatus er Finished eller Updated, kan du få en ordre.

Hvordan downloader jeg en offline rapport?

Du kan downloade Offline-rapporter direkte. Her er instruktionen for, hvordan du skal gøre det:

Anmodningen består af 3 dele:

  1. Fast del https://www.infoproff.com/en/orders/files/
  2. Din unikke hash, som vi giver dig som svar
  3. Og den faste del i slutningen /download

Hvordan får jeg en kreditvurdering?

Funktion CreditOpinionCalculator

Hvordan får jeg yderligere oplysninger?

Funktion GetClassifiersFinancialStatements
Funktion GetActivityClassificators
Funktion GetDictionaryStandardPhrases
Funktion GetAvailableProducts

Mulige fejl

Disse fejl kan opstå, når du anmoder om vores webtjeneste.

Alle funktioner
  • Forkert brugernavn/adgangskode, eller du har ingen tilladelser.
    Du har indtastet forkerte legitimationsoplysninger, eller din API-adgang er blokeret.
Funktion SimpleSearch
  1. Du har ikke tilladelse til at søge i dette land.
    Liste over tilgængelige lande: Republikken Finland (FIN), Kongeriget Sverige (SWE)
Funktion Order
  1. Dette produkt er ikke tilgængeligt.
    Et sådant produkt kan ikke findes, og det er ikke muligt at bestille.
  2. Du kan ikke bestille en rapport om en virksomhed med juridisk form: "juridisk_form"
    Denne fejl gælder kun for: Kongeriget Sverige (SWE)
    I Sverige er det ikke muligt at bestille online-rapport (delivery_term = "o") med de næste juridiske formularer:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Denne virksomhed er ikke på testlisten.
    Virksomhedens registreringskode er ikke på vores testliste.
    Liste over tilgængelige virksomheder til en 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. Virksomhedsnavn eller registreringskode er påkrævet
    Ved bestilling af offline-rapport (delivery_term = "n", "f" eller "s") er "Business Name" eller "Reg Code" påkrævet.
  5. Reg-kode er påkrævet, når leveringsbetingelsen er Online
    Ved bestilling af online-rapport (delivery_term = "o") er "Reg Code" påkrævet.
Funktion GetReport
  1. Dette sprog understøttes ikke.
    Liste over tilgængelige sprog for Online-rapporter: en (English), et (Estonian), ru (Russian), de (German)
Funktioner GetReport ChkStatus
  1. Forkert ordre_id.
    Ordre-ID kan ikke findes. Du får ordre-ID, når du bruger funktionen Order.
Funktion OrderCancellation
  1. Your order is already canceled.
    Du har ikke længere tilladelse til at annullere ordren.
Funktion OrderConfirmation
  1. Du har ikke længere tilladelse til at bekræfte ordren. Bekræftelse kan ske inden for en time efter, at du har modtaget 'order_id'.

SOAP (version 3) ændringer i forhold til SOAP (version 2)

SOAP (version 3) ændringer i forhold til SOAP (version 2) [Oversigt]

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!

For at afgive en onlineordre skal du modtage 'search_result_id' fra funktionen 'SimpleSearch', og først derefter kan du afgive en onlineordre (delivery_term = 'o').

- Ændringer i listen over tilgængelige lande for online kreditrapporter: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Tilgængelig for download af regnskaber (ved hjælp af produkt: økonomi) i online-tilstand: 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) ændringer i forhold til SOAP (version 2) [WSDL and XSD]

File: report.xsd

Nye elementer:

- 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

Nyt element:

- preferable_finances

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

3) SimpleSearchRequest

Fjernet element:

search_block.reg_code

Nyt element:

search_block->company_code

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

4) SimpleSearchResponse

Fjernede elementer

- code

Nye elementer:

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