Skip to content

How It Works - Alma Talent

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

The user can manually update the integrated company by pressing the ACD Alma Talent button found on company card. The user can also link a company to an Alma Talent's company via this button.

Using Alma Talent as a data source requires the customer to have an agreement with Alma Talent in order to use it in the ACD package. The customer agrees with Alma Talent 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 Talent's quota size. When the user imports a given company to Lime via ACD, this company is automatically added to the quota in Alma Talent and thus, the company will receive updates from Alma Talent on a regular basis.

The customer agrees with Alma Talent on what data they have access to; either only the basic information (CompanyBasicInfo in Alma Talent's payload) or also the statement information (StatementInfos in Alma Talent's payload).

For the standard integration, the following fields are included:

Payload's CompanyBasicInfo includes the following fields:

  • officialname
  • businessId
  • companyId
  • officialpostaladdress.streetaddress
  • status
  • officialpostaladdress.postOffice
  • officialpostalAddress.postalCode
  • officialvisitingaddress.streetaddress
  • officialvisitingaddress.postalcode
  • officialvisitingaddress.postoffice
  • phoneNumber
  • companyForm
  • industry.industryLevel5
  • personnelcategory
  • turnovercategory
  • language
  • customerbase
  • locationmunicipality
  • homemunicipality
  • homepage
  • email

Payload's StatementInfos 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 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 Talent API

Documentation for Alma Talent's API can be found here, after you have logged into Alma Talent'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).

Country support

Currently Alma Talent offers data only on Finnish companies. However, in the future companies from other countries will be included.