> ## Documentation Index
> Fetch the complete documentation index at: https://docs.begin.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Taavi

> Prepare a CSV of hours and absences for import into Taavi.

export const BetaCallout = ({children}) => <div className="kb-beta-callout" role="note">
    <span className="kb-beta not-prose">Beta</span>
    <div className="kb-beta-callout-body">{children}</div>
  </div>;

<img src="https://mintcdn.com/beginltd/BRY4HutgAYlm2EDK/images/cover/integrations-taavi-light.png?fit=max&auto=format&n=BRY4HutgAYlm2EDK&q=85&s=e6ce4c8438678cfe37a32fb248c63258" alt="Taavi in Begin" className="block dark:hidden" noZoom width="1152" height="616" data-path="images/cover/integrations-taavi-light.png" />

<img src="https://mintcdn.com/beginltd/BRY4HutgAYlm2EDK/images/cover/integrations-taavi-dark.png?fit=max&auto=format&n=BRY4HutgAYlm2EDK&q=85&s=589991b1c4a2040334b95269a3aecf40" alt="Taavi in Begin" className="hidden dark:block" noZoom width="1152" height="616" data-path="images/cover/integrations-taavi-dark.png" />

Export a CSV for your payroll team to import into Taavi. Generating the file in Begin does not upload it to Taavi.

<BetaCallout>
  Payroll integrations are rolling out gradually. If **Settings → Integrations** is missing, ask us
  about enabling it for your workspace. Your role also needs permission to manage integrations.
</BetaCallout>

## Prepare the export

<Steps>
  <Step title="Enable Taavi">
    Open **Settings → Integrations → Taavi** and turn on the header switch. This file export needs
    no API credentials.
  </Step>

  <Step title="Check employee codes">
    Give each person the **Payroll export code** Taavi uses, on their
    [profile](/for-managers/people/member-profiles). A person without an export code is left out of
    the file.
  </Step>

  <Step title="Map the hours">
    Open **Field mappings**. Edit the values you need, set their **Export code**, and turn on
    **Include in export**. New configurable mappings start off.
  </Step>

  <Step title="Include absences if needed">
    Enable **Absences** in Setup and map the time-off policies to the codes Taavi expects.
  </Step>
</Steps>

<img src="https://mintcdn.com/beginltd/MJcYB5P5kjj9okDt/images/articles/integrations/integrations-taavi-mappings-light.png?fit=max&auto=format&n=MJcYB5P5kjj9okDt&q=85&s=a1bea9ffa0239906c7c4af2e9ecf6b7a" alt="Prepare a CSV of hours and absences for import into Taavi." className="block dark:hidden" width="2944" height="1840" data-path="images/articles/integrations/integrations-taavi-mappings-light.png" />

<img src="https://mintcdn.com/beginltd/MJcYB5P5kjj9okDt/images/articles/integrations/integrations-taavi-mappings-dark.png?fit=max&auto=format&n=MJcYB5P5kjj9okDt&q=85&s=43a5e819662a550d6155ce5ce87b8df7" alt="Prepare a CSV of hours and absences for import into Taavi." className="hidden dark:block" width="2944" height="1840" data-path="images/articles/integrations/integrations-taavi-mappings-dark.png" />

## Choose what payroll receives

Leave **Include unconfirmed hours** off to use approved hours only. Rejected and cancelled hours are always excluded, even when this setting is on. Add only the hour categories your Taavi import is configured to accept.

A mapping can apply a **Multiplier**, **Rounding method**, **Rounding precision**, or **Skip zero values**. Use these only when your payroll import requires that transformation; they change the values exported.

## Download and import

Open **Export**, choose the month and any people, location or department filters, then run the export. When the run finishes, download its file from the history and import it into Taavi.

Check errors and skipped records before treating the file as a complete month. If no field mappings are enabled, fix the mappings before exporting again.

**Taavi objects** is a separate catalogue entry. It cannot run yet, so use the working **Taavi** integration described here.

**Taavi: access and limits**

* **Who can:** the default Administrator role manages integrations; Manager and Employee do not. A custom role can carry that permission.
* **Where:** integration access is controlled per role in **Settings → Permissions**.
* **Not supported:** this integration does not send directly to Taavi or read employee data back into Begin.
* **Limits:** absence export is separately selected from hour mappings; it is not enabled by choosing an hour category.

## Next

<Columns cols={2}>
  <Card title="Run the integration" icon="arrow-right" href="/for-managers/integrations/running-payroll-integrations">
    Choose a month, run it and check the result.
  </Card>

  <Card title="Choose an integration" icon="arrow-right" href="/for-managers/integrations/available-integrations">
    Compare providers and connection methods.
  </Card>
</Columns>

## Still need help?

<Columns cols={2}>
  <Card title="Contact support" icon="envelope" href="mailto:support@heybegin.eu">
    Email the Begin team and we'll get back to you.
  </Card>

  <Card title="Ask Begin AI" icon="comment-dots" href="?assistant=open">
    Open the AI assistant and get instant answers based on these docs.
  </Card>
</Columns>