Infoproff API-dokumentasjon - v2

Bytt versjon V2

Komme i gang

Webtjenesten wsdl og skjemaer finnes her.:

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

Webtjenestens hovedfunksjoner:

  • SimpleSearch - Søk etter informasjon om selskaper i ulike land.
  • Order - Oppretter en order_id og returnerer duplikater. Duplikater velges ved hjelp av følgende parametere: country, product, delivery_term and reg_code.
  • OrderCancellation - Hvis du har sendt en bestillingsforespørsel og mottatt order_id, har du mulighet til å kansellere denne bestillingen (hvis den ikke er gått i produksjon).
  • OrderConfirmation - Etter å ha fått order_id må du bekrefte bestillingen din innen 1 time. Hvis du ikke bekrefter bestillingen din innen 1 time, blir bestillingen automatisk kansellert.
  • ChkStatus - Sjekk bestillingsstatus.
  • GetReport - Få ferdige rapporter.
  • GetClassifiersFinancialStatements - Hent alle finansielle dokumenter med alle elementer: row_number, row_formated_description, row_lang_key og row_order.
  • GetLegalForms - Få alle juridiske skjemaer for alle tilgjengelige land.
  • GetActivityClassificators - Få alle koder og beskrivelser for spesifikke aktivitetsklassifikatorer.
  • GetDictionaryStandardPhrases - Få alle standardfraser med nøkler og språk.
  • GetAvailableProducts - Få en liste over tilgjengelige produkter.
  • CreditOpinionCalculator - Kredittvurderingskalkulator hjelper deg med å tildele kredittvurdering på et selskap.

API tilbyr flere tjenester:

  1. Nettbaserte kredittrapporter for følgende land: Republikken Finland (FIN), Kongeriket Sverige (SWE)
  2. Frakoblede rapporter for følgende land: Alle land
  3. Kredittvurderingskalkulator

Hvordan søke etter et selskap?

Firmasøket består av to alternativer:

  1. Søk etter firmanavn,
  2. Søk etter registreringskode.
Liste over tilgjengelige land: Republikken Finland (FIN), Kongeriket Sverige (SWE), Kongeriket Norge (NOR), Kongeriket Danmark (DNK)
Viktig informasjon:
Norge-registeret tillater ikke å søke i slettede selskaper etter navn. Derfor kan vi ikke gi en SimpleSearch etter navn i slettede selskaper i Norge.
Field's length:
company_name varchar(512)
company_code varchar(64)

Nedenfor finner du et eksempel:

Funksjon SimpleSearch

Alternativ 2: Søk etter registreringskode

Funksjon SimpleSearch

Hvordan bestille en kredittrapport?

Rekkefølgen fra registrering til mottak av rapporten består av disse trinnene:

  1. Brukeren registrerer en ny bestilling (funksjonen "Bestill"). Systemet returnerer bestillingsdetaljer, liste over duplikater plassert de siste 60 dagene og venter på ordrebekreftelse.
  2. Brukeren bekrefter en ordre (funksjonen "OrderConfirmation"). Systemet sender bestillingen til produksjon og returnerer gjeldende produksjonsstatus.
  3. Brukeren sjekker ordrestatus (funksjon "ChkStatus").
  4. Hvis en ordre er klar, kan brukeren laste ned rapporten (funksjonen "GetReport").
Liste over tilgjengelige land: Republikken Finland (FIN), Kongeriket 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 finner du et eksempel:

TRINN 1: Bestill rapport

Brukere som anser trinnet med ordrebekreftelse som unødvendig, kan bruke elementet "confirm_order" og sende verdien "TRUE".

Vanligvis tar det 10-20 sekunder å utarbeide kredittrapporten i nettmodus.
For nettbaserte rapporter bør du derfor foreta kontroller hvert 5. sekund eller oftere.

Liste over tilgjengelige selskaper for 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
I tillegg kan du for nettrapporter (delivery_term = "o") bruke eksempler som er generert for hvert land (bruk: registreringskode "00000000"). Disse rapportene er gratis og kan bestilles ved hjelp av en testkonto.
Funksjon Order
Funksjon OrderCancellation

TRINN 2. Ordrebekreftelse

Funksjon OrderConfirmation

TRINN 3. Statuskontroll

Funksjon ChkStatus

TRINN 4. Få rapport

Liste over tilgjengelige språk for elektroniske rapporter: en (English), et (Estonian), ru (Russian), de (German)
Nedlasting av online-rapporten i pdf er ennå ikke tilgjengelig.
Funksjon GetReport

Følgende statuser brukes for rapporter:

  • Under arbeid - Rapport på produksjonsstadiet
  • Canceled - Kansellert ordre
  • Finished - Rapporten er klar
  • Updated - Informasjon ble lagt til i den ferdige rapporten
  • Rejected - Order is rejected (Insufficient funds, incorrect order details or other reason).
  • Technical Error - Det har oppstått en teknisk feil i systemet vårt. Dette betyr at vi er informert om denne feilen og vil fikse den så snart som mulig. Du vil bli informert om når du vil kunne motta bestillingen.

Hvis utførelsesstatusen er Finished eller Updated, kan du få en ordre.

Hvordan laste ned frakoblet rapport?

Du kan laste ned frakoblede rapporter direkte. Her er instruksjonene for hvordan du gjør det:

Forespørselen består av 3 deler:

  1. Fast del https://www.infoproff.com/en/orders/files/
  2. Din unike hash-kode, som vi oppgir som svar
  3. Og fast del på slutten /download

Hvordan få kredittuttalelse?

Funksjon CreditOpinionCalculator

Hvordan få ytterligere informasjon?

Funksjon GetClassifiersFinancialStatements
Funksjon GetActivityClassificators
Funksjon GetDictionaryStandardPhrases
Funksjon GetAvailableProducts

Mulige feil

Disse feilene kan oppstå når du gjør forespørsler til nettjenesten vår.

Alle funksjoner
  • Feil brukernavn/passord eller du har ingen rettigheter.
    Du oppgir feil legitimasjon, eller API-tilgangen din er blokkert.
Funksjon SimpleSearch
  1. Du har ikke tillatelse til å søke i dette landet.
    Liste over tilgjengelige land: Republikken Finland (FIN), Kongeriket Sverige (SWE)
Funksjon Order
  1. Dette produktet er ikke tilgjengelig.
    Slike produkter finnes ikke, og det er ikke mulig å bestille dem.
  2. Du kan ikke bestille rapport om selskap med juridisk form: "juridisk_form"
    Denne feilen gjelder bare for: Kongeriket Sverige (SWE)
    I Sverige er det ikke mulig å bestille online-rapport (delivery_term = "o") med de neste juridiske skjemaene:
    • enskild näringsidkare
    • kommanditbolag
    • handelsbolag
  3. Dette selskapet er ikke på testlisten.
    Selskapets registreringskode er ikke i vår testliste.
    Liste over tilgjengelige selskaper for 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. Firmanavn eller registreringskode er påkrevd
    Ved bestilling av offline rapport (delivery_term = "n", "f" eller "s") er "Business Name" eller "Reg Code" påkrevd.
  5. Reg-kode er påkrevd når leveringsbetingelsen er Online
    Ved bestilling av nettrapport (delivery_term = "o") er "Reg Code" påkrevd.
Funksjon GetReport
  1. Dette språket støttes ikke.
    Liste over tilgjengelige språk for elektroniske rapporter: en (English), et (Estonian), ru (Russian), de (German)
Funksjoner GetReport ChkStatus
  1. Feil ordre_id.
    Bestillings-ID kan ikke bli funnet. Du får ordre-ID når du bruker funksjonen Order.
Funksjon OrderCancellation
  1. Your order is already canceled.
    Du har ikke lenger tillatelse til å kansellere bestillingen.
Funksjon OrderConfirmation
  1. Du har ikke lenger tillatelse til å bekrefte bestillingen. Bekreftelse kan gjøres innen én time etter at du har mottatt 'order_id'.

Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 2)

Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 2) [Oversikt]

1) Ny funksjon: ChkFinance

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

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

For å legge inn en nettbestilling må du motta 'search_result_id' fra funksjonen 'SimpleSearch', og først da kan du legge inn en nettbestilling (delivery_term = 'o').

- Endringer i listen over tilgjengelige land for kredittvurderinger på nett: Finland (FIN), Sweden (SWE), Belgium (BEL), Netherlands (NLD), Estonia (EST)

- Tilgjengelig for nedlasting av regnskaper (ved hjelp av produktet: økonomi) i online-modus.: Estonia (EST), Sweden (SWE)

3) Funksjon: 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)


Endringer i SOAP (versjon 3) sammenlignet med SOAP (versjon 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 funksjon:

- 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

Fjernet 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

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