Skip to content

How It Works - Alma Tietohuolto

The user can search companies in the ACD menu either based on the registration number (named business Id in Alma Database) or the company name and subsequently import the found company.

The user can manually update the integrated company by pressing the Alma button. The user can also link the company to the company from Alma Tietohuolto via this button. Updates are also run each night via an automatic task.

Using Alma Insights as a data source requires the customer to have an agreement with Alma Media Finland Oy in order to use it in the ACD. The customer agrees with Alma Media Finland Oy on which data they have access to and how many companies they can bring to their Lime CRM. The number of companies the user can bring to Lime CRM is dependent on the Alma Tietohuolto quota size. The size determines the maximum number of companies which can be added into Lime CRM. This size is agreed upon by the customer and Alma Media Finland Oy. When the user adds a given company via ACD, this company is automatically added to the quota in Alma Tietohuolto and thus, the company will be updated on a regular basis in Lime CRM (the task to update companies runs at midnight every night). Furthermore, the customer agrees with Alma Media Finland Oy on what data they have access to; either only the basic information or also the statement information.

For the standard integration, the following fields are included:

Company Basic Information includes the following fields:

  • officialname
  • businessId
  • companyId
  • postaladdress.streetaddress
  • status
  • postaladdress.postOffice
  • postalAddress.postalCode
  • visitingaddress.streetAddress
  • visitingaddress.postalCode
  • visitingaddress.postOffice
  • phoneNumber
  • companyForm
  • industry.industryLevel5
  • personnelCategory
  • turnoverCategory
  • language
  • customerBase
  • locationMunicipality
  • homeMunicipality
  • homePage
  • email

Company Financial Statement Information includes the following fields:

  • turnover
  • numberofemployees

Note: ACD does not currently support deletion of companies from the quota! I.e. if the company is fetched to Lime CRM from Alma Tietohuolto and then deleted in Lime, it will not be deleted from the quota. However, the same company can be brought back via the normal ACD company import.

Alma Tietohuolto API

Documentation for Alma Tietohuolto API can be found here, after you have logged into Alma Insights's website here.

Company search is carried out by calling making a POST request to following endpoint with either company business id or its name: /information-service/company/search/{businessid/companyname} This call returns a json with basic information about the company such as the name, id, address.

The company is then added to quota with a PUT call: /information-service/account/business-ids/{businessid} . The PUT request returns a json object containing the up-to-date company data.

A task is run each night where we fetch the updated companies from the last day. To this end, a POST call is made to the endpoint: /information-service/datasets?StartDate={start_date}&EndDate={end_date}

This needs to be enabled at Lime side when configuring the ACD (please see the configuration section).

Decision makers and sites integration

Decision maker and site objects can be added via the separate package documented here.

Country support

Currently Alma Tietohuolto offers data only on Finnish companies.