What is the BambooHR Integration add-on?

Crystal Payroll 提供与 BambooHR 的全面集成功能。BambooHR 是一款全球性人力资源管理软件，受到超过 30,000 家不同规模企业的使用。通过此集成功能，您只需点击几下，即可在两个系统之间获取员工信息、更新工资率及同步假期余额。

Please contact sales@crystalpayroll.co.nz for pricing.

Who is the BambooHR Integration add-on for?

BambooHR 集成功能专为已经使用 BambooHR，并希望将人力资源管理系统与工资管理系统连接起来的企业而设计。通过将 BambooHR 与 Crystal Payroll 集成，您可以在两个平台之间传输员工信息，减少手动输入数据的工作，并简化人力资源及工资管理流程。

Setting Up BambooHR

首先，请确保您已购买 BambooHR 的 Advantage 套餐，因为 Essentials 套餐不包含与 Crystal Payroll 集成所需的 Open API 支持。您可以通过以下链接查看其套餐及价格：BambooHR 套餐与价格。

登录 BambooHR。点击右上角的姓名或个人头像，然后选择 "API Keys"。

点击 "Add New Key"。

在 "API Key Name" 字段中输入一个名称，例如 "Crystal Payroll"。

点击 "Generate Key"。

点击 "Copy Key"，并将 API 密钥保存在安全的位置，因为您在 Crystal Payroll 中配置集成功能时需要使用此密钥。如果丢失了密钥，您可以重复上述步骤生成新的密钥。

点击 "Done"。

Configuring Leave Categories in BambooHR

接下来，请检查 BambooHR 中的 "Time Off" 类别是否与 Crystal Payroll 中相应的假期类别一致。The category names must match exactly, including spelling, spacing, characters, and units of measurement.

请按照以下要求配置假期类别：

• "Annual Leave" – 以小时为单位。默认情况下，此类别在 BambooHR 中可能被命名为 "Vacation Leave"。如果是这样，您需要重新命名现有类别或创建一个新类别。
• "Sick Leave" – 以天为单位。
• "Alternative Leave" – 以天为单位。

在 BambooHR 中管理这些类别最简单的方法是将它们全部设置为 "Manual Policy"。这样，Crystal Payroll 就可以负责计算和管理员工的假期累积及权益，而 BambooHR 则通过集成功能接收更新后的假期余额。

Creating the Required Custom Fields in BambooHR

下一步需要位于美国的 BambooHR 客户支持团队协助完成。此步骤必须在 Tuesday and Saturday, before 12:00 p.m. New Zealand time 的时间范围内完成，因为 BambooHR 的在线客服在此期间可以协助完成相关设置。

点击 BambooHR 页面右上角的 "Question Mark" 图标。

选择 "Chat with us now"。

Important: Do not attempt to create these fields yourself. They require specific background IDs to function correctly with the Crystal Payroll integration.

当聊天窗口打开并有 BambooHR 客服代表可以提供协助时，请copy and paste the following message exactly as provided. 请勿修改任何措辞、字段名称、符号或后台 ID，因为这些信息对于集成功能正常运行至关重要。

Dear BambooHR,

I am setting up an integration with my payroll system and have been provided the following letter for you.

Please add the following tab and fields under the "People" dashboard:

New custom tab: "Payroll | CP".

New custom text field: "IRD Number (000-000-000) | CP", background ID: customIRDNumberCP

New custom text field: "Tax Code (X or X XX or XX XX) | CP", background ID: customTaxCodeCP

New custom text field: "Withholding Tax Rate (%) (Optional) | CP", background ID: customWithholdingTaxRateCP

New custom text field: "Bank Account Number (00-0000-0000000-00) | CP", background ID: customBankAccountNumberCP

New custom text field: "Default Hours (M-T-W-T-F-S-S) | CP", background ID: customDefaultHoursCP

New custom text field: "KiwiSaver Employee Contribution (%) | CP", background ID: customKiwiSaverEmployeeContributionCP

New custom text field: "KiwiSaver Employer Contribution (%) | CP", background ID: customKiwiSaverEmployerContributionCP

New custom text field: "KiwiSaver ESCT Rate (%) | CP", background ID: customKiwiSaverESCTRateCP

New custom text field: "Casual Employee (Y or N) | CP", background ID: customCasualEmployeeCP

New custom text field: "Region for Anniversary Day (Optional) | CP", background ID: customRegionforAnniversaryDayCP

All fields must be optional, use text field type, and include all brackets and symbols as shown.

Warm regards

BambooHR 客服代表完成设置后，每位员工的个人资料中都会显示一个新标签页及所需的自定义字段，如下图所示。

Setting Up Crystal Payroll

完成 BambooHR 的配置后，您就可以将其连接到 Crystal Payroll。

在 Crystal Payroll 中，前往 "Company Settings"，然后选择 "Import/Export"。

在 "API Settings" 下，从 "HR System" 下拉菜单中选择 "BambooHR"，然后点击 "Save"。

接下来，输入您的 "Client ID"。这通常是您 BambooHR 域名的第一部分。如果您不确定，可以登录 BambooHR 后查看浏览器地址栏。您的客户端 ID 就是网站地址中 ".bamboohr.com" 之前的部分。

输入您之前在 BambooHR 设置过程中生成并保存的 "API Key"。

点击 "Save" 完成配置。

Using the BambooHR Integration

完成集成功能的配置后，您就可以开始在 BambooHR 与 Crystal Payroll 之间传输员工信息。

在 Crystal Payroll 中，前往 "Employee Settings"，然后选择 "Employee Details"。

点击页面右上角的 "BambooHR"。

您将看到以下三个可用选项：

• Import new employees from BambooHR – 将 BambooHR 中的员工记录导入 Crystal Payroll。
• Update an employee's pay rate from BambooHR – 根据 BambooHR 中保存的信息，获取并更新现有员工的工资率。
• Update an employee's details from BambooHR – 将现有员工的信息与 BambooHR 中记录的资料进行同步。

除假期余额外，所有员工信息均从 BambooHR 导入 Crystal Payroll。这意味着您可以在 BambooHR 中管理员工记录，并根据需要将信息同步到 Crystal Payroll，从而减少在两个系统中重复维护相同信息的工作。

Updating Leave Balances in BambooHR

与员工信息的传输方向不同，leave balances are transferred from Crystal Payroll to BambooHR。

当员工休假或其假期权益在 Crystal Payroll 中更新时，您可以将这些变更同步到 BambooHR，以确保两个系统中的员工假期余额保持最新。

要执行此操作，请点击集成页面右上角的 "Step 2: Update Leave Balances"。

配置好 BambooHR 集成功能后，您可以简化员工管理、减少重复输入数据的工作，并确保人力资源和工资信息保持一致。通过在 BambooHR 中管理员工资料，同时在 Crystal Payroll 中管理员工的假期权益，您的企业将能够享受更加简便、高效的工作流程。

希望本指南对您有所帮助！