Nordic Netproducts API

API

Nordic Netproducts API gör det möjligt att integrera företagsinformation med tredjepartsapplikationer.

Åtkomst av företagsdata sker via en REST-baserad webbtjänst som returnerar företagsinformation med svarsformat XML för konsumtion och integration.

Nordic Netproducts API är enkelt att använda.

Vänligen kontakta oss om du har frågor eller för ytterligare information om Nordic Netproducts API.

URL Template

http://api.nordicnetproducts.se/CompanyInformation.svc/v2/ \
user/{användarnamn}/passwd/{lösenord}/lang-code/{språkkod}/data-option/1 \
?{sökparam1=värde1}&{sökparam2=värde2} ...

Standardparametrar

Parameter Beskrivning
user Användarnamn
passwd Lösenord
lang-code Språkkod [ SVE | NOR | FIN | DAN | ENG ]
data-option 1 (default)

Sökparametrar

Parameter Beskrivning
company-name Företagsnamn (innehåller)
exact-company-name Företagsnamn (exakt matchning)
organization-number Organisationsnummer
vat-number VAT-nummer
address Adress (innehåller)
exact-address Adress (exakt matchning)
zip-code Postnummer [zip-code=98194,10000-20000,40000-50000]
city Stad (innehåller)
exact-city Stad (exakt matchning)
country Land (innehåller)
exact-country Land (exakt matchning)
municipality Kommun (innehåller)
exact-municipality Kommun (exakt matchning)
county Län (innehåller) [county=Stockholms län,Västra Götalands län,Dalarnas län]
exact-county Län (exakt matchning)
telephone Telefon (innehåller)
exact-telephone Telefon (exakt matchning)
www Webbplats (innehåller)
exact-www Webbplats (exakt matchning)
email E-post (innehåller)
exact-email E-post (exakt matchning)
industry-code Branschkod (exakt matchning) [industry-code=62010,80100,1440]
industry-code-starts-with Branschkod (inleds med... för sökning i branschträd)
industry-tabcode Bransch-tabkod [industry-tabcode=B01,B02,B03]
turnover Omsättning
turnover-min Omsättning (lägre gräns)
turnover-max Omsättning (övre gräns)
number-of-employees Antal anställda
number-of-employees-min Antal anställda (lägre gräns)
number-of-employees-max Antal anställda (övre gräns)
establishing-year Etableringsår

Syntax som är parameterspecifik (exempelvis postnummer) visas med exempel inom hakparenteser i beskrivningen ovan.

VAT-nummer används istället för organisationsnummer för danska företag i databasen. För norska företag i databasen används endast organisationsnummer.

Branschkod-sökningar matchar både mot företagens primära och sekundära branschkod (se företagsdata nedan) i databasen, förutsatt att företaget har en sekundär branschkod avgiven. Bransch-tabkod-sökningar fungerar på motsvarande sätt.

Bransch-tabkoder (B00, B01, B02 ... B99) utgör en gruppering av branschkoder i branschträdet.

Svarsresultat som returneras innehåller maximalt 500 företag per sökning.

Textsökningar måste innehålla minst tre tecken (sökparametern company-name=AB returnerar således inga träffar).

XML Branschkoder (trädstruktur)

http://api.nordicnetproducts.se/CompanyInformation.svc/lang-code/SVE/industry-codes

Språkkod: [ SVE | NOR | FIN | DAN | ENG ]

XML Län

http://api.nordicnetproducts.se/CompanyInformation.svc/lang-code/SVE/country-code/SE/county-names

Språkkod: [ SVE | NOR | FIN | DAN | ENG ]

Landskod: [ SE | NO | FI | DK ]

XML Kommuner

http://api.nordicnetproducts.se/CompanyInformation.svc/lang-code/SVE/country-code/SE/municipality-names

Språkkod: [ SVE | NOR | FIN | DAN | ENG ]

Landskod: [ SE | NO | FI | DK ]

Företagsdata

ORGANIZATION_NO Organisationsnummer
VATNR VAT-nummer
COMPANY_NAME Företagsnamn
ADDRESS Adress
VISITING_ADDRESS Besöksadress
ZIPCODE Postnummer
CITY Stad
COUNTRYNAME Land
TELEPHONE Telefon
TELEFAX Fax
WWW Webbplats
EMAIL E-post
INDUSTRY_CODE Branschkod (primär)
INDUSTRY_CODE2 Branschkod (sekundär)
INDUSTRY_CODE_DESCRIPTION Branschkod-beskrivning (primär)
INDUSTRY_CODE2_DESCRIPTION Branschkod-beskrivning (sekundär)
INDUSTRY_TABCODE Bransch-tabkod (primär)
INDUSTRY_TABCODE2 Bransch-tabkod (sekundär)
SALES_X1000 Omsättning x1000
CURRENCY Valuta
EMPLOYEES Antal anställda
FISCAL_DATE Bokslutsperiod
MANAGING_DIRECTOR_NAME Verkställande direktör
MARKETING_MANAGER_NAME Marknadschef
FINANCIAL_MANAGER_NAME Ekonomichef
TECHNICAL_MANAGER_NAME Teknisk chef
PURCHASING_MANAGER_NAME Inköpschef
PERSONNEL_MANAGER_NAME Personalchef
IT_MANAGER_NAME IT-chef
SALES_MANAGER_NAME Försäljningschef
PRODUCTION_MANAGER_NAME Produktionschef
MUNICIPALITYNAME Kommun
COUNTYNAME Län
ESTABLISHING_YEAR Etableringsår

Företagsdata ovan avser data-option 1 (default) och kan utökas beroende på behov.

Exempel

http://api.nordicnetproducts.se/CompanyInformation.svc/v2/user/foo/passwd/bar/lang-code/SVE/data-option/1?company-name=Nordic Netproducts

XML Företagsdata (svarsresultat)

<Companies>
    <CompanyData>
        <ORGANIZATION_NO>556061-8620</ORGANIZATION_NO>
        <VATNR>SE556061862001</VATNR>
        <COMPANY_NAME>Nordic Netproducts AB</COMPANY_NAME>
        <ADDRESS>Box 14113</ADDRESS>
        <VISITING_ADDRESS>Gustavslundsvägen 18</VISITING_ADDRESS>
        <ZIPCODE>167 14</ZIPCODE>
        <CITY>Bromma</CITY>
        <COUNTRYNAME>Sverige</COUNTRYNAME>
        <TELEPHONE>08-56622900</TELEPHONE>
        <TELEFAX>08-56622910</TELEFAX>
        <WWW>www.nordicnetproducts.se</WWW>
        <EMAIL>info@nordicnetproducts.se</EMAIL>
        <INDUSTRY_CODE>63120</INDUSTRY_CODE>
        <INDUSTRY_CODE_DESCRIPTION>Drift av web-portaler</INDUSTRY_CODE_DESCRIPTION>
        <INDUSTRY_TABCODE>B63</INDUSTRY_TABCODE>
        <SALES_X1000>26018</SALES_X1000>
        <CURRENCY>SEK</CURRENCY>
        <EMPLOYEES>42</EMPLOYEES>
        <FISCAL_DATE>201212</FISCAL_DATE>
        <MANAGING_DIRECTOR_NAME>Krister Wellros</MANAGING_DIRECTOR_NAME>
        <MARKETING_MANAGER_NAME>Krister Wellros</MARKETING_MANAGER_NAME>
        <FINANCIAL_MANAGER_NAME>Malin Hansson</FINANCIAL_MANAGER_NAME>
        <TECHNICAL_MANAGER_NAME>Anders Hedberg</TECHNICAL_MANAGER_NAME>
        <PURCHASING_MANAGER_NAME>Krister Wellros</PURCHASING_MANAGER_NAME>
        <IT_MANAGER_NAME>Anders Hedberg</IT_MANAGER_NAME>
        <SALES_MANAGER_NAME>Christoffer Göransson</SALES_MANAGER_NAME>
        <MUNICIPALITYNAME>Stockholm</MUNICIPALITYNAME>
        <COUNTYNAME>Stockholms len</COUNTYNAME>
    </CompanyData>
</Companies>

XML Felkoder

Unauthorized (401)

Åtkomst nekad
Felaktigt användarnamn eller lösenord
<ErrorData>
    <Error>Access denied</Error>
    <ErrorInformation>Invalid username or password</ErrorInformation>
</ErrorData>

BadRequest (400)

Ogiltig förfrågan
<ErrorData>
    <Error>Invalid request</Error>
    <ErrorInformation>Invalid option or request</ErrorInformation>
</ErrorData>
Ogiltig sökparameter
<ErrorData>
    <Error>Invalid search parameter</Error>
    <ErrorInformation>Query string contains invalid search parameter</ErrorInformation>
</ErrorData>
Ogiltig språkkod
<ErrorData>
    <Error>Invalid language code</Error>
    <ErrorInformation>Invalid language code</ErrorInformation>
</ErrorData>

Forbidden (403)

Ogiltigt tecken
<ErrorData>
    <Error>Illegal character</Error>
    <ErrorInformation>Search word contains illegal character</ErrorInformation>
</ErrorData>