Begin OÜ (registry code 12100876) is an X-tee member and a data-service
intermediary. Its subsystem EE/COM/12100876/begin carries Tervisekassa’s
employer services for the companies that use Begin.
This page is Begin’s intermediation procedure, published under §5.4.6.1 of the
X-tee joining contract. It states on what basis Begin intermediates, how it
authenticates and authorises the people who use the services through Begin, how
it protects the data it receives, and how the resulting logs are archived and
kept.
Last updated: 27 September 2026.
The basis for intermediating
Begin intermediates two Tervisekassa services, both in thekirst subsystem:
Tervisekassa has opened both to Begin’s subsystem. Each employer Begin acts for
grants Begin a mandate on eesti.ee — Volitused →
Tervisekassa alamplokk → Tööandja X-tee teenused, to registry code
12100876. Without that mandate Begin has no right to act for the employer.
Every employer is also Begin’s client under Begin’s terms of service, accepted
when their workspace is created.
The employer a request concerns travels in the request itself. Begin reads it
from the workspace that holds the company registry code. One number belongs to
one workspace at a time, shared by Tervisekassa and TÖR: saving the number claims
it when no other workspace holds it. A claim gives no access. Before either
integration can connect, Begin staff verify that the company approved that exact
workspace. Connecting requires the verified claim as well as the government’s own
mandate. Once a workspace is verified for a number, every other workspace is
refused it. A claim nobody has verified does not stop another workspace saving the
number, and Begin staff verifying that other workspace releases it.
Who may use the services through Begin
A person reaches these services only from inside their employer’s own Begin workspace, and only after passing four checks.- Identity. They sign in to Begin with a verified email address or phone number, by one-time code, or with a passkey.
- Membership. The sign-in resolves to one workspace. A person who is not a member of that workspace has no route to its data.
- Permission. Their role in that workspace must carry the Manage integrations permission, checked when connecting the integration, mapping certificate types, and sending the employer’s part.
- Employer verification. The company comes from the current binding Begin staff verified. Begin checks that binding before dispatch and before applying an asynchronous response. A successful API response does not establish the workspace’s authority.
userId header.
Tervisekassa has required it since 15 September 2025. Begin refuses to send
when that code is missing from the person’s profile or fails its checksum, so
every submission includes a structurally valid personal code from that profile.
An employer ends the intermediation by disconnecting the integration in Begin,
or by withdrawing the eesti.ee mandate. Disconnecting stops the queries — the
next scheduled query and every one after it. Deleting the workspace stops them as
well. A request already sent cannot be recalled.
Disconnecting does not release the company number or revoke the mandate on
eesti.ee. The number moves only when the employer changes it in workspace
settings with both government integrations disconnected, when the workspace
holding it has been deleted and another workspace claims it, or when Begin staff
verify another workspace for a number whose claim nobody has verified. Connection
errors, empty results and lost external permissions do not release it. Begin
staff revoking a verification disconnects both integrations; the number stays
with the workspace, unverified, until staff verify that workspace or another one
for it.
Logs of authentication and authorisation
Begin records every act that authorises a Tervisekassa query, in the workspace’s own audit log:- connecting and disconnecting the integration, and who did it;
- claiming or releasing the company registration number;
- Begin staff verifying or revoking the company;
- recording or withdrawing the eesti.ee mandate confirmation;
- changing which certificate type becomes which absence;
- sending the employer’s part — naming the person, the certificate and the figures sent.