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) or the company name and subsuquently import the found company.

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

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. 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. 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 Talent. When the user adds a given company via ACD, this company is automatically added to the quota in Alma Talent 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 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
visitingaddress_streetaddress
officialPostalAddress_postalCode
visitingaddress_postalcode
visitingaddress_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} .

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}

Country support¶

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